Skip to main content
函数调用(也叫 工具调用 / Tool Use)允许模型在生成回复过程中要求执行外部函数, 用于查询数据库、调用 API、读写文件等动作。OpenPAI 三套协议都完整支持,且可互通。

OpenAI 协议

执行函数后,把结果回传:

tool_choice

parallel_tool_calls

新模型默认支持并行调用多个工具,响应中 tool_calls 是数组,需逐个执行后一次性回传。 若需禁用并行,设置 parallel_tool_calls: false

Claude 协议

tool_choice(Claude)

Gemini 协议

回传:

协议互通

通过 OpenPAI 的 OpenAI 兼容端点 调用 Claude / Gemini 模型时, OpenPAI 会自动将 Anthropic / Google 的工具调用结构转换为 OpenAI 的 tools / tool_calls, 反向亦然。你 无需 关心协议差异,只需选择一套写法即可。

最佳实践

详细 description

工具的 description 越具体,模型越能正确决定何时调用与传什么参数。

严格 schema

使用 requiredadditionalProperties: false,避免模型乱传字段。

错误优雅处理

工具执行失败时,把错误信息以 tool_result 形式回传,模型可重试或换策略。

并行调用

多个相互独立的工具一次调用并行执行,降低延迟。