MiniMax Agent工具调用流程详解

必须完成权限配置、工具注册、提示词约束和请求体携带tools字段四步，缺一不可；需在控制台启用工具调用、逐个注册工具、用三步提示词明确指令边界、API请求中显式传入tools数组。

要在 MiniMax Agent 中让智能体自动调用外部工具（比如搜索网页、执行代码、查天气、发飞书消息），必须完成从权限配置、工具注册到实际触发的完整链路，缺一不可，否则工具始终处于“可见但不可用”状态。

在控制台启用工具调用能力

Agent 默认不开启工具调用，即使后续配置了工具，也不会识别或执行任何 function call 请求。

登录 Minimax 开发者控制台 → 进入目标 Agent 的「编辑」页 → 左侧菜单点击「工具」→ 找到顶部开关「启用工具调用」，将其切换为开启状态。

注册你要使用的具体工具

工具不是即装即用的，必须逐个注册并绑定参数，系统才认得它。目前支持三类注册方式：

方法一：直接接入最新预置工具
在「工具」页点击「添加工具」→ 选择「预置工具」标签页 → 勾选「Web 搜索」或「Python 代码执行器」→ 点击「确认添加」。这类工具无需填密钥，但仅限基础功能。

方法二：填写 API 密钥接入第三方服务
例如接入飞书机器人：选择「自定义工具」→ 工具类型选「HTTP」→ 填写飞书开放平台提供的 App ID 和 App Secret → 在请求模板中写好 POST 地址与 JSON body 结构 → 测试连接成功后保存。

方法三：上传本地可执行脚本（仅限私有部署环境）
如果当前采用的是 Minimax 私有 Agent 部署方案，就可以在「自定义工具」里选择「Shell 脚本」类型，然后直接粘贴脚本内容，比如用 curl 调用内部 CRM 接口；接着设置超时时间（建议 ≤15s），最后保存即可。需要特别注意的是，公有云平台并不支持这种方式。

配置系统提示词，明确指令边界

工具调用不是模型自发行为，必须靠提示词强制约束其决策路径。以下写法实测有效：

第一步：声明工具可用性
在系统提示词开头写明：“你具备调用以下工具的能力：[Web 搜索]、[Python 执行器]、[飞书消息推送]。仅在用户明确要求执行动作、查询实时信息或需要计算结果时，才调用工具。”

第二步：禁止幻觉调用
紧接着加一句：“若用户问题可通过已有知识回答，严禁虚构工具调用；未获用户授权，不得擅自发送飞书消息或运行 Python 代码。”

第三步：指定失败兜底话术
补上：“工具调用失败时，直接告知用户‘暂无法获取该信息’，不要编造结果。”

这三步缺一不可。漏掉第二步，Agent 可能在不该调用时强行发起请求，造成飞书误通知或代码执行异常。

构造带工具描述的请求体

调用 API 时，必须把工具定义塞进 messages 上下文里，而不是只传 agent_id。否则模型根本“看不见”工具。

发起 POST 请求时，Body 里的 JSON 不能只放 agent_id 和 messages，还必须额外带上 tools 字段。这个字段的值是一个数组，数组中的每一项都要是完整的工具定义对象，通常需要包含 type、name、description 和 parameters；其中，parameters 必须遵循 JSON Schema 格式。

示例中 tools 字段不能省略，哪怕只用一个工具；parameters 的 required 字段必须精确列出必填参数名，少一个就会导致模型生成无效 function_call 参数。

发送请求后，若返回 content 为空、function_call 字段存在，则说明调用已触发，下一步就是你自己实现函数执行并回传结果。