متى تستخدمه: أنت تريد وكيل حلقة أداة عامل كنقطة بداية، وليس دفتر ملاحظات فارغًا آخر.
المتطلبات الأساسية
- بايثون 3.10+ والنقطة — pyenv أو نظام بايثون
- LangGraph + LangChain الأساسية — نقطة تثبيت langgraph langchain-core
الخطوات
-
اطلب سقالة ReAct
قم بدعم وكيل ReAct باستخدام أداتين (بحث + آلة حاسبة) ونقطة فحص MemorySaver.✓ تم النسخ
→ كود قابل للتشغيل مع الرسم البياني والأدوات ونقطة التفتيش السلكية
-
تشغيل وخطوة من خلال
قم بتشغيله باستخدام thread_id='thread-1' وأظهر لي الحالة في كل خطوة.✓ تم النسخ
→ تؤكد لقطات الحالة لكل خطوة أن الحلقة تعمل
النتيجة: وكيل تشغيل يمكنك تمديده بدلاً من البدء من الصفر.
المزالق
- استخدام InMemorySaver في الإنتاج — قم بالتبديل إلى نقطة تفتيش Postgres قبل الشحن؛ يغطي الدليل المبادلة
متى تستخدمه: يحتوي سير العمل الخاص بك على فروع (تصنيف → مسار → تخصص → وضع اللمسات الأخيرة) وتريد حالة واضحة.
الخطوات
-
وصف الفروع
قم بصياغة LangGraph من أجل: تصنيف النية ← الطريق إلى الملخص أو الأسئلة والأجوبة ← الانتهاء من الاستشهادات.✓ تم النسخ
→ الرسم البياني والرمز. حواف شرطية صريحة
-
إضافة نقاط التفتيش
أضف نقطة تفتيش حتى يستأنف العمل في منتصف التدفق.✓ تم النسخ
→ استمرت الحالة بين الدعوات
النتيجة: خط أنابيب مكتوب قابل للاختبار وقابل للاستئناف.
المزالق
- التعامل مع كل عقدة كمكالمة LLM — غالبًا ما تكون عقد Python النقية غير LLM أكثر وضوحًا وأرخص
متى تستخدمه: الوكيل على وشك إنفاق المال، أو إرسال بريد إلكتروني إلى شخص ما، أو تغيير الحالة - فأنت تريد نقطة تفتيش بشرية.
الخطوات
-
إضافة عقدة المقاطعة
أدخل مقاطعة موافقة بشرية قبل عقدة "send_email"؛ أظهر كيفية الاستئناف.✓ تم النسخ
→ مقاطعة_قبل الأسلاك + واجهة برمجة تطبيقات السيرة الذاتية الواضحة
-
اختبار الموافقة + رفض المسارات
اكتب برنامجًا نصيًا يختبر تدفقات الموافقة والرفض.✓ تم النسخ
→ مساران يمارسان بشكل نظيف
النتيجة: البشر بوابة الخطوة المحفوفة بالمخاطر؛ يتم تشغيل الإجراءات المعتمدة حتى الاكتمال.
المزالق
- نسيان استمرار الحالة عبر المقاطعة — المقاطعات تحتاج إلى نقطة تفتيش. وبدونها لا فائدة من التوقف
متى تستخدمه: وكيل واحد يصبح مرتبكًا أو كبيرًا جدًا؛ أنت تفكر في أنماط التنسيق.
الخطوات
-
المشي من خلال المقايضات
قارن بين المشرف والسرب بالنسبة لفريق الباحثين + المبرمجين + المراجعين.✓ تم النسخ
→ إيجابيات/سلبيات واضحة؛ متى تختار كل منها
-
اختيار والسقالة
سقالة النمط المختار مع الوكلاء الثلاثة.✓ تم النسخ
→ كود قابل للتشغيل مع منطق التوجيه/التسليم
النتيجة: اختيار مبدئي لنمط متعدد الوكلاء مع تشغيل التعليمات البرمجية.
المزالق
- اعتماد وكيل متعدد قبل تصحيح وكيل واحد — ابدأ بوكيل واحد؛ انقسم فقط عندما تصل إلى حدود ملموسة
متى تستخدمه: لديك رسم بياني عملي وتحتاج إلى خطة نشر حقيقية.
الخطوات
-
اختر هدف النشر
قارن بين منصة Docker + LangGraph ومنصة الاستضافة الذاتية؛ يوصي لفريق صغير.✓ تم النسخ
→ توصية ملموسة مع مقايضات التكلفة / العمليات
-
تتبع الأسلاك
أضف تتبع LangSmith مع تحديد نطاق المشروع.✓ تم النسخ
→ آثار مرئية في LangSmith مع اسم المشروع الصحيح
النتيجة: مسار نشر يمكنك إظهاره لفريق النظام الأساسي.