> ## 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ç Parametreleri — Girdi Şeması ve Kendi Alanlarınız

> Aracın modelden istediği alanları tanımlama: varsayılan parametreler, kendi eklediğiniz parametreler, tipler, enum değerleri ve oluşan şema.

## Parametre Nedir

Parametreler, aracın **modelden istediği alanlardır**. Agent aracı çağırırken bu alanları doldurur.

Doldurulan değerler iki yerde işinize yarar:

* **Görüşme kaydında** görünür — çağrının hangi veriyle yapıldığını sonradan görebilirsiniz
* **Mesaj koşullarında** kullanılabilir — hangi cümlenin söyleneceğine bu değerlere bakarak karar verebilirsiniz (bkz. [Araç Mesajları](/docs/tools/tool-messages))

## İki Tür Parametre

<CardGroup cols={2}>
  <Card title="Varsayılan parametreler" icon="lock">
    Araç tipinden ya da bağlı olduğu aksiyondan gelir. Değiştirilemez, silinemez — çalışma anını platform doldurur.
  </Card>

  <Card title="Sizin eklediğiniz parametreler" icon="pen">
    Varsayılanların altına eklediğiniz kendi alanlarınız. Modelden bunları da doldurmasını isteriz.
  </Card>
</CardGroup>

<Note>
  Her araç tipi kendi parametrelerinizi eklemeye izin vermez. İzin veren tiplerde **Parametre ekle** butonu görünür; vermeyenlerde yalnızca varsayılanlar listelenir.
</Note>

## Parametre Ekleme

<Steps>
  <Step title="Düzenle'ye geçin">
    Parametreler bölümü salt okunur açılır. Kendi alanlarınızı eklemek için önce **Düzenle**'ye basın.
  </Step>

  <Step title="Parametre adı verin">
    Harf veya alt çizgi ile başlamalı; yalnızca harf, rakam ve alt çizgi içerebilir. En fazla 100 karakter.

    **Örnekler:** `orderNumber`, `card_last4`, `amount`
  </Step>

  <Step title="Tipini seçin">
    Değerin ne olduğunu söyler. Tip listesi aşağıda.
  </Step>

  <Step title="Modele açıklama yazın">
    Modelin bu alana ne yazacağını buradan öğrenir. Parametrenin en önemli alanı budur — belirsiz bir açıklama, yanlış doldurulmuş bir alan demektir.
  </Step>

  <Step title="Gerekiyorsa zorunlu işaretleyin">
    Zorunlu bir parametreyi model her çağrıda doldurmak zorundadır.
  </Step>
</Steps>

## Tipler

| Tip        | Kullanım                                             |
| ---------- | ---------------------------------------------------- |
| `string`   | Serbest metin                                        |
| `number`   | Ondalıklı sayı                                       |
| `integer`  | Tam sayı                                             |
| `boolean`  | Doğru / yanlış                                       |
| `date`     | Tarih                                                |
| `datetime` | Tarih ve saat                                        |
| `array`    | Liste — ayrıca **dizi eleman tipi** seçmeniz gerekir |
| `object`   | İç içe yapı                                          |

## Enum Değerleri

Bir parametrenin alabileceği değerleri önceden belirlemek isterseniz **enum değerleri** yazın; virgülle ayırın.

Boş bırakırsanız model serbest değer üretir.

<Tip>
  Enum yazmanın ikinci bir faydası var: **mesaj koşulları yalnızca değeri belli olan parametrelerle çalışır.** Modelin her çağrıda yeniden yazdığı serbest bir metin, eşitlik karşılaştırmasını hiçbir zaman tutturamaz. Bir parametreye göre farklı cümleler söyletmek istiyorsanız o parametreye enum verin.
</Tip>

**Örnek**

| Alan            | Değer                                   |
| --------------- | --------------------------------------- |
| Parametre adı   | `islemTipi`                             |
| Tip             | `string`                                |
| Enum değerleri  | `bakiye, borc, limit`                   |
| Modele açıklama | Müşterinin öğrenmek istediği bilgi türü |

## Oluşan Şema

Sayfanın altındaki **Oluşan şema**, varsayılan parametreler ile sizin eklediklerinizin birleşmiş halidir — modele giden son hâl budur. Bir parametrenin gerçekten şemaya girdiğinden emin olmak için buraya bakın.

## Agent Ekranından Değiştirilemez

Bir araç kütüphaneden geliyorsa, parametreleri **tüm agent'lar için ortaktır** ve yalnızca araç kütüphanesinden düzenlenir. Agent ekranındaki araç detayında parametreler görünür ama düzenlenemez.

Sebep basit: parametreler aracın modele sunduğu sözleşmedir; agent başına değişirse aynı aracın çağrıları birbirini tutmaz.

<Warning>
  Bir parametreyi sildiğinizde, o parametreye bağlı bir mesaj koşulu kalmışsa araç kaydedilmez. Önce koşulu düzeltin ya da parametreyi geri ekleyin.
</Warning>