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

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

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

ابدأ هنا

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

بناء التكامل

  • بثّ الرسائل والأدوات والنتائج
  • أبقِ خادمك الخلفي متحكّمًا
  • بناء واجهة React تفاعلية مباشرة
  • ربط تطبيق Next.js

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

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

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

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

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

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

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

عرض Markdown

لتكامل Next.js ومتطلبات الواجهة الخلفية Python، راجع Next.js.

المهارة حزمة تعليمات تحتوي على ملف 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.

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

يقرأ المثال ملف SKILL.md فقط. أدرج كل الموارد المطلوبة في files بمسارات نسبية آمنة ومحتوى بترميز base64.

typescript
import { readFile } from "node:fs/promises"

const content = await readFile("skills/release-review/SKILL.md")
const skill = await agents.skills.create({
  name: "Release review",
  description: "A repeatable review checklist for application releases.",
  files: [
    {
      path: "SKILL.md",
      content_base64: content.toString("base64"),
    },
  ],
})
const 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,
})
const session = await agents.sessions.create({
  title: "Review release candidate",
  profile_id: profile.id,
})

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

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

ربط خادم MCP بعيدبناء واجهة React تفاعلية مباشرة