> ## Documentation Index
> Fetch the complete documentation index at: https://aiagenttr.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Gelişmiş Yapılandırma — Eskalasyon ve Performans Ayarları

> AI Agent eskalasyon koşulları, temperature ayarı, timeout yapılandırması ve performans optimizasyonu. İleri düzey agent yapılandırma rehberi.

## Genel Bakış

Gelişmiş yapılandırma özellikleri ile AI Agent'ınızın performansını optimize edebilir, eskalasyon davranışını detaylı yapılandırabilir ve özel ihtiyaçlarınıza göre kişiselleştirebilirsiniz.

<Info>
  **Not:** AI model ve ses seçimi platform tarafından otomatik olarak yönetilir. Platform en iyi performans için bu ayarları otomatik olarak optimize eder.
</Info>

## Gelişmiş Eskalasyon Ayarları

Agent düzenleme sayfasında yönlendirmeyi etkinleştirdikten sonra, **Gelişmiş Ayarlar** bölümünü genişleterek aşağıdaki ayarlara erişebilirsiniz.

### Koşul Bazlı Çoklu Yönlendirme

Her yönlendirme koşulu için **bağımsız bir hedef** yapılandırılabilir. Bu sayede farklı durumlar için farklı departmanlara veya numaralara yönlendirme yapabilirsiniz.

**Örnek Senaryo:**

| Koşul           | Hedef Tipi | Hedef                                             |
| --------------- | ---------- | ------------------------------------------------- |
| Müşteri sinirli | Telefon    | +905301234567 (Müşteri İlişkileri)                |
| İnsan isteği    | SIP        | sip:[destek@sirket.com](mailto:destek@sirket.com) |
| Ödeme konusu    | Telefon    | +905309876543 (Muhasebe)                          |

Her koşul kartında şu alanlar yapılandırılır:

<Steps>
  <Step title="Hedef Tipi Seçimi">
    * **Telefon Numarası**: `E.164` formatında numara (örn: +905304159722)
    * **SIP URI**: SIP adresine yönlendir (örn: sip:[destek@sirket.com](mailto:destek@sirket.com))
  </Step>

  <Step title="Hedef Adresi">
    Seçilen tipe göre telefon numarası veya SIP URI girin.
  </Step>

  <Step title="Yönlendirme Mesajı">
    Müşteriye yönlendirme öncesi söylenecek mesaj (en az 20, en fazla 250 karakter).

    ```
    İlettiğiniz konu ile ilgili sizi ilgili birimimize aktaracağım.
    Lütfen hattan ayrılmayın.
    ```
  </Step>
</Steps>

<Tip>
  **Koşul Kopyalama:** Bir koşulun yapılandırmasını **Kopyala** butonuyla kopyalayıp, başka bir koşula **Yapıştır** ile uygulayabilirsiniz. Bu, aynı hedefe yönlendiren birden fazla koşul oluşturmayı hızlandırır.
</Tip>

### Yönlendirme Başarısız Mesajı

Yönlendirme başarısız olduğunda müşteriye söylenecek mesaj.

| Özellik          | Değer        |
| ---------------- | ------------ |
| Minimum uzunluk  | 20 karakter  |
| Maksimum uzunluk | 250 karakter |

**Örnek:**

```
Üzgünüm, şu anda sizi bir temsilciye aktaramıyorum.
Lütfen daha sonra tekrar arayın.
```

### Gecikme Mesajı

Yönlendirme beklenenden uzun sürdüğünde müşteriye söylenecek mesaj.

| Özellik          | Değer        |
| ---------------- | ------------ |
| Minimum uzunluk  | 20 karakter  |
| Maksimum uzunluk | 250 karakter |

**Örnek:**

```
Lütfen bekleyin, sizi bir temsilciye bağlıyorum.
Bu birkaç saniye sürebilir.
```

### Gecikme Süresi (Delay Threshold)

Gecikme mesajının ne zaman oynatılacağını belirler.

| Özellik    | Değer                         |
| ---------- | ----------------------------- |
| Minimum    | 100 milisaniye                |
| Maksimum   | 120.000 milisaniye (2 dakika) |
| Varsayılan | 5.000 milisaniye (5 saniye)   |

<Warning>
  Gecikme süresi 100 ile 120.000 milisaniye arasında olmalıdır. Bu aralık dışındaki değerler kabul edilmez.
</Warning>

### Mesaj Sonrası Aramayı Sonlandır

**Mesaj söylendikten sonra aramayı sonlandır** toggle'ı etkinleştirildiğinde, yönlendirme başarısız mesajı müşteriye söylendikten sonra arama otomatik olarak sonlandırılır.

* **Etkin**: Mesaj söylendikten sonra arama biter
* **Devre dışı** (varsayılan): Mesaj söylendikten sonra agent konuşmaya devam eder

### Eskalasyon Ayarları Özeti

| Ayar                            | Açıklama                                         | Karakter/Değer Limiti |
| ------------------------------- | ------------------------------------------------ | --------------------- |
| Yönlendirme başarısız mesajı    | Yönlendirme başarısız olduğunda söylenir         | 20-250 karakter       |
| Gecikme mesajı                  | Yönlendirme beklenenden uzun sürdüğünde söylenir | 20-250 karakter       |
| Gecikme süresi                  | Gecikme mesajının tetikleneceği süre             | 100-120.000 ms        |
| Mesaj sonrası aramayı sonlandır | Başarısız mesajından sonra arama biter           | Açık/Kapalı           |

<Frame>
  <img src="https://mintcdn.com/aiagenttr/DXCGeoE5pY0ImAYy/images/agent-create-form.png?fit=max&auto=format&n=DXCGeoE5pY0ImAYy&q=85&s=2435686823a84f587ab539b90ff15a10" alt="Gelişmiş eskalasyon ayarları" width="1528" height="943" data-path="images/agent-create-form.png" />
</Frame>

## Parametre Ayarları

### Temperature (Yaratıcılık)

**Ne İşe Yarar:** Agent'ın ne kadar yaratıcı/tahmin edilemez olacağını belirler (0-2 arası değer)

<Tabs>
  <Tab title="0.0 - 0.3 (Tutarlı)">
    * Her zaman benzer cevaplar
    * Tahmin edilebilir
    * Resmi/profesyonel ton

    **Kullanım:** Müşteri hizmetleri, bilgi verme
  </Tab>

  <Tab title="0.4 - 0.7 (Dengeli)">
    **Varsayılan: 0.7**

    * Dengeli yaratıcılık
    * Doğal konuşma

    **Kullanım:** Genel amaçlı agent'lar
  </Tab>

  <Tab title="0.8 - 2.0 (Yaratıcı)">
    * Çok yaratıcı cevaplar
    * Tahmin edilemez

    **Kullanım:** Yaratıcı içerik, beyin fırtınası
  </Tab>
</Tabs>

### Max Tokens (Maksimum Uzunluk)

**Ne İşe Yarar:** Agent'ın tek seferde üretebileceği maksimum kelime sayısı

| Aralık              | Kullanım                                                                      |
| ------------------- | ----------------------------------------------------------------------------- |
| 50-250 tokens       | IVR, kısa yönlendirme (250'nin altındaki değerler otomatik 500'e yükseltilir) |
| 500-1.000 tokens    | Genel amaçlı (Varsayılan: 250)                                                |
| 1.000-10.000 tokens | Teknik destek, detaylı açıklamalar                                            |

## Zaman Aşımı Ayarları

### Call Timeout (Çağrı Zaman Aşımı)

**Ne İşe Yarar:** Görüşme maksimum ne kadar sürebilir (otomatik sonlandırma)

<CardGroup cols={3}>
  <Card title="5 dakika" icon="clock">
    * Kısa bilgilendirmeler
    * Randevu alma
  </Card>

  <Card title="10 dakika" icon="clock">
    **Varsayılan**

    * Müşteri hizmetleri
    * Satış görüşmeleri
  </Card>

  <Card title="20 dakika" icon="clock">
    * Teknik destek
    * Detaylı danışmanlık
  </Card>
</CardGroup>

<Warning>
  **Sınırsız timeout kullanılması önerilmez** - Maliyet kontrolsüz artar
</Warning>

### Idle Timeout (Boşta Bekleme)

**Ne İşe Yarar:** Müşteri ne kadar süre sessiz kalırsa görüşme sonlanır

**Değerler:**

* **30 saniye** - Agresif
* **60 saniye** - Orta (Varsayılan)
* **90 saniye** - Toleranslı

## Ses Ayarları

### Ses Seçimi

Platform, dil seçimine göre otomatik olarak en uygun ses modelini atar. Ses ayarları platform tarafından optimize edilir.

### Konuşma Hızı (Speaking Rate)

Konuşma hızı, dil seçimine göre otomatik yapılandırılır:

| Dil       | Varsayılan Hız |
| --------- | -------------- |
| Türkçe    | 1.1x           |
| Çoklu Dil | 0.9x           |

<Info>
  **Öneri:** Türkçe için 1.0x-1.1x arası idealdir.
</Info>

## Davranış Ayarları

### Interruption Sensitivity (Kesme Hassasiyeti)

**Ne İşe Yarar:** Agent konuşurken müşteri araya girerse ne olur

<Tabs>
  <Tab title="Düşük Hassasiyet">
    * Agent konuşmayı bitirmeden durdurmaz
    * Müşteri ısrarla araya girmeli
  </Tab>

  <Tab title="Orta Hassasiyet">
    **Varsayılan**

    * Dengeli
    * Doğal konuşma akışı
  </Tab>

  <Tab title="Yüksek Hassasiyet">
    * Müşteri hemen araya girebilir
    * Agent anında durur
  </Tab>
</Tabs>

## Ek Yapılandırma

Agent düzenleme sayfasının **Ek Yapılandırma** bölümünde şu ayarlar bulunur:

### Konuşma Loglama

Görüşme detaylarının loglanmasını etkinleştirir veya devre dışı bırakır.

* **Etkin** (varsayılan): Tüm görüşme detayları loglanır
* **Devre dışı**: Loglama kapatılır

### DTMF Girdisi Gizleme

Transkriptte tuş basımı (DTMF) girdilerinin gizlenmesini sağlar. Müşterinin tuşladığı bilgiler (örn: kredi kartı numarası) transkriptte görünmez.

* **Etkin**: DTMF girdileri gizlenir
* **Devre dışı** (varsayılan): DTMF girdileri transkriptte görünür

## İpuçları ve En İyi Uygulamalar

### Eskalasyon Ayarları

<Tip>
  * ✅ Her koşul için anlamlı bir yönlendirme mesajı yazın (en az 20 karakter)
  * ✅ Gecikme süresini 5.000 ms (5 saniye) civarında tutun
  * ✅ Yönlendirme başarısız mesajını mutlaka yapılandırın
  * ✅ Koşul kopyalama özelliğini kullanarak aynı hedefi hızlıca yapılandırın
  * ❌ Çok kısa gecikme süresi kullanmayın (100 ms çok erken tetiklenir)
  * ❌ Tüm koşulları aynı anda etkinleştirmeyin — gerçekten gerekli olanları seçin
</Tip>

### Temperature

<Tip>
  * ✅ Müşteri hizmetleri: 0.3-0.5
  * ✅ Satış: 0.5-0.7
  * ✅ Yaratıcı: 0.7-0.9
  * ❌ 0.0 çok robotik
  * ❌ 2.0 çok tahmin edilemez
</Tip>

### Timeout

<Tip>
  * ✅ Görev süresine göre ayarlayın
  * ✅ Idle timeout 60 saniye ideal
  * ❌ Çok kısa timeout müşteriyi keser
  * ❌ Çok uzun timeout maliyeti artırır
</Tip>

### Ses Ayarları

<Tip>
  * ✅ Konuşma hızı 1.0x-1.1x (Türkçe)
  * ✅ Müşteriye uygun dil seçin
  * ❌ Çok hızlı konuşma anlaşılmaz
  * ❌ Çok yavaş konuşma can sıkıcı
</Tip>

## Sorun Giderme

<AccordionGroup>
  <Accordion title="Agent Çok Yavaş Yanıt Veriyor">
    **Çözüm:**

    1. Max Tokens değerini azaltın
    2. Temperature değerini düşürün
    3. Sistem talimatlarını kısaltın
  </Accordion>

  <Accordion title="Agent Tutarsız Cevaplar Veriyor">
    **Çözüm:**

    1. Temperature: 0.3'e düşürün
    2. Sistem talimatını daha detaylı yapın
    3. Versiyon geçmişinden önceki versiyona dönün
  </Accordion>

  <Accordion title="Görüşme Sık Sık Kesiliyor">
    **Çözüm:**

    1. Idle Timeout: Artırın (90 saniye)
    2. Call Timeout: Artırın
    3. Interruption Sensitivity: Düşürün
  </Accordion>

  <Accordion title="Yönlendirme Başarısız Oluyor">
    **Çözüm:**

    1. Hedef telefon numarasının `E.164` formatında olduğunu kontrol edin
    2. SIP URI formatını doğrulayın (sip:[kullanici@domain.com](mailto:kullanici@domain.com))
    3. Yönlendirme mesajının en az 20 karakter olduğunu kontrol edin
    4. Gecikme süresinin 100-120.000 ms arasında olduğunu doğrulayın
  </Accordion>

  <Accordion title="Yönlendirme Mesajı Hata Veriyor">
    **Çözüm:**

    Yönlendirme mesajları (başarısız mesajı, gecikme mesajı, koşul bazlı mesajlar) en az **20 karakter** ve en fazla **250 karakter** olmalıdır. Karakter sayacını kontrol edin.
  </Accordion>
</AccordionGroup>

## Sık Sorulan Sorular

<AccordionGroup>
  <Accordion title="Hangi model kullanılıyor?">
    Platform en uygun AI modelini otomatik olarak seçer ve yönetir. Model seçimi kullanıcı tarafından değiştirilemez.
  </Accordion>

  <Accordion title="Temperature ne olmalı?">
    Müşteri hizmetleri için 0.3-0.5, satış için 0.5-0.7 ideal. Varsayılan 0.7'dir.
  </Accordion>

  <Accordion title="Gecikme süresi ne kadar olmalı?">
    Genel kullanım için 5.000 ms (5 saniye) önerilir. Minimum 100 ms, maksimum 120.000 ms (2 dakika).
  </Accordion>

  <Accordion title="Her koşul için farklı hedef tanımlayabilir miyim?">
    Evet, her yönlendirme koşulu için bağımsız hedef tipi (telefon/SIP) ve hedef adresi tanımlayabilirsiniz.
  </Accordion>

  <Accordion title="Ayarları değiştirmek ücretli mi?">
    Hayır, ayar değişiklikleri ücretsizdir. Ancak farklı yapılandırmalar çağrı maliyetini etkileyebilir.
  </Accordion>

  <Accordion title="Mevcut görüşmeler etkilenir mi?">
    Hayır, sadece yeni görüşmeler yeni ayarları kullanır.
  </Accordion>

  <Accordion title="Ayarları başka agent'a kopyalayabilir miyim?">
    Evet, agent kopyalama özelliğiyle ayarlar da kopyalanır.
  </Accordion>
</AccordionGroup>

## İlgili Makaleler

<CardGroup cols={2}>
  <Card title="AI Agent Oluşturma" icon="robot" href="/docs/voice-ai-agents/create-agent">
    Yeni AI Agent oluşturma ve yapılandırma
  </Card>

  <Card title="Agent Araçları" icon="wrench" href="/docs/voice-ai-agents/agent-tools">
    Handoff, özel fonksiyon ve entegrasyon araçları
  </Card>

  <Card title="Yapılandırılmış Çıktılar" icon="table" href="/docs/voice-ai-agents/structured-outputs">
    JSON formatında veri toplama
  </Card>

  <Card title="Ses ve Transkript Ayarları" icon="microphone" href="/docs/voice-ai-agents/voice-transcript-settings">
    Özel terim ve telaffuz ayarları
  </Card>
</CardGroup>