调用工具
描述你的函数,执行模型请求的调用,并把结果发回去,直到它给出回答。
在 tools 中描述你的函数,模型就会用对其中某个函数的调用来回答(例如一次数据库查询),而不是去猜。模型自己从不运行任何东西:由你的应用运行函数并把结果发回去,然后模型再写出最终回答。
curl https://api.phaseo.app/v1/chat/completions \
-H "Authorization: Bearer $PHASEO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "openai/gpt-6-astra",
"messages": [
{ "role": "user", "content": "What is the weather in London?" }
],
"tools": [
{
"type": "function",
"function": {
"name": "get_weather",
"description": "Get current weather by city",
"parameters": {
"type": "object",
"properties": {
"city": { "type": "string" }
},
"required": ["city"]
}
}
}
]
}'
在 Chat Completions 上,回复带有 finish_reason: "tool_calls",助手消息上有一个 tool_calls 列表,每一项都包含 id、函数 name 和 JSON 字符串形式的 arguments。执行每个调用,然后发送一个后续请求:重复之前的对话、原样附上助手消息,并为每个调用附上一条 role: "tool" 消息,用 tool_call_id 对应。同时再次发送 tools。模型要么给出回答,要么调用另一个工具,你就重复这个过程。在 /v1/responses 上,调用是一个 function_call 项,你的结果是一个带有相同 call_id 的 function_call_output 项;在 /v1/messages 上,它们是 tool_use 和 tool_result 块。
tool_choice 控制模型是否可以调用工具:none 表示只输出文本,auto(或不设置)表示由模型决定,required 表示强制调用,也可以用一个对象指定某个工具。当你的工具必须一次只运行一个时,把 parallel_tool_calls 设为 false。
把每个调用都当作不可信的输入。根据允许列表检查工具名称,拒绝未知名称,并在运行任何东西之前验证解析后的参数。如果验证失败,不要运行工具:把一条简短的错误作为工具结果发回去,让模型重试。使用 stream: true 时,先收集完所有参数增量再解析。类型以 phaseo: 开头的工具(例如 phaseo:web_search 或 phaseo:datetime)在 Phaseo 端运行,所以你无需编写执行器就能拿到最终回答。这些服务器工具目前处于 Beta 阶段。
检验你的理解
模型返回了一个对 delete_user 的调用,参数为 {"id": "42"}。你的应用只定义了 get_weather。你的代码应该怎么做?
学以致用
你的客服机器人调用 get_order,然后给出回答。一位同事写的循环在后续请求中只发送了 role: "tool" 消息,结果被提供商拒绝了。缺了什么?
显示答案隐藏答案
后续请求必须先重复之前的对话,然后原样附上带有 tool_calls 的助手消息,再为每个调用附上一条带有对应 tool_call_id 的 role: "tool" 消息。同时也要再次发送 tools。前面没有调用的工具结果无从对应。
要点
相关链接
最后核对于 2026年11月17日