MiniMax_Agent资料检索工具调用教程

MiniMax Agent需启用联网检索工具获取最新信息：网页端开启M2.5-Search权限（需实名认证），API调用须在请求中显式声明functions，验证需检查response中function_call字段及后端服务响应。

你需要让MiniMax Agent在回答中自动调用资料检索工具，获取最新政策、技术动态或事件进展，而不是依赖模型内置知识——这要求明确启用并正确触发工具链，否则所有提问都只会返回静态、过期的回答。

网页端Agent开启M2.5-Search联网检索权限

这是最快生效的方式，适用于日常对话场景，无需代码，但必须确保账号已完成实名认证。

访问 MiniMax Agent官网，使用已实名认证的账号登录。

点击右上角齿轮图标 → 进入“Agent设置”面板 → 找到“工具权限”区域。

将

，该操作会立即生效，无需重启或刷新页面。

回到对话框后，可以直接输入带有明确时效性关键词的问题，比如“2026年7月工信部新发布的AI大模型备案清单”。这样一来，系统就会自动触发M2.5-Search，开始执行全网检索。要是没有返回实时数据结果，通常就要先检查一下：问题里是不是少了清晰的时间锚点。因为模型并不会主动替你推断“最新”到底指什么，必须把时间范围写具体，例如“截至2026年8月”这类限定词，效果才会更准确。

API调用时注入functions声明检索工具

当通过HTTP接口集成Agent时，仅开启网页端权限无效，必须在每次请求中显式声明可调用的工具，否则模型默认不触发任何外部动作。

方法一：直接使用MiniMax原生search函数定义

在POST请求Body的JSON中，添加functions字段，内容为：

{"name": "m2_5_search", "description": "执行全网实时信息检索，返回权威信源摘要", "parameters": {"type": "object", "properties": {"query": {"type": "string", "description": "检索关键词，需包含时间、主体、事件三要素"}}}}

方法二：自定义封装后端检索服务

如果手头已经有内部知识库，或者接入了指定 API（比如 Elasticsearch 集群），那就可以把functions.name直接设为/retrieve，并在parameters里强制要求传入index_name和keywords。这样一来，模型生成的function_call就会更准确地路由到你的服务上，避免一不留神误调到公网接口。

，否则API将忽略整个工具声明，静默降级为普通对话。

验证工具调用是否真实触发

第一步：发送含明确检索意图的请求，例如用户消息为“查一下神舟十九号发射时间”。

第二步：检查响应体中是否存在function_call字段。

第三步：若存在，提取arguments中的query值，手动用浏览器打开搜索引擎验证该query能否返回2026年8月前后的权威结果；若不存在，则说明functions未生效或模型判定无需检索。

第四步：若function_call存在但后续无结果，需确认你是否已将function_call.name对应的服务端点部署就绪，并能接收POST JSON且返回格式符合MiniMax要求——它必须是纯文本摘要，不能是HTML或原始JSON列表。