بناء التكامل
بثّ الرسائل والأدوات والنتائج
راقب التنفيذ كاملًا أثناء حدوثه، مع حالة محفوظة بشكل دائم وسلوك مدمج لإعادة الاتصال.
لتكامل Next.js ومتطلبات الواجهة الخلفية Python، راجع Next.js.
ما الذي يُبثّ؟
قد ينتج عن التنفيذ رسائل واستدعاءات أدوات ونتائجها واستدعاءات للخادم الخلفي وتحديثات تقدّم وبيانات استخدام وطلبات إدخال. لا يعني اكتمال رسالة اكتمال التشغيل. تصل وسائط الأدوات بمستوى التفصيل الذي توفّره الخدمة. لا تنشئ API أجزاءً مصطنعة من رموز الوسائط.
لسجلّات الأدوات واستدعاءات الخادم الخلفي معرّفات مستقلة. قد ترسل أداة واحدة عدة طلبات إلى الخادم الخلفي. وقد لا يكون للأداة المدمجة في بيئة التنفيذ أي استدعاء للخادم الخلفي. لا تربط معرّفاتها ببعضها. ولا تفترض أن الآثار الفعلية على بيانات العمل تحدث مرة واحدة فقط.
راقب التحديثات
استخدم مخزن TypeScript الذي تعيده run.stream() أو استخدم useSession() في React للحصول على لقطة متّسقة وتحديثات مرتبة ومعالجة للتكرارات والتعافي. المُكرِّر run.events() أدناه منخفض المستوى. يتحقّق من التسلسل وقد يطلق RecoveryRequired عند وجود فجوة. احصل على لقطة جديدة بدلًا من المتابعة من حالة ناقصة.
const observer = new AbortController()
for await (const event of run.events({ signal: observer.signal })) {
switch (event.type) {
case "message.delta":
console.log(event.data.message_id, event.data.part_id, event.data.delta)
break
case "tool.updated":
console.log(event.data.tool)
break
case "mcp.invocation.updated":
console.log(event.data.invocation.result)
break
case "interaction.updated":
console.log(event.data.interaction)
break
case "run.updated":
console.log(event.data.run.status, event.data.run.usage)
break
}
}
تحلّ سجلّات tool.updated وmessage.updated المعتمدة محل الإصدارات السابقة من السجلّ نفسه. تحافظ النتائج على أنواع JSON، بما فيها المصفوفات والقيم المفردة وحقلا MCP المسمّيان structuredContent وisError. قد يتضمّن محتوى الرسائل الغني نصوصًا وصورًا أو صوتًا مضمّنًا وموارد وروابط موارد. أظهر المحتوى غير المدعوم بوضوح. لا تجلب روابط الموارد العشوائية تلقائيًا.
المراقبة والتنفيذ مستقلّان
يوقف إغلاق البث أو إزالة المكوّن أو فقدان اتصال المتصفح المراقبة. يستمر التشغيل المقبول. اطلب الإلغاء صراحةً عندما تريد إيقاف التنفيذ:
await run.cancel()
ينتهي المُكرِّر المحدّد بنطاق تشغيل بعد حدثه النهائي. راقب الجلسة أو اطلب لقطة لاحقة لرؤية تسوية عملية خلفية غير مؤكدة. تتطلّب tool.incomplete أو الاستدعاءات بالحالة uncertain تسويةً من التطبيق.
سلوك الوكيل الوسيط
استخدم وكيل Next الوسيط ومثال الخادم الخلفي للعميل المرفقين للحفاظ على التحقّق من الهوية والملكية. يستخدم المثال المرفق خادم Python خلفيًا. يجب أن يمرّر الوكيل ترويسات الاستجابة قبل استهلاك جسمها. يجب أن يعطّل التخزين المؤقت للأحداث ويُبقي الجسم مفتوحًا طوال المراقبة. يمكن لمهلة الاتصال أن تحدّ وقت بدء الاستجابة. يجب ألّا تقطع بثًّا طويلًا يعمل بصورة سليمة.
بث SDK ليس استجابة رموز عامة لروبوت محادثة. فالجلسات وعمليات التشغيل الدائمة والأدوات والصلاحيات والاستخدام أجزاء مستقلة من حالة التنفيذ نفسها.