DialogContext الفصل

دفع مربع حوار جديد إلى مكدس الحوار. :p aram dialog_id: معرف مربع الحوار لبدء :p خيارات aram: (اختياري) وسيطة (وسيطات) إضافية لتمريرها إلى مربع الحوار الذي يتم بدء تشغيله.

async begin_dialog(dialog_id: str, options: object = None)

المعلمات

حذف أي مكدس حوار موجود وبالتالي إلغاء كافة مربعات الحوار على المكدس. cancel_parents :p aram: :p aram event_name: :p aram event_value: :return:

async cancel_all_dialogs(cancel_parents: bool = None, event_name: str = None, event_value: object = None)

المعلمات

متابعة تنفيذ مربع الحوار النشط، إذا كان هناك واحد، عن طريق تمرير كائن السياق إلى أسلوب Dialog.continue_dialog() الخاص به. يمكنك التحقق من turn_context.responded بعد اكتمال المكالمة لتحديد ما إذا كان قد تم تشغيل مربع حوار وإرسال رد إلى المستخدم. :أعاد:

async continue_dialog()

البحث عن مربع حوار بمعرف معين. يصدر حدثا مسمى لمربع الحوار الحالي، أو شخص بدأه، للتعامل معه. :p aram name: اسم الحدث المراد رفعه. قيمة :p aram: قيمة لإرسالها مع الحدث. :p aram bubble: ضع علامة للتحكم في ما إذا كان يجب فقاعة الحدث إلى الأصل إذا لم تتم معالجته محليا. الإعدادات الافتراضية لقيمة True. :p aram from_leaf: ما إذا كان الحدث منبعثا من عقدة طرفية. :p aram cancellationToken: رمز الإلغاء المميز. :return: True إذا تمت معالجة الحدث.

async emit_event(name: str, value: object = None, bubble: bool = True, from_leaf: bool = False) -> bool

المعلمات

async end_active_dialog(reason: DialogReason)

المعلمات

ينهي مربع حوار عن طريق انشائه من المكدس وإرجاع نتيجة اختيارية إلى أصل مربع الحوار. مربع الحوار الأصل هو مربع الحوار الذي بدأ إنهاء مربع الحوار عبر مكالمة إما إلى "begin_dialog" أو "مطالبة". سيستدعي مربع الحوار الأصل أسلوب Dialog.resume_dialog() الخاص به مع أي نتيجة تم إرجاعها. إذا لم ينفذ مربع الحوار الأصل أسلوب resume_dialog()، إنهاؤه تلقائيا أيضا وتم تمرير النتيجة إلى الأصل. إذا لم يكن هناك المزيد من مربعات الحوار الأصل على المكدس، فستنتهي معالجة الدور. نتيجة :p aram: (اختياري) لتمريرها إلى مربعات الحوار الأصل. :أعاد:

async end_dialog(result: object = None)

المعلمات

إذا تعذر العثور على مربع الحوار ضمن مجموعة حوارالحالية، البحث في مربع حوار الأصل إذا كان هناك مربع حوار. :p aram dialog_id: معرف مربع الحوار للبحث عن. :أعاد:

async find_dialog(dialog_id: str) -> Dialog

المعلمات

إذا تعذر العثور على مربع الحوار ضمن مجموعة حوارالحالية، البحث في مربع حوار الأصل إذا كان هناك مربع حوار. :p aram dialog_id: معرف مربع الحوار للبحث عن. :أعاد:

find_dialog_sync(dialog_id: str) -> Dialog

المعلمات

دالة المساعد لتبسيط تنسيق خيارات استدعاء مربع حوار المطالبة. سيأخذ هذا المساعد وسيطة PromptOptions ثم يتصل. :p aram dialog_id: معرف المطالبة للبدء. خيارات :p aram: يحتوي على مطالبة، يحتمل أن يكون RetryPrompt وإذا كنت تستخدم ChoicePrompt، Options. :أعاد:

async prompt(dialog_id: str, options) -> DialogTurnResult

المعلمات

إنهاء مربع الحوار النشط وبدء مربع حوار جديد بدلا منه. هذا مفيد بشكل خاص لإنشاء حلقات أو إعادة التوجيه إلى مربع حوار آخر. :p aram dialog_id: معرف مربع الحوار للبحث عن. :p خيارات aram: (اختياري) وسيطة (وسيطات) إضافية لتمريرها إلى مربع الحوار الجديد. :أعاد:

async replace_dialog(dialog_id: str, options: object = None) -> DialogTurnResult

المعلمات

يتم إعادة استدعاء على مربع الحوار النشط حاليا، إذا كان هناك واحد. يستخدم مع المطالبات التي لها سلوك متكرر. :أعاد:

async reprompt_dialog()

إرجاع ارتباط الحاوية في قاعدة البيانات.

إرجاع ارتباط الحاوية في قاعدة البيانات.

الحصول على سياق الدور الحالي للمحادثة.

الحصول على مجموعة مربعات الحوار التي يمكن استدعاؤها من هذا السياق.

الحصول على مكدس الحوار الحالي.