يشرح هذا الدليل كيفية ترحيل روبوت دردشة ذكي قائم من GPT Assistant v1.2.0 (المبني على Assistants API من OpenAI) إلى GPT Assistant v1.3.0 (المبني على Responses API من OpenAI) داخل WOZTELL.

وهو موجَّه إلى العملاء الذين لديهم بالفعل روبوت دردشة يعمل على v1.2.0 ويحتاجون إلى إعادة إنشائه على v1.3.0 قبل إيقاف Assistants API.

لماذا يجب أن تقوم بالترحيل

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

ما هذا الترحيل — وما ليس كذلك

النهج الموصى به: الترحيل مع الاختبار.

أنشئ روبوت v1.3.0 الجديد، وتحقّق منه في بيئة اختبار مع مجموعة صغيرة من المختبِرين، ثم انقله إلى الإنتاج فقط عندما تكون واثقًا تمامًا. بهذه الطريقة يستمر عملاؤك في التحدث مع روبوت v1.2.0 المُجرَّب طوال العملية، دون أي انقطاع.

قبل أن تبدأ

تأكّد من توفّر ما يلي:

• إمكانية الوصول إلى إعدادات امتداد v1.2.0 الخاص بك (ستقوم بنسخ الإعدادات منه).
• مفتاح API Key الخاص بـ OpenAI (يمكن إعادة استخدام المفتاح نفسه).
• قناة واحدة على الأقل متصلة بالفعل في WOZTELL (WhatsApp Business Platform / Cloud API أو Instagram أو Facebook Messenger أو Webchat).
• بعض المختبِرين الذين يمكنك استخدام حساباتهم أو أرقام هواتفهم لتجربة الروبوت الجديد بأمان.

أسرع طريقة للترحيل هي فتح إعدادات v1.2.0 في علامة تبويب وامتداد v1.3.0 الجديد في علامة تبويب أخرى، ثم نسخ كل إعداد من واحدة إلى الأخرى.

الخطوة 1 — أبقِ روبوت v1.2.0 نشطًا

لا تفصل روبوت الدردشة الحالي أو تحذفه بعد. فهو يبقى نشطًا ويستمر في الرد على العملاء طوال الوقت الذي تبني فيه الروبوت الجديد وتختبره. لن توقفه إلا في النهاية، أثناء التحويل إلى الإنتاج (الخطوة 6).

الخطوة 2 — أنشئ امتداد v1.3.0 الجديد

ستقوم بإنشاء الروبوت الجديد من الصفر بوصفه امتدادًا منفصلًا.

1. انتقل إلى Marketplace ← + New Extension.
2. ابحث عن بطاقة امتداد ChatGPT (Artificial Intelligence · OpenAI | WOZTELL) وانقر على Learn More.
3. ضمن Extension Version، اختر v1.3.0.
4. أدخل اسمًا فريدًا في Alias (أحرف صغيرة، بدون مسافات)، مثل my-gpt-assistant-v13.
5. انقر على Install، ثم افتح الامتداد الجديد ضمن Installed Extensions.
6. في قسم API Key Setup، الصق مفتاح API Key الخاص بـ OpenAI وانقر على Save. تؤكّد علامة الصح الخضراء أن المفتاح صالح، ويتم عندها فتح قسمَي Configuration و Connect to Channel.

للاطلاع على الإعداد الكامل خطوة بخطوة مع لقطات الشاشة، اتبع الدليل الكامل: How to Create an AI Chatbot with OpenAI in WOZTELL. يركّز دليل الترحيل هذا على الخطوات الخاصة بالانتقال من v1.2.0.

مهم: لا يمكنك إعداد الروبوت أو ربطه بقناة قبل حفظ مفتاح API Key.

الخطوة 3 — انسخ إعداداتك

في v1.2.0، كان سلوك الروبوت بالكامل موجودًا داخل الـ prompt (Instructions). والترحيل في معظمه مجرّد نسخ هذا الـ prompt واختيار النموذج المناسب.

في امتداد v1.3.0 الجديد، افتح Configuration ← AI Chatbot واضبط الـ Instructions (prompt) و Model و Transcription model والإعدادات المتقدّمة.

مهم: احفظ كل علامة تبويب قبل الانتقال إلى أخرى؛ فقد تُفقد التغييرات غير المحفوظة.

فهم القنوات والبيئات

هذا هو المفهوم الذي يجعل الترحيل الآمن ممكنًا، لذا يستحق أن تفهمه قبل أن تربط أي شيء.

• القناة هي قناة التواصل المتصلة بـ WOZTELL — مثل WhatsApp أو Instagram أو Facebook Messenger أو Webchat.
• البيئة هي مساحة عمل داخل القناة تتيح لك الفصل بين الاختبار والإنتاج. وإذا لم تنشئ بيئات إضافية، فإن القناة تستخدم بيئة Default.

أثناء الترحيل، تتيح لك البيئات تشغيل روبوت v1.3.0 الجديد في بيئة اختبار، بينما يبقى روبوت v1.2.0 في البيئة المباشرة (Default/الإنتاج). ويستمر عملاؤك في التحدث مع الروبوت القديم المُجرَّب إلى أن تكون جاهزًا للتحويل.

أبقِ الروبوتين في بيئتين منفصلتين.

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

الخطوة 4 — اربط الروبوت الجديد ببيئة اختبار

اربط الآن الروبوت الجديد — لكن ببيئة اختبار، وليس بالإنتاج.

1. إذا لم تكن لديك بيئة اختبار، فأنشئ واحدة وعيّن المختبِرين لقناتك. راجع: How to create a test environment.
2. في امتداد v1.3.0، افتح قسم Connect to Channel.
3. ابحث عن قناتك واختر بيئة الاختبار التي أنشأتها — وليس بيئة Default/الإنتاج التي يعمل عليها v1.2.0.
4. انقر على Connect.
5. أدخل Prefix Name إذا طُلب منك ذلك؛ استخدم تسمية واضحة مثل AI-CHATBOT-WHATSAPP-TEST.
6. انقر على Confirm ثم انقر على Connect مرة أخرى.

عندما يتغيّر الزر إلى Disconnect، يكون الروبوت الجديد قد أصبح نشطًا في بيئة الاختبار فقط.

الخطوة 5 — الاختبار والتحقّق

الآن يتم توجيه المختبِرين المدرَجين في القائمة البيضاء (whitelist) فقط إلى بيئة الاختبار وإلى روبوت v1.3.0 الجديد. أما الإنتاج — وعملاؤك الحقيقيون — فيبقى على v1.2.0 دون أي تغيير.

اطلب من المختبِرين أن يختبروا الروبوت الجديد اختبارًا شاملًا:

1. من جهاز أو رقم مدرَج في القائمة البيضاء، أرسل رسائل إلى القناة.
2. تأكّد من أن الروبوت يرد، وأن الردود مطابقة لما في Instructions.
3. اختبر أنواعًا مختلفة من الأسئلة والحالات الحدّية (بما في ذلك أسئلة خارج نطاق الروبوت).
4. إذا أضفت Knowledge Base / File Search، فاطرح أسئلة يُفترض أن تُجاب من مستنداتك وتأكّد من أنها تعمل.
5. راجع الـ logs بحثًا عن أي أخطاء (API Key أو النموذج أو tools أو File Search أو مشكلات اتصال القناة).

الخطوة 6 — التحويل إلى الإنتاج

عندما تطمئن إلى الروبوت الجديد، حوّل قناتك المباشرة من v1.2.0 إلى v1.3.0.

1. افصل روبوت v1.2.0 عن قناة/بيئة الإنتاج (Default).
2. اربط روبوت v1.3.0 ببيئة الإنتاج تلك (الخطوات نفسها كما في الخطوة 4، لكن مع اختيار بيئة الإنتاج هذه المرة).
3. أرسل اختبارًا مباشرًا أخيرًا للتأكّد من أن الروبوت الجديد يرد في الإنتاج.

مهم: افصل v1.2.0 أولًا، ثم اربط v1.3.0، حتى لا يكون الاثنان نشطين في البيئة نفسها في الوقت نفسه أبدًا.

بعد أن تتأكّد من أن v1.3.0 يعمل في الإنتاج، يمكنك حذف امتداد v1.2.0 القديم بأمان.

مشكلات معروفة أثناء الترحيل

مقالات ذات صلة

• How to Create an AI Chatbot with OpenAI in WOZTELL | User Guide
• How to create a new environment
• Introduction to AI Chatbots with OpenAI + WOZTELL
• 14 Frequently Asked Questions About the New AI Chatbots with OpenAI + WOZTELL