إعدادات روبوت الدردشة
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 حرف في الخطة المجانية وخلال الفترة التجريبية، وبـ25,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 حرف في الخطة المجانية وخلال الفترة التجريبية، وبـ25,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: تعيد إعدادات روبوت الدردشة المحدّثة (المخطط نفسه كما في استجابة جلب إعدادات روبوت الدردشة).