> ## 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ç Talimatı — Agent'ın Aracı Ne Zaman Çağıracağı
> Araç talimatı yazma rehberi: talimatın agent promptu içindeki yeri, değişken kullanımı, işlenmiş talimat önizlemesi ve versiyon geçmişi.
## Talimat Ne İşe Yarar
Bir aracı agent'a bağlamak, agent'ın onu doğru zamanda çağıracağı anlamına gelmez. **Araç talimatı**, agent'a bu aracın ne işe yaradığını ve hangi durumda çağrılması gerektiğini anlatan metindir.
Araç çağrılmıyorsa bakılacak ilk yer neredeyse her zaman talimattır.
## Talimat Nereye Gidiyor
Agent'ın modele giden promptu üç katmandan oluşur ve araç talimatı **en sona** eklenir:
AI Agent TR'nin eklediği güvenlik ve uyumluluk kuralları.
Agent'ın kim olduğu ve nasıl konuştuğu.
Agent'a bağlı her aracın talimatı, sırayla sona eklenir.
Araç talimatını üsttekilerin **devamı** gibi yazın. Agent'ın kimliğini, üslubunu veya genel kurallarını burada tekrar etmeyin — onlar zaten yukarıda var. Burada yalnızca bu aracın ne zaman ve nasıl çağrılacağını anlatın.
## Değişkenler
Talimat içinde platformun çalışma anında dolduracağı değişkenler kullanabilirsiniz. Editörün altında o araç tipinin desteklediği değişkenler listelenir; üzerine tıklayınca imlecin bulunduğu yere eklenir. Her değişkenin yanında bir **örnek değer** görünür.
## Talimatı Önizleme
**Talimatı Önizle** dediğinizde, değişkenleri çözülmüş haliyle talimatın son hali açılır — yani modele gerçekte ne gideceğini görürsünüz.
Önizlemede iki uyarı çıkabilir:
| Uyarı | Anlamı |
| ------------------------------ | ---------------------------------------------------------------------------------------- |
| **Çözülemeyen değişkenler** | Değişken geçerli ama besleyecek bağlı bir kaynak yok. Kaynağı bağladığınızda dolacaktır. |
| **Desteklenmeyen değişkenler** | Bu araç tipinin tanımadığı bir değişken yazılmış. Metinde olduğu gibi kalır. |
Çözülemeyen bir değişken, talimatın modele eksik gitmesi demektir. Yayına almadan önce önizlemeyi bir kez açıp bakın.
## Versiyon Geçmişi
Araç her kaydedildiğinde talimatın o anki hali versiyon geçmişine yazılır. **Geçmiş**'ten eski bir versiyonu seçebilirsiniz.
Seçilen versiyon yalnızca **editöre yüklenir**; kaydetmeden kalıcı olmaz. Yani eski bir versiyona bakmak, üzerinde oynamak ve vazgeçmek serbesttir.
Versiyon geçmişi araç kaydedildikten sonra görünür — yeni oluşturulan bir araçta henüz kayıtlı versiyon yoktur.
Bir aracı belirli bir agent için özelleştirdiyseniz, o agent'ın kendi özelleştirme geçmişi ayrı tutulur ve agent ekranından görülür.
## İyi Bir Talimat Nasıl Yazılır
* ✅ Tetikleyici durumu açıkça yazın: "Müşteri sipariş durumu sorarsa…"
* ✅ Parametrelerin adlarına referans verin, hangi bilginin nereye yazılacağını söyleyin
* ✅ Aracın **çağrılmaması** gereken durumu da yazın, varsa
* ✅ Kısa tutun; talimat her göreve eklendiği için uzun metin agent'ın odağını dağıtır
* ❌ Agent'ın kimliğini/üslubunu tekrar etmeyin
* ❌ Birden fazla işi tek araca yüklemeyin — ayrı araçlar daha isabetli çağrılır
**Zayıf örnek**
```text theme={null}
Bu araç sipariş sistemiyle konuşur.
```
**İyi örnek**
```text theme={null}
Müşteri sipariş durumunu veya kargo takibini sorduğunda bu aracı çağır.
Sipariş numarasını musteriye sor ve orderNumber parametresine yaz.
Müşteri sipariş numarasını bilmiyorsa bu aracı çağırma, önce telefon
numarasıyla kaydını doğrula.
```
## İlgili Sayfalar
Talimatta referans verdiğiniz alanları tanımlama
Araç çalışırken müşteriye söylenecek cümleler