الأدوات والسلوك
التعامل مع الموافقات والأسئلة والنماذج
أبقِ قرارات المستخدم صريحة وحافظ على الخيارات نفسها التي يعرضها الوكيل أثناء التشغيل.
لتكامل Next.js ومتطلبات الواجهة الخلفية Python، راجع Next.js.
قد يتوقف الوكيل لطلب إذن أو طرح سؤال أو طلب إدخال منظّم. هذه سجلات تفاعل ذات أنواع محددة. لا تستنتج الإذن من رسالة محادثة.
راقب التفاعل وأجب عنه
انتظر طلب الإدخال. اعرض التفاعل المعلّق على مستخدم مخوّل. اعرض كل خيارات الإذن المقدّمة. اعرض السؤال أو مخطط النموذج المدعوم بحسب نوع التفاعل. لا تستدعِ الدالة المناسبة أدناه إلا بعد أن يقدّم المستخدم استجابته.
import { InputRequired } from "@wkala/client"
try {
const result = await run.wait({ timeout: 120 })
} catch (error) {
if (!(error instanceof InputRequired)) {
throw error
}
for (const interaction of error.interactions) {
console.log(interaction.id, interaction.kind, interaction.prompt)
console.log(interaction.permission_options, interaction.schema)
}
}
import type { Interaction, JSONObject } from "@wkala/client"
async function chooseOption(interaction: Interaction, optionId: string) {
if (!interaction.permission_options.some(option => option.id === optionId)) {
throw new Error("That option was not offered")
}
return agents.interactions.respond(interaction.id, { option_id: optionId })
}
async function answerQuestion(interaction: Interaction, answer: string) {
return agents.interactions.respond(interaction.id, { message: answer })
}
async function submitForm(interaction: Interaction, data: JSONObject) {
return agents.interactions.respond(interaction.id, { data })
}
يرسل عميل TypeScript كل استجابة عبر agents.interactions.respond().
حافظ على الاستجابة المعروضة
صيغ الاستجابة متنافية: {option_id} أو {message} أو {data} أو {decision}. يجب أن تطابق بيانات النموذج المخطط المعروض وأن تحافظ على القيم المنطقية والأعداد والمصفوفات وقيم التعداد. وضّح عدم دعم أي مخطط لا يمكنك عرضه. لا تحوّله ضمنيًا إلى نص.
تكرار الاستجابة نفسها بعد توحيد صيغتها لا يغيّر النتيجة. تُرفض الاستجابة المتعارضة أو المتأخرة أو المنتهية أو الملغاة. حدّث التفاعل واشرح حالته الحالية. لا تتجاوز الموافقات قواعد تفويض التطبيق على مستوى السجل.
الانتظار ليس إلغاءً
تطلق wait() الاستثناء InputRequired افتراضيًا. انتهاء مهلة المراقبة يوقف الانتظار ويترك التنفيذ مستمرًا. استخدم run.cancel() لطلب الإلغاء صراحةً.
استخدم onInput: "wait" عندما يتولى مكوّن آخر مخوّل معالجة التفاعل.