Asistanlar: baştan sona yapılandırma

Asistan, platformdaki tek yapılandırma nesnesidir: ne söyleyeceğini belirleyen talimat, hangi modeli kullandığı, hangi sesle konuştuğu, hangi bilgi tabanına baktığı, kimlere aktarma yapabildiği ve hangi numaralarda telefonu açtığı — hepsi tek yerde. Bu sayfa her bölümü tek tek anlatıyor.

Sistem talimatı (system prompt)

Asistanın her aramada uyduğu kurallar. Zamanınızı harcamanız gereken tek en önemli alan burasıdır — model seçimi bile bunun kadar fark yaratmaz.

• İşinize özgü olsun. "Kadıköy’deki Acme Diş Kliniği’nin resepsiyonisti Aysel’sin" cümlesi, "yardımcı bir asistansın" cümlesinden kat kat iyi çalışır.
• Kısa tutun — 800 kelimenin altı. Uzun talimat modeli hem yavaşlatır hem kafasını karıştırır.
• Aktarma kuralını açıkça yazın: tam olarak hangi durumda, kime aktaracak.
• Üslubu tanımlayın. İnsan bir çalışanınızın nasıl konuşmasını isterdiniz — onu yazın.
• Uydurmayı yasaklayın. "Bilmiyorsan kontrol edip döneceğini söyle, tahmin etme" satırı hataların çoğunu keser.

Sen [İsim], [İşletme] firmasının [rolü]sün.

Görevin:
- [birincil iş 1]
- [birincil iş 2]
- Acil konuları +90 850 123 45 67 numarasına aktar.

Üslup:
- Doğal konuş, en fazla 2 cümlelik cevaplar ver.
- Her talebin sonunda detayları teyit et.
- Asla "bir yapay zekâ olarak" deme — sen [İsim]'sin.

Belirli sorulara YALNIZCA bilgi tabanındaki içerikle cevap ver.
Bilmiyorsan "Kontrol edip size döneceğim" de — tahmin etme.

Dil ve model

Dil BCP-47 kodu olarak tutulur; Türkçe için tr-TR. Asistan bu dilde dinler ve konuşur. Model sağlayıcısı varsayılan olarak OpenRouter’dır — tüm modellere tek geçitten erişilir.

Modeli istediğiniz an değiştirebilirsiniz; yeniden yayına alma gerekmez, bir sonraki arama yeni modelle çalışır. Model başına dakika ücreti farklıdır — fiyatlandırma sayfasında güncel liste var.

Motor: cascade mı realtime mı

İki ses motoru var. cascade klasik zincirdir: konuşma metne çevrilir, model cevap üretir, metin sese çevrilir. realtime ise doğrudan konuşmadan konuşmaya çalışan GPT Realtime motorudur — daha akıcı, ses tonuna daha duyarlı, ama model seçimi ve ses seçimi kısıtlı. Varsayılan cascade’dir ve Türkçe’de en öngörülebilir sonucu verir.

Ses

Panelde ses galerisinden seçilir; her sesin önizleme düğmesi var — üç saniyede nasıl konuştuğunu duyarsınız. Türkçe için özel kaydedilmiş sesler (Selin, Nergis, Will) ve tüm dillerde çalışan çok dilli sesler mevcut.

• voice_speed — konuşma hızı, 0.5 ile 2.0 arası. Türkçe için 1.0 doğal, telesekreter mesajlarında 0.95 daha anlaşılır.
• background_sound — arka plan sesi: none, office veya keyboard. Ofis uğultusu aramanın steril hissini azaltır.
• Çok dilli asistan kuruyorsanız çok dilli bir ses seçin; arama ortasında karakter değişmesi rahatsız edicidir.

Konuşma davranışı

Bu ayarlar asistanın "insan gibi" hissedilmesini belirler. Hepsi 0 ile 1 arasında oran değerleridir.

Karşılama ve kapanış mesajı

Asistan telefonu açtığında söylediği ilk cümle. begin_message_mode iki değer alır: dynamic (varsayılan) talimatınıza ve arama bağlamına göre selamlamayı modelin üretmesidir; static ise yazdığınız cümlenin birebir okunmasıdır.

Somut bir açılış, genel bir açılıştan belirgin şekilde daha iyi karşılık görür: "Acme Diş, ben Aysel — randevu için mi arıyorsunuz?" cümlesi "Merhaba, size nasıl yardımcı olabilirim?" cümlesini rahat geçer.

Kapanış için aynı ikilik var: end_call_mode static ise end_call_message okunur, dynamic ise end_call_prompt ile modele ne söyleyeceğini anlatırsınız (örneğin "konuşmayı özetle ve nazik bir veda et").

Bilgi tabanı

Asistanın işinize dair somut soruları cevaplayabilmesi için bilgi tabanı bağlarsınız: fiyat listesi, çalışma saatleri, sık sorulanlar. Konuşma anında en ilgili parçalar getirilir ve cevap bu parçalara dayandırılır.

• kb_chunks_count — kaç parça getirilsin (1-10, varsayılan 3). Cevaplar eksik kalıyorsa 5’e çıkarın.
• kb_similarity_threshold — benzerlik eşiği (varsayılan 0.6). Yükseltmek alakasız parçaları keser ama "bilmiyorum" cevaplarını artırır.

Aktarma hedefleri

Asistanın devredebileceği yerleri tanımlarsınız; ne zaman kullanacağını talimat söyler. transfer_targets alanı bir liste tutar ve her hedefin bir tipi vardır: phone, sip, agent, external veya queue.

AKTARMA:
- Acil tıbbi sorularda hemen +90 850 111 22 33'e aktar.
- Bilgi tabanında olmayan fiyat sorularında +90 850 444 55 66'ya aktar.
- Diğer her şeyi kendin çöz.

agent tipi ile başka bir asistana aktarabilirsiniz. Dil bazlı devir (Türkçe asistandan İngilizce asistana) veya departman bazlı uzmanlaşma için doğru yol budur.

Arama sonrası veri çıkarımı

Her arama bittiğinde dökümden yapılandırılmış alanlar çıkarılabilir. Alanları asistanda tanımlarsınız; çıkarım modeli (post_call_extraction_model, varsayılan gpt-4o-mini) dökümü okuyup JSON’u doldurur.

[
  {"name": "musteri_adi", "type": "string", "description": "Müşterinin tam adı"},
  {"name": "ilgi_seviyesi", "type": "enum", "description": "yuksek, orta, dusuk, yok"},
  {"name": "geri_arama_gerekli", "type": "boolean", "description": "Geri arama isteniyor mu"},
  {"name": "randevu_tarihi", "type": "string", "description": "ISO 8601 formatında tarih"}
]

Webhook

webhook_url alanına adresinizi yazarsanız arama olayları JSON gövdeyle o adrese POST edilir. Yaygın kullanım: arama bittiğinde tam döküm ve çıkarılan alanların CRM’e yazılması, ya da devredilemeyen bir konuda destek ekibine anında haber gitmesi.

Kayıt

enable_recording ile asistan bazında açılır, varsayılan kapalıdır. Açıkken dakikası +$0.05 ek ücretlidir. Kayıtlar Aramalar sekmesinde sayfa içinde dinlenebilir ve API’den indirilebilir.

Telesekreter tespiti

voicemail_detection_enabled varsayılan olarak KAPALIDIR; giden arama yapıyorsanız açmanız gerekir. Karşılamadan sonra voicemail_detection_timeout_ms süresince (varsayılan 5000 ms) insan sesi duyulmazsa telesekreter varsayılır.

DTMF (tuş girişi)

Asistan tuş takımı girişini kabul eder: "Satış için 1, destek için 2". Menüyü sistem talimatında tanımlarsınız, çalışma zamanı DTMF tonlarını çözüp metin olarak modele verir. Dil seçimi, müşteri numarası girişi veya sesli asistanın üzerine IVR tarzı yönlendirme için kullanılır.