الإجراءات

حدد ما يستطيع وكيل AI فعله أثناء المحادثة، من الإجابة عن الأسئلة ببيانات API الآنية وجمع العملاء المحتملين وبيانات أبحاث السوق، إلى تنفيذ مهام مخصصة.

تتوفر لوكلاء Quickchat AI فئتان من الإجراءات.

إجراءات Quickchat AI مدمجة، فلا تحتاج إلا إلى تفعيلها وضبطها:

• التحويل إلى موظف ينقل المحادثة إلى شخص.
• جمع البيانات الذكي يجمع العملاء المحتملين وبيانات أخرى أثناء الدردشة.

تصل إجراءات مخصصة إلى خارج Quickchat AI:

• تستدعي إجراءات API أي نقطة نهاية HTTP. تتناولها هذه الصفحة.
• تربط إجراءات MCP خادم MCP كاملًا دفعة واحدة.
• تمثل Google Sheets اختصارًا بنقرة واحدة يجهز لك إجراء تسجيل.

يمكن لكل إجراء قراءة بيانات المحادثة الحية عبر متغيرات إجراءات AI، ويوضح مثال Jira إنشاء إجراء من البداية إلى النهاية.

أدوات إعداد اختيارية

• تحقق من شروط تشغيل الإجراءات. قيّم الشروط باستخدام بيانات وصفية تجريبية تقدمها دون تشغيل أي إجراء.

• تحقق من اتصال MCP تجريبي. هيّئ الاتصال واعرض الأدوات في نقطة نهاية توثيق Cloudflare أو Microsoft Learn فقط. لا يتم تسجيل الدخول أو تنفيذ الأدوات.

إجراءات مخصصة

تتيح الإجراءات المخصصة لـ AI استدعاء أدوات خارجية أثناء المحادثة للبحث في الأنظمة الداخلية أو إنشاء التذاكر أو تشغيل التنبيهات أو جلب بيانات حديثة غير موجودة في قاعدة المعرفة. تجدها في الإجراءات وMCP ضمن قسم إجراءات مخصصة.

اضغط + إضافة إجراء لإنشاء إجراء. توفر القائمة:

• إجراء API: يستدعي أي نقطة نهاية REST عبر HTTP. هذا الخيار الأعم؛ استخدمه لأي خدمة لها عنوان URL وتقبل JSON.
• MCP: يربط خادم MCP خارجيًا بنقرة واحدة ليستخدم AI الأدوات التي يوفرها. راجع إجراءات MCP.
• إجراء HubSpot: اتصال جاهز بـ HubSpot CRM. استخدمه للعمل على جهات الاتصال والصفقات والتذاكر، بما في ذلك إضافة ملاحظات خاصة للتذاكر، دون إدارة رموز API بنفسك.
• إجراء Discord: يثبت قوالب إجراءات API قابلة للتعديل للدعم والإشراف. يتطلب تطبيق Discord الخاص بك. راجع إجراءات Discord.
• Google Sheets: يقرأ جدول بيانات تربطه ويكتب فيه.
• Shopify MCP: يربط متجر Shopify عبر خادم Shopify Storefront MCP ليبحث AI في الكتالوج وسياسات المتجر ويقرأ تفاصيل المنتجات وينشئ سلة. يُسمح بإجراء Shopify MCP واحد لكل سيناريو. لا يشمل الاستعلام عن الطلبات؛ راجع الملاحظة أدناه.

ملاحظة

يوضح عداد المتبقي: N بجانب زر + إضافة إجراء عدد الإجراءات التي تسمح خطتك بإبقائها نشطة. وبشكل منفصل، يمكن لكل وكيل الاحتفاظ بـ 15 إجراء كحد أقصى إجمالًا، بصرف النظر عن الخطة. رقّ خطتك إن احتجت إلى إجراءات نشطة أكثر، أو تواصل معنا.

حالة الطلب إجراء منفصل

خادم Shopify Storefront MCP مخصص للعملاء ولا يعرض بيانات الطلبات، لذلك لا يستطيع وكيل AI المتصل به وحده الاستعلام عن طلب عميل. تأتي حالة الطلب من إجراء API منفصل باسم التحقق من حالة الطلب يقرأ Shopify Admin API، ويُعد تلقائيًا عند تثبيت تطبيق Quickchat من Shopify App Store. المتاجر المتصلة بلصق عنوان URL لا تملك وصول Admin، وبالتالي لا توفر الاستعلام عن الطلبات. أعد التثبيت عبر متجر التطبيقات إذا احتجت إليه.

كيفية عمل الإجراءات المخصصة

1. اختر نوع الإجراء: إجراء API أو MCP أو إجراء HubSpot أو إجراء Discord أو Google Sheets أو Shopify MCP. اضبط الاتصال والتعليمات التي يحتاجها AI.
2. أثناء الدردشة، يستخدم AI عادة وصف الإجراء وتفاصيل الأدوات أو المعاملات المتاحة ليقرر متى يشغله. يمكن بدلًا من ذلك تشغيل إجراء API تلقائيًا قبل الرد الأول أو عند تطابق شروط البيانات الوصفية لأول مرة.
3. ينفذ Quickchat الاستدعاء. يستطيع AI استخدام الاستجابة إذا اختار الإجراء بنفسه أو كان الإجراء يعمل قبل الرد الأول. يعمل الإجراء الذي تشغله البيانات الوصفية بصمت ولا تُضاف مخرجاته إلى الدردشة.
4. اختبر الإجراء أو اربطه من محرره قبل استخدامه في المحادثات.

نصيحة

اكتب الوصف كتعليمات لـ AI. وضح متى يستخدم الإجراء، وما الذي يعيده، وأي قيود لازمة، مثل “لا تستدعه إلا عندما يقدم المستخدم رقم طلب”.

إنشاء مسودات إجراءات من وصف

1. في الإجراءات وMCP، اختر + إضافة إجراء > إجراء API.
2. صف سير العمل ومتى ينبغي للوكيل التصرف وواجهات API المطلوبة (أو أرفق روابط توثيقها) والمعلومات اللازمة لكل خطوة. اضغط توليد.
3. يجهز Quickchat ما يصل إلى أربع مسودات جديدة لإجراءات API، وكلها غير نشطة. قد توصي النتيجة بإجراءات موجودة بدلًا من إنشاء نسخ مكررة، أو تطلب تفاصيل إضافية. إنشاء المسودات لا يشغّل الإجراءات.
4. اقرأ الإجراءات الحالية المستخدمة وأي متطلبات مسبقة والخطوات التالية. أكمل الإعداد واستبدل القيم النائبة وراجع طلب كل إجراء وتعليماته وشروط تشغيله. اختبر كل إجراء قبل تفعيل المسودات أو أي إجراء موجود غير نشط مطلوب.

يصف التسلسل المقترح السلوك المطلوب، لكنه لا يضمن ترتيب الإجراءات التي يختارها AI. استخدم المدخلات المطلوبة والذاكرة المحفوظة وشروط التشغيل للتعبير عن الاعتماد بين الخطوات. بعد التفعيل، اختبر المسار كاملًا في محادثة.

إنشاء إجراء API

1. انتقل إلى الإجراءات وMCP.
2. اضغط + إضافة إجراء في إجراءات مخصصة، واختر إجراء API، ثم اضغط إنشاء يدويًا.
3. أكمل التفاصيل:
   • الاسم: واضح ووصفي.
   • الوصف: متى يستخدم الإجراء وما الذي تتضمنه المعاملات.
4. ضمن وقت التشغيل، اختر AI يقرر أو قبل الرد الأول أو عند تطابق البيانات الوصفية.
5. اضبط الاتصال:
   • نوع الإجراء: طريقة HTTP، مثل GET أو POST.
   • عنوان URL لنقطة نهاية الإجراء: عنوان API كاملًا.
   • الترويسات: أضف الترويسات المطلوبة مثل Authorization أو content-type: application/json.
6. عرّف المعاملات: حدد لكل معامل الاسم والموقع (الاستعلام أو الجسم أو الترويسة) والوصف الذي يخبر AI بكيفية تكوين القيمة. قيم المسار ليست موقعًا للمعامل؛ أدرجها مباشرة في عنوان نقطة النهاية باستخدام قوالب {{placeholder}}.
7. استخدم اختبار الطلب وتحقق من الاستجابة، ثم اضغط تم.

نصيحة

يقبل أي حقل قيمة (عنوان URL أو ترويسة أو جسم أو استعلام) قيمًا نائبة ديناميكية عبر زر + إضافة بيانات AI. يمكنك إدراج معاملات AI ومتغيرات المحادثة المدمجة ({{scenario_id}}، {{language}}، {{country}}، …) والبيانات الوصفية للمحادثة ({{metadata_*}}). راجع متغيرات إجراءات AI للمرجع الكامل.

إضافة إلى الطلب نفسه، يضم إجراء API ثلاثة إعدادات اختيارية مفيدة: حفظ في الذاكرة والتشغيل فقط عندما وفلتر الاستجابة.

عاين طلب إجراء API باستخدام قالب تقدمه وقيم تجريبية اصطناعية. احذف ترويسات بيانات الاعتماد. تعرض المعاينة الطلب دون إرساله.

اختيار وقت تشغيل إجراء API

استخدم وقت التشغيل لاختيار أحد ثلاثة أوضاع:

يكون القسم مطويًا افتراضيًا ويعرض الوضع الحالي بجانب عنوانه؛ وسّعه لتغيير الوضع.

• AI يقرر: الوضع الافتراضي. يقرأ AI وصف الإجراء ويقرر إن كان طلب الزائر يحتاج إليه. استخدمه عندما ينبغي تشغيل الإجراء لأسئلة محددة فقط أو بعد أن يجمع AI معلومات من الزائر.
• قبل الرد الأول: يشغّل Quickchat الإجراء مرة واحدة بعد إرسال الزائر رسالته الأولى وقبل أن يكتب AI رده الأول. يتلقى رد AI العادي الاستجابة وأي قيم محفوظة عبر حفظ في الذاكرة. لا يعود AI قادرًا على اختيار هذا الإجراء كأداة، لذلك يعمل في الجولة الأولى فقط ولا يتكرر لاحقًا في المحادثة. استخدمه للتعرف على العميل أو سياق الحساب أو التحقق من الاستحقاق أو أي إعداد تحتاجه كل محادثة فعلية.
• عند تطابق البيانات الوصفية: يفحص Quickchat شروط التشغيل عندما بعد كل جولة AI ويشغّل الإجراء عند تطابق جميع الشروط لأول مرة. تتوفر فورًا القيم التي يحفظها إجراء آخر في الذاكرة أثناء تلك الجولة. لا يستطيع AI اختيار هذا الإجراء كأداة، ولا تُضاف استجابته إلى الدردشة. استخدمه للإشعارات الداخلية أو تحديثات CRM أو طلبات المتابعة التي ينبغي تنفيذها تلقائيًا عند توفر بيانات المحادثة.

يرتبط قبل الرد الأول برسالة الزائر الأولى، لا بإنشاء المحادثة. فتح الدردشة أو تلقي رسالة ترحيب لا يشغله، لذلك لا ترسل الدردشات المهجورة أي طلب. يسجل Quickchat التشغيل قبل استدعاء نقطة النهاية، فلا يعيد المحاولة في المحادثة نفسها حتى إذا فشل الطلب أو كانت نتيجته غير مؤكدة.

ينتظر الرد الأول انتهاء الطلب، لذلك قد يزيد هذا الوضع زمن الانتظار. إذا استخدمت عدة إجراءات هذا الوضع، فإنها تعمل بالتتابع وتتراكم أزمنة طلباتها. إذا غابت البيانات الوصفية المطلوبة أو تعذرت نقطة النهاية أو فشل الطلب، يظل AI يرد. افتح سجل الطلبات في الإجراء لمعرفة ما حدث.

لأن الإجراء يعمل قبل أن يختار AI قيم المعاملات، يجب أن تكون لكل معامل AI يستخدمه قيمة افتراضية. يمكن إدراج البيانات الوصفية والمتغيرات المدمجة مباشرة في عنوان URL أو الترويسات أو الاستعلام أو الجسم.

يتطلب عند تطابق البيانات الوصفية شرط التشغيل عندما واحدًا على الأقل وقيمة افتراضية لكل معامل AI. يسجل Quickchat المحاولة قبل استدعاء نقطة النهاية، لذلك بعد إرسال الطلب لا يعاد الإجراء في المحادثة نفسها سواء نجح أو فشل أو كانت نتيجته غير مؤكدة. أما الطلب الذي تعذر تكوينه أصلًا بسبب غياب قيمة لازمة فلا يُسجل ويظل مؤهلًا لجولة لاحقة. يعمل الإجراء فور انتهاء جولة AI، فلا يستبدل الفشل رد AI. في القنوات التي لا تبث الرد تدريجيًا، تضاف مدة الطلب ذهابًا وإيابًا إلى انتظار الزائر للرد.

عند اختيار عند تطابق البيانات الوصفية يظهر محرر التشغيل عندما داخل القسم نفسه، ليبقى المحفز وشروطه معًا.

التعرف بالبريد الإلكتروني أو الهاتف

للقنوات التي قد تقدم بريدًا إلكترونيًا أو رقم هاتف، أنشئ إجراء بحث لكل معرّف. اضبط كليهما على قبل الرد الأول، ثم أضف شرط التشغيل فقط عندما المطابق مثل visitor_email exists أو visitor_phone_number exists. يرسل Quickchat الطلب الذي تتوفر بياناته الوصفية فقط.

إجراءات HubSpot

يفتح إجراء HubSpot معرضًا من إجراءات API المعبأة مسبقًا والقابلة للتعديل التي تستخدم حساب HubSpot المتصل.

ينشئ قالب إضافة ملاحظة إلى التذكرة ملاحظة خاصة في تذكرة HubSpot المرتبطة بالمحادثة. احفظ محتوى الملاحظة في ذاكرة المحادثة باسم hubspot_note_body، ثم أضف القالب وفعّله. يأتي مضبوطًا على عند تطابق البيانات الوصفية وينتظر توفر كل من hubspot_note_body وhubspot_ticket_id الذي يقدمه خادم Quickchat. يمكنك تعديل القيمة الافتراضية للمعامل note_body لإضافة نص ثابت حول {{metadata_hubspot_note_body}}.

الملاحظة داخلية في HubSpot ولا تظهر للزائر. يحاول القالب إرسال الطلب مرة واحدة لكل محادثة Quickchat. افتح سجل الطلبات في الإجراء لتأكيد التسليم أو التحقيق في طلب فاشل.

إجراءات Discord

يفتح إجراء Discord معرضًا من إجراءات API المعبأة مسبقًا والقابلة للتعديل:

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

ينشئ Quickchat طريقة HTTP والعنوان والترويسات والجسم والمعاملات والوصف وإعدادات الاستجابة وشروط التشغيل في الخادم. البطاقات الناتجة إجراءات طلب HTTP عادية. يمكنك فحص كل حقل وتعديله.

تشمل قوالب الإشراف السبعة author_is_admin is true ضمن التشغيل فقط عندما. يحسب Discord صلاحية Administrator للكاتب الحالي، وتقدم بوابة Discord هذه القيمة، ويتحقق منها Quickchat قبل إرسال الطلب. لا يمكن للدردشة العامة أو بيانات API الوصفية تعيين هذا المفتاح. اختبر إجراءات الإشراف في Discord بحساب مسؤول وحساب غير مسؤول؛ لا يوفر وضع معاينة AI مرسل Discord مخولًا.

تنبيه

إجراءات الإشراف قابلة للتعديل. إزالة شرط author_is_admin is true أو إضعافه تلغي حد التفويض الذي توفره. لا يطلب الطرد والحظر تأكيدًا قبل التنفيذ.

لا تضيف القوالب أي أتمتة خاصة بها. لا يشغلها الوكيل إلا عندما يطلب مسؤول ذلك في المحادثة؛ لا توجد عدادات مخالفات عبر المحادثات، أو تحقق من لقطات الشاشة والأدلة الأخرى، أو عقوبات مجدولة أو ذاتية البدء.

يظل البوت نفسه بحاجة إلى صلاحية Discord اللازمة لكل طلب:

الإجراء	صلاحية البوت أو الوصول المطلوب
تقييد عضو مؤقتًا	Moderate Members
طرد عضو	Kick Members
حظر عضو، إلغاء حظر عضو	Ban Members
تعيين دور	Manage Roles
تعيين الوضع البطيء	Manage Channels
إرسال إعلان	View Channels وSend Messages

يفرض Discord أيضًا تسلسل الأدوار. ضع دور البوت أعلى من الأعضاء والأدوار التي ينبغي أن يديرها. لا يجري القالب فحصًا إضافيًا للتسلسل أو لكل صلاحية لدى المسؤول مقدم الطلب.

يقبل تعيين الوضع البطيء وإرسال إعلان معامل معرّف القناة. من دون هدف ثابت إضافي، لا يتحقق القالب من أن القناة تنتمي إلى الخادم الذي أرسل منه المسؤول الطلب. إذا انضم البوت نفسه إلى عدة خوادم، عدّل هذه الإجراءات لاستخدام معرّف قناة ثابت أو افصل الخوادم بين وكلاء وبيانات اعتماد بوتات مختلفة.

يستخدم تثبيت تذكرة الدعم ميزات الإجراءات الحالية لتمرير البيانات:

1. ينشئ open_support_ticket سلسلة خاصة في القناة المحددة، ويلتقط $.id، ويحفظه في ذاكرة المحادثة باسم discord_ticket_thread_id. يتطلب discord_message is true، ولا يعمل إلا في الخادم المحدد وفقط عندما لا يوجد مفتاح الذاكرة هذا.
2. يقرأ add_ticket_requester قيمة {{metadata_discord_ticket_thread_id}} وقيمة {{metadata_discord_author_id}} التي يوفرها Discord. يتطلب discord_message is true، ويعمل في الخادم المحدد فقط بعد توفر معرّف السلسلة.
3. يقرأ post_in_ticket معرّف السلسلة المحفوظ نفسه، وينشر ملخص المشكلة الذي كتبه الوكيل في سطر واحد، ويشير إلى مقدم الطلب. إذا اخترت دور دعم، يشير إليه أيضًا. له شروط رسالة Discord والخادم والسلسلة المحفوظة نفسها. يقتصر جسم allowed_mentions في Discord على مقدم الطلب وذلك الدور عند ضبطه.

ينبغي للوصف وتعليمات الوكيل توجيه الوكيل لتشغيل هذه الإجراءات بهذا الترتيب. لا توجد طبقة منفصلة لحالة سير العمل أو القفل أو التأكيد أو إعادة المحاولة أو الاسترداد أو المطابقة أو الحماية من إعادة التنفيذ. إذا كانت النتيجة غير مؤكدة، افحص Discord وسجل الإجراء قبل إعادة المحاولة لأن Discord ربما أكمل الطلب بالفعل.

لا تُمسح قيمة discord_ticket_thread_id تلقائيًا. لذلك يدعم القالب المبدئي تذكرة واحدة لكل محادثة Quickchat. ابدأ محادثة Discord أو سلسلة جديدة لتذكرة أخرى، أو عدّل الإجراءات لإضافة دورة حياة الذاكرة المطلوبة.

لتذكرة الدعم، امنح البوت View Channels وSend Messages وRead Message History وCreate Private Threads وSend Messages in Threads وManage Threads في قناة التذاكر المحددة. اترك إشعار دور (اختياري) مضبوطًا على عدم إشعار أي دور إذا لم ترغب في الإشارة إلى دور. إذا اخترت دورًا، يجب أن يكون قابلًا للإشارة وأن يملك أعضاؤه وصولًا إلى السلاسل الخاصة. إذا لم تتوفر أدوار قابلة للإشارة، تُفتح التذاكر طبيعيًا دون إشعار دور. يعرض المعرض القنوات النصية والأدوار القابلة للإشارة لكنه لا يتحقق من جميع استثناءات صلاحيات القنوات.

تنبيه

تحتاج إجراءات Discord إلى الرمز من تطبيق Discord الخاص بك ضمن التطبيقات الخارجية → Discord → الإعداد المتقدم. البوت المشترك الذي يُربط بنقرة واحدة لا يستطيع وحده توفير الرمز. راجع Discord.

المعرض اختصار للإعداد وليس طبقة سياسات إضافية. إذا عدلت إجراء مولدًا أو أنشأت إجراء Discord API مخصصًا، فراجع بيانات اعتماده وأهدافه ومعاملاته وما تعرضه استجابته وشروط التشغيل فقط عندما قبل تفعيله.

حفظ في الذاكرة

احفظ قيمة من مدخلات إجراء أو استجابة API في ذاكرة المحادثة تحت مفتاح تختاره. تستطيع الإجراءات اللاحقة إعادة استخدامها بصيغة {{metadata_<key>}}، وتظهر في تفاصيل المحادثة (صندوق الوارد وAPI وملفات التصدير).

استخدم ذلك عندما ينتج إجراء شيئًا يحتاجه إجراء لاحق. يمكن لإجراء بحث حفظ customer_id من استجابته؛ ثم يرسل إجراء متابعة {{metadata_customer_id}} دون أن ينسخ AI القيمة بينهما.

في محرر إجراء API، افتح حفظ في الذاكرة وأضف صفًا:

1. اختر المصدر. يقرأ استجابة API استجابة JSON من API وهو الخيار الافتراضي للصفوف الجديدة. يقرأ مدخلات الإجراء قيم معاملات الإدخال المعرفة في الإجراء.
2. ضمن القيمة المراد حفظها، اختر المعامل من القائمة في حالة مدخلات الإجراء. وفي حالة استجابة API، أدخل تعبير JSONPath مثل $.customer_id.
3. اختر مفتاح الذاكرة. تقترح أسماء المدخلات الإنجليزية الشائعة للاسم والهاتف والبريد مفتاح الزائر المطابق. يمكنك قبول الاقتراح أو إدخال مفتاح خاص بك.

لحفظ بيانات الاتصال في صندوق الوارد، استخدم مدخلات الإجراء مع هذه الروابط:

معامل الإجراء	مفتاح الذاكرة
Name أو Full name	visitor_name
Phone number أو Phone	visitor_phone_number
Email أو Email address	visitor_email

يجب تعريف المدخل في الإجراء. حفظه عبر قاعدة ذاكرة مدخلات الإجراء يُعد استخدامًا للمعامل، فيمكن جمعه للذاكرة دون إرساله في طلب HTTP. تملأ مفاتيح الزائر هذه حقول الاتصال غير المعينة في صندوق الوارد وبيانات المحادثة الوصفية باستخدام التحقق نفسه في جمع البيانات الذكي. تُحفظ بيانات الاتصال الموجودة والحقول التي مسحها موظف صراحةً. لا تستطيع قواعد استجابة API الكتابة في مفاتيح الزائر هذه؛ استخدم مفتاحًا مخصصًا مثل customer_id لقيم استجابة CRM.

تُحفظ المدخلات بعد اجتياز فحوص المدخلات المطلوبة وشروط التشغيل وقبل طلب HTTP. لذلك تبقى بيانات الاتصال الصالحة متاحة إذا أعاد API خطأ أو انتهت مهلة الطلب. للتحقق منها، شغّل الإجراء في محادثة معاينة جديدة وافتحها في صندوق الوارد. اختبار API المعزول في المحرر لا يملك محادثة لحفظ الذاكرة فيها.

تُشارك مفاتيح الذاكرة مع أدوات MCP البعيدة للوكيل. إذا كانت أداة MCP تحفظ في المفتاح نفسه، يبلغ حقل مفتاح الذاكرة عن التعارض عند الحفظ، فاختر مفتاحًا مختلفًا. تستمر أدوات MCP البعيدة في حفظ قيم من نتائجها.

نصيحة

استخدم مفاتيح snake_case (أحرف وأرقام وشرطات سفلية). يمكن الإشارة إلى مفتاح مثل customer_id بصيغة {{metadata_customer_id}}؛ أما المفاتيح التي تحتوي مسافات أو علامات ترقيم أخرى فلا يمكن استخدامها في القيم النائبة. راجع البيانات الوصفية للمحادثة لمعرفة عمل هذه المتغيرات.

التشغيل فقط عندما

قيّد الإجراء ليعمل فقط عندما تتحقق شروط البيانات الوصفية للمحادثة. تُفحص الشروط دائمًا من جانبنا، خارج النموذج. مع AI يقرر أو قبل الرد الأول، يفحصها Quickchat مباشرة قبل إرسال الطلب. ومع عند تطابق البيانات الوصفية، تُشغّل الشروط نفسها الطلب بعد جولة AI دون انتظار اختيار AI للإجراء.

هذه الأداة مناسبة للإجراءات ذات الصلاحيات أو التي لا رجعة فيها، مثل حظر عضو أو إصدار استرداد أو حذف سجل. عبارة في التعليمات مثل “يسمح للمسؤولين فقط بهذا” مفيدة، لكنها ليست حدًا أمنيًا: يستطيع مستخدم مصرّ مجادلة النموذج أو محاولة حقن التعليمات. شرط التشغيل حتمي ويعيش خارج التعليمات، لذلك يظل نافذًا مهما قيل في المحادثة.

• شرط التشغيل هو الحد الفاصل. يُقيّم على الخادم وليس جزءًا من التعليمات التي يقرأها النموذج. هو ما يمنع الإجراء فعليًا من العمل.
• قاعدة التعليمات تضبط تجربة المستخدم. احتفظ بها أيضًا ليعتذر AI بلطف ويشرح السبب بدلًا من الصمت.

أضف الشروط في قسم التشغيل فقط عندما في محرر الإجراء. يسمى هذا القسم التشغيل عندما لإجراء عند تطابق البيانات الوصفية. اضغط إضافة شرط، واختر مفتاح بيانات وصفية مثل telegram_sender_is_admin، ثم اختر طريقة المقارنة:

الشرط	ينجح عندما تكون قيمة البيانات الوصفية…
صحيح	ذات قيمة منطقية صحيحة
غير صحيح	ذات قيمة منطقية خاطئة
موجود	موجودة في المحادثة
غير موجود	غائبة
يساوي	مطابقة لقيمة تحددها
لا يساوي	مختلفة عن قيمة تحددها
إحدى القيم	مطابقة تمامًا لإحدى القيم المدرجة، بما في ذلك حالة الأحرف والمسافات
يحتوي على النص	نصًا يحتوي على النص الحرفي المحدد مع مراعاة حالة الأحرف

لا يعمل الإجراء إلا عند تحقق كل الشروط. يعرض المحرر AND بين الصفوف. عندما يمنع شرط إجراءً اختاره AI، يستطيع AI توضيح أن الإجراء غير متاح. يظل إجراء عند تطابق البيانات الوصفية صامتًا حتى تتحقق شروطه.

استخدم إحدى القيم للبدائل على المفتاح نفسه، وأدخل كل بديل كعنصر قيمة منفصل. مثلًا يمكن وضع modelName is one of [K-65XR95M2, K-75XR95M2, K-85XR95M2] بجانب country equals UK؛ ويجب نجاح الصفين. يمكنك إضافة ما يصل إلى 50 بديلًا، بحد 500 حرف لكل بديل. الفواصل أجزاء حرفية من القيمة. لا يمكن لصفوف يساوي منفصلة لقيم مختلفة من المفتاح نفسه أن تتطابق كلها.

يفحص يحتوي على النص جزءًا نصيًا حرفيًا، لا محرف بدل أو تعبيرًا نمطيًا. تطابق XR95M2 أيضًا نسخ أسماء طرازات خارج الثلاثة المذكورة أعلاه. يرفض الشرطان الجديدان المفاتيح الغائبة وnull والقوائم والكائنات؛ ويرفض يحتوي على النص أيضًا الأرقام والقيم المنطقية. لا يسمح بنص مقارنة فارغ. يمكن لشروط غير صحيح ولا يساوي وغير موجود الحالية مطابقة المفاتيح الغائبة.

عند فشل شرط، لا يُرسل طلب ويخبر AI المستخدم أنه لا يستطيع تنفيذ ذلك. أدناه يُمنع طلب الحظر نفسه لغير المسؤول ويُسمح به للمسؤول، دون تغيير سوى هوية مقدم الطلب:

تنبيه

اعتمد فقط على البيانات الوصفية التي يضبطها Quickchat، مثل العلامة telegram_sender_is_admin التي تتحقق منها القناة، لا على قيم يستطيع الزائر التأثير فيها. راجع البيانات الوصفية للمحادثة لمعرفة مصدر كل مفتاح.

فلتر الاستجابة

يرى AI افتراضيًا استجابة API كاملة. أضف تعبيرات JSONPath في قسم فلتر الاستجابة لقصر ما يراه على أجزاء محددة منها.

سببان شائعان للتصفية:

• إخفاء الحقول الحساسة. أبقِ عناوين بريد العملاء وتفاصيل الدفع والمعرّفات الداخلية خارج سياق النموذج عندما تعيد نقطة النهاية أكثر مما يحتاجه AI.
• تقليل حجم التعليمات. قد تعيد واجهات API كثيرة التفاصيل حمولات كبيرة؛ التصفية إلى الحقول المهمة تبقي الاستجابة صغيرة وAI مركزًا.

أضف تعبير JSONPath أو أكثر. يحتفظ الفلتر بالحقول المحددة داخل كائناتها ومصفوفاتها الحاوية بدلًا من تسطيحها إلى قائمة قيم. تُحذف الحقول خارج المسارات المحددة. مثلًا استخدم هذين الصفين:

• $.customer.name
• $.orders[*].id

لهذه الاستجابة من API:

{
  "customer": {"name": "Ada", "email": "ada@example.com"},
  "orders": [{"id": 101, "total": 25}, {"id": 102, "total": 40}]
}

يتلقى AI هذه الاستجابة المصفاة، مع بقاء customer كائنًا وorders مصفوفة كائنات:

{
  "customer": {"name": "Ada"},
  "orders": [{"id": 101}, {"id": 102}]
}

نصيحة

استخدم لوحة اختبار الاستجابة لترى بدقة ما سيتلقاه AI بعد التصفية قبل الاعتماد عليها. راجع اختبار الإجراء.

تنبيه

إذا لم يطابق JSONPath شيئًا، يتلقى AI استجابة فارغة. ابدأ دون فلتر وتأكد أن الاستدعاء يعمل، ثم ضيّق النتائج.

عاين مطابقات JSONPath في استجابة JSON تقدمها. تدعم المعاينة مسارات الجذر والحقول وفهارس المصفوفات ومحارف البدل لقواعد فلتر الاستجابة أو حفظ في الذاكرة.

التحقق من حالة الإجراءات وسجلاتها

يعني التحذير بجانب الإجراءات وMCP في الشريط الجانبي أن إجراء يحتاج إلى انتباه. افتح الصفحة ومرر المؤشر فوق شارة بطاقته أو ركّز عليها لمعرفة السبب:

• يفشل: فشلت الاستدعاءات الأخيرة مرارًا. تعرض الشارة عدد الإخفاقات وأحدث خطأ عند توفره.
• لا يعمل: تم تخطي الإجراء مرارًا دون استدعاءات منفذة في نافذة حالته الحالية. افحص السبب المذكور، مثل غياب قيم المحادثة أو مشكلة إعداد.
• يلزم إعادة الاتصال: فقد اتصال MCP التفويض وأُوقف. افتح تعديل، وأعد الاتصال، ثم فعّله من جديد.

تعتمد الحالة على المحادثات الفعلية الحديثة خلال الأيام السبعة الماضية، أو منذ آخر تعديل للإجراء إن كان أحدث. وهي منفصلة عن طلبات الاختبار. بعد تصحيح الإجراء وحفظه، افحص المحادثات الجديدة لتأكيد الإصلاح؛ إزالة تحذير قديم وحدها لا تثبت نجاحه.

في حالتي يفشل أو لا يعمل، اضغط عرض التفاصيل لفتح سجل الطلبات مع تفعيل المشكلات فقط. يفتح عرض السجلات السجل بكل الاستدعاءات. أوقف المشكلات فقط لمقارنة الاستدعاءات ذات المشاكل بالناجحة.

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

عندما يسرد السبب قيمًا غائبة مثل {{metadata_visitor_email}}، وفرها عبر بيانات موقعك أو قناتك الوصفية، أو اجعل إجراء سابقًا يحفظها في الذاكرة. ثم افحص وضع التنفيذ:

• AI يقرر: لا يُعرض الإجراء على AI إلا في المحادثات التي تتوفر فيها القيم المطلوبة بالفعل.
• قبل الرد الأول: يجب توفر القيم عند إرسال الزائر الرسالة الأولى.
• عند تطابق البيانات الوصفية: أضف شرط موجود لكل قيمة مطلوبة ليَنتظرها الإجراء.

راجع متغيرات إجراءات AI لمعرفة مصادر قيم المحادثة.

تتضمن رسائل ملخص النشاط أيضًا قسم إجراءات AI تحتاج إلى انتباه عندما يحتاج إجراء HTTP أو MCP بعيد إلى انتباه. يسرد حتى خمسة إجراءات، مع سبب ورابط إلى الإجراءات وMCP؛ ويبين عداد إضافي عدد الإجراءات الأخرى. يُحذف القسم عندما تكون حالة الجميع سليمة.

يعرض البريد الحالة الحالية، التي قد تغطي أكثر من نافذة نشاط الملخص اليومي. بعد حفظ إجراء API مصحح، يبدأ تقييم حالته من ذلك التعديل. إعادة ربط اتصال MCP المتأثر أو فصله تزيل تحذير التفويض. تسري تفضيلات رسائل الملخص وقواعد أهليتها الحالية، ولا تُرسل رسالة تنبيه منفصلة.

أفضل الممارسات

• كن واضحًا في الأوصاف. أخبر AI متى يستخدم الإجراء وما الذي ينبغي أن يحتويه كل معامل.
• قلل نطاق الصلاحيات. لا تدرج إلا الترويسات والرموز التي تحتاجها نقطة النهاية. في Jira، استخدم ترويسة Basic المشتقة من بريد Atlassian ورمز API.
• اختبر قبل الإطلاق باستخدام لوحة اختبار الطلب. تأكد من أن رموز الحالة والحمولات التجريبية صحيحة في الأداة المستهدفة.

دروس تطبيقية

• ربط وكيل AI بتذاكر Jira (المرجع الأساسي) أو الشرح المفصل في المدونة
• إرسال إشعار Slack بإجراء AI