Chatbot Settings
Dział zatytułowany „Chatbot Settings”Pobieraj i aktualizuj pełną konfigurację swojego AI Agenta, w tym osobowość, styl rozmowy i system prompt.
Ustawienia zachowania znajdziesz w panelu w Tożsamość > Persona AI. Teksty widoczne dla odwiedzających znajdują się w Kanały > Twoja strona > Treść tekstowa. Poniższa tabela wskazuje dokładne położenie każdego ustawienia.
Get Chatbot Settings
Dział zatytułowany „Get Chatbot Settings”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()Response 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"]}| Field | Description |
|---|---|
one_word_description string | Nazwa AI Agenta. Panel: Tożsamość > Persona AI > Nazwa. API akceptuje do 200 znaków; pole w aplikacji ogranicza nazwę do 40. |
short_description string | Główny prompt (system prompt). Panel: Tożsamość > Persona AI > Główny prompt. API akceptuje do 25 000 znaków w każdym planie; edytor w aplikacji ogranicza wartość do limitu Twojego planu, który zaczyna się od 15 000. |
ai_commands array of strings | Wytyczne dotyczące zachowania AI, jedna wytyczna na element tablicy. Panel: Tożsamość > Persona AI > Wytyczne. Maksymalnie 250 elementów, 5 000 znaków na element i 10 000 znaków łącznie dla wszystkich elementów. |
personality integer (0–13) | Preset osobowości AI. Panel: Tożsamość > Persona AI > Osobowość. Zobacz tabelę poniżej |
profession string | Profesja/rola AI. Panel: Tożsamość > Persona AI > Zawód (maks. 200 znaków). Zobacz tabelę poniżej |
creativity_level integer (0–2) | Panel: Tożsamość > Persona AI > Kreatywność. 0 = Niska, 1 = Normalna, 2 = Wysoka |
reply_length integer (0–2) | Panel: Tożsamość > Persona AI > Długość Odpowiedzi. 0 = Krótka, 1 = Normalna, 2 = Dłuższa |
greeting string | Główna wiadomość powitalna (HTML). Panel: Kanały > Twoja strona > Treść tekstowa > Wiadomość powitalna (maks. 1000 znaków). To samo pole co welcome_message w Widget Configuration. |
greeting2 string | Dodatkowa wiadomość powitalna (HTML). Dostępna przez API; w panelu nie ma pola do jej edycji. |
header string | Tekst nagłówka czatu. Panel: Kanały > Twoja strona > Treść tekstowa > Tekst nagłówka (maks. 200 znaków) |
header2 string | Dodatkowy tekst nagłówka (maks. 200 znaków). Dostępny przez API jako header2 lub jako subtitle w Widget Configuration; w panelu nie ma pola do jego edycji. |
language_chosen string | Kody języków oddzielone przecinkami (np. "en,es,de"). Panel: Tożsamość > Persona AI > Języki (maks. 200 znaków łącznie; kody przekraczające limit 30 języków są pomijane) |
Wartości Personality:
| Value | Label | Description |
|---|---|---|
| 0 | Classic | Wszechstronna, zrównoważona między profesjonalizmem a przystępnością (domyślna) |
| 1 | Humorous | Dowcipny ton z grą słów i żartami dla zabawnych interakcji |
| 2 | Formal | Formalny i poważny, zwięzłe rzeczowe informacje dla zastosowań biznesowych |
| 3 | Friendly | Swobodne rozmowy z osobistym, przystępnym charakterem |
| 4 | Sassy | Pewny siebie i przekorny, z humorem |
| 5 | Intelligent | Szczegółowe, dokładne informacje dla pełnego zrozumienia |
| 6 | Empathetic | Troskliwe, pełne współczucia interakcje, okazujące zainteresowanie uczuciami |
| 7 | Bold | Zdecydowane opinie i rekomendacje wyrażane z pewnością |
| 9 | Excited | Żywe i energiczne zaangażowanie |
| 10 | Mysterious | Tajemnicze, intrygujące odpowiedzi dla wyjątkowego doświadczenia |
| 11 | Inspiring | Promuje pozytywne myślenie i osiąganie celów w stylu coacha |
| 12 | Adventurous | Zachęca do wychodzenia ze strefy komfortu i poznawania nowych możliwości |
| 13 | Elegant | Wyrafinowane doświadczenie dla wyjątkowych i wykwintnych marek |
Wartości Profession:
| Value | Dashboard Label | Description |
|---|---|---|
helpful_assistant | Helpful Assistant | Wszechstronny, wielozadaniowy. Zalecany dla większości zastosowań |
customer_support_representative | Support Agent | Empatyczny, dostarcza rozwiązania krok po kroku i pomaga w diagnostyce |
shopping_assistant | Shopping Assistant | Proaktywnie oferuje rekomendacje produktów z linkami |
field_expert | Field Expert | Profesjonalny konsultant, zadaje pytania doprecyzowujące, udziela eksperckich wskazówek |
interviewer | Interviewer | Zadaje pytania zamiast udzielać odpowiedzi. Do ankiet, wywiadów, zbierania opinii |
Pola one_word_description, short_description i ai_commands są również dostępne przez endpoint Knowledge Base Settings. Te pola są współdzielone — aktualizacja przez którykolwiek z endpointów modyfikuje te same dane.
Update Chatbot Settings
Dział zatytułowany „Update Chatbot Settings”PATCH https://app.quickchat.ai/v1/api/chatbot_settings
Request Body — Wszystkie pola są opcjonalne. Dołącz tylko te pola, które chcesz zaktualizować.
| Parameter | Description |
|---|---|
personality integer (0–13) | Preset osobowości AI |
profession string | Profesja/rola AI (maks. 200 znaków) |
creativity_level integer (0–2) | 0 = Niska, 1 = Normalna, 2 = Wysoka |
greeting string | Główna wiadomość powitalna (HTML, maks. 1000 znaków) |
greeting2 string | Dodatkowa wiadomość powitalna |
header string | Tekst nagłówka czatu (maks. 200 znaków) |
header2 string | Dodatkowy tekst nagłówka (maks. 200 znaków) |
language_chosen string | Kody języków oddzielone przecinkami (maks. 200 znaków łącznie; kody przekraczające limit 30 języków są pomijane) |
reply_length integer (0–2) | 0 = Krótka, 1 = Normalna, 2 = Dłuższa |
one_word_description string | Nazwa AI Agenta. Limit API to 200 znaków; pole w aplikacji ogranicza nazwę do 40. |
short_description string | System prompt / Główny prompt AI Agenta. API akceptuje do 25 000 znaków w każdym planie; edytor w aplikacji ogranicza wartość do limitu Twojego planu, który zaczyna się od 15 000. Zbyt długa wartość zwraca 422. |
ai_commands array of strings | AI Guidelines, jedna wytyczna na element tablicy. Maksymalnie 250 elementów, 5 000 znaków na element i 10 000 znaków łącznie dla wszystkich elementów. Zbyt długa wartość zwraca 422. |
Każdy element tablicy to jedna wytyczna, zapisywana dokładnie w takiej postaci, w jakiej ją wyślesz. Interpunkcja jest zachowywana, łącznie ze średnikami. Wcześniej ten endpoint usuwał ; z tekstu przed zapisem. Jeśli z tego powodu pomijasz lub zastępujesz średniki, nie jest to już potrzebne.
Pomiń ai_commands lub wyślij null, aby pozostawić wytyczne bez zmian. Wyślij [], aby je usunąć.
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()Response 200 OK — Zwraca zaktualizowane ustawienia chatbota (ten sam schemat co odpowiedź Get Chatbot Settings).