انتقل إلى المحتوى
وكلاء من أوكال

جارٍ تحميل دليل الاستخدام…

وكلاء من أوكال
للوكلاءالتواصل
وكلاء من أوكال
مسار دليل الاستخدام
دليل الاستخدام

ابدأ هنا

  • شغّل وكيلك الأول

بناء التكامل

  • بثّ الرسائل والأدوات والنتائج
  • أبقِ خادمك الخلفي متحكّمًا

الأدوات والسلوك

  • عرّف الأدوات داخل خادمك الخلفي
  • ربط خادم MCP بعيد
  • إضافة مهارات وتعليمات قابلة لإعادة الاستخدام
  • التعامل مع الموافقات والأسئلة والنماذج

التشغيل الموثوق

  • الأخطاء والتعافي
  • فهم الاستخدام والحدود
فهرس دليل الاستخدام للوكلاءدليل الاستخدام الكامل للوكلاء

الأدوات والسلوك

إضافة مهارات وتعليمات قابلة لإعادة الاستخدام

جهّز حزم التعليمات مرة واحدة واربط إصداراتها غير القابلة للتغيير بملف تعريف وكيل.

عرض Markdown

المهارة حزمة تعليمات تحتوي على ملف SKILL.md وموارد داعمة اختيارية، وهي توجّه سلوك الوكيل. مكان عمليات الأعمال هو الأدوات المصرّح بها صراحةً؛ ولا تُفعَّل نصوص المهارات القابلة للتنفيذ في هذا الإصدار.

أنشئ مجلدًا مثل skills/release-review يحتوي على ملف SKILL.md التالي:

markdown
# Release review

Review a proposed release in three steps:
1. Identify the user-visible change and its acceptance criteria.
2. List meaningful boundary and failure-path checks.
3. Report observed evidence separately from assumptions.

Use only attached, authorized tools. Ask for clarification when the target
environment or required permissions are missing.

ارفع الحزمة من خادمك الخلفي:

تجهّز upload_directory المجلد وموارده.

python
skill = await agents.skills.upload_directory(
    "skills/release-review",
    name="Release review",
    description="A repeatable review checklist for application releases.",
)
profile = await agents.profiles.create(
    name="Release reviewer",
    instructions="Be concise and cite the observed evidence.",
    skill_ids=[skill.id],
    max_cost_microusd=300_000,
    timeout_seconds=120,
)
session = await agents.sessions.create(
    title="Review release candidate",
    profile_id=profile.id,
)

تتطلب الحزم مسارات نسبية آمنة وملف SKILL.md؛ والحدود الحالية هي 64 ملفًا، و1 MiB لكل ملف، و2 MiB إجمالًا. تُحفَظ الموارد الثنائية كما هي. وتُحفَظ بصمات المهارات المرفوعة وإصدار ملف التعريف الفعلي لكل عملية تشغيل مقبولة، حتى لا تتمكن التعديلات اللاحقة من تغيير سلوكها بصمت.

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

ربط خادم MCP بعيدالتعامل مع الموافقات والأسئلة والنماذج