> ## 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ç Oluşturma — Aksiyon Aracı ve Varsayılan Araç Kopyalama

> Araç kütüphanesine yeni araç ekleme yolları: bir platform aksiyonuna bağlı araç oluşturma ve varsayılan bir araçtan kendi kopyanızı üretme.

## İki Yol Var

Araç kütüphanesinde **Yeni araç ekle** dediğinizde iki seçenek çıkar.

<CardGroup cols={2}>
  <Card title="Aksiyon aracı" icon="bolt">
    Bir platform aksiyonuna bağlanır. Agent aracı çağırdığında arka planda entegrasyon servisi çalışır.
  </Card>

  <Card title="Varsayılan araçtan kopya" icon="copy">
    Hazır bir aracın kopyasını çıkarır. Kopya ayrı bir araç olur ve kendi talimatını siz verirsiniz.
  </Card>
</CardGroup>

## Aksiyon Aracı

Aksiyon aracı, organizasyonunuz için tanımlanmış bir **platform aksiyonuna** bağlanır. Agent aracı çağırdığında o aksiyon çalışır ve sonucu agent'a döner.

<Steps>
  <Step title="Aksiyonu seçin">
    Açılır listeden bu aracın bağlanacağı aksiyonu seçin. Seçtiğiniz anda aksiyonun parametreleri ekranda listelenir ve platform, aksiyona göre bir başlangıç talimatı hazırlar.
  </Step>

  <Step title="Araç adını verin">
    Örn. "Kart Bakiyesi Sorgulama". Adı yazdıkça platform bir **çağrılabilir araç adı** üretir.
  </Step>

  <Step title="Talimatı yazın">
    Agent'ın bu aracı ne zaman ve nasıl çağıracağını anlatın. Ayrıntı için [Araç Talimatı](/docs/tools/tool-prompt).
  </Step>

  <Step title="Oluşturun">
    Araç kütüphaneye eklenir. Bundan sonra istediğiniz agent'a bağlayabilirsiniz.
  </Step>
</Steps>

<Note>
  Organizasyonunuzda tanımlı bir aksiyon yoksa bu seçenek boş gelir. Aksiyon aracı bir aksiyona bağlanmak zorunda olduğu için önce aksiyonun tanımlanması gerekir.
</Note>

### Aksiyon Parametreleri

Seçtiğiniz aksiyonun kendi parametreleri vardır ve bunlar aracın **varsayılan parametreleri** olur. Değiştiremezsiniz, ama talimatınızda adlarına referans verebilir, üstlerine kendi parametrelerinizi ekleyebilirsiniz — bkz. [Parametreler](/docs/tools/tool-parameters).

## Varsayılan Araçtan Kopya

Varsayılan araçlar doğrudan düzenlenemez. Kendi talimatınızı vermek ya da aynı tipten **birden fazla** araca sahip olmak istiyorsanız kopya çıkarırsınız.

Kopya, kaynağından bağımsız ayrı bir araçtır: kendi talimatı, kendi mesajları ve kendi versiyon geçmişi olur. Kaynak araç sonradan güncellense de kopya değişmez.

<Steps>
  <Step title="Kopyalanacak aracı seçin">
    Listede yalnızca kopyalanabilir araçlar çıkar.
  </Step>

  <Step title="Ayırt edici bir ek yazın">
    Kopyanın adı, kaynağın adına eklediğiniz bu ekle oluşur — ikisini listede birbirinden ayıran şey budur.

    **Kurallar:** yalnızca küçük İngilizce harf ve rakam, 2–24 karakter, boşluksuz. Kelimeleri tireyle ayırabilirsiniz.

    **Örnekler:** `vip`, `refund`, `with-path`
  </Step>

  <Step title="Kopyalayın">
    Yeni araç "Özel araçlar" bölümünde belirir ve kaynağı **Özelleştirilmiş varsayılan** olarak işaretlenir.
  </Step>
</Steps>

<Warning>
  Ek boş bırakılamaz ve aynı ek iki kez kullanılamaz. Kaynak adı ile ekin toplamı da bir uzunluk sınırına tabidir; ad çok uzun olursa daha kısa bir ek yazmanız istenir.
</Warning>

## Aracın Alanları

<AccordionGroup>
  <Accordion title="Araç Adı">
    İnsanların gördüğü ad. Listelerde, agent kartlarında ve görüşme kayıtlarında bu görünür. İstediğiniz zaman değiştirebilirsiniz.
  </Accordion>

  <Accordion title="Çağrılabilir Araç Adı">
    Modele giderken kullanılan benzersiz ad. Araç adına göre otomatik üretilir.

    <Warning>
      Araç bir kez kaydedildikten sonra çağrılabilir ad **değişmez**. Görüşme kayıtlarında araç çağrıları bu adla eşleştiği için sabit kalması gerekir.
    </Warning>
  </Accordion>

  <Accordion title="Açıklama">
    Aracın ne yaptığının kısa özeti. Kütüphanede arama bu alanda da çalışır.
  </Accordion>

  <Accordion title="İkon">
    Aracın listelerde ve agent kartlarında görüneceği ikon. Ada göre arayıp seçebilir, dilerseniz boş bırakabilirsiniz.
  </Accordion>

  <Accordion title="Versiyon ve son güncelleme">
    Araç her kaydedildiğinde versiyon ilerler. Detay sayfasında versiyon numarası, son güncelleme tarihi ve aracı kaç agent'ın kullandığı görünür.
  </Accordion>
</AccordionGroup>

## Aracı Silme

Bir aracı kütüphaneden silmek kalıcıdır ve geri alınamaz. Silmeden önce **kaç agent'ın kullandığına** bakın — araç detayında yazar.

<Info>
  Bir aracı yalnızca tek bir agent'tan çıkarmak istiyorsanız silmeyin: agent ekranından **Bağlantıyı Kaldır** deyin. Araç kütüphanede kalır, sadece o agent ile bağı kopar. Bkz. [Agent'a Bağlama](/docs/tools/attach-to-agent).
</Info>