腾讯云官网文档搜索 SKILL
在用户需要使用腾讯云官网公共(Tencent Cloud Portal)能力时加载。公共能力是腾讯云官网(cloud.tencent.com)的统一服务入口,通过 TCCLI 的 portal 系列接口调用。当前提供的能力:文档搜索(查询云产品文档、操作指南、API 文档、最佳实践、故障排查等)。触发词示例:"搜索腾讯云文档"、"腾讯云官网搜索"、"查一下腾讯云…怎么配置"、"腾讯云文档搜索"、"帮我搜腾讯云…的文档"、"查云产品文档"、"portal search"、"search tencent cloud docs"。不适用于:操作云资源(CVM/轻量服务器/VPC 等)——本技能面向官网门户信息类能力,不管理资源。
腾讯云官网门户(Tencent Cloud Portal)
通过 TCCLI 的 portal 系列接口调用腾讯云官网门户的信息类能力(非资源管理)。当前提供:文档搜索(SearchDocuments)。
前置条件
tccli --version
python3 -c "import tencentcloud.portal" # 自检 portal 模块
- 未安装,或报
No module named 'tencentcloud.portal'→ 见references/install.md。 - 凭证配置(OAuth / 无浏览器 / agent 非交互 / AK/SK)→ 见
references/auth.md。默认tccli auth login。
能力路由
| 用户意图 | 接口 | 参考文档 |
|---|---|---|
| 搜索腾讯云官网文档 / 操作指南 / API 文档 | SearchDocuments | references/search-documents.md |
| 其它 portal 操作 | — | tccli portal help |
执行前先读对应参考文档。 参数不确定时用 tccli portal <Action> help 核对(你对参数的了解可能过时)。
调用约定
- 形式:
tccli portal <Action> [参数...];复杂参数加--cli-unfold-argument,用--Name value而非 JSON。 - 地域可选,无需
--region。
结果呈现
- 只呈现接口实际返回的数据,不得编造 URL / 标题 / 摘要等;失败时报告错误与
RequestId。 - 分页能力先报总数,有更多结果再询问是否翻页。
错误处理
| 现象 | 处理 |
|---|---|
command not found / No module named 'tencentcloud.portal' | 见 references/install.md |
AuthFailure / 凭证过期 / EOF when reading a line / invalid state | 见 references/auth.md |
InvalidParameter(Value) | 用 tccli portal <Action> help 核对参数与取值范围 |
| 频率超限 | 放慢请求节奏重试 |
| 空结果 | 换关键词,见 references/search-documents.md |
同类错误多次重试仍失败时,停止重试,引导用户参照官方文档手动处理。
渠道输出兼容性
部分渠道会转换 Markdown 破坏输出:CLI/JSON 用代码块包裹;URL 中的 _ 若被吞则替换为 %5F;标识符用行内反引号包裹。
- Downloads
- Security audit
- Pass
- Last updated
- 2mo ago
- Current version
- v1.0.1
- License
- MIT-0
