Asistanı güncelle
Asistanlar
Asistanı güncelle
Mevcut bir AI asistanının yapılandırmasını güncelleyin
PUT
Asistanı güncelle
Bu endpoint, mevcut bir AI asistanının yapılandırmasını güncellemenize olanak tanır. Tüm alanlar isteğe bağlıdır - yalnızca güncellemek istediğiniz alanları sağlayın.
Yol Parametreleri
Güncellenecek asistanın benzersiz tanımlayıcısı
İstek Gövdesi
Temel Alanlar
Asistanın adı (maks. 255 karakter)
Asistan için kullanılacak ses ID’si. Motor modunuz ile uyumlu sesleri almak için
mode parametresi ile Get Voices endpoint’ini kullanın.Asistanın dil ID’si. Mevcut dilleri almak için Get Languages endpoint’ini kullanın.
Asistan türü. Seçenekler:
inbound, outboundMotor modu. Seçenekler:
pipeline, multimodal, dualplexAsistanın saat dilimi (ör. “Europe/Bucharest”, “America/New_York”)
Arama başladığında asistanın söyleyeceği ilk mesaj (maks. 200 karakter)
Asistanın davranışını ve kişiliğini tanımlayan sistem istemi
Moda Özel Alanlar
Kullanılacak LLM model ID’si. Yalnızca
pipeline modu için geçerlidir.Mevcut modelleri almak için Get Models endpoint’ini kullanın.Multimodal model ID’si. Yalnızca
multimodal ve dualplex modları için geçerlidir.Mevcut multimodal modelleri almak için Get Models endpoint’ini kullanın.Multimodal/dualplex modlarında araç çağrıları için yedek LLM model ID’si. Kaldırmak için
null olarak ayarlayın.Multimodal/dualplex modları için konuşma sırası algılama hassasiyeti (0-1). Otomatik için
null olarak ayarlayın.İkincil Diller
Asistanın konuşabileceği ek dil ID’lerinin dizisi. Mevcut ikincil dilleri değiştirir. Tüm ikincil dilleri kaldırmak için boş bir dizi
[] gönderin.Bilgi Bankası Ayarları
Eklenecek bilgi bankası ID’si. Bilgi bankasını kaldırmak için
null olarak ayarlayın.Bilgi bankasının nasıl kullanılacağı. Seçenekler:
function_call- AI arama yapmak için bir fonksiyon çağırır (multimodal/dualplex için zorunlu)prompt- Bilgi isteme enjekte edilir (yalnızca pipeline)
Telefon Numarası
Atanacak telefon numarasının ID’si. Atamayı kaldırmak için
null olarak ayarlayın. Hesabınıza ait olmalıdır.Özel Görüşme İçi Araçlar
Senkronize edilecek özel görüşme içi araç ID’lerinin dizisi. Mevcut tüm araç atamalarını değiştirir. Tüm araçları kaldırmak için boş bir dizi
[] gönderin. Her araç hesabınıza ait olmalıdır.Yerleşik Araçlar
Yerleşik araçların dizisi. Mevcut tüm yerleşik araçları değiştirir. Tüm araçları kaldırmak için boş bir dizi
[] gönderin.Ses ve TTS Ayarları
Duygusal metin-konuşma sentezinin etkinleştirilip etkinleştirilmeyeceği
Ses kararlılık ayarı (0-1). Yüksek = daha tutarlı ses
Ses benzerlik ayarı (0-1). Yüksek = orijinal sese daha yakın
Konuşma hızı çarpanı (0.7-1.2)
LLM sıcaklık ayarı (0-1). Düşük = daha belirleyici
Özel TTS sağlayıcı ID’si. Dil varsayılanını kullanmak için
null olarak ayarlayın. Mevcut sağlayıcıları keşfetmek için Get Synthesizer Providers endpoint’ini kullanın.Özel STT sağlayıcı ID’si. Yalnızca pipeline modu. Dil varsayılanını kullanmak için
null olarak ayarlayın. Mevcut sağlayıcıları keşfetmek için Get Transcriber Providers endpoint’ini kullanın.Arama Davranış Ayarları
Arayan kişinin sözünü kesmesine izin verilip verilmeyeceği.
İşleme sırasında dolgu sesi kullanılıp kullanılmayacağı.
Kategoriye göre özel dolgu kelime profilleri. Mevcut dolgu yapılandırmasını değiştirir. Her kategori kısa ifadelerden oluşan bir dizidir.
positive: Olumlu/onaylayıcı yanıtlar için dolgu kelimelerinegative: Olumsuz/nötr yanıtlar için dolgu kelimeleriquestion: Bir soru işlenirken kullanılan dolgu kelimelerineutral: Nötr onay için dolgu kelimeleri
Aramanın kaydedilip kaydedilmeyeceği
Gürültü engellemenin etkinleştirilip etkinleştirilmeyeceği
Doğru ise, asistan müşterinin önce konuşmasını bekler
Zamanlama Ayarları
Saniye cinsinden maksimum arama süresi (20-1200)
Yeniden etkileşimden önce saniye cinsinden maksimum sessizlik süresi (1-360)
Aramayı sonlandırmadan önce arama başlangıcındaki maksimum sessizlik (1-120 saniye). Devre dışı bırakmak için
null olarak ayarlayın.Vazgeçmeden önce maksimum çalma süresi (1-60 saniye)
Yeniden Etkileşim Ayarları
Saniye cinsinden yeniden etkileşim aralığı (7-600)
Yeniden etkileşim mesajları için özel istem (maks. 1000 karakter). Varsayılanı kullanmak için
null olarak ayarlayın.Sesli Mesaj Ayarları
Sesli mesaj algılandığında aramanın sonlandırılıp sonlandırılmayacağı
Kapatmadan önce sesli mesaja bırakılacak mesaj (maks. 1000 karakter). Devre dışı bırakmak için
null olarak ayarlayın.Uç Nokta Algılama
Ses aktivite algılama türü. Seçenekler:
vad, aiUç nokta hassasiyet seviyesi (0-5)
Kesinti hassasiyet seviyesi (0-5)
Kesintiye izin verilmeden önce minimum kelime sayısı (0-10). Devre dışı bırakmak için
null olarak ayarlayın.Ortam Sesi
Arka plan ortam sesi. Seçenekler:
off, office, city, forest, crowded_room, cafe, natureOrtam sesi ses seviyesi (0-1)
Webhook Yapılandırması
Webhook bildirimlerinin etkin olup olmadığı
Arama sonrası bildirimler için webhook URL’si. Kaldırmak için
null olarak ayarlayın.Webhook’ların yalnızca tamamlanan aramalarda gönderilip gönderilmeyeceği (başarısız/cevaplanmayan aramalar hariç)
Webhook yüküne kayıt URL’sinin dahil edilip edilmeyeceği
Arama Sonrası Değerlendirme
AI arama sonrası değerlendirmenin etkinleştirilip etkinleştirilmeyeceği
Arama sonrası veri çıkarma için şema tanımı. Mevcut şemayı değiştirir.
Değişkenler
Özel değişkenlerin anahtar-değer çiftleri. Mevcut tüm değişkenleri değiştirir.
Görüşme Sona Erme Ayarları
Görüşmenin sona ermiş sayılmasından önceki sohbet hareketsizlik süresi (dakika) (1-1440). Devre dışı bırakmak için
null olarak ayarlayın. Varsayılan: 30Hareketsizlik nedeniyle sona erdikten sonra görüşmenin yeniden tetiklenmesine izin verilip verilmeyeceği
Sohbet görüşmesi hareketsizlik nedeniyle sona erdiğinde çağrılan webhook URL’si. Kaldırmak için
null olarak ayarlayın. Ana arama webhook’undan bağımsızdır.Örnek İstekler
Temel Ayarları Güncelle
Multimodal Moda Geç
Araçları ve Bilgi Bankasını Güncelle
Yeniden Etkileşim ve Sesli Mesajı Güncelle
İsteğe Bağlı Ayarları Kaldır
Yanıt
Asistan güncellemesini onaylayan başarı mesajı
Notlar
- Yalnızca istek gövdesinde sağladığınız alanlar güncellenecektir
- İsteğe bağlı alanları kaldırmak için açıkça
nullolarak ayarlayın - Dizileri temizlemek (araçlar, ikincil diller) için boş bir dizi
[]gönderin - Asistan, kimlik doğrulaması yapılmış kullanıcıya ait olmalıdır
- Uyumlu sesleri almak için
modeparametresi ile Get Voices endpoint’ini kullanın - Multimodal/dualplex modları için
knowledgebase_modedeğerifunction_callolmalıdır - Multimodal/dualplex modları için
allow_interruptionsdevre dışı bırakılamaz - Modun değiştirilmesi moda özel ayarları sıfırlar (LLM modeli, multimodal model, sağlayıcılar)

