نظرة عامة
TQEN Agent هو مساحة التواصل الحيّة. يعرض المنتج العام حاليًا مساحة دعم عبر الموقع متصلة بـ TQEN Engine.
البداية السريعة
- افتح مركز التجارب.
- اختر تجربة دعم العملاء.
- أرسل رسالة بالإنجليزية أو العربية أو التركية وراقب أحداث سير العمل الحقيقية الصادرة عن ذلك الطلب.
البنية
يرسل المتصفح رسالة إلى مسار خادم في Next.js. يحفظ ذلك المسار بيانات الاعتماد التطويرية في الخادم ويعيد دفق رد المحرك إلى المتصفح. تعرض مساحة العمل نص الرد الآمن والأحداث الصادرة عن المحرك فقط.
Browser → Next.js support proxy → TQEN Engine stream → Support workspace
تكامل الموقع
استخدم مساحة عمل الموقع لتجربة دعم عبر المتصفح. أبقِ بيانات اعتماد الخلفية على الخادم؛ على المتصفح إرسال معرّف المحادثة ومعرّف العميل والرسالة فقط.
يحفظ التطبيق العام معرّفات المحادثة في التخزين المؤقت لجلسة المتصفح، فيمكن متابعة الجلسة نفسها بعد التحديث دون إنشاء نظام حسابات عام.
مرجع API
نقطة النهاية الخاصة بالمتصفح هي POST /api/demo/support. تقبل JSON وتعيد دفق أحداث مرسلة من الخادم (SSE).
POST /api/demo/support
Content-Type: application/json
{
"conversation_id": "session-conversation-id",
"customer_id": "session-customer-id",
"message": "What are your pricing plans?"
}أحداث SSE
يُغلّف كل حدث بتنسيق SSE. تستخدم مساحة العمل اسم الحدث وبيانات JSON الآمنة لتحديث الحالة المرئية، ولا تخترع مراحل استرجاع أو أدوات مفقودة.
event: response.delta
data: {"type":"response.delta","payload":{"text":"Here is how…"}}
event: response.completed
data: {"type":"response.completed","payload":{"intent":"faq"}}| الحدث | سلوك مساحة العمل |
|---|---|
| request.started | وصلت رسالة المتصفح إلى المحرك. |
| request.validated | اجتاز الطلب مرحلة التحقق في المحرك. |
| memory.loaded | تم تحميل سياق المحادثة. |
| intent.detected | أصدر المحرك نتيجة القصد. |
| retrieval.started | بدأ استرجاع المعرفة الخاصة بالأعمال. |
| retrieval.completed | اكتمل استرجاع المعرفة الخاصة بالأعمال. |
| response.started | بدأت مرحلة الرد. |
| response.delta | وصل نص آمن من المساعد ضمن payload.text. |
| response.completed | اكتمل الطلب بنجاح. |
| request.failed | فشل الطلب؛ تعرض مساحة العمل رسالة استرجاع آمنة. |
response.delta.payload.text يُلحق بالرسالة النشطة للمساعد. response.completed هو نجاح نهائي؛ request.failed ينتج رسالة استرجاع آمنة.
قاعدة المعرفة
تُسترجع معرفة الأعمال من مجموعات مدعومة بـ Qdrant. حافظ على تحديث المحتوى ونطاقه ضمن العمل المقصود وراجعه للتأكد من دقته قبل دخوله أي سير عمل حيّ.
الأسلوب المتكيف
تساعد أمثلة الأسلوب TQEN على تكييف صياغة الرد مع الحفاظ على الإجابة الأساسية للعمل. تعامل مع الأمثلة كإرشادات تواصل مراجَعة، لا كبديل عن سياسة العمل.
Google Calendar
تتطلب الجدولة تكامل Google Calendar مُعدًا وسير عمل متاحًا. أكّد التقويم المقصود وأبقِ بيانات الاعتماد في الخادم قبل تفعيل الإجراءات. تعرض مساحة العمل العامة رابط الحدث الذي يعيده المحرك فقط؛ وتبقى تفاصيل الحدث في Google Calendar.
البيئة
اضبط إعدادات الموقع العامة بمعزل عن إعدادات المحرك الخاصة بالخادم. لا تكشف بيانات اعتماد الخدمة عبر متغيرات تبدأ ببادئة المتصفح أو شيفرة العميل.
NEXT_PUBLIC_SITE_URL=https://your-domain.com
NEXT_PUBLIC_CONTACT_EMAIL=hello@your-domain.com
NEXUS_BACKEND_URL=http://127.0.0.1:8000
NEXUS_DEVELOPMENT_API_KEY=replace-with-server-only-keyالأمان
تحفظ التجربة العامة مفتاح المحرك في وكيل الخادم وتعرض رسائل خطأ آمنة بدل تفاصيل المزوّد. يجب تقييم ضوابط الوصول للإنتاج والاحتفاظ ومتطلبات النشر لكل ارتباط على حدة.
استكشاف الأخطاء
إذا تعذّر بدء مساحة العمل، تأكد من قدرة الخادم على الوصول إلى محرك الدفق وأن المتغيرات الخاصة بالخادم مُعدّة. إذا توقف الدفق، تحقق من سجلات الخادم الآمنة وتأكد من إصدار المحرك حدث إتمام أو فشل نهائي. لا تُعد محاولة طلب إجراء فاشل تلقائيًا، فقد يؤدي ذلك إلى تكرار إجراء تقويم خارجي.