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:
- Araçları gönderin. İstek; adı, açıklaması ve argümanlar için bir JSON Schema’sı olan fonksiyonları listeler.
- 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.
- Ç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.
- Sonucu eşleşen çağrı kimliğiyle geri gönderin.
- 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
argumentsalanını nesne olarak ayrıştırmaya çalışmak. JSON dizesi olarak gelir; çözümleyin ve hataları ele alın.tool_call_iddeğerini unutmak. Model onsuz sonuçları çağrılarla eşleştiremez.