Asistan oluştur
Asistanlar
Asistan oluştur
Belirtilen yapılandırma ile yeni bir AI asistanı oluşturun
POST
Asistan oluştur
Bu endpoint, kapsamlı yapılandırma seçenekleriyle yeni bir AI asistanı oluşturmanıza olanak tanır.
Motor Modları
API, her biri farklı yeteneklere sahip üç motor modunu destekler:| Mod | Açıklama | Zorunlu Alanlar |
|---|---|---|
pipeline | Geleneksel STT → LLM → TTS işlem hattı | llm_model_id |
multimodal | Gerçek zamanlı multimodal AI | multimodal_model_id |
dualplex | Multimodal beyin + özel TTS sesi | multimodal_model_id |
İstek Gövdesi
Temel Zorunlu Alanlar
Asistanın adı (maks. 255 karakter)
Asistan için kullanılacak ses ID’si. Motor modunuzla uyumlu sesleri almak için
mode parametresiyle Sesleri Getir uç noktasını kullanın.Asistan için dil ID’si. Mevcut dilleri almak için Dilleri Getir uç noktasını kullanın.
Asistan türü. Seçenekler:
inbound, outboundMotor modu. Seçenekler:
pipeline, multimodal, dualplexAsistan için 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.
pipeline modu için zorunludur.Mevcut modelleri almak için Modelleri Getir uç noktasını kullanın.Multimodal model ID’si.
multimodal ve dualplex modları için zorunludur.Mevcut multimodal modelleri almak için Modelleri Getir uç noktasını kullanın.Multimodal/dualplex modlarında araç çağrıları için yedek LLM model ID’si. İsteğe bağlı.
Multimodal/dualplex modları için konuşma sırası algılama hassasiyeti (0-1). Varsayılan: otomatik
İkincil Diller
Asistanın konuşabileceği ek dil ID’lerinin dizisi. Asistan dilleri otomatik olarak algılar ve geçiş yapar.
Bilgi Bankası Ayarları
Bu asistana eklenecek bilgi bankası ID’si
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ı
Asistana atanacak telefon numarasının ID’si. Hesabınıza ait olmalıdır.
Özel Görüşme İçi Araçlar
Eklenecek özel görüşme içi araç ID’lerinin dizisi. Her araç hesabınıza ait olmalıdır.
Yerleşik Araçlar
Etkinleştirilecek yerleşik araçların dizisi. Her aracın bir
type değeri ve araca özel alanları vardır.Ses ve TTS Ayarları
Duygusal metin-konuşma sentezinin etkinleştirilip etkinleştirilmeyeceği
Ses kararlılığı ayarı (0-1). Yüksek = daha tutarlı ses
Ses benzerliği 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. Belirtilmezse dile göre otomatik seçilir. Mevcut sağlayıcıları keşfetmek için Sentezleyici Sağlayıcıları Getir uç noktasını kullanın.
Özel STT sağlayıcı ID’si. Belirtilmezse dile göre otomatik seçilir. Yalnızca pipeline modu. Mevcut sağlayıcıları keşfetmek için Yazıya Dökücü Sağlayıcıları Getir uç noktasını kullanın.
Arama Davranış Ayarları
Arayan kişinin sözünü kesmesine izin verilip verilmeyeceği.
İşleme sırasında dolgu seslerinin kullanılıp kullanılmayacağı (ör. “hmm”, “bir kontrol edeyim”).
Kategori bazında özel dolgu kelime profilleri. Belirtilmezse, asistanın diline göre varsayılanlar ayarlanır. Her kategori kısa ifadelerden oluşan bir dizidir.
positive: Olumlu/onaylayıcı yanıtlar için dolgu kelimeleri (ör. “Harika!”, “Mükemmel!”)negative: Olumsuz/nötr yanıtlar için dolgu kelimeleri (ör. “Hmm.”, “Mhm.”)question: Bir soru işlenirken dolgu kelimeleri (ör. “Hmm.”, “Bir düşüneyim.”)neutral: Nötr onaylar için dolgu kelimeleri (ör. “Tamam.”, “Anlıyorum.”)
Aramanın kaydedilip kaydedilmeyeceği
Gürültü engellemenin etkinleştirilip etkinleştirilmeyeceği
true ise asistan müşterinin önce konuşmasını bekler
Zamanlama Ayarları
Saniye cinsinden maksimum arama süresi (20-1200)
Yeniden etkileşim öncesi saniye cinsinden maksimum sessizlik süresi (1-360)
Arama başlangıcında sonlandırma öncesi maksimum sessizlik süresi (1-120 saniye). İsteğe bağlı.
Vazgeçme öncesi 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)Örnek:
"Hâlâ orada mısınız? Başka sorularınız var mı?"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)
Uç Nokta Algılama
Ses etkinliği algılama türü. Seçenekler:
vad, aiUç nokta hassasiyet seviyesi (0-5)
Söz kesme hassasiyet seviyesi (0-5)
Söz kesmeye izin verilmeden önceki minimum kelime sayısı (0-10). Etkinleştirmek için 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.
is_webhook_active değeri true ise zorunludur.Webhook’ların yalnızca tamamlanan aramalarda gönderilip gönderilmeyeceği (başarısız/cevapsız aramalar hariç)
Webhook yüküne kayıt URL’sinin dahil edilip edilmeyeceği
Arama Sonrası Değerlendirme
AI arama sonrası değerlendirmesinin etkinleştirilip etkinleştirilmeyeceği
Arama sonrası veri çıkarma için şema tanımı
Değişkenler
İstemlerde
{{variable_name}} aracılığıyla erişilebilen özel değişkenlerin anahtar-değer çiftleriGörüşme Sona Erme Ayarları
Görüşmenin sona ermiş sayılması için dakika cinsinden sohbet etkinsizlik süresi (1-1440)
Etkinsizlik nedeniyle sona erdikten sonra görüşmenin yeniden tetiklenmesine izin verilip verilmeyeceği
Bir sohbet görüşmesi etkinsizlik nedeniyle sona erdiğinde çağrılan webhook URL’si. Ana arama webhook’undan ayrıdır.
Örnek İstekler
Pipeline Modu Asistanı
Multimodal Modu Asistanı
Dualplex Modu Asistanı
Yanıt
Asistan oluşturma işlemini onaylayan başarı mesajı
Notlar
- Asistanın başarıyla oluşturulması için tüm zorunlu alanlar sağlanmalıdır
- Uyumlu sesleri almak için
modeparametresiyle Sesleri Getir uç noktasını kullanın - Multimodal/dualplex modları için
knowledgebase_modedeğerifunction_callolmalıdır - Multimodal/dualplex modları için
allow_interruptionsher zaman etkindir - Dolgu kelimeleri yalnızca pipeline modunda kullanılabilir
- Asistan varsayılan olarak
inactivedurumuyla oluşturulur

