BroadRouter
Başlayın

Araç çağırma (tool calling)

Güncellendi

Araç çağırma (tool calling), fonksiyon çağırma (function calling) olarak da bilinir; modelin, geliştiricinin tanımladığı bir fonksiyonu çalıştırmak için JSON argümanlı yapılandırılmış bir istek döndürdüğü bir LLM API özelliğidir. Fonksiyonu uygulama çalıştırır ve sonucu geri gönderir; model hiçbir zaman kodu kendisi çalıştırmaz.

Diğer adları: araç çağırma, araç çağrısı, fonksiyon çağırma, araç kullanımı, function calling, tool calling, tool use, tools, tool_calls

Araç çağırma, bir dil modelinin dünyada iş yapma yoludur: kodunuzdan bir şeye bakmasını, bir sorgu çalıştırmasını veya bir dosyayı düzenlemesini ister, sonra sonucu kullanır.

Nasıl çalışır

OpenAI’nin rehberi, uygulamanızla model arasında bir döngü tarif eder:

  1. Araçları gönderin. İstek; adı, açıklaması ve argümanlar için bir JSON Schema’sı olan fonksiyonları listeler.
  2. Bir araç çağrısı alın. Modelin bir araca ihtiyacı varsa nihai yanıt yerine fonksiyon adını ve JSON argümanlarını döndürür.
  3. Çalıştırın. Fonksiyonu kodunuz yürütür. OpenAI’nin rehberi bu adımı “the application side” (çeviri: uygulama tarafı) olarak konumlar; model hiçbir zaman kodu kendisi çalıştırmaz.
  4. Sonucu eşleşen çağrı kimliğiyle geri gönderin.
  5. Yanıtı alın ya da yeni bir araç çağrısı. Gerektiği kadar tekrarlayın.

Chat Completions biçiminde bir araç tanımı şöyle görünür:

{
  "type": "function",
  "function": {
    "name": "get_order_status",
    "description": "Look up an order by ID",
    "parameters": {
      "type": "object",
      "properties": { "order_id": { "type": "string" } },
      "required": ["order_id"]
    }
  }
}

(Buradaki description, fonksiyonun bir siparişi kimliğiyle sorguladığını söyler.) Yanıtta finish_reason: "tool_calls" ve bir tool_calls listesi bulunur. Her girişte bir id, fonksiyon adı ve JSON dizesi olarak arguments vardır. role: "tool", aynı tool_call_id ve sonucu içeren bir mesaj ekler, ardından API’yi yeniden çağırırsınız.

Neden önemli

  • Ajanlar. Kodlama ajanları, destek botları ve veri asistanları çoğunlukla araç çağrısı döngülerinden ibarettir.
  • Maliyet. Her gidiş-dönüş; konuşmayı, araç tanımlarını ve araç sonuçlarını girdi token’ı olarak yeniden gönderen yeni bir istektir. Uzun araç döngüleri önbellekli girdiyi ve sabit bir araç sırasını önemli kılar.
  • Güvenlik. Argümanlar modelden gelir. Veri değiştiren veya para harcayan bir şeyi çalıştırmadan önce doğrulayın.

Bir şemaya uyması gereken ama fonksiyon gerektirmeyen bir yanıt için yapılandırılmış çıktı daha basit bir araçtır.

BroadNet Inference’ta

BroadNet’in belgeleri araç çağırmayı GLM 5.3 ve Qwen3.8 27B için, ikisinde de yapılandırılmış çıktı ve akıl yürütmeyle birlikte listeler. Belgeler DeepSeek V4.1 Flash veya BroadNet Gemma 4 VL 26B için araç desteği belirtmez. Kendi araç döngünüzü yayına almayı planladığınız modelde test edin.

Listelenen iki model de yanıt vermeden önce akıl yürütür ve akıl yürütme max_tokens sınırına dahildir; bu yüzden pay bırakın, yoksa bir araç çağrısı kesilebilir. Akıl yürütme token’ları maddesine bakın. Kendi araç biçimini getiren ajan araçları için Cline rehberine ve Vercel AI SDK rehberine bakın.

Sık yapılan hatalar

  • arguments alanını nesne olarak ayrıştırmaya çalışmak. JSON dizesi olarak gelir; çözümleyin ve hataları ele alın.
  • tool_call_id değerini unutmak. Model onsuz sonuçları çağrılarla eşleştiremez.

Sık sorulan sorular

Fonksiyonumu model mi çalıştırıyor?

Hayır. Model yalnızca fonksiyon adını ve argümanları döndürür. Çalıştırıp çalıştırmamaya kodunuz karar verir, onu çalıştırır ve sonucu bir tool mesajıyla geri gönderir.

Model aynı anda birkaç araç çağırabilir mi?

Birçok API paralel araç çağrılarına izin verir ve tek yanıtta tool_calls içinde birkaç giriş döndürür. Kodunuz her birini çalıştırır ve her tool_call_id için bir sonuç döndürür.

Hangi BroadNet modelleri araç çağırmayı destekliyor?

BroadNet'in belgeleri araçları GLM 5.3 ve Qwen3.8 27B için listeler. DeepSeek V4.1 Flash veya BroadNet Gemma 4 VL 26B için araç desteği belirtilmez; bu modellerde buna güvenmeden önce test edin.

Markdown olarak okuChatGPT asistanına sorClaude asistanına sorPerplexity asistanına sor