الأدوات والسلوك
التعامل مع الموافقات والأسئلة والنماذج
أبقِ قرارات المستخدم صريحة وحافظ على الخيارات نفسها التي يعرضها الوكيل أثناء التشغيل.
قد يتوقف الوكيل لطلب إذن أو طرح سؤال أو طلب إدخال منظّم. هذه سجلات تفاعل ذات أنواع محددة. لا تستنتج الإذن من رسالة محادثة.
راقب التفاعل وأجب عنه
انتظر طلب الإدخال. اعرض التفاعل المعلّق على مستخدم مخوّل. اعرض كل خيارات الإذن المقدّمة. اعرض السؤال أو مخطط النموذج المدعوم بحسب نوع التفاعل. لا تستدعِ الدالة المناسبة أدناه إلا بعد أن يقدّم المستخدم استجابته.
from wkala import InputRequired
try:
result = await run.wait(timeout=120)
except InputRequired as required:
for interaction in required.interactions:
print(interaction.id, interaction.kind, interaction.prompt)
print(interaction.permission_options, interaction.form_schema)
async def choose_option(interaction, option_id):
if not any(option.id == option_id for option in interaction.permission_options):
raise ValueError("That option was not offered")
return await agents.interactions.respond(
interaction.id,
option_id=option_id,
)
async def answer_question(interaction, answer):
return await agents.interactions.respond(interaction.id, message=answer)
async def submit_form(interaction, data):
return await agents.interactions.respond(interaction.id, data=data)
يوفّر Python أيضًا run.reply() للأسئلة وrun.respond() للنماذج. تختار run.approve() خيار السماح لمرة واحدة الوحيد المعروض، ولا تختار إذنًا محفوظًا. مرّر interaction_id= عندما يطابق الطلب أكثر من تفاعل.
حافظ على الاستجابة المعروضة
صيغ الاستجابة متنافية: {option_id} أو {message} أو {data} أو {decision}. يجب أن تطابق بيانات النموذج المخطط المعروض وأن تحافظ على القيم المنطقية والأعداد والمصفوفات وقيم التعداد. وضّح عدم دعم أي مخطط لا يمكنك عرضه. لا تحوّله ضمنيًا إلى نص.
تكرار الاستجابة نفسها بعد توحيد صيغتها لا يغيّر النتيجة. تُرفض الاستجابة المتعارضة أو المتأخرة أو المنتهية أو الملغاة. حدّث التفاعل واشرح حالته الحالية. لا تتجاوز الموافقات قواعد تفويض التطبيق على مستوى السجل.
الانتظار ليس إلغاءً
تطلق wait() الاستثناء InputRequired افتراضيًا. انتهاء مهلة المراقبة يوقف الانتظار ويترك التنفيذ مستمرًا. استخدم run.cancel() لطلب الإلغاء صراحةً.
استخدم on_input="wait" عندما يتولى مكوّن آخر مخوّل معالجة التفاعل.