مقدمة إلى روبوتات الدردشة بالذكاء الاصطناعي مع OpenAI + WOZTELLGPT Assistant — المصطلحات

مقدمة إلى روبوتات الدردشة بالذكاء الاصطناعي مع OpenAI + WOZTELLGPT Assistant — المصطلحات

مقدمة إلى روبوتات الدردشة بالذكاء الاصطناعي مع OpenAI + WOZTELL

دليل عملي لفهم GPT Assistant v1.3.0 و Responses API والمطالبات وقواعد المعرفة والأدوات والقنوات داخل WOZTELL

يشرح هذا الدليل كيفية عمل روبوتات الدردشة الجديدة بالذكاء الاصطناعي في WOZTELL باستخدام OpenAI وإضافة GPT Assistant v1.3.0.

باستخدام هذه الإضافة، يمكنك إنشاء مساعدين بالذكاء الاصطناعي متصلين بـ OpenAI للرد تلقائيًا عبر قنوات مثل WhatsApp Business و WhatsApp Cloud API و Instagram و Facebook Messenger و Webchat. كما يمكنك استخدام الذكاء الاصطناعي لمساعدة الوكلاء البشريين داخل Inbox في WOZTELL من خلال اقتراحات الردود.

مهم: الانتقال من Assistants API

في السابق، كان WOZTELL يستخدم إعدادات مبنية على Assistants API من OpenAI.

أعلنت OpenAI عن إيقاف Assistants API تدريجيًا، ومن المقرر إيقافها نهائيًا في 26 أغسطس 2026. لذلك، يجب ترحيل الإعدادات القديمة إلى روبوتات الدردشة الجديدة المبنية على Responses API قبل هذا التاريخ.

تستخدم النسخة الجديدة من GPT Assistant في WOZTELL واجهة Responses API، وهي المعيار الذي توصي به OpenAI للتطبيقات الجديدة الخاصة بالمساعدين والوكلاء الحواريين وأدوات الذكاء الاصطناعي.

1. ما هو روبوت الدردشة بالذكاء الاصطناعي في WOZTELL؟

روبوت الدردشة بالذكاء الاصطناعي في WOZTELL هو مساعد متصل بـ OpenAI يمكنه تفسير رسائل المستخدمين، وإنشاء ردود تلقائية، واستخدام أدوات إضافية لتقديم إجابات أفضل.

بحسب الإعدادات، يمكن للمساعد أن يقوم بما يلي:

  • الرد تلقائيًا على العملاء عبر WhatsApp أو Instagram أو Facebook Messenger أو Webchat.
  • الاطلاع على مستندات من قاعدة المعرفة قبل الرد.
  • البحث عن معلومات محدثة على الويب.
  • تنفيذ وظائف خارجية من خلال Function Call.
  • مساعدة الوكلاء البشريين باقتراحات للردود داخل Inbox في WOZTELL.

يساعد ذلك على أتمتة المحادثات المتكررة، وتحسين سرعة الاستجابة، ودعم فريق المبيعات، وتقديم إجابات أكثر اتساقًا عبر جميع القنوات الحوارية.

2. ما هو GPT Assistant v1.3.0؟

GPT Assistant v1.3.0 هو إضافة WOZTELL التي تتيح ربط حساب OpenAI بقنوات WOZTELL الحوارية.

تنقسم الإعدادات الرئيسية إلى ثلاث خطوات أساسية:

  1. API Key Setup: ربط حساب OpenAI باستخدام API Key.
  2. Configuration: إعداد النموذج، والمطالبة، والأدوات، وقاعدة المعرفة، والاقتراحات.
  3. Connect to Channel: ربط المساعد بقناة واحدة أو أكثر من قنوات WOZTELL.

بعد الانتهاء من الإعداد، يمكن تفعيل المساعد على القنوات المتاحة داخل حساب WOZTELL.

3. ما هي واجهة API التي يستخدمها WOZTELL الآن؟

Responses API

تستخدم النسخة الجديدة من GPT Assistant واجهة Responses API من OpenAI.

تُعد Responses API واجهة API التي توصي بها OpenAI للتطبيقات الجديدة الخاصة بمساعدي الذكاء الاصطناعي. تتيح العمل مع النماذج، والتعليمات، والسياق، والأدوات مثل File Search و Web Search و Function Call.

في WOZTELL، تتم إدارة سياق المحادثة بواسطة WOZTELL. وهذا يعني أن WOZTELL يحدد عدد الرسائل السابقة التي يتم إرسالها إلى النموذج بناءً على إعدادات المساعد.

لماذا تعتبر هذه الهجرة مهمة؟

الهجرة مهمة لأن الإعدادات القديمة المبنية على Assistants API لن تكون مدعومة من OpenAI بدءًا من 26 أغسطس 2026.

لذلك، يجب على العملاء الذين ما زالوا يستخدمون الإعدادات السابقة ترحيل مساعدينهم إلى الإعداد الجديد المبني على Responses API.

4. مفاهيم أساسية في OpenAI

API Key

API Key هي بيانات الاعتماد التي تسمح لـ WOZTELL بالاتصال بحساب OpenAI الخاص بالعميل.

بدون API Key صالحة، لا يستطيع WOZTELL إرسال الطلبات إلى النموذج أو تفعيل إعدادات المساعد بشكل صحيح.

Model

Model هو نموذج OpenAI الذي ينشئ ردود المساعد.

يتم جلب قائمة النماذج المتاحة ديناميكيًا من حساب OpenAI المتصل. لذلك، قد لا يرى جميع العملاء نفس النماذج بالضبط.

Token

Token هو وحدة النص التي يعالجها النموذج. قد يكون كلمة، أو جزءًا من كلمة، أو رقمًا، أو مسافة، أو علامة ترقيم.

عادةً ما يتم حساب تكلفة OpenAI بناءً على رموز الإدخال والإخراج.

Input Tokens

هي الرموز التي يتم إرسالها إلى النموذج. وقد تشمل:

  • رسالة المستخدم.
  • تعليمات المساعد.
  • سجل المحادثة.
  • مقاطع مسترجعة من File Search.
  • نتائج Web Search.
  • بيانات يتم إرجاعها من Function Call.

Output Tokens

هي الرموز التي ينشئها النموذج في رده.

Context

Context هو كل المعلومات التي يتم إرسالها إلى النموذج حتى يتمكن من الرد بشكل صحيح.

قد يشمل التعليمات، والرسائل السابقة، ومعلومات قاعدة المعرفة، ونتائج الأدوات، والبيانات الخارجية.

Context Window

Context window هي الحد الأقصى لكمية المعلومات التي يستطيع النموذج معالجتها في طلب واحد.

كلما زاد السياق المرسل، قد تزيد التكلفة، وفي بعض الحالات قد تصبح الاستجابة أبطأ.

5. كيفية اختيار النموذج المناسب

يعتمد اختيار النموذج على حالة الاستخدام، وحجم المحادثات، وتعقيد الردود، والميزانية المتاحة.

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

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

6. كيفية إعداد سلوك المساعد

Instructions / Prompt

Instructions، والمعروفة أيضًا باسم prompt الأساسي أو system prompt، تحدد كيف يجب أن يتصرف المساعد.

يجب أن يتضمن prompt الجيد ما يلي:

  • دور المساعد.
  • نبرة التواصل.
  • الموضوعات التي يمكنه الإجابة عنها.
  • الموضوعات التي يجب أن يتجنبها.
  • المعلومات التي يجب أن يطلبها من المستخدم.
  • قواعد التصعيد إلى إنسان.
  • تنسيق الرد المتوقع.

مثال على prompt أساسي

You are a presales assistant for WOZTELL.

Your goal is to help companies understand how WOZTELL can help them automate conversations across WhatsApp, Instagram, Facebook Messenger, and Webchat.

Be friendly, concise, and professional.

Only answer questions related to WOZTELL, WhatsApp Business Platform, AI chatbots, integrations, automation, and conversational channels.

If the user asks about something unrelated, politely explain that you can only help with WOZTELL-related topics.

Before qualifying the lead, ask for their name, company, website, and main use case.

Negative Constraints

Negative constraints هي قواعد تحدد ما لا يجب على المساعد فعله.

Do not invent prices.
Do not promise implementation timelines unless confirmed.
Do not answer questions outside the scope of WOZTELL.
Do not provide legal, financial or medical advice.
Do not say you are an AI unless the user asks directly.

Human Handover / Escalation

Human Handover أو التصعيد إلى إنسان يحدث عندما يحتاج المساعد إلى نقل المحادثة إلى وكيل بشري.

يوصى بالتصعيد عندما:

  • يطلب المستخدم التحدث مع شخص.
  • توجد أسئلة حول الأسعار.
  • توجد مشكلة فنية.
  • توجد أسئلة حول الفوترة.
  • لا يملك المساعد معلومات كافية.
  • تتطلب المحادثة تحققًا بشريًا.

7. الأدوات المتاحة في GPT Assistant

File Search يسمح للمساعد بالبحث عن معلومات داخل قاعدة معرفة قبل الرد.

يفيد عندما يحتاج المساعد إلى الرد بناءً على وثائق رسمية، أو أسئلة شائعة، أو أدلة المنتج، أو العمليات الداخلية، أو المواد التجارية.

Web Search يسمح للمساعد بالبحث عن معلومات محدثة على الإنترنت.

يوصى باستخدامه عندما تعتمد الإجابة على معلومات قد تتغير، مثل الوثائق الخارجية، أو الأسعار، أو اللوائح، أو الأخبار، أو المعلومات العامة الحديثة.

Domain Filtering

Domain Filtering يسمح بتقييد عمليات البحث على الويب بنطاقات محددة.

مثال صحيح:

woztell.com
support.woztell.com
openai.com

مثال غير صحيح:

https://woztell.com/

Function Call

Function Call يسمح للمساعد باستدعاء وظيفة خارجية لاسترجاع بيانات أو تنفيذ إجراء.

أمثلة على الاستخدام:

  • التحقق من حالة الطلب.
  • التحقق من موعد أو حجز.
  • البحث عن بيانات العميل.
  • إنشاء تذكرة دعم.
  • إرسال معلومات إلى CRM.
  • التحقق من التوفر.

8. قاعدة المعرفة و Vector Stores

Knowledge Base

Knowledge Base هي مجموعة المستندات التي يمكن للمساعد الرجوع إليها للإجابة عن الأسئلة.

قد تشمل:

  • الأسئلة الشائعة.
  • أدلة التثبيت.
  • وثائق المنتج.
  • المواد التجارية.
  • السياسات الداخلية.
  • مواد الدعم.

Vector Store

Vector Store هو الحاوية التقنية التي يتم فيها تخزين المستندات المعالجة حتى يتمكن المساعد من البحث عن المعلومات ذات الصلة.

طريقة مبسطة لفهم ذلك:

  • Knowledge Base: مكتبة المستندات.
  • Vector Store: الحاوية التقنية التي تتم فيها فهرسة المستندات.
  • File Search: الأداة التي تبحث داخل تلك المكتبة.

Retrieval

Retrieval هي العملية التي يسترجع من خلالها المساعد مقاطع ذات صلة من قاعدة المعرفة ويستخدمها كسياق إضافي للرد.

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

  • استخدم مستندات واضحة ومحدثة.
  • احذف المعلومات القديمة.
  • تجنب المستندات المكررة.
  • لا تخلط بين نسخ متناقضة.
  • افصل بين الوثائق التقنية والتجارية ووثائق الدعم عند الحاجة.
  • راجع قاعدة المعرفة بشكل دوري.

9. AI Chatbot مقابل AI Inbox Replies

الميزةما الذي تفعلهمن يستخدمهاهل ترد تلقائيًا؟
AI Chatbotيرد على المستخدمين النهائيين في القنوات المتصلةالمستخدم النهائينعم
AI Inbox Repliesينشئ اقتراحات للرد داخل Inboxالوكيل البشريلا

AI Chatbot

يرد AI Chatbot تلقائيًا على المستخدمين النهائيين عبر قنوات مثل WhatsApp و Instagram و Facebook Messenger و Webchat.

AI Inbox Replies

يساعد AI Inbox Replies الوكلاء البشريين من خلال إنشاء اقتراحات للرد داخل Inbox في WOZTELL. يمكن للوكيل مراجعة الرد وتعديله وإرساله يدويًا.

10. الاتصال بالقنوات

Channel

Channel هي قناة التواصل التي سيرد فيها المساعد على المستخدمين.

القنوات المدعومة:

  • WhatsApp Business
  • WhatsApp Cloud API
  • Instagram
  • Facebook Messenger
  • Webchat

Environment

Environment هو مساحة داخل القناة تتيح الفصل بين الاختبار والتطوير والإنتاج.

إذا لم يتم إنشاء بيئة إضافية، فسيتم استخدام البيئة الافتراضية.

Prefix Name

Prefix Name هو الاسم التعريفي لإعدادات المساعد المرتبطة بقناة أو بيئة محددة.

أمثلة:

AI-CHATBOT-WHATSAPP-PRESALES
AI-CHATBOT-INSTAGRAM-SUPPORT
AI-CHATBOT-WEBCHAT-FAQ
AI-CHATBOT-FACEBOOK-LEADS

Connect

Connect يربط المساعد بالقناة المحددة ويفعّله.

Disconnect

Disconnect يفصل المساعد عن القناة المحددة.

Go Live

Go Live هي اللحظة التي يصبح فيها المساعد نشطًا على قناة حقيقية ويبدأ في الرد على المستخدمين النهائيين.

11. التكاليف والتحكم في الاستخدام

تعتمد تكلفة استخدام OpenAI بشكل أساسي على النموذج، والرموز المعالجة، والأدوات المستخدمة.

العوامل التي قد تزيد التكلفة

  • المطالبات الطويلة جدًا.
  • سجل محادثة كبير جدًا.
  • ردود طويلة جدًا.
  • الاستخدام المتكرر لـ File Search.
  • الاستخدام المتكرر لـ Web Search.
  • النماذج الأكثر تقدمًا.
  • الرسائل الصوتية الطويلة التي تتطلب نسخًا نصيًا.
  • قواعد المعرفة الكبيرة أو غير المنظمة جيدًا.

أفضل ممارسات التحكم في التكلفة

  • استخدم نماذج فعّالة للحالات ذات الحجم الكبير.
  • قلّل عدد الرسائل السابقة المرسلة كسياق.
  • اجعل الردود مختصرة.
  • فعّل Web Search فقط عند الحاجة.
  • حافظ على قاعدة المعرفة نظيفة ومحدثة.
  • صعّد إلى وكيل بشري عندما تكون المحادثة معقدة.
  • راجع السجلات والاستهلاك بشكل دوري.

12. الجودة والدقة ومنع الإجابات المختلقة

Hallucination

Hallucination هي إجابة ينشئها النموذج وقد تبدو صحيحة، لكنها لا تستند إلى معلومات حقيقية أو مؤكدة.

كيفية تقليل hallucinations

  • استخدم تعليمات واضحة.
  • حدد نطاق المساعد.
  • فعّل File Search عند وجود وثائق رسمية.
  • حافظ على تحديث قاعدة المعرفة.
  • اطلب من المساعد عدم اختلاق المعلومات.
  • حدد قواعد واضحة للتصعيد إلى إنسان.
If the answer is not available in the Knowledge Base or confirmed documentation, do not invent it. Ask the user to contact the WOZTELL team or escalate to a human agent.

Grounding

Grounding يعني أن تكون ردود المساعد مبنية على مصادر محددة، مثل مستندات قاعدة المعرفة، أو نتائج Web Search، أو البيانات العائدة من Function Call.

13. السجلات واستكشاف الأخطاء

Logs

Logs هي سجلات تقنية تعرض الأحداث والطلبات والأخطاء التي يتم إنشاؤها أثناء تشغيل المساعد.

تُستخدم لتشخيص المشكلات المتعلقة بـ:

  • API Key.
  • النماذج.
  • المعاملات غير المتوافقة.
  • القنوات.
  • File Search.
  • Web Search.
  • Function Call.
  • أخطاء OpenAI.
الخطأالسبب المحتملالحل الموصى به
API Key غير مقبولةتم نسخ المفتاح بشكل خاطئ، أو تم إلغاؤه، أو أنه غير صالحإنشاء API Key جديدة وحفظها في WOZTELL
النموذج غير متاححساب OpenAI لا يملك صلاحية الوصول إلى النموذجمراجعة الصلاحيات، والمشروع، والفوترة في OpenAI
File Search لا يعمللا توجد ملفات، أو Vector Store غير صحيح، أو الأداة غير مفعّلةرفع الملفات، واختيار Vector Store الصحيح، وتفعيل File Search
الروبوت لا يردالقناة غير متصلة، أو API Key غير صالحة، أو يوجد خطأ في الإعداداتمراجعة القناة، و API Key، والسجلات، وإعدادات المساعد

14. قائمة التحقق قبل تفعيل المساعد

  • API Key صالحة ومحفوظة.
  • تم اختيار النموذج بشكل صحيح.
  • Prompt واضح ومختبر.
  • قواعد التصعيد محددة.
  • Temperature مناسبة.
  • سجل المحادثة محدود.
  • تم إعداد Format كـ Text لروبوتات الدردشة العادية.
  • قاعدة المعرفة محدثة إذا تم استخدام File Search.
  • Web Search محدود بالنطاقات المعتمدة عند الحاجة.
  • تم اختبار Function Call إذا تم استخدام تكامل خارجي.
  • القناة الصحيحة متصلة.
  • Environment الصحيح محدد.
  • Prefix Name واضح.
  • تم الانتهاء من الاختبارات قبل Go Live.
  • تمت مراجعة السجلات بعد أولى المحادثات.

الملخص

تتيح روبوتات الدردشة الجديدة بالذكاء الاصطناعي من WOZTELL، المدعومة بـ OpenAI و Responses API، إنشاء مساعدين أكثر مرونة قادرين على العمل عبر قنوات متعددة واستخدام أدوات مثل File Search و Web Search و Function Call.

تستبدل هذه البنية الجديدة تدريجيًا الإعدادات السابقة المبنية على Assistants API. لذلك، يجب على العملاء الذين لا يزالون يستخدمون مساعدين قدامى الترحيل قبل 26 أغسطس 2026.

إن إعداد النموذج، والـ prompt، وقاعدة المعرفة، والأدوات، والقناة، وقواعد التصعيد بشكل صحيح أمر أساسي لإنشاء مساعد موثوق ومفيد ومتحكم في تكلفته.