الانتقال إلى المحتوى الرئيسي
حزمة الوكيل

حزمة الوكيل — كيف أبني الوكلاء

إجابتي المدعومة بالرأي على السؤال الذي يطرحه عليّ البنّاؤون أكثر من غيره. هذه وثيقة حيّة — أحدّثها مع تحرّك المجال. كل خيار له رأي من سطر واحد، والآراء هي المقصد.

01

Orchestration

framework

LangGraph

تحكم صريح قائم على الرسوم البيانية للوكلاء الذين لديهم تفرعات وحلقات وحالات حقيقية.

رأيالرسوم البيانية الصريحة تتغلب على السلاسل الضمنية؛ عندما يمتلك الوكيل الخاص بك تدفق تحكم حقيقي، قم بنمذجته كرسم بياني، وليس كـ prompt.

سير العمل المستدام

Temporal

تنفيذ سير عمل متين وقابل للاستئناف لمهام الوكلاء طويلة الأمد.

رأيعمل الوكلاء هو عمل الأنظمة الموزعة؛ إذا كان بإمكان خطوة أن تنهار، فاجعل سير العمل متينًا وقابلًا للاستئناف.

الحوسبة والتقديم

Ray

حوسبة موزعة وخدمة لتنفيذ الوكلاء بالتوازي.

رأيالتنفيذ المتوازي على نطاق السرب هو مشكلة حوسبة أولاً؛ استعن بـ Ray قبل أن تستعين بمزيد من البراعة.

runtime

K8s / Fly.io

تشغيل الوكلاء حيث يمكنهم التوسّع والانتهاء بنظافة.

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

02

استخدام الأدوات واستدعاء الدوال

contract

استدعاء الدوال/الأدوات + المخرجات المهيكلة (مخطط JSON)

توقيعات أدوات مُنمّطة بمخرجات مفروضة عبر JSON-schema.

رأيأعطِ النموذج عقداً، لا نثراً؛ الوكيل بأكمله لا يكون أكثر موثوقية من توقيعات أدواته.

environment

First-class action API

واجهة برمجية للإجراءات والماكرو للبيئة التي يعمل فيها الوكيل (النمط المستمد من العمل على الوكلاء القائمين على الرؤية).

رأيلتتصرف في عالم، تحتاج واجهة إجراءات من الدرجة الأولى — امنح الوكيل مقابض حقيقية ومُتحقّقاً، في كل مجال.

protocol

MCP — بروتوكول سياق النموذج

ناقل موحّد يربط النماذج بالأدوات ومصادر البيانات.

رأيوحّد كيفية وصول النموذج إلى العالم؛ ناقل أدوات مشترك أفضل من عشرين موصلًا مخصصًا.

03

الذاكرة والسياق

context

سياق قصير المدى + استرجاع متجهي (RAG)

الاحتفاظ بما يحتاج الوكيل معرفته عبر الأدوار، مسترجعًا من قاعدة معرفة.

رأياحتفظ بما يحتاج الوكيل معرفته؛ الوكيل بلا حالة هو حلقة إعادة تشغيل، لا عامل.

memory

Scratchpad والذاكرة العاملة

حالة وسيطة منظمة للتخطيط متعدد الخطوات ونتائج الأدوات.

رأيلا تحشر كل شيء في النافذة؛ احتفظ بذاكرة عمل يقرأها الوكيل ويكتب فيها عن قصد.

04

التقييم والمراقبة

verifier

مُدقّقات مستندة إلى البيئة

بيئات معزولة ومحاكيات وألعاب تقيّم الوكيل في العالم الذي يتصرف فيه.

رأيقيّم الوكيل في العالم الذي يتصرف فيه، لا مقابل المشاعر. التقييم مشكلة بيئة، وليس مشكلة rubric.

judge

LLM-as-judge (بشكل مقتصد، مع تدقيق)

تقييم قائم على النماذج، مع تدقيق مزدوج عبر فحوصات حتمية.

رأيالمُحكِّمون خطوط أساس، لا حقيقة؛ تحقق منها مرتين بفحوصات حتمية.

debuggability

تصنيفات الفشل + معيار تقييم تملكه

كتالوج مصنّف للإخفاقات (أمر خاطئ، خطوة ناقصة، خطأ منطقي) ومعيار تقييم تحتفظ به.

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

cost

Cost/latency budgets as first-class metrics

تتبّع الإنفاق وزمن الاستجابة لكل تشغيل مثل أي مقياس آخر.

رأيتشغيل فعّال بتكلفة معقولة يتفوق على تشغيل أجمل بعشرة أضعاف السعر.

observability

التتبعات (على نمط OpenTelemetry / LangSmith)

تتبعات على مستوى الخطوة وإعادة تشغيل كامل لتشغيلات الوكيل.

رأيلا يمكنك ضبط ما لا يمكنك إعادة تشغيله؛ فالتتبعات هي مسجّل رحلة الوكيل.

operate

لوحات معلومات لمعدل النجاح والتكلفة وزمن الاستجابة وتوزيع الإخفاقات

لوحات معلومات بنمط SLO لصحة الوكيل.

رأيشغّله كـ SLO، وإلا فأنت تشغّله كعرض تجريبي. الثقة تسكن في السجلات، لا في الملخّص.

05

Deployment

packaging

الحاويات + عمليات النشر غير القابلة للتغيير

انشر الوكلاء كحاويات مع إصدارات وقطع أثرية قابلة لإعادة الإنتاج.

رأيإذا لم تستطع إعادة بنائه من نفس الـ artifact مرتين، فليس لديك نشر — أنت تخمن.

release

CI/CD مع بوابات التقييم

يشغّل مجموعة تقييم الوكيل قبل ترقية إصدار جديد إلى الإنتاج.

رأيترقية النموذج مخاطرة ارتداد، لا ميزة؛ اجعل كل إصدار مشروطًا بمجموعة التقييم، لا بالحدس.

scaling

بيئة تشغيل مُدارة بدون خادم / للحاويات

توسيع الوكلاء إلى الصفر والعودة دون الإشراف على البنية التحتية.

رأيالوكلاء بطبيعتهم متقطعون في نشاطهم — انشرهم حيث يمكنهم التوسع إلى الصفر والعودة بسرعة.

إجابات مباشرة.

ما هو سرب الذكاء الاصطناعي؟+

An AI swarm is a coordinated system of multiple independent agents that share goals, decompose tasks, and negotiate solutions together. Unlike a single agent — one loop with one bottleneck and one point of failure — a swarm gets resilience and scale from redundancy and division of labor: parallel exploration, no single point of failure, and answers that emerge from collective reasoning rather than one model's guess. My thesis: intelligence emerges from structured interaction among many agents, not from a single bigger brain.

كيف تقيّم الأنظمة متعددة الوكلاء؟+

Evaluation is the bottleneck, not the model. I grade agents in the environment they act in — sandboxes, simulators, games — not against intuition. I use LLM-as-judge sparingly and audited, backed by deterministic checks; I ship failure taxonomies plus a benchmark I own; and I treat cost and latency as first-class metrics. A feedback loop is only as smart as its verifier.

متى تستخدم الوكلاء مقابل استدعاء نموذج واحد؟+

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

لنتحدث!