BroadRouter
Başlayın

Paralel araç çağrıları (parallel tool calls)

Güncellendi

Paralel araç çağrıları, bir modelin tek bir yanıtta birden fazla araç çağrısı döndürmesidir; örneğin aynı anda üç dosya okuma. OpenAI formatında bunlar tool_calls içinde birkaç girdi olarak gelir ve parallel_tool_calls değerini false yapmak modeli tur başına sıfır veya bir çağrıyla sınırlar.

Diğer adları: paralel araç çağırma, paralel fonksiyon çağırma, çoklu araç çağrısı, parallel tool calling, parallel function calling, parallel_tool_calls, multiple tool calls

Üç dosyaya ihtiyaç duyan bir ajanın bunları her biri için ayrı bir gidiş-dönüşle istemesi gerekmez. Paralel araç çağrılarıyla model üçünü birden ister.

Nasıl çalışır

Bir araç çağırma yanıtında message.tool_calls bir listedir. Paralel çağrılarda bu listede birden fazla girdi bulunur; her birinin kendi id değeri, fonksiyon adı ve JSON argümanları vardır.

"tool_calls": [
  {"id": "call_1", "type": "function", "function": {"name": "read_file", "arguments": "{\"path\": \"a.py\"}"}},
  {"id": "call_2", "type": "function", "function": {"name": "read_file", "arguments": "{\"path\": \"b.py\"}"}}
]

Kodunuz çağrıları çalıştırır, her çağrı için eşleşen tool_call_id değeriyle birer tool mesajı ekler ve ardından modeli yeniden çağırır.

  • OpenAI: parallel_tool_calls varsayılan olarak true değerindedir. false yapmak “ensures exactly zero or one tool is called.” (çeviri: tam olarak sıfır veya bir aracın çağrılmasını sağlar.) Rehber, bir model sürümünün (snapshot) zaman zaman aynı araca yinelenen çağrılar yaptığı konusunda uyarır ve orada özelliğin kapatılmasını önerir.
  • Anthropic: paralel kullanım varsayılan olarak açıktır. tool_choice nesnesinin içinde disable_parallel_tool_use: true ile kapatın. Anthropic, API’nin “doesn’t prescribe an execution order” (çeviri: bir yürütme sırası dayatmadığını) ve paralelliğin çalışmaya devam etmesi için tüm araç sonuçlarının tek bir kullanıcı mesajında geri gönderilmesi gerektiğini söyler.

Neden önemli

  • Gecikme. Modele daha az gidiş-dönüş yapılır. Birbirinden bağımsız, salt okunur araçlar sizin tarafınızda aynı anda çalışabilir.
  • Sıralama. Önce yazıp sonra okumak gibi yan etkili çağrılar birbirine bağlı olabilir. Anthropic bunların sırayla çalıştırılmasını önerir. Ya da özelliği kapatın.
  • Kayıt tutma. Her çağrının doğru kimlikle bir sonucu olmalıdır. Eksik bir sonuç, bir sonraki isteğin başarısız olmasının yaygın bir nedenidir.

BroadNet Inference’ta

BroadNet’in API referansı, GLM 5.3 ve Qwen3.8 27B için araç çağırmayı belgeler, parallel_tool_calls parametresini ise belgelemez. İsteminizin birkaç çağrı döndürüp döndürmediğini ve false değerine uyulup uyulmadığını test edin. Paralel çağrılar tek bir yanıtta gelir; dolayısıyla istek sayınızı artırmaz. Araçları çalıştırmak sizin tarafınızdadır. BroadNet sınırsız plan oturumunun aynı anda tek bir isteğe izin verdiğini ve yalnızca DeepSeek V4.1 Flash için olduğunu unutmayın; kullandıkça öde anahtarlarında eşzamanlılık sınırı aynı anda 4 açık istektir. Açık modellerle araç çağırma yazısında çalışan bir döngü bulunur.

Sık yapılan hatalar

  • Sonuçları her çağrı için farklı bir mesaj biçiminde döndürmek ya da birini atlamak.
  • Model birlikte listeledi diye birbirine bağlı araçları eşzamanlı çalıştırmak.

Sık sorulan sorular

Paralel araç çağrıları paralel API istekleri anlamına mı gelir?

Hayır. Model tek bir yanıtta birkaç çağrı döndürür. Kodunuz bunları eşzamanlı ya da sırayla çalıştırır ve tüm sonuçları bir sonraki istekte geri gönderir.

Paralel araç çağrılarını nasıl kapatırım?

OpenAI formatında parallel_tool_calls değerini false yapın; OpenAI bunun "ensures exactly zero or one tool is called" (çeviri: tam olarak sıfır veya bir aracın çağrılmasını sağladığını) söyler. Anthropic API'sinde tool_choice içinde disable_parallel_tool_use değerini true yapın.

BroadNet Inference parallel_tool_calls destekliyor mu?

BroadNet'in API referansı parallel_tool_calls parametresini belgelemez. Araç çağırma GLM 5.3 ve Qwen3.8 27B için belgelenmiştir; birkaç çağrı döndürüp döndürmediklerini ve bayrağa uyulup uyulmadığını test edin.

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