文档

工具调用与结构化输出

只对所选配置已声明的能力发送对应字段。

先选择同一配置

一个模型的 OpenAI 与 Anthropic 配置可能声明不同能力。工具、结构化输出、输入模态和预算必须来自同一 profile,不能合并成模型“全部支持”。模型详情给出当前参数清单。

工具调用

工具调用是模型提出的操作请求,应用仍须检查工具名称、参数和授权,再执行操作并回传结果。

以下 JSON 只是工具定义片段,不是完整请求:

OpenAI 格式:

json
{"tools":[{"type":"function","function":{"name":"lookup_weather","description":"Look up weather for a city","parameters":{"type":"object","properties":{"city":{"type":"string"}},"required":["city"]}}}]}
{"tools":[{"type":"function","function":{"name":"lookup_weather","description":"Look up weather for a city","parameters":{"type":"object","properties":{"city":{"type":"string"}},"required":["city"]}}}]}

Anthropic 格式:

json
{"tools":[{"name":"lookup_weather","description":"Look up weather for a city","input_schema":{"type":"object","properties":{"city":{"type":"string"}},"required":["city"]}}]}
{"tools":[{"name":"lookup_weather","description":"Look up weather for a city","input_schema":{"type":"object","properties":{"city":{"type":"string"}},"required":["city"]}}]}
环节OpenAIAnthropic
模型请求工具message.tool_callscontent 中的 tool_use
参数function.arguments 的 JSON 字符串input 对象
回传关联role=tool 与原 tool_call_idtool_result 与原 tool_use_id

流式工具参数可能分多次到达,应按 ID/索引收集完整参数再执行。不要对每个增量块执行一次工具。现有体验台显示工具输出不等于代您的应用完成外部工具执行。

结构化输出

只在配置明确声明支持且列出相应参数时使用。例如 OpenAI 形式的 response_format 不应原样传给 Anthropic 配置。当前接入没有提供某种 JSON Schema 子集、strict 或保证时,不作统一保证;查所选模型资料与接口参考。

对结构化响应仍需读取结束原因和错误,截断/拒绝/流中断不能当完整 JSON。需要完整结构时为输出预算预留足够空间。

图像输入与缓存

输入模态包含 image 只表示该配置声明图像输入,不能推出生图能力。消息块格式、大小和传输方式随协议及模型变化,缺少正式说明时不要猜测上限。

缓存计量与价格见计费说明。原厂显式缓存参数不自动等于平台已接入;当前百炼适配器使用隐式缓存,不能照搬原厂显式 cache_control 承诺。