AI Open Guide
→ Claude · للمطوّرين

1في جملة واحدة

الوكيل هو Claude وهو يعمل في حلقة (يفكر، يستخدم أداة، ينظر إلى النتيجة، يكرر) حتى تُنجز المهمة، وهناك ثلاث طرق لبناء واحد، من الأكثر جهدًا إلى الأقل.

2كلمات جديدة

  • الوكيل (Agent) — Claude مع أدوات وهدف، يعمل عبر الخطوات بنفسه. Cowork وClaude Code وكيلان بنتهما Anthropic؛ ويمكنك بناء وكيلك الخاص.
  • حلقة الوكيل (Agent loop) — الدورة: يقرر Claude، يستدعي أداة، يقرأ النتيجة، يقرر مجددًا. تنتهي عندما يقول Claude إن المهمة أُنجزت أو عند بلوغ حد.
  • Agent SDK — مكتبة (Python أو TypeScript) تمنح برنامجك المحرك نفسه الذي يستخدمه Claude Code: الأدوات، الصلاحيات، الجلسات، المساعدون، الخطافات، MCP، المهارات.
  • Managed Agents — تستضيف Anthropic الوكيل نيابة عنك: الحلقة، وبيئة العزل (حاسوب آمن يعمل فيه)، والذاكرة، والجدولة. أنت ترسل المهام وتقرأ النتائج.
  • بيئة العزل (Sandbox) — حاسوب معزول يستطيع الوكيل فيه تشغيل الكود والملفات من دون أن يمس أي شيء آخر.

3لماذا تحتاجه

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

الخيارما تكتبه أنتما تقدمه Anthropicالأفضل لـ
حلقتك الخاصة (Client SDK)الحلقة، تنفيذ الأدوات، الأمانالنموذج وميزات APIتحكم كامل؛ وكلاء صغار مركّزون
Agent SDKأدواتك وقواعدكالمحرك الكامل من Claude Codeوكلاء داخل منتجك أو خوادمك
Managed Agentsوصف للوكيل وأدواتهالاستضافة، بيئة العزل، الذاكرة، الجدولة، تنسيق عدة وكلاءالعمل طويل الأمد أو غير المراقب، سريع الإطلاق

4جرّبه الآن

(حساب مطوّر؛ Claude Code يساعد)

  1. اطلب من Claude Code: باستخدام Agent SDK، ابنِ وكيلًا صغيرًا يقرأ كل ملف في مجلد ويكتب summary.md بسطر واحد لكل ملف. قيّده بالقراءة والكتابة في ذلك المجلد فقط.
  2. شغّله على مجلد فيه عشرة ملفات. اقرأ summary.md.
  3. أضف قاعدة واحدة: اسأل قبل الكتابة إذا كان summary.md موجودًا بالفعل.

5ماذا سترى

[الصورة قيد الإعداد: سجل تشغيل الوكيل وملف الملخص.] برنامج قصير؛ عند تشغيله، سجل بكل خطوة (قراءة الملف 1، 2، ...) والملخص النهائي. أما Managed Agents فتعرض الشيء نفسه كجلسة يمكنك مراقبتها في لوحة التحكم.

6انتبه

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

7خطوة أبعد

أعطِ الوكيل جدولًا زمنيًا (الفصل 6.9) فيصبح زميلًا يعمل ليلًا. الفصل 6.10 هو فصل الأمان والتكلفة الذي تقرأه قبل أن تسمح له بذلك.