MiniMax Agent工具参数填写方法-人工智能-PHP中文网

必须在配置界面准确填写tools字段的json结构：一、网页端agent创建时在「工具集」添加自定义工具并填入含type、function.name等四字段的合法json；二、api调用时在post body中与messages同级传入tools数组；三、openclaw本地部署需在openclaw.json中为模型配置tools并重启gateway服务。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

minimax agent工具参数填写方法

要在MiniMax Agent中正确启用联网搜索、代码执行或文档解析等工具能力，必须在配置界面准确填写tools字段的JSON结构，否则模型将无法识别可用工具或触发调用。

网页端Agent创建时填写tools参数

适用于通过Minimax控制台创建通用对话型Agent的场景，需在系统提示词下方手动填入结构化工具定义。

第一步：进入Agent配置页，在「工具集」区域点击「添加工具」→选择「自定义工具」。

第二步：在弹出的JSON编辑框中，粘贴标准格式的tools数组。每个tool对象必须包含type、function.name、function.description和function.parameters四个字段，缺一不可。

第三步：确保function.parameters符合JSON Schema v7规范——例如字符串类型必须写"string"，必填字段需列在required数组中，properties内嵌结构不能漏掉type声明。写错任意一层嵌套都会导致400错误。

第四步：点击「保存并发布」，此时Agent ID才正式绑定该tools配置。未发布的修改不会生效，且已发布的Agent无法直接编辑tools，只能新建版本。

API调用时动态传入tools参数

当需要为单次请求定制工具集（如临时启用PDF解析），可在HTTP POST body中与messages同级传入tools字段。

方法一：直接构造JSON body

在POST请求体中，除messages外，显式添加tools字段，值为合法数组，例如：【"tools": [{"type": "function", "function": {"name": "search_web", "description": "实时联网搜索最新信息", "parameters": {"type": "object", "properties": {"query": {"type": "string"}}, "required": ["query"]}}}]】。

Openclaw Wallet

多链钱包与交易工具，为 AI 代理提供 27 项功能：钱包管理（创建、查余额、导出密钥），灵活额度代币兑换（100美元、50%、最大），跨链桥，DEX 市场数据（热门、成交量、涨跌榜），分层市值的代币发行，费用管理。支持 Solana 与 EVM 链。适用于代理需要操作钱包、执行交易、调研或发行代币的场景。

下载

方法二：使用curl命令行快速验证

执行以下命令（替换your_api_key和agent_id）：curl -X POST "https://api.minimax.chat/v1/text/chatcompletion" -H "Authorization: Bearer your_api_key" -H "Content-Type: application/json" -d '{"agent_id":"your_agent_id","messages":[{"role":"user","content":"查2026年8月中国新能源汽车销量排名"}],"tools":[{"type":"function","function":{"name":"search_web","description":"全网实时检索","parameters":{"type":"object","properties":{"query":{"type":"string"}},"required":["query"]}}}]}'。

注意：若返回{"error":{"code":"invalid_parameter","message":"tools must be an array"}}，说明JSON格式有误，常见原因是tools值不是数组、function缺失name字段或parameters里少了type声明。