火山引擎方舟平台仅部分模型支持工具调用，如Doubao-Seed-2.1-pro等已支持OpenAI兼容的tools/tool_choice；图像模型不支持，配置将被忽略；需在请求体中正确声明tools数组及required字段，并通过tool_choice控制调用行为，最后验证响应中的tool_calls字段。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
确认模型是否支持工具调用能力
火山引擎方舟平台当前仅部分模型原生支持函数调用（Function Calling）协议，不是所有模型都能调用工具。Doubao-Seed-2.1-pro、Doubao-Seed-2.1-turbo、DeepSeek-R1、Kimi-Plus 等主流编程/推理模型已通过 OpenAI 兼容接口开放 tool_choice 与 tools 参数解析能力；而 Doubao-Seed-Character、Doubao-Seedream 系列图像生成模型【不支持工具调用】，配置 tools 字段将被直接忽略。
登录火山方舟控制台 → 进入「模型服务」→ 查看目标模型详情页的「能力说明」栏，确认是否标注“支持函数调用”或“兼容 OpenAI tools schema”。未标注即不可用，强行配置会导致请求静默失败或返回 400 错误。
在请求体中声明可用工具列表
使用 OpenAI 兼容接口时，必须在 POST 请求的 JSON body 中显式传入 tools 数组。每个工具需包含 type（固定为 "function"）、function.name、function.description 及 function.parameters（JSON Schema 格式）。
例如调用联网搜索工具：
{"tools": [{"type": "function", "function": {"name": "web_search", "description": "实时检索互联网公开信息，适用于时效性问题", "parameters": {"type": "object", "properties": {"query": {"type": "string", "description": "搜索关键词，不超过200字符"}}, "required": ["query"]}}}]}
注意：火山网关对 parameters 的 required 字段校验严格，若声明了 required: ["query"] 却未传 query 值，会直接返回 400 错误，而非触发模型推理。
控制工具调用行为：tool_choice 参数设置
tool_choice 决定模型是否必须调用工具、调用哪个工具，或由模型自主判断。它有三个合法取值：
方法一：不强制调用 → 设为 "none"。模型将忽略 tools 列表，纯文本回复。适用于测试阶段或兜底场景。
方法二：自动选择 → 设为 "auto"（默认值）。模型根据用户问题语义决定是否调用、调用哪一个。这是最常用的方式，但存在不确定性：同一问题可能某次调用、某次不调用。
方法三：指定调用 → 设为 {"type": "function", "function": {"name": "web_search"}}。模型【必须调用该工具且仅能调用该工具】，否则请求失败。适用于流程强约束场景，如日报生成链路中固定需先查行业新闻。
验证工具调用是否生效
第一步：用 curl 发起最小化测试请求，只带 tools 和 tool_choice，不加 system message 或历史上下文。
第二步：观察响应中的 "tool_calls" 字段。若存在，说明模型已识别并准备调用；若为空数组或缺失该字段，检查 tools 格式是否符合 JSON Schema、tool_choice 是否拼写错误、模型 ID 是否在支持清单内。
第三步：捕获响应中的 function.name 和 function.arguments。arguments 必须是合法 JSON 字符串，不能含换行或未转义引号，否则下游工具执行会报错。
