إعدادات روبوت الدردشة
Section titled “إعدادات روبوت الدردشة”اجلب الإعداد الكامل لوكيل AI وحدّثه، بما فيه الشخصية وأسلوب المحادثة وتعليمات النظام.
توجد إعدادات السلوك في الهوية > شخصية AI بلوحة التحكم. ويوجد النص الموجه للزائر في القنوات > موقعك الإلكتروني > المحتوى النصي. يوضح جدول الحقول أدناه الموقع الدقيق لكل إعداد.
جلب إعدادات روبوت الدردشة
Section titled “جلب إعدادات روبوت الدردشة”GET https://app.quickchat.ai/v1/api/chatbot_settings
curl https://app.quickchat.ai/v1/api/chatbot_settings \ -H 'Authorization: Bearer <API_TOKEN>'import requests
response = requests.get( url="https://app.quickchat.ai/v1/api/chatbot_settings", headers={"Authorization": "Bearer <API_TOKEN>"},)data = response.json()الاستجابة 200 OK
{ "personality": 0, "profession": "helpful_assistant", "creativity_level": 1, "greeting": "<p>Hello! How can I help you today?</p>", "greeting2": "", "header": "Support Assistant", "header2": "", "language_chosen": "en", "reply_length": 1, "one_word_description": "Support Agent", "short_description": "A helpful customer support assistant.", "ai_commands": ["Be polite", "Stay on topic"]}| الحقل | الوصف |
|---|---|
one_word_description سلسلة نصية | اسم وكيل AI. لوحة التحكم: الهوية > شخصية AI > الاسم. تقبل API حتى 200 حرف؛ يحد حقل التطبيق الاسم بـ 40 حرفًا. |
short_description سلسلة نصية | التعليمات الرئيسية (تعليمات النظام). لوحة التحكم: الهوية > شخصية AI > التعليمات الرئيسية. تقبل API حتى 25,000 حرف في كل خطة؛ يحد محرر التطبيق النص بسقف خطتك الذي يبدأ من 15,000. |
ai_commands مصفوفة سلاسل نصية | إرشادات سلوك AI، إرشاد لكل عنصر. لوحة التحكم: الهوية > شخصية AI > الإرشادات. حتى 250 عنصرًا و5,000 حرف لكل عنصر و10,000 حرف عبر كل العناصر. |
personality عدد صحيح (0–13) | إعداد شخصية AI الجاهز. لوحة التحكم: الهوية > شخصية AI > الشخصية. راجع الجدول أدناه |
profession سلسلة نصية | مهنة أو دور AI. لوحة التحكم: الهوية > شخصية AI > المهنة (200 حرف كحد أقصى). راجع الجدول أدناه |
creativity_level عدد صحيح (0–2) | لوحة التحكم: الهوية > شخصية AI > الإبداع. 0 = منخفضة، 1 = عادي، 2 = عالية |
reply_length عدد صحيح (0–2) | لوحة التحكم: الهوية > شخصية AI > طول الرد. 0 = قصير، 1 = عادي، 2 = أطول |
greeting سلسلة نصية | رسالة الترحيب الرئيسية (HTML). لوحة التحكم: القنوات > موقعك الإلكتروني > المحتوى النصي > رسالة الترحيب (1000 حرف كحد أقصى). الحقل نفسه مثل welcome_message في إعداد Widget. |
greeting2 سلسلة نصية | رسالة الترحيب الثانوية (HTML). متاحة عبر API؛ لا يوجد حقل لتحريرها في لوحة التحكم. |
header سلسلة نصية | نص ترويسة الدردشة. لوحة التحكم: القنوات > موقعك الإلكتروني > المحتوى النصي > نص الترويسة (200 حرف كحد أقصى) |
header2 سلسلة نصية | نص الترويسة الثانوية (200 حرف كحد أقصى). متاح عبر API باسم header2 أو subtitle في إعداد Widget؛ لا يوجد حقل لتحريره في لوحة التحكم. |
language_chosen سلسلة نصية | رموز لغات مفصولة بفواصل (مثل "en,es,de"). لوحة التحكم: الهوية > شخصية AI > اللغات (200 حرف إجمالًا كحد أقصى؛ تُسقط الرموز التي تتجاوز حد 30 لغة) |
قيم الشخصية:
| القيمة | التسمية | الوصف |
|---|---|---|
| 0 | كلاسيكي | متكامل ومتوازن بين المهنية وسهولة التواصل (الافتراضي) |
| 1 | مرح | نبرة طريفة مع تلاعب بالألفاظ ونكات لتفاعلات مسلية |
| 2 | رسمي | رسمي وجاد، يقدم معلومات واقعية موجزة لبيئات العمل |
| 3 | ودود | محادثات غير رسمية بلمسة شخصية يسهل التواصل معها |
| 4 | مشاكس | واثق ومرح مع حس فكاهي |
| 5 | ذكي | معلومات مفصلة ودقيقة لفهم شامل |
| 6 | متعاطف | تفاعلات حانية ومتعاطفة تراعي المشاعر |
| 7 | جريء | آراء وتوصيات قوية تُقدم بثقة |
| 9 | متحمس | تفاعل حيوي ومفعم بالطاقة |
| 10 | غامض | ردود ملغزة ومثيرة للاهتمام لتجربة فريدة |
| 11 | ملهم | يشجع التفكير الإيجابي وتحقيق الأهداف بأسلوب المدرب |
| 12 | مغامر | يشجع الخروج من منطقة الراحة واستكشاف الفرص الجديدة |
| 13 | أنيق | تجربة راقية للعلامات الفريدة والمميزة |
قيم المهنة:
| القيمة | التسمية في لوحة التحكم | الوصف |
|---|---|---|
helpful_assistant | مساعد متعاون | مرن ومتعدد الأغراض. موصى به لمعظم حالات الاستخدام |
customer_support_representative | وكيل دعم | متعاطف، يقدم حلولًا خطوة بخطوة واستكشافًا للمشكلات |
shopping_assistant | مساعد تسوق | يقترح المنتجات استباقيًا مع روابط |
field_expert | خبير متخصص | مستشار مهني، يطرح أسئلة توضيحية ويقدم إرشادًا متخصصًا |
interviewer | محاور | يطرح أسئلة بدلًا من تقديم إجابات. للاستبيانات والمقابلات والملاحظات |
تتوفر الحقول one_word_description وshort_description وai_commands أيضًا عبر نقطة إعدادات قاعدة المعرفة. الحقول مشتركة؛ يغير التحديث عبر أي نقطة البيانات الأساسية نفسها.
تحديث إعدادات روبوت الدردشة
Section titled “تحديث إعدادات روبوت الدردشة”PATCH https://app.quickchat.ai/v1/api/chatbot_settings
جسم الطلب: كل الحقول اختيارية. أدرج فقط ما تريد تحديثه.
| المعلمة | الوصف |
|---|---|
personality عدد صحيح (0–13) | إعداد شخصية AI الجاهز |
profession سلسلة نصية | مهنة أو دور AI (200 حرف كحد أقصى) |
creativity_level عدد صحيح (0–2) | 0 = منخفضة، 1 = عادي، 2 = عالية |
greeting سلسلة نصية | رسالة الترحيب الرئيسية (HTML، حتى 1000 حرف) |
greeting2 سلسلة نصية | رسالة الترحيب الثانوية |
header سلسلة نصية | نص ترويسة الدردشة (200 حرف كحد أقصى) |
header2 سلسلة نصية | نص الترويسة الثانوية (200 حرف كحد أقصى) |
language_chosen سلسلة نصية | رموز لغات مفصولة بفواصل (200 حرف إجمالًا كحد أقصى؛ تُسقط الرموز التي تتجاوز حد 30 لغة) |
reply_length عدد صحيح (0–2) | 0 = قصير، 1 = عادي، 2 = أطول |
one_word_description سلسلة نصية | اسم وكيل AI. حد API هو 200 حرف؛ يحد حقل التطبيق الاسم بـ 40. |
short_description سلسلة نصية | التعليمات الرئيسية لـ AI (تعليمات النظام). تقبل API حتى 25,000 حرف في كل خطة؛ يحد محرر التطبيق النص بسقف خطتك الذي يبدأ من 15,000. تعيد القيمة المتجاوزة 422. |
ai_commands مصفوفة سلاسل نصية | إرشادات AI، إرشاد لكل عنصر. حتى 250 عنصرًا و5,000 حرف لكل عنصر و10,000 حرف عبر كل العناصر. تعيد القيمة المتجاوزة 422. |
كل عنصر في المصفوفة إرشاد واحد يُحفظ كما ترسله تمامًا. تُحفظ علامات الترقيم بما فيها الفواصل المنقوطة. كانت هذه النقطة تحذف ; من النص قبل حفظه؛ إذا كنت تحذفها أو تستبدلها للتحايل على ذلك، لم تعد بحاجة إلى هذا.
احذف ai_commands أو أرسل null لترك الإرشادات كما هي. أرسل [] لمسحها.
curl -X PATCH https://app.quickchat.ai/v1/api/chatbot_settings \ -H 'Authorization: Bearer <API_TOKEN>' \ -H 'Content-Type: application/json' \ -d '{ "greeting": "<p>Welcome! Ask me anything.</p>", "creativity_level": 2}'import requests
response = requests.patch( url="https://app.quickchat.ai/v1/api/chatbot_settings", headers={"Authorization": "Bearer <API_TOKEN>"}, json={ "greeting": "<p>Welcome! Ask me anything.</p>", "creativity_level": 2, },)data = response.json()الاستجابة 200 OK: تعيد إعدادات روبوت الدردشة المحدّثة (المخطط نفسه كما في استجابة جلب إعدادات روبوت الدردشة).