سيناريوهات AI

تُضبط السيناريوهات في /ai/scenarios. يتطلب العرض صلاحية قراءة، ويتطلب الإنشاء والتعديل صلاحية إدارة؛ وبدون الصلاحية المناسبة تبقى البطاقة غير متاحة أو للقراءة فقط.

عقد السيناريو

حدد key ثابتاً والاسم والوصف والفئة وenabled وuseCase (text_improve وtext_fix وjson_analysis وcustom) وoutputMode (text أو json) وsystemPrompt وuserPromptTemplate وtags وresponseSchema الاختياري. اربط connectionId أو اترك الاتصال الافتراضي.

تشمل الحدود maxPromptChars وmaxOutputChars وmaxContextChars وrequestTimeoutMs وoverflowMode (reject/truncate). لا تعطل التعليمة النظامية دون فهم الأثر؛ عند disableSystemPrompt=true يبقى قالب المستخدم فقط.

الاختبار

اختبر السيناريو في ساحة AI بعينة اصطناعية. في JSON تحقق من أن schema كائن صالح، وأن الحقول المطلوبة ضرورية وأن النموذج العملي يستطيع معالجة النتيجة. اختبر إدخالاً طويلاً وtimeout وغياب الاتصال والقائمة المحمّلة جزئياً. عطّل السيناريو القديم بجعل enabled=false بدلاً من إعادة استخدام key.

النموذج وتعارضات التعديل

يتطلب الإنشاء أو التعديل key والاسم. إذا أُدخل responseSchema فيجب أن يكون كائن JSON؛ وتُدخل tags مفصولة بفواصل. يعيد التحديث داخل نافذة السيناريو تحميل أحدث بيانات السيناريو المحفوظة وينبه إذا حُذف السجل أو تعذّر العثور عليه. إذا كان السيناريو مرتبطاً باتصال، يمكن فتح بطاقته من النموذج؛ ويحتفظ التعطيل بالسجل ويضبط enabled على false.

الأمان

يجب ألا يطلب Prompt كلمات مرور أو token أو بيانات شخصية زائدة أو مبالغ تعاقدية أو ملفات عميل آخر. السيناريو الذي يغيّر CRM أو مهمة أو تقويماً أو مستنداً يحتاج دائماً إلى مراجعة بشرية. يجب أن يذكر الوصف المالك والسياق المسموح ومعيار الجاهزية.

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

مرتبط: ساحة الاختبار، الاتصالات، إعدادات AI وAssistant.