كتب الذكاء الاصطناعيمشاريع الذكاء الاصطناعيمقالات الذكاء الاصطناعيمعجم الذكاء الاصطناعياسئلة واجوبة في الذكاء الاصطناعيأكاديمية الذكاء الاصطناعي للأطفالأكاديمية الذكاء الاصطناعيمدرسة رياضيات الذكاء الاصطناعيمختبر الذكاء الاصطناعيمختبر الخوارزميات المستوحاة من الطبيعةأطلس نماذج الذكاء الاصطناعيموسوعة تطبيقات الذكاء الاصطناعيمستكشف مجموعات البيانات للذكاء الاصطناعياختبارات الذكاء الاصطناعيالفايب كودينغدليل البرمجة بالذكاء الاصطناعيمولّد مشاريع الذكاء الاصطناعيمرصد الذكاء الاصطناعيدليل أدوات الذكاء الاصطناعي البحث والنشر الأكاديميمكتبة البرومبتات الأكاديميةمستودع الرسائل والأطاريح في الذكاء الاصطناعيحاسبة الترقية العلميةأكاديمية الوكلاء الذكيينمختبر أخلاقيات الذكاء الاصطناعي والعدالةساحة ألعاب الذكاء الاصطناعيمختبر التنبؤ بالسلاسل الزمنيةمتحف الذكاء الاصطناعيمختبر الرؤية الحاسوبيةمختبر الشبكات العصبية البيانيةمختبر معالجة اللغة الطبيعيةمختبر الحوسبة الكمّيةخرائط طريق الذكاء الاصطناعي

الوحدة 7 · الدرس 3 · 16 دقيقة قراءة

LangGraph: الوكيل كرسم بياني للحالة

LangGraph: Agents as State Graphs

المقدمة

يعامل LangGraph الوكيل كرسم بياني: عُقد تقرأ حالة مشتركة وتحدّثها، وحواف تحدد المسار. في هذا الدرس نبني رسمًا صغيرًا يعمل دون مفتاح API، ونفهم لماذا يسهّل الرسم الصريح الاختبار والاستئناف والموافقة البشرية.

أهداف التعلم

  • شرح مفهوم رسم الحالة والعقد والحواف في LangGraph
  • بناء رسم بسيط باستخدام StateGraph وMessagesState وSTART وEND
  • فهم كيف تعيد العقدة تحديثًا للحالة لا حالة كاملة
  • مقارنة رسم الحالة بالحلقة المفتوحة مع التسليم

LangGraph: التنظيم منخفض المستوى

يصف التوثيق الرسمي LangGraph بأنه إطار تنظيم (Orchestration) منخفض المستوى لبناء وكلاء طويلي التشغيل يحتفظون بالحالة (Stateful)، ويركّز على أربع قدرات: التنفيذ المتين (Durable Execution) الذي يسمح باستئناف التشغيل بعد انقطاع، والبث (Streaming)، والإنسان في الحلقة (Human-in-the-Loop)، والاستمرارية والذاكرة (Persistence). ومن المهم أنه لا يتطلب استخدام LangChain، وإن كان يتكامل معه. يُثبَّت بالأمر pip install -U langgraph، وآخر إصدار على PyPI هو 1.2.22 (بحسب التوثيق الرسمي، مراجعة 18 نوفمبر 2026).

الفكرة الأساسية: بدل أن يقرر النموذج وحده ما يحدث بعد كل خطوة كما في الحلقة المفتوحة، ترسم أنت رسمًا بيانيًا للحالة (State Graph): عُقد (Nodes) هي دوال تقرأ الحالة وتعيد تحديثًا لها، وحواف (Edges) تحدد الانتقال من عقدة إلى أخرى.

أداة؟حساس؟انتهىSTARTوكيلnodeأدواتnodeموافقة بشريةinterruptENDالحالة Statecheckpoint
سير عمل بمخطط حالات: عقد تقرأ الحالة المشتركة وتعدّلها، وحواف شرطية تختار المسار، ونقاط حفظ تسمح بالاستئناف.

المكونات الخمسة التي تحتاجها للبداية

  • StateGraph: باني الرسم، ويأخذ نوع الحالة.
  • MessagesState: حالة جاهزة تحتوي على مفتاح messages، وتُضاف الرسائل الجديدة إلى القائمة بدل استبدالها.
  • add_node(name, fn): يضيف عقدة. الدالة تستقبل الحالة وتعيد قاموسًا بالتحديث.
  • add_edge(a, b): يضيف حافة. الثابتان START وEND يمثلان بداية الرسم ونهايته.
  • compile() ثم invoke(...): تحويل الباني إلى رسم قابل للتشغيل ثم تشغيله على حالة ابتدائية.

مثال عملي يعمل دون مفتاح API

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

python
# langgraph 1.2.22 — مراجعة 18 نوفمبر 2026
# يتطلب: pip install -U langgraph (لا يحتاج هذا المثال إلى مفتاح API لأن العقد لا تستدعي نموذجًا)
from langgraph.graph import StateGraph, MessagesState, START, END

def classify(state: MessagesState):
    text = state["messages"][-1].content
    label = "مالي" if "رسوم" in text or "فاتورة" in text else "أكاديمي"
    return {"messages": [{"role": "assistant", "content": "التصنيف: " + label}]}

def respond(state: MessagesState):
    label = state["messages"][-1].content
    reply = "سنحوّلك إلى الشؤون المالية" if "مالي" in label else "سنحوّلك إلى المرشد الأكاديمي"
    return {"messages": [{"role": "assistant", "content": reply}]}

builder = StateGraph(MessagesState)
builder.add_node("classify", classify)
builder.add_node("respond", respond)
builder.add_edge(START, "classify")
builder.add_edge("classify", "respond")
builder.add_edge("respond", END)

graph = builder.compile()
result = graph.invoke({"messages": [{"role": "user", "content": "لدي سؤال عن رسوم الفصل"}]})
for m in result["messages"]:
    print(type(m).__name__, ":", m.content)

عند التشغيل ستظهر ثلاث رسائل: رسالة المستخدم، ثم التصنيف، ثم الرد. لاحظ أن كل عقدة أعادت تحديثًا يحتوي على رسالة جديدة فقط، وأن MessagesState أضافها إلى القائمة. ولاحظ أن القواميس التي كتبناها تحوّلت إلى كائنات رسائل (مثل HumanMessage وAIMessage)، لذلك نقرأ النص عبر .content.

لماذا الرسم الصريح مفيد؟

  1. قابلية التنبؤ: المسار مكتوب في الكود، فلا يستطيع النموذج تخطي خطوة التحقق أو الموافقة.
  2. قابلية الاختبار: كل عقدة دالة مستقلة يمكن اختبارها وحدها.
  3. الاستئناف: لأن الحالة مركزية وصريحة، يمكن للإطار حفظها بعد كل خطوة (الاستمرارية) واستئناف التشغيل من آخر نقطة، وهو أساس التنفيذ المتين ونقاط الموافقة البشرية التي سندرسها في وحدة الوكلاء المستقلين.
  4. الدورات المقصودة: يمكن رسم حافة تعود إلى عقدة سابقة لبناء حلقة «فكّر ثم نفّذ ثم راجع»، مع شرط خروج واضح.

مقارنة سريعة بالحلقة والتسليم

السؤالحلقة مع تسليم (Agents SDK)رسم حالة (LangGraph)
من يحدد الخطوة التالية؟النموذج غالبًاالحواف التي ترسمها، مع قرارات النموذج داخل العقد
شكل الحالةسجل المحادثةحالة مُعرّفة تتشاركها العقد
أفضل استخداممحادثات متعددة المتخصصينمسارات عمل طويلة ومضبوطة وقابلة للاستئناف

الملخص

LangGraph إطار تنظيم منخفض المستوى للوكلاء طويلي التشغيل، يركّز على التنفيذ المتين والبث والإنسان في الحلقة والاستمرارية، ولا يتطلب LangChain. تبني الرسم بـ StateGraph وتضيف العقد والحواف بين START وEND ثم تستدعي compile وinvoke. العقد تعيد تحديثات للحالة، وMessagesState يضيف الرسائل الجديدة إلى القائمة. الرسم الصريح يجعل المسار قابلًا للتنبؤ والاختبار والاستئناف.

المصطلحات

المصطلحEnglishالتعريف
عقدةNodeدالة تقرأ الحالة وتعيد تحديثًا لها
حافةEdgeانتقال محدد من عقدة إلى أخرى
حالة الرسائلMessagesStateحالة جاهزة بمفتاح messages تُضاف إليه الرسائل الجديدة
التنفيذ المتينDurable Executionالقدرة على استئناف التشغيل بعد انقطاع من آخر حالة محفوظة
التجميعcompileتحويل الباني إلى رسم قابل للتشغيل

أسئلة المراجعة

  1. ما دور START وEND في رسم LangGraph؟
  2. لماذا تعيد العقدة قاموس تحديث بدل الحالة كاملة؟
  3. كيف يساعد الرسم الصريح على وضع نقطة موافقة بشرية لا يمكن تخطيها؟
  4. ما الخطر في رسم دورة دون شرط خروج؟

المراجع