TSMAI联网搜索:为 Agent 接入腾讯混元 SearchPro 实时检索

前言

Agent 回答时效性问题,往往受限于模型训练数据与内置工具。若要在对话里直接拿到网页标题、链接和摘要,并支持站内检索、时间范围过滤,通常要自行对接搜索 API、写调用逻辑,再塞进 Skill 规范。下面介绍 SkillHub 上的 TSMAI联网搜索(坐标 @user_ccf72f3e/tsmai-search),它把腾讯云联网搜索能力封装成标准 Skill,面向「查新闻、查资料、按站点搜」等常见需求。

这是什么

TSMAI联网搜索 是社区来源(community)的 ai-agent 类 Skill,当前版本 1.0.0,由发布者 user_ccf72f3e 维护;SkillHub 页面标注作者为 aslinwang。

一句话定位:基于 腾讯混元 SearchPro API 的联网搜索工具,为 Agent 提供实时网页检索,结果形态包含标题、URL、摘要等,并支持自然语言检索、多模态 VR 结果、站内搜索与时间范围过滤。

官方入口:

  • API 地址:https://api.skillhub.cn/user_ccf72f3e/tsmai-search
  • SkillHub 页面:https://www.skillhub.cn/skills/user_ccf72f3e/tsmai-search

核心功能

以下能力均来自 SkillHub 公开简介,未在资料中出现的细节不展开。

  1. 实时联网搜索:通过 SearchPro 拉取当前网页信息,而非仅依赖模型记忆。
  2. 自然检索:用自然语言描述检索意图,由 Skill 侧对接搜索能力。
  3. 多模态 VR 结果:简介中写明支持多模态 VR 类结果(具体展示形态以安装后的 Skill 说明为准)。
  4. 站内搜索:在指定站点范围内检索。
  5. 时间范围过滤:按时间条件收窄结果。
  6. 结构化输出:适用于需要标题、链接、摘要的场景。

Skill 标签含 requires_api_key=true,使用前需准备腾讯云 / 混元 SearchPro 相关 API 密钥,并按 Skill 包内说明配置(安装后查看该 Skill 目录下的 SKILL.md 或同类文档)。

官方建议的触发场景与话术包括:

  • 用户要查实时信息、最新新闻或文章;
  • 需要带标题、URL、摘要的搜索结果;
  • 要做站内搜索;
  • 常见触发语:「搜索」「联网搜索」「查一下」,或英文 search、web search、find information。

安装与启用

1、安装 SkillHub CLI(若尚未安装)

先检查是否已有 CLI:

command -v skillhub && skillhub --version

未安装时,可按 SkillHub 官方安装文档执行完整安装(CLI + 默认 Skill):

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

仅安装 CLI:

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

安装说明全文:https://skillhub.cn/install/skillhub.md

2、安装本 Skill

安装时必须用 --dir 指向当前 Agent 的 skills 目录,否则默认落在 ./skills/,Agent 可能无法加载。

skillhub install @user_ccf72f3e/tsmai-search --dir <你的 skills 目录>

也可将下面提示交给支持 SkillHub 的 AI,由其按官方安装文档完成安装:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ccf72f3e/tsmai-search。

3、各客户端 skills 目录(参考)

SkillHub 文档给出的常见路径如下,请按你实际使用的客户端选择:

客户端 skills 目录
Cursor ~/.cursor/skills/
Claude Code ~/.claude/skills/
Codex ~/.codex/skills/ 或项目下 .agents/skills/
Gemini CLI ~/.gemini/skills/

安装到正确目录后,按所用 Agent 的要求重启或刷新 Skill 列表。API Key 的配置项名称与取值方式以安装包内文档为准。

典型用法

本 Skill 采用通用 SKILL.md 格式,具体工具名与参数以安装后的文件为准。从官方简介可复现的用法模式如下。

  1. 实时信息查询:在对话中说明要查的主题,并使用触发语(如「联网搜索一下……」),由 Agent 加载本 Skill 后调用 SearchPro。
  2. 新闻与文章:明确要求「最新」或时间范围,配合 Skill 的时间过滤能力。
  3. 站内搜索:说明目标站点与关键词,对应简介中的 site-specific searches。
  4. 结构化结果:需要列表化展示时,说明要标题、链接与摘要,与 Skill 设计目标一致。

适用场景与注意

适合谁

  • 已在 Cursor、Claude Code、Codex 等环境使用 Skill,且需要国内可落地的联网搜索封装;
  • 愿意使用腾讯云混元 SearchPro,并能自行申请与保管 API Key 的开发者或团队。

限制与注意

  • 依赖外网搜索 API,需有效密钥;标签已标明 requires_api_key=true。
  • 社区 Skill,升级与维护节奏取决于发布者;安装前可在 SkillHub 查看版本(当前 1.0.0)与页面信息。
  • 多模态 VR、时间过滤等高级能力的边界以 SearchPro 与 Skill 文档为准,本文不臆测未公开的配额或计费。

结尾

TSMAI联网搜索 把腾讯混元 SearchPro 的联网检索能力收敛成 Agent 可直接调用的 Skill,减少自研搜索桥接的工作量。若你的场景是实时网页信息、新闻检索或站内搜索,可在 SkillHub 安装 @user_ccf72f3e/tsmai-search,配置 API Key 后按对话触发即可。

官方页面:https://www.skillhub.cn/skills/user_ccf72f3e/tsmai-search

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜