הגדרות צ’אטבוט
Section titled “הגדרות צ’אטבוט”קבלו ועדכנו את ההגדרות המלאות של הסוכן, כולל אישיות, סגנון שיחה ופרומפט מערכת.
הגדרות ההתנהגות נמצאות בלוח הבקרה תחת זהות > אישיות 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 > שם. ה-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). בלוח הבקרה: ערוצים > האתר שלך > תוכן טקסט > הודעת פתיחה (עד 1,000 תווים). זהו אותו שדה כמו welcome_message בהגדרות הווידג’ט. |
greeting2 מחרוזת | הודעת פתיחה משנית (HTML). זמינה ב-API; אין שדה עריכה בלוח הבקרה. |
header מחרוזת | טקסט כותרת הצ’אט. בלוח הבקרה: ערוצים > האתר שלך > תוכן טקסט > טקסט כותרת (עד 200 תווים) |
header2 מחרוזת | טקסט כותרת משנית (עד 200 תווים). זמין ב-API כ-header2 או כ-subtitle בהגדרות הווידג’ט; אין שדה עריכה בלוח הבקרה. |
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, עד 1,000 תווים) |
greeting2 מחרוזת | הודעת פתיחה משנית |
header מחרוזת | טקסט כותרת הצ’אט (עד 200 תווים) |
header2 מחרוזת | טקסט כותרת משנית (עד 200 תווים) |
language_chosen מחרוזת | קודי שפה מופרדים בפסיקים (עד 200 תווים; קודים מעבר למגבלת 30 השפות מושמטים) |
reply_length מספר שלם (0–2) | 0 = קצר, 1 = רגיל, 2 = ארוך יותר |
one_word_description מחרוזת | שם הסוכן. עד 200 תווים ב-API; עד 40 באפליקציה. |
short_description מחרוזת | פרומפט ראשי (פרומפט מערכת). עד 25,000 תווים ב-API בכל תוכנית; העורך מגביל לפי התוכנית, החל מ-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: מחזירה הגדרות מעודכנות באותה סכימה של קבלת הגדרות צ’אטבוט.