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

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

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

ابدأ هنا

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

بناء التكامل

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

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

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

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

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

بناء التكامل

بثّ الرسائل والأدوات والنتائج

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

عرض Markdown

ما الذي يُبثّ؟

قد ينتج عن التنفيذ رسائل واستدعاءات أدوات ونتائجها واستدعاءات للخادم الخلفي وتحديثات تقدّم وبيانات استخدام وطلبات إدخال. لا يعني اكتمال رسالة اكتمال التشغيل. تصل وسائط الأدوات بمستوى التفصيل الذي توفّره الخدمة. لا تنشئ API أجزاءً مصطنعة من رموز الوسائط.

لسجلّات الأدوات واستدعاءات الخادم الخلفي معرّفات مستقلة. قد ترسل أداة واحدة عدة طلبات إلى الخادم الخلفي. وقد لا يكون للأداة المدمجة في بيئة التنفيذ أي استدعاء للخادم الخلفي. لا تربط معرّفاتها ببعضها. ولا تفترض أن الآثار الفعلية على بيانات العمل تحدث مرة واحدة فقط.

راقب التحديثات

يحمّل بث Python عالي المستوى لقطة متّسقة، ويطبّق الأحداث بالترتيب، ويتجاهل التكرارات، ويستعيد الحالة عند غياب أحد المتطلبات. استبدل العرض عند وصول SnapshotUpdate.

python
from wkala import SnapshotUpdate, ToolUpdated, MCPInvocationUpdated

async with run.stream() as stream:
    async for update in stream:
        if isinstance(update, SnapshotUpdate):
            print(stream.state.runs[run.id].status)
        elif isinstance(update, ToolUpdated):
            tool = update.data.tool
            print(tool.title, tool.status)
            print(tool.arguments, tool.output, tool.content)
        elif isinstance(update, MCPInvocationUpdated):
            call = update.data.invocation
            print(call.server_name, call.status, call.result)

تحلّ سجلّات tool.updated وmessage.updated المعتمدة محل الإصدارات السابقة من السجلّ نفسه. تحافظ النتائج على أنواع JSON، بما فيها المصفوفات والقيم المفردة وحقلا MCP المسمّيان structuredContent وisError. قد يتضمّن محتوى الرسائل الغني نصوصًا وصورًا أو صوتًا مضمّنًا وموارد وروابط موارد. أظهر المحتوى غير المدعوم بوضوح. لا تجلب روابط الموارد العشوائية تلقائيًا.

المراقبة والتنفيذ مستقلّان

يوقف إغلاق البث أو إزالة المكوّن أو فقدان اتصال المتصفح المراقبة. يستمر التشغيل المقبول. اطلب الإلغاء صراحةً عندما تريد إيقاف التنفيذ:

python
await run.cancel()

ينتهي المُكرِّر المحدّد بنطاق تشغيل بعد حدثه النهائي. راقب الجلسة أو اطلب لقطة لاحقة لرؤية تسوية عملية خلفية غير مؤكدة. تتطلّب tool.incomplete أو الاستدعاءات بالحالة uncertain تسويةً من التطبيق.

سلوك الوكيل الوسيط

استخدم وكيل Next الوسيط ومثال الخادم الخلفي للعميل المرفقين للحفاظ على التحقّق من الهوية والملكية. يستخدم المثال المرفق خادم Python خلفيًا. يجب أن يمرّر الوكيل ترويسات الاستجابة قبل استهلاك جسمها. يجب أن يعطّل التخزين المؤقت للأحداث ويُبقي الجسم مفتوحًا طوال المراقبة. يمكن لمهلة الاتصال أن تحدّ وقت بدء الاستجابة. يجب ألّا تقطع بثًّا طويلًا يعمل بصورة سليمة.

بث SDK ليس استجابة رموز عامة لروبوت محادثة. فالجلسات وعمليات التشغيل الدائمة والأدوات والصلاحيات والاستخدام أجزاء مستقلة من حالة التنفيذ نفسها.

شغّل وكيلك الأولأبقِ خادمك الخلفي متحكّمًا