Panduan
Panggilan tool
Kedua model memanggil tool dalam format OpenAI: kamu mendeskripsikan fungsi, model meminta salah satunya, kamu menjalankannya dan mengirim kembali hasilnya.
Diperiksa 26 Oktober 2026
Loop-nya
- Kirim
tools: masing-masing berupa fungsi dengan nama, deskripsi, dan parameter JSON Schema. - Saat model menginginkannya,
finish_reasonbalasan adalahtool_callsdanmessage.tool_callsmendaftarkannya, dengan argumen sebagai string JSON. - Jalankan masing-masing, dan tambahkan pesan
tooldengantool_call_id-nya dan hasilnya. - Kirim percakapannya lagi. Ulangi sampai
finish_reasonadalahstop.
import json
import os
from openai import OpenAI
client = OpenAI(
base_url="https://nokeep.ai/v1",
api_key=os.environ["NOKEEP_API_KEY"],
)
tools = [{
"type": "function",
"function": {
"name": "get_weather",
"description": "Today's weather in a city",
"parameters": {
"type": "object",
"properties": {"city": {"type": "string"}},
"required": ["city"],
},
},
}]
def get_weather(city):
return {"city": city, "high_c": 21, "sky": "clear"}
messages = [{"role": "user", "content": "Should I bring a jacket in Lisbon today?"}]
while True:
reply = client.chat.completions.create(model="deepseek-v4.1-flash-uncensored", messages=messages, tools=tools)
message = reply.choices[0].message
messages.append(message)
if not message.tool_calls:
print(message.content)
break
for call in message.tool_calls:
result = get_weather(**json.loads(call.function.arguments))
messages.append({"role": "tool", "tool_call_id": call.id, "content": json.dumps(result)})tool_choice
| Model | Menerima |
|---|---|
deepseek-v4.1-flash-uncensored | auto, none, required, atau nama fungsi tertentu. Juga parallel_tool_calls. |
glm-5.3-flash-uncensored | auto atau none. Ia memilih tool-nya sendiri; nilai lain dijawab 400 unsupported_tool_choice. |
Perlu diketahui
- Setiap pesan
toolharus memuattool_call_idyang dijawabnya, atau panggilan ditolak dengan400 invalid_messages. - Skema tool dikirim di setiap permintaan dan dihitung sebagai token input.
- Model tidak menjalankan apa pun sendiri. Kodemu yang menjalankan tool, jadi kamu yang memutuskan apa yang bisa mereka jangkau.