> ## 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.

# Araç Mesajları — Araç Çalışırken Söylenen Cümleler

> Araç çağrılırken, gecikirken, hata verdiğinde ve tamamlandığında müşteriye söylenecek mesajlar; koşullu mesajlar, rastgele seçim ve bloklama ayarları.

## Neden Var

Bir araç çalışırken geçen süre, müşteri açısından sessizliktir. Araç mesajları bu boşluğu doldurur: agent "hemen kontrol ediyorum" der, işlem uzarsa müşteriyi bilgilendirir, sonucu bildirir.

## Dört Blok

<CardGroup cols={2}>
  <Card title="Araç Çağrılırken" icon="play">
    Araç çalışmaya başladığında iletilir.
  </Card>

  <Card title="Yanıt Geciktiğinde" icon="hourglass-half">
    Araç yanıtı belirtilen süreden uzun sürdüğünde iletilir.
  </Card>

  <Card title="Araç Hata Verdiğinde" icon="triangle-exclamation">
    Araç hata döndüğünde iletilir.
  </Card>

  <Card title="Araç Tamamlandığında" icon="circle-check">
    Araç başarıyla tamamlandığında iletilir.
  </Card>
</CardGroup>

<Note>
  Her araç tipi dört bloğun hepsini desteklemez. Ekranda yalnızca o aracın desteklediği bloklar görünür.
</Note>

## Bir Blokta Birden Fazla Mesaj

Her bloğa birden fazla cümle yazabilirsiniz. Hangisinin okunacağına iki yoldan biriyle karar verilir.

<Tabs>
  <Tab title="Rastgele seçilir">
    Koşulu tutan cümleler arasından biri okunur. Böylece araç her çalıştığında müşteri aynı cümleyi duymaz.

    Koşulsuz bir mesaj her zaman bu havuzdadır.

    **Kullanım:** "Hemen kontrol ediyorum." / "Bir saniye, bakıyorum." / "Şimdi sorguluyorum."
  </Tab>

  <Tab title="Koşula göre seçilir">
    Koşulu tutan mesaj okunur. Öncelik yukarıdan aşağıdır — en üstteki koşul önce değerlendirilir.

    Aynı koşula sahip iki mesaj tanımlanamaz; hangisinin okunacağı belirsiz kalırdı.

    **Kullanım:** tutara, işlem tipine veya sonuca göre farklı cümleler.
  </Tab>
</Tabs>

Bir blokta en fazla **25** mesaj tanımlanabilir.

## Koşullar

Bir mesaja koşul eklediğinizde, o mesaj yalnızca koşulların hepsi tuttuğunda okunur. Koşul, aracın bir **parametresinin** değerine bakar.

| Alan          | Açıklama                      |
| ------------- | ----------------------------- |
| **Parametre** | Aracın parametrelerinden biri |
| **İşleç**     | Karşılaştırma biçimi          |
| **Değer**     | Karşılaştırılacak değer       |

### İşleçler

| İşleç | Anlamı          | Hangi tiplerde   |
| ----- | --------------- | ---------------- |
| `==`  | Eşit            | Her tip          |
| `!=`  | Eşit değil      | Her tip          |
| `>`   | Büyük           | Yalnızca sayısal |
| `>=`  | Büyük veya eşit | Yalnızca sayısal |
| `<`   | Küçük           | Yalnızca sayısal |
| `<=`  | Küçük veya eşit | Yalnızca sayısal |

Metin ve doğru/yanlış tipindeki parametrelerde yalnızca eşitlik karşılaştırmaları sunulur — sıralama karşılaştırması sayısal olarak değerlendirildiği için diğerleri zaten çalışmazdı.

<Warning>
  **Serbest metin alanları koşul olarak kullanılamaz.** Koşullar eşitlikle karşılaştırır; modelin her çağrıda yeniden yazdığı bir metin hiçbir zaman tutmaz. Bir parametreye göre farklı cümleler söyletmek istiyorsanız o parametreye [enum değerleri](/docs/tools/tool-parameters) verin.
</Warning>

<Note>
  Koşulu olmayan bir mesaj **her zaman uygun** sayılır ve aynı bloktaki koşullu mesajlarla çakışır. Ya bir koşul ekleyin ya da onu listenin en altında "son çare" mesajı olarak bırakın.
</Note>

### Örnek

Bir ödeme aracında, tutara göre iki farklı tamamlanma mesajı:

| Sıra | Koşul             | Mesaj                                                                      |
| ---- | ----------------- | -------------------------------------------------------------------------- |
| 1    | `amount` > `5000` | "İşleminiz alındı, tutar yüksek olduğu için ek onay için sizi arayacağız." |
| 2    | *(koşul yok)*     | "İşleminiz tamamlandı."                                                    |

## Ek Ayarlar

<AccordionGroup>
  <Accordion title="Araç çağrılmadan önce mesajın okunmasını bekle">
    Açıkken agent, cümleyi tamamen söyleyip aracı ondan sonra çağırır. Kapalıyken cümle söylenirken araç paralel çalışır — daha hızlı, ama müşteri cümlenin ortasında sonucu duyabilir.
  </Accordion>

  <Accordion title="Mesaj okunduktan sonra görüşmeyi sonlandır">
    Cümle söylendikten sonra çağrı kapatılır. Mesajlaşma kanalında karşılığı "oturumu sonlandır"dır.

    Genellikle hata mesajlarında kullanılır: işlem yapılamıyorsa müşteriyi boşuna bekletmemek için.
  </Accordion>

  <Accordion title="Gecikme süresi">
    "Yanıt Geciktiğinde" bloğunun kaç milisaniye sonra devreye gireceği.

    **Aralık:** 200 – 10.000 ms · **Varsayılan:** 2.000 ms
  </Accordion>
</AccordionGroup>

## İpuçları

<Tip>
  * ✅ Başlangıç mesajına birkaç seçenek yazıp rastgele seçtirin — tekrar eden aynı cümle robotik duyuluyor
  * ✅ Gecikme mesajını mutlaka doldurun; sessizlik müşteriye "hat düştü" hissi verir
  * ✅ Hata mesajında ne yapılacağını söyleyin: "Şu anda sistemde bir problem var, sizi temsilciye aktarıyorum."
  * ❌ Koşullu bloklarda koşulsuz mesajı en üste koymayın; altındaki hiçbir kural çalışmaz
  * ❌ Uzun cümleler yazmayın; araç bu sırada zaten çalışıyor
</Tip>