必须完成权限配置、工具注册、提示词约束和请求体携带tools字段四步，缺一不可；需在控制台启用工具调用、逐个注册工具、用三步提示词明确指令边界、api请求中显式传入tools数组。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在 MiniMax Agent 中让智能体自动调用外部工具（比如搜索网页、执行代码、查天气、发飞书消息），必须完成从权限配置、工具注册到实际触发的完整链路，缺一不可，否则工具始终处于“可见但不可用”状态。
在控制台启用工具调用能力
Agent 默认不开启工具调用，即使后续配置了工具，也不会识别或执行任何 function call 请求。
登录 Minimax 开发者控制台 → 进入目标 Agent 的「编辑」页 → 左侧菜单点击「工具」→ 找到顶部开关「启用工具调用」，将其切换为开启状态。
【必须手动开启，新建 Agent 不会默认启用】
注册你要使用的具体工具
工具不是即装即用的，必须逐个注册并绑定参数，系统才认得它。目前支持三类注册方式：
方法一：直接接入官方预置工具
在「工具」页点击「添加工具」→ 选择「预置工具」标签页 → 勾选「Web 搜索」或「Python 代码执行器」→ 点击「确认添加」。这类工具无需填密钥，但仅限基础功能。
方法二：填写 API 密钥接入第三方服务
例如接入飞书机器人：选择「自定义工具」→ 工具类型选「HTTP」→ 填写飞书开放平台提供的 App ID 和 App Secret → 在请求模板中写好 POST 地址与 JSON body 结构 → 测试连接成功后保存。
方法三：上传本地可执行脚本（仅限私有部署环境）
若你使用的是 Minimax 私有 Agent 部署方案，可在「自定义工具」中选择「Shell 脚本」类型 → 粘贴脚本内容（如 curl 调用内部 CRM 接口）→ 设置超时时间（建议 ≤15s）→ 保存。注意：公有云平台不支持此方式。
配置系统提示词，明确指令边界
工具调用不是模型自发行为，必须靠提示词强制约束其决策路径。以下写法实测有效：
多Agent加密货币量化交易系统 — 基于TradingAgents多Agent框架+Binance执行层。支持：技术分析、消息分析、多Agent辩论、自动交易信号生成、Binance现货下单。适用场景：量化策略研究、自动交易Bot开发、加密货币组合分析。
第一步：声明工具可用性
在系统提示词开头写明：“你具备调用以下工具的能力：[Web 搜索]、[Python 执行器]、[飞书消息推送]。仅在用户明确要求执行动作、查询实时信息或需要计算结果时，才调用工具。”
第二步：禁止幻觉调用
紧接着加一句：“若用户问题可通过已有知识回答，严禁虚构工具调用；未获用户授权，不得擅自发送飞书消息或运行 Python 代码。”
第三步：指定失败兜底话术
补上：“工具调用失败时，直接告知用户‘暂无法获取该信息’，不要编造结果。”
这三步缺一不可。漏掉第二步，Agent 可能在不该调用时强行发起请求，造成飞书误通知或代码执行异常。
构造带工具描述的请求体
调用 API 时，必须把工具定义塞进 messages 上下文里，而不是只传 agent_id。否则模型根本“看不见”工具。
在 POST 请求 Body 的 JSON 中，除 agent_id 和 messages 外，必须额外包含 tools 字段，值为数组，每一项是完整工具定义对象，含 type、name、description、parameters（符合 JSON Schema 格式）。
示例中 tools 字段不能省略，哪怕只用一个工具；parameters 的 required 字段必须精确列出必填参数名，少一个就会导致模型生成无效 function_call 参数。
发送请求后，若返回 content 为空、function_call 字段存在，则说明调用已触发，下一步就是你自己实现函数执行并回传结果。
