Agentic Workflow Patterns

أنماط سير العمل الوكيل؟

أنماط تدفق سير العمل Agentic هي مستودع يعرض أفضل الممارسات وأنماط التصميم لبناء مهام سير العمل متعددة الوكلاء في Python. يؤكد هذا المستودع على تقنيات التصميم المعيارية وقابلة للتطوير وقابلة لإعادة الاستخدام ، بهدف تسهيل الأتمتة الذكية وإدارة سير العمل القوية من خلال كل من البنية الواحدة الواحدة والتعاونية متعددة الوكلاء. يرافق هذا المستودع مقالًا متوسطًا يغوص في الأنماط بعمق أكثر: تصميم البنية المعرفية: أنماط سير العمل الوكلاء من نقطة الصفر

جدول المحتويات

• ملخص
• نظرة عامة على الأنماط
• ابدء
• تثبيت
• إعداد البيئة
• الاستخدام
• هيكل المشروع
• المساهمة
• رخصة

ملخص

يوفر هذا المستودع أمثلة وقوالب لتصميم مهام سير العمل ، والتي تتكون من مهام سير العمل من عوامل قائمة بذاتها ، كل مسؤول عن مهام مميزة. ينصب التركيز على إنشاء مكونات قابلة لإعادة الاستخدام التي يمكن تكييفها لمهام الأتمتة المختلفة ، مما يتيح اتخاذ القرارات الذكية والمعالجة المبسطة.

نظرة عامة على الأنماط

النمط 1 - التفكير

ينفذ نمط الانعكاس نظام توليد المحتوى التكراري وصقله باستخدام إطار عمل فاعلي. يمكّن هذا النمط توليد المحتوى ذاتيًا من خلال حلقات التغذية المرتدة المستمرة بين الممثل (مولد المحتوى) والناقد (مراجع المحتوى).

؟ يمكن العثور على كل رمز لهذا النمط هنا .

النمط 2 - الوصول إلى الويب

ينفذ نمط الوصول إلى الويب سير عمل وكيل لاسترداد محتوى الويب ومعالجته وتلخيصه. يقوم بتنظيم خط أنابيب من الوكلاء المتخصصين الذين يتعاملون مع جوانب مختلفة من اكتساب محتوى الويب ومعالجته من خلال عمليات البحث والكشط وتلخيص العمليات.

؟ يمكن العثور على كل رمز لهذا النمط هنا .

النمط 3 - التوجيه الدلالي

ينفذ نمط التوجيه الدلالي سير عمل وكيل لتوجيه استفسارات المستخدمين بذكاء إلى وكلاء متخصصين على أساس النية الدلالية. يستخدم هذا النمط بنية المنسق المنسق حيث تحدد مخطط السفر الرئيسي نية المستخدم وطلبات المسارات إلى العوامل الفرعية المتخصصة لمهام محددة ذات صلة بالسفر مثل حجز الطيران وتجاوزات الفنادق وتأجير السيارات.

؟ يمكن العثور على كل رمز لهذا النمط هنا .

النمط 4 - تفويض متوازي

يعالج نمط التفويض الموازي الاستعلامات المعقدة من خلال تحديد كيانات متميزة من خلال التعرف على الكيان المسماة (NER) وتفويض هذه الكيانات إلى وكلاء متخصصة للمعالجة الموازية. إنه فعال للسيناريوهات حيث يمكن تنفيذ المهام الفرعية المستقلة بشكل متزامن.

؟ يمكن العثور على كل رمز لهذا النمط هنا .

النمط 5 - تقطيع ديناميكي

يعالج نمط التقويم الديناميكي مجموعات بيانات كبيرة بكفاءة عن طريق تقسيم عبء العمل ديناميكيًا إلى شظايا أصغر يمكن التحكم فيها ومعالجتها بالتوازي. يتضح هذا النمط من خلال جلب السير الذاتية للمشاهير باستخدام البحث على الويب (تمت مناقشته في النمط 2).

؟ يمكن العثور على كل رمز لهذا النمط هنا .

النمط 6 - تحلل المهمة

يقسم نمط تحلل المهمة مهمة معقدة إلى مهام فرعية مستقلة ، يدير كل منها من قبل وكلاء المهام الفرعية المنفصلة. هذا النمط مفيد لتعزيز الكفاءة وقابلية التوسع.

؟ يمكن العثور على كل رمز لهذا النمط هنا .

النمط 7 - التحلل الديناميكي

يحلل نمط التحلل الديناميكي مهامًا معقدة بشكل مستقل إلى مهام متعددة باستخدام نموذج لغة كبير (LLM) لإنشاء مهام فرعية ، تتم معالجتها بواسطة عوامل منفصلة.

؟ يمكن العثور على كل رمز لهذا النمط هنا .

النمط 8 - DAG Orchestration

يدير نمط تنسيق DAG (الرسم البياني الموجه) سير العمل المعقدة بطريقة مرنة ، مما يسمح بتنفيذ مهام متعددة بترتيب محدد. ويستخدم DAG محددة من YAML لتنظيم سير العمل.

؟ يمكن العثور على كل رمز لهذا النمط هنا .

ابدء

استنساخ هذا المستودع للبدء. يتطلب هذا المشروع Python 3.8 أو أحدث.

المتطلبات الأساسية

• بيثون 3.8+
• pip (يأتي مع Python 3.8+)

تثبيت

1. استنساخ المستودع:

   git clone https://github.com/arunpshankar/Agentic-Workflow-Patterns.git
   cd Agentic-Workflow-Patterns

2. إعداد بيئة افتراضية:

   python -m venv .venv
   source .venv/bin/activate  # On Windows, use `.venvScriptsactivate`

3. ترقية PIP وتثبيت التبعيات:

   pip install --upgrade pip
   pip install -r requirements.txt

إعداد بيانات الاعتماد؟

1. قم بإنشاء مجلد credentials في جذر المشروع:

   mkdir credentials

2. قم بإعداد بيانات اعتماد حساب خدمة GCP:

   • انتقل إلى وحدة التحكم السحابية Google (https://console.cloud.google.com/).
   • إنشاء أو تحديد مشروع موجود.
   • انتقل إلى "واجهات برمجة التطبيقات والخدمات"> "بيانات الاعتماد".
   • انقر فوق "إنشاء بيانات الاعتماد"> "مفتاح حساب الخدمة".
   • اختر JSON كنوع المفتاح ، وانقر فوق "إنشاء".
   • احفظ ملف JSON الذي تم تنزيله كـ key.json في مجلد credentials .

3. قم بإعداد بيانات اعتماد API SERP:

   • قم بالتسجيل للحصول على حساب SERP API على https://serpapi.com/.
   • الحصول على مفتاح API الخاص بك من لوحة القيادة.
   • قم بإنشاء ملف اسمه key.yml في مجلد credentials .
   • أضف رمز SERP API الخاص بك:

      serp :
       key : your_serp_api_key_here

ملاحظة : يتم تضمين مجلد credentials في .gitignore لمنع الالتزام بالمعلومات الحساسة.

إعداد البيئة؟

للحفاظ على بيئة نظيفة وتعطيل توليد بيثون بايت كود ، تكوين متغيرات البيئة التالية:

 export PYTHONDONTWRITEBYTECODE=1
export PYTHONPATH= $PYTHONPATH :.

هيكل المشروع

• ./src/patterns/ - يحتوي على جميع شفرة المصدر لأنماط سير العمل.
• ./data/patterns/

الاستخدام

بعد إعداد البيئة ، يمكنك البدء في تجربة أنماط سير العمل المدرجة في هذا المستودع. تم توثيق كل نمط بأمثلة لإظهار تطبيقه في سير عمل وكيل البناء.

على سبيل المثال ، لتشغيل نمط الانعكاس:

python src/patterns/reflection/pipeline.py

المساهمة؟

نرحب ونقدر المساهمات! فيما يلي كيفية المساهمة في أنماط سير العمل الوكلاء :

1. شوكة المستودع : قم بإنشاء شوكة خاصة بك على github لإجراء تغييرات بشكل مستقل.
2. إنشاء فرع : اعمل على فرع منفصل لكل ميزة أو إصلاح.

   git checkout -b feature-branch-name

3. قم بإجراء تغييرات : احتفظ بأسلوب الكود ثابتًا وتأكد من توثيق التغييرات الخاصة بك جيدًا.
4. ارتكب تغييراتك : اكتب رسالة ملزمة واضحة وموجزة.

   git commit -m " Add feature or fix description "

5. إرسال طلب سحب : ادفع التغييرات الخاصة بك وفتح طلب سحب.

المبادئ التوجيهية

• نمط الترميز : اتبع اتفاقيات التعليمات البرمجية الحالية.
• الوثائق : تأكد من توثيق الكود والمساهمات الخاصة بك بشكل جيد.
• الاختبار :

أضف اختبارات إذا كان ذلك ممكنًا للحفاظ على استقرار المستودع.

• إصدار القضية : الإبلاغ عن الأخطاء أو اقتراح ميزات عبر القضايا.

رخصة

تم ترخيص هذا المستودع بموجب ترخيص معهد ماساتشوستس للتكنولوجيا. انظر ملف الترخيص للحصول على التفاصيل.