需完成鉴权配置、工具注册与调用链路打通三步：先在秘塔ai官网获取并配置api key（环境变量metaso_api_key或authorization: bearer sk-xxx）；再通过spring-ai-alibaba依赖注册metaso_web_search工具或手动mcp对接；最后发送含明确检索意图的自然语言指令触发搜索。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
给智能体增加秘塔AI搜索API联网能力，需完成鉴权配置、工具注册与调用链路打通三步，缺一不可。未配置API Key将返回401错误，未声明tool name会导致模型忽略搜索意图。
获取并配置API Key
登录秘塔AI搜索官网（https://metaso.cn/），点击右上角头像→「API管理」→「创建新密钥」，生成的Key仅显示一次，【务必立即复制保存】，刷新页面后无法再次查看。
将该Key填入智能体运行环境：可设为环境变量METASO_API_KEY，或写入配置文件中Authorization字段，格式为Bearer sk-xxx。
在智能体中注册metaso_search工具
方法一：使用spring-ai-alibaba（推荐）
① 在pom.xml中添加依赖：<dependency><groupid>com.alibaba.cloud.ai</groupid><artifactid>spring-ai-alibaba-starter-tool-calling-metaso</artifactid></dependency>
② 配置application.yml，指定tool name为metaso_web_search，并启用tool calling自动发现。
③ 启动时控制台输出含Registered tool: metaso_web_search即表示注册成功。
方法二：手动实现MCP协议对接
在MCP客户端配置中新增server条目，url填https://metaso.cn/api/mcp，headers里带Authorization头；注意【MCP服务端必须启用metaso插件，否则调用会静默失败】。
触发搜索调用的指令设计
向智能体发送含明确检索意图的自然语言指令，例如：“查2026年9月中国新能源汽车出口量TOP3企业”，模型将自动解析出q=“2026年9月 中国 新能源汽车 出口量 TOP3企业”，scope=“webpage”，size=5。
若指令中包含时间限定词（如“最新”“今日”“过去7天”），系统默认开启includeSummary=true以提升时效性召回率。
不建议在单次请求中混用多个独立事实查询，如“查A股光伏板块涨幅+美国通胀率+东京天气”，这会降低RAG重排序精度，应拆分为三次独立tool call。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
