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

الوكلاء المُدارون

متقدّم
What you'll learn
  • افهم ما الذي تتولاه عنك حلقة الوكيل المُدار (المُستضافة من Anthropic)
  • افصل بين الكائنين الأساسيين: وكيل (Agent) مُصدَّر مقابل جلسة (Session) لكل تشغيل
  • احقن الأسرار بأمان عبر الخزائن (Vaults) — دون أن يراها النموذج إطلاقاً
  • ضع وكيلاً على جدول cron باستخدام عمليات النشر المجدولة — دون جدولة تستضيفها بنفسك
  • اعرف متى يتفوق المُدار على الحلقة المخصصة، والضوابط التي تظل سارية

إذا كان بناء حلقة الوكيل الخاصة بك بنية تحتية أكبر مما ترغب في امتلاكه، فإن الوكيل المُدار (المُستضاف من Anthropic) يشغّل الحلقة نيابةً عنك — لتركّز على مهمة الوكيل، لا على سباكة الجلسات وإعادة المحاولات والحالة والجدولة.

الكائنان: الوكيل مقابل الجلسة​

هذا هو النموذج الذهني الذي يتعلق به كل شيء آخر. وهما منفصلان عن قصد.

  • الوكيل هو تكوين مُخزَّن ومُصدَّر — النموذج، ومُحفِّز النظام، والأدوات، وخوادم MCP، والمهارات. تنشئه مرة واحدة. كل تحديث ينشئ نسخة جديدة غير قابلة للتغيير.
  • الجلسة هي نسخة وقت تشغيل — تنفيذ واحد يشير إلى وكيل بواسطة المُعرِّف. التكوين يعيش على الوكيل، لا على الجلسة أبداً.
Pro tip

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

ما الذي يقدمه لك "المُدار"​

بدلاً من صياغة الحلقة واستضافتها يدوياً، تحصل على لبنات بناء مُستضافة:

  • الجلسات — عمليات تشغيل دائمة تنشئها لكل تنفيذ وتستأنفها؛ تبثّ الأحداث عبر SSE.
  • البيئات — بنية تحتية للحاويات، إما cloud (مُستضافة من Anthropic) أو self_hosted (الأدوات تُنفَّذ داخل شبكة VPC الخاصة بك). حاوية واحدة لكل جلسة هي مساحة عمل الوكيل.
  • مخازن الذاكرة — حالة دائمة عبر الجلسات، مع الإصدارات والتنقيح، دون أن توصّل قاعدة بيانات بنفسك.
  • الخزائن — أسرار لمصادقة MCP والخدمات الأخرى.
  • عمليات النشر المجدولة — وكلاء يعملون على جدول cron، دون إشراف.

أنشئ وكيلاً (تكوين مُصدَّر)، ثم شغّل جلسة عليه

# 1. Create the agent once
POST /v1/agents        -> returns $AGENT_ID
# 2. Each execution is a session pinned to that agent
POST /v1/sessions      { "agent": "$AGENT_ID" }

الخزائن: أسرار لا يراها النموذج أبداً​

كثيراً ما يحتاج الوكيل المستقل إلى مفتاح API — لكن النموذج يجب ألا يقرأه أبداً. بيانات اعتماد الخزنة (mcp_oauth، static_bearer، environment_variable) يجري استبدالها عند الخروج: بيانات اعتماد من نوع environment_variable تُحقن في الصندوق الرملي وقت التنفيذ ولا تكون مرئية أبداً للنموذج.

Watch out

هذا هو النمط الآمن لمنح الوكيل وصولاً قوياً. لا تلصق المفاتيح في مُحفِّز النظام أو في رسالة — فإنها تصبح جزءاً من السياق الذي يمكن للنموذج (ولسجلّاتك) رؤيته. ضعها في خزنة.

عمليات النشر المجدولة: وكيل على جدول cron​

عملية النشر ترفق جدول cron بوكيل. عندما يُطلق الجدول، يبدأ جلسة جديدة ويُكمل مهمته — دون جدولة عليك بناؤها أو استضافتها. مناسبة لمزامنة بيانات ليلية، أو فحص امتثال أسبوعي، أو ملخّص يومي.

Guided walkthrough1 of 4
  1. POST /v1/deployments مع agent وenvironment_id وinitial_events (يجب أن تتضمن user.message) وschedule: تعبير cron بصيغة POSIX إضافة إلى منطقة زمنية بصيغة IANA.

فحص امتثال أسبوعي، أيام الجمعة الساعة 20:00 بتوقيت نيويورك

POST /v1/deployments
{
"name": "Weekly compliance scan",
"agent": "$AGENT_ID",
"environment_id": "$ENVIRONMENT_ID",
"initial_events": [
  {"type": "user.message", "content": [{"type": "text", "text": "Run the compliance scan and summarize findings."}]}
],
"schedule": {"type": "cron", "expression": "0 20 * * 5", "timezone": "America/New_York"}
}
Pro tip

صيغة cron هي minute hour day-of-month month day-of-week، بدقة على مستوى الدقيقة. يستخدم التوقيت الصيفي (DST) دلالات ساعة الحائط: الوقت الذي لا يوجد عند التقديم الربيعي يُتخطّى؛ والوقت الذي يحدث مرتين عند التأخير الخريفي يُطلق مرتين. اختر منطقة زمنية وساعة تتجنّب تلك الحواف لأي شيء حسّاس.

متى تختار المُدار مقابل المخصص​

اختر المُدار عندما…اختر حلقة مخصصة / SDK عندما…
تريد أن تُدار الاستضافة والحالة والجدولة والأسرارتحتاج تحكماً كاملاً في الحلقة والأدوات
تبني نموذجاً أولياً بسرعةلديك متطلبات بنية تحتية/امتثال مخصصة صارمة
بساطة التشغيل تهمّ أكثر من التحكمتضمّن بعمق داخل مكدّسك الخاص

إنه طيف — استدعاء واحد ← سير عمل ← وكيل مخصص (SDK) ← مُدار. ابدأ بأبسط ما تسمح به المهمة؛ وارتقِ فقط عندما تحتاج إلى ذلك.

تنطبق الضوابط نفسها​

سواء كان مُستضافاً أم لا، فإن الوكيل المستقل لا يزال يتخذ إجراءات. حافظ على أقل امتياز ممكن، وتكلفة/تكرارات محدودة، وموافقة بشرية للخطوات الخطرة — راجع تأمين الوكلاء وتقوية عمليات التشغيل المستقلة.

Key takeaways
  • الوكلاء المُدارون يتولّون الحلقة والجلسات والبيئات والذاكرة والخزائن والجدولة لتركّز على المهمة
  • الوكيل تكوين مُصدَّر؛ والجلسة تشغيل واحد يُثبَّت على نسخة — التكوين يعيش على الوكيل، لا على الجلسة
  • بيانات اعتماد environment_variable في الخزنة تُحقن وقت التنفيذ ولا تكون مرئية أبداً للنموذج — الطريقة الآمنة لمنح الوكيل أسراراً
  • عملية النشر المجدولة هي تعبير cron + منطقة زمنية بصيغة IANA؛ كل إطلاق ينشئ تشغيلاً، وإلغاء الإيقاف المؤقت لا يُعيد ملء الإطلاقات الفائتة
  • المُدار يقع عند الطرف المُستضاف من استدعاء واحد ← سير عمل ← مخصص ← مُدار؛ وضوابط الاستقلالية تظل سارية

اختبر نفسك​

اختبر نفسك

0/3
  1. ما الفرق بين الوكيل والجلسة؟
  2. كيف ينبغي أن تعطي وكيلاً مُداراً مفتاح API يحتاجه؟
  3. أُوقفت عملية نشر مجدولة مؤقتاً لمدة يومين ثم أُلغي إيقافها. ماذا يحدث للإطلاقات التي كانت ستُطلق أثناء الإيقاف المؤقت؟

التالي​