第 1/3 节课 · 10 分钟

调用工具

描述你的函数,执行模型请求的调用,并把结果发回去,直到它给出回答。

在 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。前面没有调用的工具结果无从对应。

要点

模型提出请求,你的应用验证并执行调用,然后带着调用 ID 把结果发回去,直到模型给出最终回答。

相关链接

进度保存在此浏览器中。

最后核对于 2026年11月17日