Skip to main content

​
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:
1

Platform sabit promptu

AI Agent TR’nin eklediği güvenlik ve uyumluluk kuralları.
2

Agent'ın sistem talimatı

Agent’ın kim olduğu ve nasıl konuştuğu.
3

Araç talimatları

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:
Çö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
İyi örnek

​
İlgili Sayfalar

Parametreler

Talimatta referans verdiğiniz alanları tanımlama

Araç Mesajları

Araç çalışırken müşteriye söylenecek cümleler