前言¶
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 公开简介,未在资料中出现的细节不展开。
- 实时联网搜索:通过 SearchPro 拉取当前网页信息,而非仅依赖模型记忆。
- 自然检索:用自然语言描述检索意图,由 Skill 侧对接搜索能力。
- 多模态 VR 结果:简介中写明支持多模态 VR 类结果(具体展示形态以安装后的 Skill 说明为准)。
- 站内搜索:在指定站点范围内检索。
- 时间范围过滤:按时间条件收窄结果。
- 结构化输出:适用于需要标题、链接、摘要的场景。
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 格式,具体工具名与参数以安装后的文件为准。从官方简介可复现的用法模式如下。
- 实时信息查询:在对话中说明要查的主题,并使用触发语(如「联网搜索一下……」),由 Agent 加载本 Skill 后调用 SearchPro。
- 新闻与文章:明确要求「最新」或时间范围,配合 Skill 的时间过滤能力。
- 站内搜索:说明目标站点与关键词,对应简介中的 site-specific searches。
- 结构化结果:需要列表化展示时,说明要标题、链接与摘要,与 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