المفاهيم
المسار
محادثة واحدة يستطيع البوت إجراءها: ما يسأل عنه، وأي واجهاتك يستدعي، وما يؤكّده قبل أن ينفّذ. تبدأ التطبيقات المسار بـ مفتاحه. ويمكن أرشفة المسار: فلا يبدأ محادثة جديدة، وتبقى نسخه ومحادثاته وسجله.
الخطوة
المسار قائمة خطوات، وكل خطوة تسمّي الخطوة التي تليها:
- اسأل تجمع الخانات، وتسأل عن كل منها بسؤالها.
- استدعِ واجهة تشغّل إحدى عمليات موصّلاتك، ويمكنها حفظ الجواب للخطوات التالية.
- اختر تدع المستخدم ينتقي من قائمة حفظها استدعاء.
- أكّد تعرض ما سيحدث وتنتظر الموافقة. وتُصاغ كلماتها من معاملات الاستدعاء التالي الحقيقية، لا مما قاله النموذج.
- قل، وحوّل (إلى موظف في فريقك)، وأنهِ.
الخانة
قيمة تجمعها خطوة السؤال: نص، أو عدد صحيح، أو واحدة من قائمة. تُفحص كل خانة بالشيفرة مقابل نوعها قبل استعمالها. ويمكن للمستخدم كتابتها بكلماته، أو بالأرقام العربية الهندية.
الموصّل والعملية
الموصّل إحدى واجهاتك البرمجية: عنوانها، وكيف تسجّل الدخول، وعملياتها، وهي الاستدعاءات الوحيدة التي يستطيع المسار إجراءها. والاستدعاء الذي يغيّر البيانات يحتاج خطوة تأكيد قبله مباشرة ومستخدمًا مسجّلًا. وما تعيده الواجهة لا يوسّع ما يحق للنموذج فعله.
النسخة
كل حفظ للمسار نسخة. نشر إحداها يجعلها فعّالة للمحادثات الجديدة، وتحتفظ المحادثات الجارية بنسختها. ويمكنك الرجوع إلى نسخة أقدم.
مفتاح المحادثة
المفتاح العام الذي يبدأ به التطبيق جلسات المحادثة. يظهر مرة واحدة عند إصداره. وإلغاؤه يمنع ذلك التطبيق من بدء محادثة، ولا يمكن التراجع عنه.
المستخدم المسجّل
توقّع خوادمك رمزًا قصير العمر للمستخدم (انظر دليل الحزمة). ودونه يستطيع المسار أن يحادث المستخدم ويدعه يختار، لكنه لا ينفّذ أي خطوة تغيّر شيئًا له.
التحويل إلى الفريق
حين يحوّل المسار المحادثة إلى فريقك، يواصل المستخدم الكتابة في المحادثة نفسها، وتصل ردود الفريق فيها موسومة بأنها من الفريق.
المحادثات والتحليلات
تحفظ المحادثات كل محادثة: كيف انتهت، وأين، وكل استدعاء أجرته لواجهاتك. وتعرض التحليلات النتائج والتحويلات وعدد المحادثات والخطوات التي يتوقف عندها الناس. والمحادثات التجريبية لا تُحتسب أبدًا.