// سلسلة
ثمانية مقالات تأخذك من السؤال الأول — ما هو الوكيل؟ — إلى وكيل حقيقي تحفظ حالته، وتطلب موافقة بشرية قبل أي إجراء حسّاس. كل مقال يبني على سابقه، وكل مقال يخبرك بماذا ستبني بعده.
8 articles in this series
لانغ تشين إطار عمل أعلى المستوى تبني به وكيلك من نموذج لغوي وأدوات، ولانغ غراف بيئة تشغيل منخفضة المستوى تُشغّله وتحفظ حالته وتتيح تعليقه بانتظار موافقة إنسان. هذه الصفحة بوابة سلسلة من ثمانية مقالات تبدأ من تثبيت البيئة وتنتهي وكيلاً كاملاً يحفظ حالته ويطلب إذنك قبل كل إجراء حساس. كل ما فيها مبني على الوثائق الرسمية للإصدار الأول لا على شروح قديمة.
ابدأ من هنا — المقالة الأولى في السلسلة.
الوكيل يُبنى بـ create_agent من حزمة langchain وحدها، ولا تحتاج حزمة langgraph إلا إذا أردت نقاط حفظ أو تحكماً صريحاً في ترتيب الخطوات أو تدخّلاً بشرياً في الحلقة. هذا المقال يفكّك المعادلة الرسمية «الوكيل = نموذج + بنية تشغيل» إلى أربعة معاملات عملية، ويشرح لماذا لا نضع أي توصية على حزمة deepagents ما دامت قبل الإصدار 1.0.
تشرح init_chat_model وصيغة «provider:model» التي تفصل المزوّد عن اسم النموذج، فتنتقل بين OpenAI وAnthropic وGoogle وOllama بتغيير سلسلة نصّية واحدة لا سطراً من المنطق. كما تغطي الرسائل، وخاصية content_blocks المدعومة اليوم في خمس حزم تكامل فقط لا كل المزوّدين، والبثّ عبر stream_events بنسخة v3، مع تمرين عملي يبني طبقة نموذج قابلة للتبديل عندك.
الأداة في لانغ تشين دالة لها مُدخلات ومخرجات محدّدة يعرضها على النموذج فيقرّر بنفسه متى يستدعيها، وهذه الآلية تُسمّى استدعاء الأدوات (tool calling) لا استدعاء الدوال (function calling) الذي هو المصطلح الأقدم من OpenAI. والـ docstring وتلميحات النوع هما العقد الذي يقرأه النموذج حرفياً، لا زينة. وثلاثة أخطاء تكلّف القارئ وقتاً طويلاً: أسماء الأدوات غير snake_case، واستخدام الاسم المحجوز config أو runtime، والاعتقاد بأن return_direct تنهي الحلقة قبل أن تحمل كل أدوات الدفعة هذه العلامة.
create_agent هي الدالة الوحيدة لبناء وكيل في لانغ تشين 1.0 بعد أن حلّت محل create_react_agent، وسبب قوتها الحقيقي هو طبقة الوساطة البرمجية middleware التي تُدخل ستّة خطّافات في دورة الوكيل. يشرح المقال الخطّافات الستة في جدول، ويغطّي الحالة AgentState والمخرجات المهيكلة عبر response_format، وكتابة وسيطتك الخاصة التي تختار النموذج حسب خبرة المستخدم.
الذاكرة في لانغ غراف ليست صندوقاً سحرياً بل ثلاث قطع منفصلة: الحالة (State)، ومُحافِظ النقاط (checkpointer)، والمخزن (store). يشرح المقال كيف تُدمج حقول الحالة بدوال الدمج، ولماذا إرجاع قائمة فارغة لا يفرّغ حقلاً مدموجاً، ولماذا يُعدّ thread_id المؤشر الدائم للمحادثة وحدّه الأقصى 255 حرفاً. كما يوضح الفرق بين الذاكرة الدلالية والبحث الدلالي، وينبّه إلى أن القنوات الخاصة في الحالة لا تُخفى أثناء البثّ.
لانغ غراف يبني سير العمل من ثلاث قطع: الحالة والعقد والحواف، ويُنفّذها في خطوات كبرى متوازية. هنا تشرح بنية StateGraph ومتى تختار Command أو Send بدل الحواف الشرطية، وأنماط سير العمل الخمسة، ثم بوابة الموافقة البشرية بـ interrupt — مع الفخاخ التي تُعيد العقدة تنفيذ نفسها عند الاستئناف فتضاعف ما تدفعه فعلاً.
دليل عملي تبني فيه وكيل حجوزات كاملاً سطراً بسطر: ثلاث أدوات، رسم حالة بعقدتين، حفظ دائم على القرص، وبوابة موافقة بشرية قبل أي حجز. التحذيران اللذان يُكلّفان مالاً حقيقياً مكتوبان داخل البناء لا في نهايته: أن InMemorySaver يفقد كل شيء عند إعادة تشغيل البرنامج، وأن استئناف المقاطعة يعيد العقدة من بدايتها فيجب تصميم الحجز كي لا يتكرر. وينتهي الدليل بقائمة تحقق من ثمانية أسئلة تشخيصية، بعد عرض الرسم عبر draw_mermaid_png والبثّ التشخيصي عبر stream_events بنسخته v3.
هذه السلسلة مكتوبة على docs.langchain.com ↗ الأصلية. كل رقم واسم حزمة فيها موثّق بمصدره داخل كل مقال، وكل الأكواد منقولة من الوثائق الرسمية. إن اختلفت الوثائق عن مقالنا، فالوثائق هي المرجع — وأي خطأ يُصحَّح علنًا في سجل التصحيحات.
