النقاط الرئيسية
- ترخيص MIT — مجاني تمامًا للاستخدام والتعديل والاستضافة الذاتية، بلا حدود استخدام على المكتبة نفسها
- طوّرته LangChain Inc.، وصدر لأول مرة كحزمة مستقلة قابلة للتثبيت في يناير 2024، بعد أن كان موجودًا كوحدة وكيل تجريبية داخل LangChain
- أكثر من 41,000 نجمة على GitHub في المستودع الأساسي langchain-ai/langgraph
- وصل LangGraph 1.0 إلى التوافر العام في أكتوبر 2025 جنبًا إلى جنب مع LangChain 1.0، مع التزام مشترك بعدم إجراء تغييرات كاسرة حتى الإصدار 2.0
- النموذج الذهني الأساسي: الوكلاء كعُقَد وحواف في رسم بياني، مع كائن حالة مشترك يستمر عبر كل خطوة
- نقاط التفتيش المدمجة (عبر checkpointer قابل للتبديل، مثل حافظة في الذاكرة أو أخرى مدعومة بقاعدة بيانات) تتيح للرسم البياني التوقف والاستئناف من أي نقطة والتعافي بعد إعادة تشغيل العملية
- استضافة وكلاء LangGraph في الإنتاج — المسوَّقة باسم "LangGraph Platform" حتى 2025 — تُباع الآن باسم LangSmith Deployment، وهي ميزة تُحتسب بحسب الاستخدام ضمن خطط LangSmith المدفوعة، وليست منتجًا مستقلاً له قائمة أسعار خاصة به
📍 في جملة واحدة
LangGraph إطار عمل مجاني ومفتوح المصدر برخصة MIT طوّرته LangChain Inc. لنمذجة وكلاء الذكاء الاصطناعي كرسوم بيانية من العُقَد والحواف، مع حالة صريحة، ونقاط تفتيش، ومقاطعات human-in-the-loop.
💬 بعبارات بسيطة
بدلاً من كتابة الوكيل كحلقة واحدة تستدعي نموذجًا وتأمل النتيجة الأفضل، يجعلك LangGraph ترسم الوكيل كمخطط تدفق — كل خطوة عُقدة، وكل مسار ممكن بين الخطوات حافة، والتقدّم الحالي للوكيل هو حالة تُحفظ بعد كل خطوة، بحيث يمكنه التوقف مؤقتًا أو الاستئناف أو التعافي بعد تعطّل.
📌ملاحظة: LangGraph مكتبة يُكتب الكود ضدها، وليست تطبيقًا يُنزَّل — لا توجد واجهة رسومية لتثبيتها لإطار العمل مفتوح المصدر نفسه (أداة LangGraph Studio، وهي أداة تصحيح مرئية منفصلة، اختيارية). تغطي هذه المراجعة مكتبة LangGraph مفتوحة المصدر وخيار نشر الإنتاج المدفوع معًا، لأن LangChain Inc. تبني وتبيع كليهما كحزمة متصلة واحدة.
من طوّر LangGraph، وكيف أصبح منتجًا مستقلاً؟
طوّرت LangChain Inc. مشروع LangGraph كامتداد لـ LangChain للوكلاء الذين يحتاجون إلى موثوقية أكبر مما يمكن أن توفره حلقة بسيطة، ثم فصلته لاحقًا في حزمة مستقلة قابلة للتثبيت. كانت تجريدات وكلاء LangChain المبكرة (نمط "agent executor" قبل 2024) تعمل كحلقة ثابتة بتحكم محدود في الخطوات الوسيطة، مما جعل من الصعب إضافة إعادة المحاولة، أو التوقف لاتخاذ قرار بشري، أو التعافي بشكل نظيف بعد تعطّل. عالج LangGraph ذلك عبر نمذجة الوكيل صراحةً كرسم بياني، مستلهمًا أفكارًا من Pregel من Google وApache Beam حول كيفية انتقال الحالة بين خطوات الحوسبة.
صدر LangGraph كحزمة Python مستقلة في يناير 2024، منفصلة عن الحزمة الأساسية langchain، مما سمح للفرق باعتماد وقت التشغيل القائم على الرسوم البيانية دون الاعتماد على بقية إطار عمل LangChain. بنت LangChain Inc. بعد ذلك منتج نشر مُستضاف حوله: نسخة تجريبية باسم LangGraph Cloud في منتصف 2024، وصلت إلى التوافر العام في مايو 2025 باسم LangGraph Platform. في أكتوبر 2025، جنبًا إلى جنب مع إصدارات التوافر العام لـ LangChain 1.0 وLangGraph 1.0، أُدمج منتج الاستضافة هذا في عائلة منتجات LangSmith، ويُباع الآن باسم LangSmith Deployment بدلاً من منصة تحمل علامة تجارية مستقلة.
وحدة تجريبية داخل LangChain
- التاريخ:
- 2023
- ماذا يعني:
- أفكار مبكرة عن وكلاء قائمين على الرسوم البيانية موجودة في كود LangChain، استجابةً لقيود حلقة agent-executor الثابتة
LangGraph كحزمة مستقلة
- التاريخ:
- 2024-01
- ماذا يعني:
- يصدر LangGraph كحزمة Python مستقلة قابلة للتثبيت، منفصلة عن الحزمة الأساسية langchain
LangGraph Cloud (تجريبي)
- التاريخ:
- 2024-06
- ماذا يعني:
- أول عرض نشر مُستضاف لوكلاء LangGraph، في مرحلة تجريبية
LangGraph Platform (توافر عام)
- التاريخ:
- 2025-05
- ماذا يعني:
- يصل منتج النشر المُستضاف إلى التوافر العام باسم LangGraph Platform
LangGraph 1.0
- التاريخ:
- 2025-10
- ماذا يعني:
- توافر عام جنبًا إلى جنب مع LangChain 1.0؛ التزام علني بعدم إجراء تغييرات كاسرة حتى الإصدار 2.0
الدمج في LangSmith Deployment
- التاريخ:
- 2025-10
- ماذا يعني:
- يُعاد بيع النشر المُستضاف كميزة LangSmith تُحتسب بحسب الاستخدام بدلاً من منصة تحمل علامة تجارية مستقلة
📌ملاحظة: ترخيص MIT لمكتبة LangGraph مفتوحة المصدر لا يتأثر بإعادة التموضع هذه — تغيّر فقط اسم منتج النشر المُستضاف وهيكل تسعيره، وليس الحالة المجانية للمكتبة التي يتم تثبيتها عبر pip install.
ما هو LangGraph؟
LangGraph مكتبة مفتوحة المصدر (ترخيص MIT، github.com/langchain-ai/langgraph) لبناء الوكلاء كرسوم بيانية ذات حالة، متوفرة لـ Python وJavaScript/TypeScript (باسم LangGraph.js). بدلاً من سلسلة خطية من الاستدعاءات، الوكيل المبني باستخدام LangGraph هو رسم بياني موجّه: العُقَد هي وحدات عمل (استدعاء نموذج، استدعاء أداة، منطق أعمال)، وتحدد الحواف أي عُقدة تُنفَّذ بعد ذلك — بما في ذلك الحواف الشرطية التي تتفرّع بناءً على الحالة الحالية، والدورات (cycles) التي تتيح للوكيل الرجوع لإعادة المحاولة أو إعادة التخطيط.
- الحالة: كائن واحد مكتوب النوع (عادةً
TypedDictفي Python) تقرأه وتكتبه كل عُقدة، بحيث يشارك الرسم البياني بأكمله مصدرًا واحدًا للحقيقة حول ما حدث حتى الآن - العُقَد والحواف: العُقَد دوال بسيطة تستقبل الحالة الحالية وتعيد تحديثات عليها؛ تُقرِّر الحواف (بما فيها الشرطية) العُقدة التالية للتنفيذ استنادًا إلى تلك الحالة
- نقاط التفتيش والاستمرارية: checkpointer قابل للتبديل (حافظة في الذاكرة للتطوير، أو أخرى مدعومة بقاعدة بيانات مثل Postgres للإنتاج) تحفظ حالة الرسم البياني بعد كل خطوة، مرتبطة بمعرّف thread، بحيث يمكن للتشغيل التوقف والاستئناف من حيث توقف بالضبط
- human-in-the-loop: تُوقف الدالة
interrupt()التنفيذ داخل عُقدة وتعيد التحكم إلى الكود المستدعي؛ استئناف التنفيذ عبرCommand(resume=...)يواصل نفس تشغيل الرسم البياني من تلك النقطة بالضبط — هكذا ينفّذ LangGraph خطوات الموافقة دون فقدان الحالة - الرسوم البيانية متعددة الوكلاء والهرمية: بما أن العُقدة نفسها يمكنها استدعاء رسم بياني فرعي مُجمَّع، يدعم LangGraph بنى الوكيل الواحد ومتعددة الوكلاء والهرمية (مشرف مع عمّال) بنفس العناصر الأساسية
- LangGraph Studio: أداة مرئية اختيارية لفحص رسم بياني قيد التشغيل واستعراضه خطوة بخطوة، منفصلة عن المكتبة الأساسية
from typing_extensions import TypedDict
from langgraph.graph import StateGraph, START, END
from langgraph.checkpoint.memory import MemorySaver
class State(TypedDict):
topic: str
draft: str
def write_draft(state: State) -> dict:
return {"draft": f"Draft about {state['topic']}"}
def review_draft(state: State) -> dict:
return {"draft": state["draft"] + " (reviewed)"}
builder = StateGraph(State)
builder.add_node("write", write_draft)
builder.add_node("review", review_draft)
builder.add_edge(START, "write")
builder.add_edge("write", "review")
builder.add_edge("review", END)
graph = builder.compile(checkpointer=MemorySaver())
result = graph.invoke(
{"topic": "local LLMs"},
config={"configurable": {"thread_id": "1"}},
)
print(result["draft"])كم تكلفة LangGraph؟
مكتبة LangGraph نفسها مجانية تمامًا بموجب ترخيص MIT — استضافة وكلاء LangGraph في الإنتاج هي الإضافة المدفوعة التي تُحتسب بحسب الاستخدام. لا تفرض LangChain Inc. رسومًا على المكتبة مفتوحة المصدر، سواء كانت مُستضافة ذاتيًا أو مستخدمة تجاريًا أو معدَّلة؛ تأتي إيرادات النشر من خطط LangSmith، نفس منتج الشركة الذي يبيع أيضًا مستوى المراقبة/التتبع المنفصل في LangSmith الذي نوقش في مراجعة LangChain من PromptQuorum.
- LangGraph (المكتبة): مجانية إلى الأبد بموجب ترخيص MIT، لـ Python وJavaScript/TypeScript، سواء استُضيفت ذاتيًا أو دُمجت في أي تطبيق
- استضافة وكلائك ذاتيًا: يمكنك تشغيل رسوم LangGraph البيانية المُجمَّعة على خوادمك الخاصة مع checkpointer خاص بك (مثل Postgres) دون أي تكلفة على LangChain Inc. — لا رسوم ترخيص للاستخدام الإنتاجي المُدار ذاتيًا
- مستوى LangSmith Developer: 0 دولار لكل مقعد شهريًا، مقعد واحد، حتى 5,000 تتبُّع أساسي شهريًا، ثم دفع حسب الاستخدام — لا يشمل النشر المُدار
- مستوى LangSmith Plus: 39 دولارًا لكل مقعد شهريًا، مقاعد غير محدودة، حتى 10,000 تتبُّع أساسي شهريًا مشمولة، ويشمل نشرًا صغيرًا بدون خوادم (serverless) مجانيًا لـ LangGraph، بالإضافة إلى الوصول إلى Deployment وEngine والبنية التحتية ذات الصلة التي تُحتسب بحسب الاستخدام
- LangSmith Enterprise: تسعير مخصص، يضيف خيارات نشر ذاتي الاستضافة/هجين واتفاقيات مستوى خدمة مخصصة
- يُحتسب استخدام النشر الذي يتجاوز الحصة المشمولة بشكل منفصل عن استخدام التتبع: تُفوتَر الحوسبة بوحدات LCU (1 LCU = 1.50 دولار) واستخدام قاعدة البيانات بوحدات LSU (1 LSU = 1.00 دولار)، لكل ساعة vCPU وساعة GiB
- ما كان يُسوَّق باسم "LangGraph Platform" حتى 2025 يُفوتَر اليوم باسم LangSmith Deployment — لم تعد هناك قائمة أسعار منفصلة لـ LangGraph Platform للتخطيط بموجبها؛ إنها بند ضمن خطة LangSmith
المستوى | السعر | الأنسب لـ |
|---|---|---|
| مكتبة LangGraph | مجانية (ترخيص MIT) | الجميع — استضافة ذاتية، بلا تكلفة |
| LangSmith Developer | 0$/مقعد/شهر، 5 آلاف تتبُّع | مطورون أفراد، النماذج الأولية |
| LangSmith Plus | 39$/مقعد/شهر، +احتساب استخدام | فرق تحتاج استضافة |
| LangSmith Enterprise | تسعير مخصص | استضافة ذاتية/هجينة، امتثال |
الأسعار موثَّقة استنادًا إلى صفحة تسعير LangChain الرسمية اعتبارًا من سبتمبر 2026 وتُفوتَر بالدولار الأمريكي عالميًا — لا تعرض الصفحة أسعارًا خاصة بكل منطقة، لذا تحقق من الصفحة المباشرة قبل وضع الميزانية، لأن مستويات SaaS ومعدلات الاحتساب تتغير دون إشعار كبير.
كيف تُثبِّت LangGraph وتبدأ استخدامه؟
يتطلب تثبيت LangGraph أمر pip أو npm واحدًا فقط — لا حاجة إلى حساب أو مفتاح ترخيص أو خادم للمكتبة مفتوحة المصدر. النشر المُدار عبر LangSmith اختياري ولا يُحتاج إليه إلا عندما تريد استضافة وكيل يستدعيه آخرون.
- 1ثبّت الحزمة:
pip install -U langgraph(Python) أوnpm install @langchain/langgraph(JavaScript/TypeScript). - 2اضبط مفتاح API لمزوّد النموذج كمتغيّر بيئة (مثل
OPENAI_API_KEY) — لا يوفر LangGraph نفسه الوصول إلى النموذج ولا يتوسط فيه؛ تستدعي النموذج المختار من داخل عُقدة. - 3عرِّف مخطط حالة (
TypedDictأو ما شابه)، وابنِ منهStateGraph، وسجّل العُقَد باستخدامadd_node، وصلها باستخدامadd_edgeأو حافة شرطية. - 4جمِّع الرسم البياني باستخدام
.compile()، مع تمريرcheckpointer(حافظةMemorySaverفي الذاكرة للتطوير، أو أخرى مدعومة بقاعدة بيانات للإنتاج) بحيث تستمر الحالة عبر الخطوات وإعادة تشغيل العملية. - 5استخدم
interrupt()داخل أي عُقدة تحتاج فيها إلى قرار بشري قبل المتابعة، واستأنف التشغيل المتوقف عبرCommand(resume=...)على نفس معرّف thread. - 6اقرأ الوثائق الرسمية لـ LangGraph وتصفّح مستودع GitHub للحصول على مرجع API الحالي ودليل البدء السريع بلغة JavaScript/TypeScript.
- 7اختياريًا، انشر إلى LangSmith Deployment أو استضف الرسم البياني المُجمَّع ذاتيًا خلف خادم API خاص بك عندما تحتاج إلى استضافة إنتاجية بدلاً من تشغيل محلي.
هل أحتاج إلى حساب في LangChain Inc. لاستخدام LangGraph؟
لا. تُثبَّت مكتبة LangGraph وتعمل دون أي حساب، وأنت توفر مفاتيح API الخاصة بك لمزوّد النموذج. الحساب مطلوب فقط إذا اخترت استخدام LangSmith للتتبع أو النشر المُدار.
هل يتطلب تثبيت LangGraph وجود LangChain؟
لا. يصدر LangGraph كحزمة مستقلة خاصة به ويمكن تثبيته واستخدامه دون الحزمة الأساسية langchain، رغم أن العديد من الفرق تستخدم تجريد create_agent من LangChain (الذي يعمل بدوره على LangGraph) كنقطة انطلاق أعلى مستوى.
لمن يناسب LangGraph؟
يناسب LangGraph الفرق التي تبني وكلاء إنتاجيين يحتاجون إلى تحكم صريح في الحالة أو إعادة المحاولة أو الموافقة البشرية — لا يحتاج كل وكيل إلى رسم بياني. يناسب بشكل أضعف الوكيل البسيط الخطي الذي يستدعي الأدوات دون متطلبات تفرّع أو استمرارية.
متى لا يجب استخدام LangGraph؟
تجنّب LangGraph لسير عمل خطي بسيط لا يحتاج إلى إعادة محاولة أو تفرّع أو استمرارية الحالة عبر توقف مؤقت — يضيف تجريد الرسم البياني عبئًا لا يحتاجه نص برمجي مباشر. بعض المواقف الملموسة التي تفوز فيها أداة أخرى.
- سير عمل يُنفِّذ دائمًا نفس تسلسل الخطوات الثابت مرة واحدة ويُعيد نتيجة — سلسلة استدعاءات دوال بسيطة، أو
create_agentمن LangChain، تغطي ذلك بكود أقل - فريق يريد نموذجًا ذهنيًا قائمًا على الأدوار — وكلاء مسمّون بشخصيات وأهداف ومهام فرعية مفوَّضة — بدلاً من التفكير بعُقَد وحواف صريحة؛ CrewAI مصمم حول هذا التجريد
- فريق لم يستثمر بعد في نظام LangChain البيئي، ويريد أصغر بصمة اعتمادية ممكنة، ومرتاح لإدارة الحالة وإعادة المحاولة يدويًا
- مشروع تكون حاجته الأساسية أنماط محادثة متعددة الوكلاء (وكلاء يتناقشون أو يراجعون مخرجات بعضهم في حلقة دردشة) بدلاً من رسم بياني صريح للتحكم في التدفق — AutoGen مبني حول هذا النمط
- استخدم LangGraph بدلاً من ذلك عندما يحتوي سير العمل فعليًا على دورات أو تفرّعات شرطية أو حاجة للتوقف بانتظار إدخال بشري، أو يجب أن يصمد أمام إعادة تشغيل في منتصف المهمة
LangGraph مقابل البدائل
يتنافس LangGraph مع أطر عمل أخرى لتنسيق الوكلاء، كل منها مبني حول نموذج ذهني مختلف لكيفية بنية الوكيل.
الأداة | النموذج الذهني | الترخيص | الجهة الداعمة | الأنسب لـ |
|---|---|---|---|---|
| LangGraph | رسم بياني صريح للحالة | MIT | LangChain Inc. (بدعم رأس مال جريء) | وكلاء إنتاجيون ذوو حالة |
| LangChain | Chains + create_agent | MIT | LangChain Inc. (بدعم رأس مال جريء) | تطبيقات LLM عامة الغرض |
| CrewAI | طواقم وكلاء قائمة على الأدوار | MIT | CrewAI Inc. (بدعم رأس مال جريء) | فرق وكلاء متعددة بأدوار مسمّاة |
| AutoGen | محادثة متعددة الوكلاء | MIT / CC-BY | Microsoft Research | أنماط وكلاء بحلقة دردشة |
| Semantic Kernel | إضافات + مخططات | MIT | Microsoft | تطبيقات مؤسسية بأولوية .NET |
أخطاء شائعة عند تقييم LangGraph
تنشأ هذه الأخطاء من الخلط بين LangGraph وLangChain أو LangGraph Platform، أو من اللجوء إلى رسم بياني حيث تكفي أداة أبسط.
الأسئلة الشائعة
هل LangGraph مجاني للاستخدام؟
نعم. مكتبة LangGraph مفتوحة المصدر بموجب ترخيص MIT ومجانية لأي استخدام، بما في ذلك المنتجات التجارية، دون حدود استخدام ودون رسوم ترخيص لاستضافة وكلائك الخاصة ذاتيًا في الإنتاج.
من طوّر LangGraph؟
طوّرت LangGraph شركة LangChain Inc.، الشركة المدعومة برأس المال الجريء التي تقف خلف LangChain، وأسسها هاريسون تشيس. بدأ كوحدة وكيل تجريبية داخل LangChain وصدر كحزمة مستقلة في يناير 2024.
ما الفرق بين LangGraph وLangChain؟
يوفر LangChain إطار عمل عامًا للسلاسل (chains) والمطالبات (prompts) وتجريد create_agent الأعلى مستوى. LangGraph هو وقت التشغيل الأدنى مستوى والقائم على الرسوم البيانية الذي يعمل create_agent نفسه فوقه — استخدم LangGraph مباشرة عندما تحتاج إلى حالة صريحة أو دورات أو تحكم human-in-the-loop لا يكشفه create_agent.
ماذا حدث لـ LangGraph Platform؟
كانت LangGraph Platform اسم منتج نشر الوكلاء المُستضاف من LangChain Inc.، من توافره العام في مايو 2025 حتى أكتوبر 2025. ثم أُدمج بعد ذلك في عائلة منتجات LangSmith ويُباع الآن باسم LangSmith Deployment، وهي ميزة تُحتسب بحسب الاستخدام ضمن خطط LangSmith المدفوعة، بدلاً من منصة تحمل علامة تجارية مستقلة وقائمة أسعار خاصة بها.
كم تكلف استضافة وكيل LangGraph في الإنتاج؟
يشمل مستوى LangSmith Plus (39 دولارًا لكل مقعد شهريًا) نشرًا صغيرًا بدون خوادم مجانيًا؛ يُحتسب الاستخدام الذي يتجاوز ذلك بشكل منفصل بوحدات LCU للحوسبة (1 LCU = 1.50 دولار) ووحدات LSU لاستخدام قاعدة البيانات (1 LSU = 1.00 دولار)، لكل ساعة vCPU وساعة GiB. تسعير Enterprise مخصص.
هل يمكنني استضافة وكلاء LangGraph ذاتيًا بدلاً من الدفع مقابل النشر المُدار؟
نعم. بما أن LangGraph مرخّص بموجب MIT، يمكنك تجميع رسم بياني، واختيار checkpointer خاص بك (مثل قاعدة بيانات Postgres مُدارة ذاتيًا)، وتشغيله خلف خادم API أو بنية تحتية خاصة بك دون تكلفة ترخيص — النشر المُدار عبر LangSmith هو راحة اختيارية، وليس شرطًا.
ما هو checkpointer في LangGraph؟
checkpointer هو مكوّن قابل للتبديل يحفظ حالة رسم بياني بعد كل خطوة، مرتبطًا بمعرّف thread. حافظة MemorySaver في الذاكرة شائعة للتطوير والاختبار؛ عادةً ما تستخدم عمليات النشر الإنتاجية checkpointer مدعومًا بقاعدة بيانات بحيث يمكن استئناف التشغيل بعد إعادة تشغيل العملية.
كيف تعمل آلية human-in-the-loop في LangGraph؟
استدعاء interrupt() داخل عُقدة يوقف تنفيذ الرسم البياني عند تلك النقطة ويعيد التحكم إلى الكود المستدعي، مع كون الحالة محفوظة بالفعل عبر نقطة تفتيش. استئناف التنفيذ عبر استدعاء Command(resume=...) على نفس معرّف thread يواصل التشغيل من النقطة التي توقف عندها بالضبط.
كم عدد نجوم GitHub التي حصل عليها LangGraph؟
تجاوز المستودع الأساسي langchain-ai/langgraph 41,000 نجمة على GitHub — أقل من مستودع LangChain الأساسي (أكثر من 140,000)، مما يعكس أن LangGraph مكتبة أكثر تخصصًا وأدنى مستوى بدلاً من كونه إطار عمل عام الغرض.
هل LangGraph أفضل من CrewAI للأنظمة متعددة الوكلاء؟
لا يُعتبر أيٌّ منهما أفضل بشكل مطلق — فهما يُصمِّمان الأنظمة متعددة الوكلاء بشكل مختلف. يكشف LangGraph رسمًا بيانيًا صريحًا للحالة تتحكم فيه عُقدة بعُقدة، وهو ما يناسب الفرق التي تحتاج إلى تحكم دقيق أو خطوات موافقة بشرية. يوفر CrewAI تجريدًا قائمًا على الأدوار (وكلاء مسمّون بأهداف ومهام مفوَّضة)، أسرع في الإعداد للفرق المرتاحة بتحكم أقل على المستوى المنخفض.
