LangChain أم LlamaIndex: كيف يستأنف وكيل المعرفة عمله بعد الموافقة البشرية؟

تحتاج وكلاء المعرفة الداخلية إلى استرجاع المعلومات والكتابة في أنظمة العمل بعد الموافقة. أعطِ الأولوية لتقييم LangGraph عندما تكون نقاط الاستئناف وسجل التنفيذ أساس التصميم. ويمكن للفرق التي تستخدم بيانات وأدوات LlamaIndex الاحتفاظ بـ Workflows، مع تحديد المسؤول عن اللقطات والاستعادة. ولا يغني أي منهما عن منع تكرار إجراءات العمل.

المصدر: docs.langchain.com
November 11, 2026
5 min

عندما ينتقل مساعد المعرفة الداخلي من الإجابة عن أسئلة السياسات إلى إنشاء تذاكر بناءً على إجاباته، تتسع المخاطر لتشمل أكثر من صحة الإجابة: ما الذي وافق عليه الشخص، وهل ستنشئ إعادة تشغيل العملية تذكرة أخرى؟ بالنسبة إلى الفرق التي تطوّر تطبيقًا من هذا النوع بوكيل واحد، يدعم كل من LangChain وLlamaIndex الأدوات والحالة والمدخلات البشرية. والعامل الحاسم هو كيفية دمج الاستعادة في الخدمة التي تبنيها.

أعطِ الأولوية لتقييم LangGraph ضمن منظومة LangChain إذا أردت توحيد مواضع التوقف وسجل الحالة والاستعادة بعد إعادة التشغيل في آلية تنفيذ واحدة. وللاحتفاظ بـ LlamaIndex Workflows مبررات قوية إذا كان الاسترجاع والأدوات مبنيين بالفعل على LlamaIndex وكان الفريق مستعدًا لإدارة الأحداث وحفظ الحالة. يستند هذا التحليل إلى وثائق Python الرسمية. وهو ليس اختبار تشغيل ولا ضمانًا لنتائج الاستعادة.

حدّد الطبقة التي تقارنها أولًا

تميّز نظرة LangChain العامة بين طبقات عدة: يوفّر create_agent في LangChain حلقة وكيل قابلة للتركيب؛ وLangGraph إطار التنسيق الأدنى مستوى؛ ويقدّم Deep Agents بنية وكيل أشمل فوق تلك الأسس؛ بينما يوفّر LangSmith إمكانات منصة مثل التتبّع وتصحيح الأخطاء والتقييم. تتناول هذه المقارنة التحكم في تنفيذ وكلاء تبنيهم بنفسك. شراء LangSmith أو اعتماد Deep Agents ليس مرادفًا لإعداد حفظ الحالة في LangGraph.

يتضمن إطار LlamaIndex أيضًا وكلاء وWorkflows قائمة على الأحداث منذ وقت سابق؛ والاسترجاع مجرد نوع من الأدوات التي يستطيع الوكيل استدعاءها. وينبغي تقييمه منفصلًا عن خدمات المستندات LlamaCloud. كما تعرض الصفحات الرسمية الحالية إمكانات التحليل والفهرسة المُدارة ذات الصلة تحت منصة LlamaParse. ربط تلك الخدمات لا يجعل عملية الوكيل الخاصة بك قابلة للاستعادة تلقائيًا.

نقطة موافقة واحدة بطريقتين مختلفتين

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

يتوقف LangGraph عبر interrupt، ويتلقى المدخل البشري باستخدام Command عند الاستئناف. يحتاج التطبيق إلى إعداد checkpointer واستخدام thread_id نفسه لاسترجاع حالة التنفيذ. يناسب ذلك فصل الاسترجاع وإعداد الإجراء للمراجعة وتنفيذ الكتابة إلى عُقد واضحة، بحيث يمكن فحص ما حفظته كل مرحلة.

أما مثال المشاركة البشرية في LlamaIndex فيجعل الأداة تنتظر أحداثًا: يطلب InputRequiredEvent مدخلًا، ويعيد HumanResponseEvent الرد، ويتولى wait_for_event الانتظار. ويمكن للفرق التي تملك خدمة لاستهلاك الأحداث ربط واجهة الموافقة بهذه الواجهات. ويظل على التطبيق تحديد التحقق من هوية المراجع ونسخة المعاملات والمعالجة المطلوبة بعد الرفض.

يتيح كلاهما إدخال الرد البشري في مسار التنفيذ. لكن زر الموافقة ليس نظام صلاحيات: لا ينبغي أن يستطيع أي عميل استئناف تذكرة تخص شخصًا آخر بمجرد إرسال كلمة «موافق».

احفظ السياق في اللحظة المناسبة

تحفظ checkpointers في LangGraph حالة الرسم البياني عند حدود super-step، وتنظّم نقاط الحفظ بحسب thread. ومع بيئة تشغيل تبنيها بنفسك، ما زلت تحتاج إلى اختيار مخزن دائم واستراتيجية للكتابة. ولا يعادل المثال الذي يعمل في الذاكرة استعادةً بين العمليات. الفائدة هي نموذج موحّد لنقاط الحفظ، لا إلغاء مسؤولية تشغيل قاعدة البيانات.

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

تشرح وثائق سير العمل القابل للاستعادة التقاط تغيّرات الحالة أثناء التنفيذ وكتابة اللقطات واستعادة Context. وفي بيئة التشغيل الافتراضية داخل العملية، تدير هذه الحلقة الخاصة بنقاط الحفظ بنفسك. وتعرض الوثائق أيضًا إضافات لبيئة التشغيل مثل DBOS تتولى الحفظ والاستعادة. لذلك يمتلك LlamaIndex خيارات للاستعادة، لكن قابلية Context للتسلسل لا تعني وجود تخزين موثوق مُعدّ افتراضيًا.

الموافقة لا تمنع تكرار التنفيذ

لا يعني الاستئناف متابعة التنفيذ من سطر الشيفرة نفسه الذي توقف عنده. تبدأ عقدة LangGraph التي تحتوي على المقاطعة من أولها مجددًا. وتوضح وثائق LlamaIndex كذلك أن الخطوة التي كانت قيد التنفيذ عند التقاط اللقطة تبدأ مجددًا، وأن الاستئناف يتبع دلالة التنفيذ مرة واحدة على الأقل. ويتطلب التصميمان التعامل بعناية مع الآثار الجانبية.

مثلًا، قد يكون نظام التذاكر أنشأ التذكرة بنجاح، ثم يتعطل الوكيل قبل حفظ نتيجة النجاح. وضع الكتابة بعد الموافقة يحدّد متى يُسمح بها، لكنه لا يمنع إعادة الإرسال بعد الاستعادة. احفظ معرّف عملية ثابتًا لهذه النسخة من الإجراء الموافق عليه، واجعل النظام المستقبِل يستخدمه لمنع التكرار. وإذا لم يدعم النظام الطلبات الآمنة عند التكرار، فاستعلم أولًا عن النتيجة أو أحِلها إلى مراجعة بشرية بدل إعادة المحاولة دون تحقق.

حفظ المعاملات الموافق عليها وهوية المراجع ومعرّف العملية ورقم التذكرة الخارجي أنفع من الاحتفاظ بسجل المحادثة وحده. وإذا تغيّر الجهاز أو الوصف بعد الموافقة، فاطلب موافقة جديدة وفق قواعد العمل. هذه توصيات لتصميم التطبيق، وليست ضمانات للمعاملات يوفّرها أي من الإطارين تلقائيًا.

اتخذ القرار عند حدود الفشل

اختبر 3 مواضع في مسار الإصلاح نفسه: إعادة تشغيل العملية أثناء انتظار الموافقة؛ والاستئناف مرة أخرى بعد الرفض؛ والمقاطعة بعد إنشاء التذكرة وقبل حفظ النتيجة. تحقّق، بالترتيب، من إمكانية العثور على الإجراء الأصلي، والاحتفاظ بنتيجة الرفض، ووجود التذكرة الواحدة المتوقعة فقط في النظام الخارجي. هذه اختبارات ينبغي تنفيذها قبل الإطلاق، وليست نتائج اختبارات أُجريت لهذا المقال.

يمكن للفرق التي تريد إدارة هذا المسار بصورة موحّدة من خلال نقاط الحفظ وحدود العُقد أن تبدأ بتجربة LangGraph، مع إدراج مخزن الحالة والأدوات الآمنة عند التكرار ضمن نطاق المشروع. أما الفرق التي تملك استرجاعًا وسير عمل قائمًا على الأحداث في LlamaIndex، فيمكنها أولًا التحقق من لقطات Context أو بيئة تشغيل مناسبة تدعم الاستعادة، دون إعادة كتابة طبقة البيانات لمجرد «دعم الوكلاء».

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

ملاحظة حول المحتوى:يستند هذا المقال إلى معلومات متاحة للعموم ويُعد مرجعًا للمساعدة في اختيار الأدوات. قد تتغير الميزات والأسعار والسياسات ذات الصلة في أي وقت، لذا يُرجى الرجوع إلى أحدث المعلومات الرسمية.

المصدر الأصلي:docs.langchain.com