AI CodeOps

Araç çağırma (tool calling)

Son güncelleme

Araç çağırma, bir modelin uygulamadan bir fonksiyonu çalıştırmasını ve sonucu döndürmesini istemesini sağlar. Gidiş-dönüşün işleyişi ve AI CodeOps oturumlarındaki araç sınırları.

Araç çağırma (tool calling), diğer adıyla fonksiyon çağırma (function calling), modelin düz metin yerine adlandırılmış bir aracı argümanlarla çalıştırmak için yapılandırılmış bir istek döndürdüğü bir model yeteneğidir. Uygulama aracı çalıştırır ve sonucu geri gönderir; model de devam eder.

Nedir

Anthropic'in tool use dokümantasyonunda tarif edildiği hâliyle gidiş-dönüş:

  1. İstek, her birinin bir adı, bir açıklaması ve girdisi için bir JSON Schema'sı olan araçları listeler.
  2. Model birini çağırmaya karar verir ve aracı ve girdisini belirten bir tool_use bloğuyla durur.
  3. Kodunuz aracı çalıştırır ve bir tool_result geri gönderir.
  4. Model sonucu yanıt vermek için kullanır veya başka bir aracı çağırır.

Web araması gibi bazı araçlar bunun yerine sağlayıcı tarafında çalışır. Araç tanımları ve sonuçlarının tümü girdi token'ı olarak sayılır.

Neden önemlidir

Araçlar, bir ajanın yalnızca konuşmayı bırakıp harekete geçmesinin yoludur: bir dosya okumak, bir iş takip aracında arama yapmak, bir komut çalıştırmak. Her araç aynı zamanda bir izindir; bu yüzden bir ajanın hangi araçları gördüğü, ona ne söylendiği kadar özen gerektirir.

AI CodeOps'ta

Bir oturumdaki ajanlar, eklediğiniz uzak MCP sunucularındaki araçları çağırır. Ajanların gördüğü hâliyle:

tool names   <server>__<tool>
per session  up to 32 MCP tools
per step     up to 6 rounds of tool calls
per call     30-second timeout; long results are shortened

Bir politika kuralının reddettiği veya bir ajanın izinlerinin dışında bıraktığı araçlar, model listeyi görmeden önce kaldırılır.

Sık sorulan sorular

Araç çağırma, fonksiyon çağırmayla aynı şey midir?

Evet. Sağlayıcılar aynı şey için iki adı da kullanır: model, adlandırılmış bir fonksiyonu argümanlarla çağırmak için yapılandırılmış bir istek döndürür.

Bir model, kendisine verilmemiş bir aracı çağırabilir mi?

AI CodeOps'ta hayır. Modelin uydurduğu bir araç adı oturumun listesinde yer almaz; bu yüzden çağrı çalışamaz.