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, nasıl konuştuğu ve görüşmenin nasıl ilerlediği.
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.

​
Sistem Talimatı mı, Araç Talimatı mı?

Araç eklerken yapılan en pahalı hata, görüşmenin akışını araç talimatına yazmaktır. Yukarıdaki katman sırası bunun neden çalışmadığını da söylüyor: araç talimatı en sona eklenir ve agent’a bağlı olduğu sürece promptta durur. Akışı oraya yazdığınızda, sistem talimatındaki akışın yanına ikinci bir akış koymuş olursunuz. Model iki akışı da uygulamaya çalışır.
Akış cümlelerini araç talimatına yazmayın. “Önce şunu sor, sonra doğrula, ardından bu aracı çağır, sonra da şunu söyle” biçimindeki bir sıralama araç talimatında durursa agent aynı adımı iki kez yürütmeye çalışır. En sık görülen sonuçları: aracın arka arkaya iki kez çağrılması, sırası gelmeden çağrılması ya da çağrıldıktan sonra baştan başlanması.

​
Hangi Cümle Nereye

Ayıklamanın kolay yolu: cümleyi okuyun ve “bu araç agent’tan çıkarılsaydı bu cümle hâlâ anlamlı olur muydu?” diye sorun. Cevap evetse cümle sistem talimatına aittir.

​
Ön Koşulları Tekrar Etmeyin, Referans Verin

Bir aracın çağrılabilmesi için sağlanması gereken koşullar (kimlik doğrulandı mı, müşteri kayıtlı mı, çalışma saati içinde mi) sistem talimatının işidir. Araç talimatı bunları yeniden yazmaz; var olduklarını hatırlatır. Platformun kendi varsayılan araçları da böyle yazılmıştır — örneğin çağrı yönlendirme aracının talimatı, koşulları saymak yerine “sistem mesajında bu aracın kullanımıyla ilgili ön koşullar tanımlıysa onları da uygula” der. Koşulun tek bir sahibi olur, iki yerde çelişme ihtimali kalmaz.

​
Bu Alana Ne Yazıyorum

Araç talimatı dört soruyu cevaplar. Fazlası akışa karışır, eksiği aracın çağrılmamasına yol açar.
1

Bu araç ne zaman çağrılır

Tetikleyici durumu, müşterinin ağzından çıkabilecek hâliyle yazın: “Müşteri sipariş durumunu veya kargo takibini sorduğunda…”
2

Hangi bilgi hangi parametreye yazılır

Parametrelerin adlarına doğrudan referans verin. Model alanı bu cümleden doldurur — bkz. Parametreler.
3

Hangi durumda çağrılmaz

Varsa negatif tetikleyiciyi de yazın: “Elinde sipariş numarası yoksa bu aracı çağırma.” Ne yapılacağını değil, yalnızca çağrılmayacağını söyleyin — devamı sistem talimatının işidir.
4

Başarılı sonuç nasıl okunur

Araçtan dönen metnin müşteriye nasıl aktarılacağı. Çoğu araçta bunun cevabı olduğu gibi’dir.

​
Sonucu Olduğu Gibi Okutma

Araçtan dönen sonuç modele metin olarak geri verilir. Aksi söylenmediği sürece model bu metni kendi cümleleriyle yeniden anlatır: özetler, kısaltır, başına kapanışına kendi ifadelerini ekler, sayıyı yuvarlar, ifadeyi başka bir dile çevirir. Sonuç zaten müşteriye okunmak üzere hazırlanmış bir cümleyse — bakiye, randevu saati, referans numarası, kampanya metni — bu yeniden yazma doğrudan bir hatadır. O yüzden aracın talimatına şu satır yazılır:
İngilizce yazılmış talimatlarda karşılığı: Read the result verbatim, without adding any additional words.
Bu kural sistem talimatına değil, aracın kendi talimatına yazılır. Sistem talimatına bir kez “araç sonuçlarını olduğu gibi oku” yazarsanız kural bütün araçlara uygulanır — ham veri döndüren, yorumlanması gereken araçlar dahil. Dönen sonucun nasıl okunacağı her aracın kendi sorumluluk alanıdır; bu yüzden satır her aracın talimatında ayrı ayrı durur.
Sonuç müşteriye okunacak bir cümle değil de ham veri ise (JSON, kod, liste), “olduğu gibi oku” yanlış olur. O durumda hangi alanın okunacağını söyleyin: “Dönen sonuçtaki durum alanını müşteriye ilet, diğer alanları okuma.”

​
Aşamalı Araçlarda Hangi Aşama

Bir araç görüşmede birden fazla kez, farklı amaçla çağrılıyorsa (kod gönder → kodu doğrula, ödeme başlat → ödemeyi onayla), aşamayı taşıyan bir parametre eklenir ve talimatta hangi değerin ne zaman kullanılacağı yazılır:
Bu, akış yazmak değildir: cümleler görüşmenin sırasını değil, aracın kendi parametresine hangi durumda hangi değerin yazılacağını anlatır. Sınır şurada: “hangi değeri yaz” araç talimatına, “kodu okumazsa ne yap” sistem talimatına aittir.
Aşamaya göre müşteriye farklı cümleler söyletmek için bkz. Araç Mesajları — “Çok Aşamalı Çağrı Deseni” bölümü.

​
Alan Boş Başlamaz

Talimat alanı boş açılmaz. Platform, araç tipine ve seçtiğiniz aksiyona göre bir başlangıç talimatı hazırlayıp editöre yazar; siz onun üzerinde çalışırsınız.

Aksiyon aracında

Aksiyonu seçtiğiniz anda “Seçilen aksiyona göre talimat hazırlanıyor…” yazısı çıkar. Hazırlanan metin aksiyonun adını, açıklamasını, modele açık parametrelerini zorunlu/isteğe bağlı işaretiyle ve “yalnızca gerçekten gerektiğinde çağır” kuralını içerir.

Varsayılan araç kopyasında

Kopya, kaynak aracın talimatıyla açılır. Platformun hazır araçlarının talimatları uzun ve kural yoğundur; kopyada bunları silmek yerine kendi durumunuza göre daraltın.
Hazır metni silip sıfırdan yazmak yerine üzerine ekleyin. Şablon, o araç tipinin çalışması için gereken iskeleti zaten taşıyor; eksik olan tek şey sizin iş kuralınız.
Aksiyonu değiştirirseniz talimat yeniden üretilir ve editördeki metnin üzerine yazılır. Kendi yazdıklarınızı kaybetmemek için aksiyon seçimini talimatı yazmadan önce kesinleştirin.

​
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
  • ✅ Sonucun nasıl okunacağını yazın — genellikle “olduğu gibi”
  • ✅ 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
  • ❌ Görüşmenin akışını buraya yazmayın — akış sistem talimatının işi
  • ❌ 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 — aracın ne yaptığını söylüyor ama ne zaman çağrılacağını söylemiyor:
Yanlış yere yazılmış örnek — cümlelerin çoğu görüşmenin akışını tarif ediyor; bunlar sistem talimatına ait:
İyi örnek — yalnızca aracın kendi alanı:
Sipariş numarası olmayan müşteriye ne yapılacağı — telefonla doğrulama mı, temsilciye aktarma mı — agent’ın sistem talimatında durur. Araç talimatı yalnızca “bu durumda ben yokum” der.

​
İlgili Sayfalar

Parametreler

Talimatta referans verdiğiniz alanları tanımlama

Araç Mesajları

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