الملاحظات في SmartFlow
تقدم الملاحظات تعليقات فورية لمساعدك الذكي خلال المحادثات. تسمح لـ SmartFlows بالتواصل بالنتائج مرة أخرى إلى الذكاء الاصطناعي.
ما هي الملاحظات؟
عندما يتم تنفيذ SmartFlow (المحفز بواسطة أداة المحادثة)، يمكنه إرسال ملاحظات مرة أخرى إلى الذكاء الاصطناعي. يستخدم الذكاء الاصطناعي هذه الملاحظات لـ:
- تقديم ردود مستنيرة للمستخدمين
- عرض البيانات المسترجعة من الأنظمة الخارجية
- تأكيد أن الإجراءات قد اكتملت بنجاح
- التعامل مع الأخطاء بشكل سلس
كيف تعمل
المستخدم يطرح سؤال → الذكاء الاصطناعي يحفز SmartFlow → SmartFlow ينفذ →
الملاحظة تُرسل → الذكاء الاصطناعي يقرأ الملاحظة → الذكاء الاصطناعي يرد على المستخدم
مثال:
- المستخدم: "ما هو وضع طلبي #12345؟"
- الذكاء الاصطناعي يحفز SmartFlow "تحقق من وضع الطلب"
- SmartFlow يستدعي واجهة برمجة التطبيقات للتجارة الإلكترونية
- SmartFlow يرسل الملاحظة:
{"status": "shipped", "tracking": "ABC123"} - الذكاء الاصطناعي يرد: "لقد تم شحن طلبك #12345! التتبع: ABC123"
إعداد الملاحظات
استخدم عقدة Set Observation في SmartFlow الخاص بك:
| الحقل | الوصف |
|---|---|
| الملاحظة | نص أو بيانات JSON لإرسالها إلى الذكاء الاصطناعي |
| المتغيرات | استخدم {{variable}} لتضمين بيانات ديناميكية |
مثال على التكوين:
{
"status": "{{apiResponse.orderStatus}}",
"tracking": "{{apiResponse.trackingNumber}}",
"estimatedDelivery": "{{apiResponse.eta}}"
}
أفضل الممارسات
اجعل الملاحظات مختصرة
يعالج الذكاء الاصطناعي الملاحظات كالسياق. اجعلها مركزة:
// جيد
{"found": true, "productName": "Blue Widget", "price": 29.99}
// مطولة جداً
{"query": "...", "timestamp": "...", "requestId": "...", "fullResponse": {...}}
التعامل مع الأخطاء
تأكد دائماً من تضمين معالجة الأخطاء في ملاحظاتك:
// نجاح
{"success": true, "data": {...}}
// خطأ
{"success": false, "error": "الطلب غير موجود"}
استخدام البيانات المنظمة
يفضل استخدام JSON على النص العادي للبيانات المعقدة:
{
"tickets": [
{"id": "JIRA-123", "status": "In Progress"},
{"id": "JIRA-124", "status": "Done"}
],
"total": 2
}
حالات الاستخدام الشائعة
| حالة الاستخدام | تحتوي الملاحظة على |
|---|---|
| البحث عن الطلب | الحالة، التتبع، تاريخ التسليم |
| حجز المواعيد | التأكيد، التاريخ/الوقت، التفاصيل |
| البحث عن المعرفة | المقالات ذات الصلة، الملخصات |
| البحث في CRM | معلومات العميل، التاريخ |
| التحقق من ا لمخزون | مستويات المخزون، التوفر |
ذات صلة
- Set Observation Action — مرجع العقد
- Conversation Tool Trigger — كيف يحفز الذكاء الاصطناعي التدفقات
- AI Request Action — طلب معالجة الذكاء الاصطناعي