Araç şeması tasarımı

Teori: model şemayı okuyarak karar verir#

Model hangi aracı çağıracağına, elindeki tek bilgiyle karar verir: araç adı, açıklaması ve parametre şeması. Kodun içinde ne olduğunu görmez. Dolayısıyla şema bir dokümantasyon değil, çalışma zamanı davranışını belirleyen bir arayüz.

• Ad ayırt edici olmalı: "ara" değil "musteri_kaydi_ara".
• Açıklama ne zaman kullanılacağını söylemeli, ne yaptığını değil: "Müşteri kimliği bilinmiyorsa ada göre arama yapar."
• Örtüşen araçlar birleştirilmeli: aynı işi yapan iki araç tutarsız seçim üretir.
• Yıkıcı araçlar ayrı ve açıkça işaretlenmeli: "kaydi_kalici_sil (GERİ ALINAMAZ)".

Örnek: zayıf ve güçlü şema#

// ZAYIF: ne zaman kullanılacağı belirsiz, parametreler serbest metin
{
  "name": "get_data",
  "description": "Veri getirir",
  "parameters": {
    "type": "object",
    "properties": {
      "query": { "type": "string" },
      "options": { "type": "string" }
    }
  }
}

// GÜÇLÜ: seçim ölçütü açık, değerler kısıtlı, zorunluluk belirtilmiş
{
  "name": "siparis_durumu_sorgula",
  "description": "Sipariş numarası BİLİNİYORSA tek siparişin güncel durumunu döndürür. Sipariş numarası bilinmiyorsa önce musteri_siparislerini_listele kullan.",
  "parameters": {
    "type": "object",
    "properties": {
      "siparis_no": {
        "type": "string",
        "pattern": "^SIP-[0-9]{4}-[0-9]{4}$",
        "description": "SIP-YYYY-NNNN biçiminde sipariş numarası"
      },
      "detay": {
        "type": "string",
        "enum": ["ozet", "kalemler", "tam"],
        "default": "ozet",
        "description": "Dönecek ayrıntı seviyesi"
      }
    },
    "required": ["siparis_no"],
    "additionalProperties": false
  }
}

Güçlü şemadaki üç detay pratikte en çok fark yaratanlar: `enum` ile değer kümesini kapatmak, `pattern` ile biçimi zorlamak ve açıklamanın içinde diğer araca yönlendirme yapmak. Üçü de modelin tahmin etme ihtiyacını azaltır.

Hata mesajı tasarımı#

Bir araç hata döndürdüğünde bu mesaj modele geri gider ve sonraki adımı belirler. "500 Internal Server Error" modelin yapabileceği bir şey söylemez; model ya aynı çağrıyı tekrarlar ya da vazgeçer. İyi bir hata mesajı, düzeltme yolunu içerir.

Araç sayısı#

Araç sayısı arttıkça iki şey birden kötüleşir: şemaların kapladığı token miktarı büyür ve seçim isabeti düşer. Pratik yaklaşım, ajan başına araç sayısını dar tutmak ve geniş yetenek ihtiyacını birden çok uzmanlaşmış ajana bölmek.