---
title: "Apakah itu tool calling (function calling) dalam API LLM?"
description: "Tool calling membolehkan LLM meminta kod anda jalankan fungsi dengan argumen JSON. Cara gelung permintaan dan hasil berfungsi, kos token dan kegunaannya oleh ejen."
url: https://broadrouter.com/ms/glossary/tool-calling/
lang: ms
updated: 2026-11-14
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Diterjemahkan daripada bahasa Inggeris dengan bantuan AI. [Baca versi asal dalam bahasa Inggeris](https://broadrouter.com/glossary/tool-calling/) (dikemas kini 2026-11-14).

# Tool calling (panggilan alatan)

Dikemas kini 2026-11-14

Tool calling, juga dipanggil function calling, ialah ciri API LLM di mana model memulangkan permintaan berstruktur untuk menjalankan fungsi yang ditakrifkan oleh pembangun, bersama argumen JSON. Aplikasi menjalankan fungsi itu dan menghantar hasilnya kembali; model sendiri tidak pernah menjalankan kod.

Juga dikenali sebagai: panggilan alatan, panggilan fungsi, tool calling, function calling, tool use, tools, tool\_calls

Tool calling ialah cara model bahasa bertindak di luar dirinya: ia meminta kod anda mencari sesuatu, menjalankan pertanyaan atau menyunting fail, kemudian menggunakan hasilnya.

## Cara ia berfungsi

Panduan OpenAI menerangkan satu gelung antara aplikasi anda dan model:

1.  **Hantar alatan.** Permintaan menyenaraikan fungsi dengan nama, penerangan dan JSON Schema untuk argumen.
2.  **Terima panggilan alatan.** Jika model memerlukan alatan, ia memulangkan nama fungsi dan argumen JSON dan bukan jawapan akhir.
3.  **Jalankan.** Kod anda melaksanakan fungsi itu. Panduan OpenAI meletakkan langkah ini di “the application side” (pihak aplikasi); model sendiri tidak pernah menjalankan kod.
4.  **Pulangkan hasil** bersama ID panggilan yang sepadan.
5.  **Terima jawapan**, atau panggilan alatan seterusnya. Ulang mengikut keperluan.

Dalam format Chat Completions, definisi alatan kelihatan seperti di bawah. Contohnya ialah fungsi `get_order_status` yang mencari pesanan mengikut ID, dengan satu argumen wajib, `order_id`:

```json
{
  "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"]
    }
  }
}
```

Jawapan mempunyai `finish_reason: "tool_calls"` dan senarai `tool_calls`. Setiap entri mempunyai `id`, nama fungsi dan `arguments` sebagai rentetan JSON. Anda menambah mesej dengan `role: "tool"`, `tool_call_id` yang sama dan hasilnya, kemudian memanggil API sekali lagi.

## Mengapa ia penting

-   **Ejen.** Ejen pengekodan, bot sokongan dan pembantu data kebanyakannya ialah gelung panggilan alatan.
-   **Kos.** Setiap pusingan ialah permintaan baharu yang menghantar semula perbualan, definisi alatan dan hasil alatan sebagai [token input](https://broadrouter.com/ms/glossary/input-and-output-tokens/). Gelung alatan yang panjang menjadikan [input cache](https://broadrouter.com/ms/glossary/cached-input-tokens/) dan susunan alatan yang stabil penting.
-   **Keselamatan.** Argumen datang daripada model. Sahkan argumen itu sebelum menjalankan apa-apa yang mengubah data atau membelanjakan wang.

Untuk jawapan yang mesti mengikut skema tetapi tidak memerlukan fungsi, [output berstruktur](https://broadrouter.com/ms/glossary/structured-output/) ialah pilihan yang lebih ringkas.

## Di BroadNet Inference

Dokumentasi BroadNet menyenaraikan tool calling untuk [GLM 5.3](https://broadrouter.com/ms/models/glm-5.3/) dan [Qwen3.8 27B](https://broadrouter.com/ms/models/qwen3.8-27b/), kedua-duanya dengan output berstruktur dan penaakulan. Dokumentasi tidak menyatakan sokongan alatan untuk DeepSeek V4.1 Flash atau BroadNet Gemma 4 VL 26B. Uji gelung alatan anda sendiri pada model yang anda rancang untuk digunakan dalam produksi.

Kedua-dua model yang disenaraikan membuat penaakulan sebelum menjawab, dan penaakulan dikira dalam `max_tokens`, jadi tinggalkan ruang atau panggilan alatan boleh terpotong. Lihat [token penaakulan](https://broadrouter.com/ms/glossary/reasoning-tokens/). Untuk alatan ejen yang membawa format alatan sendiri, lihat [panduan Cline](https://broadrouter.com/ms/guides/cline-openai-compatible/) dan [panduan Vercel AI SDK](https://broadrouter.com/ms/guides/vercel-ai-sdk-openai-compatible/).

## Kesilapan biasa

-   Menghuraikan `arguments` sebagai objek. Ia tiba sebagai rentetan JSON; nyahkodnya dan kendalikan ralat.
-   Terlupa `tool_call_id`. Model tidak dapat memadankan hasil dengan panggilan tanpanya.

## Soalan lazim

### Adakah model menjalankan fungsi saya?

Tidak. Model hanya memulangkan nama fungsi dan argumen. Kod anda yang memutuskan sama ada untuk menjalankannya, menjalankannya, dan menghantar hasilnya kembali dalam mesej tool.

### Bolehkah model memanggil beberapa alatan sekali gus?

Banyak API membenarkan panggilan alatan selari (parallel tool calls), dengan beberapa entri dalam tool\_calls dalam satu respons. Kod anda menjalankan setiap satu dan memulangkan satu hasil bagi setiap tool\_call\_id.

### Model BroadNet manakah yang menyokong tool calling?

Dokumentasi BroadNet menyenaraikan tools untuk GLM 5.3 dan Qwen3.8 27B. Ia tidak menyatakan sokongan alatan untuk DeepSeek V4.1 Flash atau BroadNet Gemma 4 VL 26B, jadi uji dahulu sebelum bergantung padanya pada model tersebut.

## Lihat juga

-   [Output berstruktur (structured output)](https://broadrouter.com/ms/glossary/structured-output/) (istilah)
-   [Token input dan output (input and output tokens)](https://broadrouter.com/ms/glossary/input-and-output-tokens/) (istilah)
-   [Token input cache (cached input tokens)](https://broadrouter.com/ms/glossary/cached-input-tokens/) (istilah)
-   [API serasi OpenAI (OpenAI-compatible API)](https://broadrouter.com/ms/glossary/openai-compatible-api/) (istilah)
-   [Ejen AI (AI agent)](https://broadrouter.com/ms/glossary/agent/) (istilah)
-   [MCP (Model Context Protocol)](https://broadrouter.com/ms/glossary/mcp/) (istilah)
-   [Mod JSON (JSON mode)](https://broadrouter.com/ms/glossary/json-mode/) (istilah)
-   [Prompt injection (suntikan prompt)](https://broadrouter.com/ms/glossary/prompt-injection/) (istilah)
-   [tool\_choice](https://broadrouter.com/ms/glossary/tool-choice/) (istilah)
-   [Panggilan alatan selari (parallel tool calls)](https://broadrouter.com/ms/glossary/parallel-tool-calls/) (istilah)
-   [JSON Schema (skema JSON)](https://broadrouter.com/ms/glossary/json-schema/) (istilah)
-   [Cara guna OpenAI Python SDK dengan BroadNet Inference](https://broadrouter.com/ms/guides/openai-python-sdk/) (panduan)
-   [Guna Cline dengan BroadNet Inference (penyedia OpenAI Compatible)](https://broadrouter.com/ms/guides/cline-openai-compatible/) (panduan)
-   [Cara guna Vercel AI SDK dengan BroadNet Inference](https://broadrouter.com/ms/guides/vercel-ai-sdk-openai-compatible/) (panduan)
-   [Cara menjalankan ejen pengekodan selari pada API LLM kadar tetap](https://broadrouter.com/ms/blog/run-parallel-coding-agents-flat-rate/) (artikel)
-   [Bila tetingkap konteks 1M token berbaloi (dan bila tidak)](https://broadrouter.com/ms/blog/million-token-context-window-guide/) (artikel)

Cuba dengan beban kerja sebenar anda. Akaun baharu bermula dengan kredit US$5 untuk Gemma dan transkripsi. DeepSeek, GLM dan Qwen3.8 memerlukan tambah nilai.

[Mulakan](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ms-glossary-tool-calling&utm_content=page-cta) ·

**Sumber**

-   [OpenAI, panduan function calling](https://developers.openai.com/api/docs/guides/function-calling)
-   [Rujukan API OpenAI, create chat completion (tools)](https://developers.openai.com/api/reference/resources/chat/subresources/completions/methods/create)
-   [Rujukan API BroadNet Inference, model (Bahasa Inggeris)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ms-glossary-tool-calling&utm_content=sources#models)
