Chatbot ayarları
Section titled “Chatbot ayarları”Kişilik, konuşma stili ve sistem istemi dahil AI Temsilcinizin tüm yapılandırmasını alın ve güncelleyin.
Davranış ayarları kontrol panelinde Kimlik > AI kişiliği altındadır. Ziyaretçiye gösterilen metinler Kanallar > Web Siteniz > Metin içeriği altındadır. Aşağıdaki alan tablosu her ayarın tam konumunu gösterir.
Chatbot ayarlarını alma
Section titled “Chatbot ayarlarını alma”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()Yanıt 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"]}| Alan | Açıklama |
|---|---|
one_word_description dize | AI Temsilcisinin adı. Kontrol paneli: Kimlik > AI kişiliği > Ad. API en fazla 200 karakter kabul eder; uygulama içi alan 40 karakterle sınırlar. |
short_description dize | Ana istem (sistem istemi). Kontrol paneli: Kimlik > AI kişiliği > Ana istem. API her planda en fazla 25.000 karakter kabul eder; uygulama içi düzenleyici, planınızın 15.000’den başlayan üst sınırını uygular. |
ai_commands dize dizisi | Her dizi öğesinde bir AI davranış yönergesi. Kontrol paneli: Kimlik > AI kişiliği > Yönergeler. En fazla 250 öğe, öğe başına 5.000 ve tüm öğelerde toplam 10.000 karakter. |
personality tamsayı (0–13) | AI kişiliği ön ayarı. Kontrol paneli: Kimlik > AI kişiliği > Kişilik. Aşağıdaki tabloya bakın |
profession dize | AI mesleği/rolü. Kontrol paneli: Kimlik > AI kişiliği > Rol (en fazla 200 karakter). Aşağıdaki tabloya bakın |
creativity_level tamsayı (0–2) | Kontrol paneli: Kimlik > AI kişiliği > Yaratıcılık. 0 = Düşük, 1 = Normal, 2 = Yüksek |
reply_length tamsayı (0–2) | Kontrol paneli: Kimlik > AI kişiliği > Yanıt Uzunluğu. 0 = Kısa, 1 = Normal, 2 = Daha uzun |
greeting dize | Birincil karşılama mesajı (HTML). Kontrol paneli: Kanallar > Web Siteniz > Metin içeriği > Karşılama mesajı (en fazla 1000 karakter). Widget Yapılandırmasındaki welcome_message ile aynı alandır. |
greeting2 dize | İkincil karşılama mesajı (HTML). API üzerinden kullanılabilir; kontrol panelinde düzenleme alanı yoktur. |
header dize | Sohbet başlığı metni. Kontrol paneli: Kanallar > Web Siteniz > Metin içeriği > Başlık metni (en fazla 200 karakter) |
header2 dize | İkincil başlık metni (en fazla 200 karakter). API’de header2 veya Widget Yapılandırmasında subtitle olarak kullanılabilir; kontrol panelinde düzenleme alanı yoktur. |
language_chosen dize | Virgülle ayrılmış dil kodları (örneğin "en,es,de"). Kontrol paneli: Kimlik > AI kişiliği > Diller (toplam en fazla 200 karakter; 30 dil sınırını aşan kodlar atılır) |
Kişilik değerleri:
| Değer | Etiket | Açıklama |
|---|---|---|
| 0 | Klasik | Profesyonellik ve yakınlık arasında dengeli, çok yönlü (varsayılan) |
| 1 | Esprili | Eğlenceli etkileşimler için kelime oyunları ve şakalarla esprili ton |
| 2 | Resmî | İş ortamları için resmî, ciddi ve kısa olgusal bilgiler |
| 3 | Samimi | Kişisel ve yakın bir dokunuşla rahat konuşmalar |
| 4 | İğneleyici | Mizah içeren, kendinden emin ve eğlenceli |
| 5 | Zeki | Kapsamlı anlayış için ayrıntılı ve doğru bilgiler |
| 6 | Empatik | Duygulara önem veren ilgili ve şefkatli etkileşimler |
| 7 | Cesur | Güçlü fikir ve önerileri kendinden emin biçimde sunar |
| 9 | Heyecanlı | Canlı ve enerjik etkileşim |
| 10 | Gizemli | Benzersiz deneyim için gizemli, merak uyandıran yanıtlar |
| 11 | İlham Verici | Koç gibi olumlu düşünmeyi ve hedeflere ulaşmayı destekler |
| 12 | Maceracı | Konfor alanından çıkmayı ve yeni fırsatları keşfetmeyi teşvik eder |
| 13 | Zarif | Benzersiz ve seçkin markalar için sofistike deneyim |
Rol değerleri:
| Değer | Kontrol paneli etiketi | Açıklama |
|---|---|---|
helpful_assistant | Yardımcı asistan | Çok yönlü, çok amaçlı. Çoğu kullanım senaryosu için önerilir |
customer_support_representative | Destek Temsilcisi | Empatik, adım adım çözüm ve sorun giderme sunar |
shopping_assistant | Alışveriş Asistanı | Bağlantılarla proaktif ürün önerileri sunar |
field_expert | Alan Uzmanı | Profesyonel danışman; açıklayıcı sorular sorar, uzman rehberliği sunar |
interviewer | Görüşmeci | Yanıt vermek yerine sorular sorar. Anketler, görüşmeler ve geri bildirim için |
one_word_description, short_description ve ai_commands alanları Bilgi Tabanı Ayarları uç noktasından da kullanılabilir. Bu alanlar ortaktır; her iki uç noktadan yapılan güncellemeler aynı temel verileri değiştirir.
Chatbot ayarlarını güncelleme
Section titled “Chatbot ayarlarını güncelleme”PATCH https://app.quickchat.ai/v1/api/chatbot_settings
İstek gövdesi: tüm alanlar isteğe bağlıdır. Yalnızca güncellemek istediğiniz alanları ekleyin.
| Parametre | Açıklama |
|---|---|
personality tamsayı (0–13) | AI kişiliği ön ayarı |
profession dize | AI mesleği/rolü (en fazla 200 karakter) |
creativity_level tamsayı (0–2) | 0 = Düşük, 1 = Normal, 2 = Yüksek |
greeting dize | Birincil karşılama mesajı (HTML, en fazla 1000 karakter) |
greeting2 dize | İkincil karşılama mesajı |
header dize | Sohbet başlığı metni (en fazla 200 karakter) |
header2 dize | İkincil başlık metni (en fazla 200 karakter) |
language_chosen dize | Virgülle ayrılmış dil kodları (toplam en fazla 200 karakter; 30 dil sınırını aşan kodlar atılır) |
reply_length tamsayı (0–2) | 0 = Kısa, 1 = Normal, 2 = Daha uzun |
one_word_description dize | AI Temsilcisinin adı. API sınırı 200 karakter; uygulama içi alan 40 karakterle sınırlar. |
short_description dize | AI Ana istemi (sistem istemi). API her planda en fazla 25.000 karakter kabul eder; uygulama içi düzenleyici planınızın 15.000’den başlayan üst sınırını uygular. Çok büyük değer 422 döndürür. |
ai_commands dize dizisi | Her dizi öğesinde bir AI Yönergesi. En fazla 250 öğe, öğe başına 5.000 ve tüm öğelerde toplam 10.000 karakter. Çok büyük değer 422 döndürür. |
Her dizi öğesi bir yönergedir ve tam gönderdiğiniz biçimiyle kaydedilir. Noktalı virgül dahil noktalama işaretleri korunur. Bu uç nokta eskiden kaydetmeden önce metninizdeki ; karakterlerini çıkarırdı. Bu sorunu aşmak için noktalı virgülleri kaldırıyor veya değiştiriyorsanız artık bunu yapmanıza gerek yoktur.
Yönergeleri değiştirmemek için ai_commands göndermeyin veya null gönderin. Temizlemek için [] gönderin.
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()Yanıt 200 OK: güncellenmiş chatbot ayarlarını döndürür (Chatbot ayarlarını alma yanıtıyla aynı şema).