通过 Skill 使用 CLS
Download
聚焦模式
字号
概述
CLS Skill 是腾讯云日志服务（Cloud Log Service，简称 CLS）的官方技能包，专为 WorkBuddy 等智能协作工具打造。安装后，用户无需登录 CLS 控制台，即可通过自然语言直接完成日志检索、资源管理、指标查询及告警运维等全链路操作。
核心价值：
自然语言交互，零语法门槛：无需学习 CQL 或 PromQL 等专业查询语法，直接以日常语言描述需求即可精准检索日志、查询指标与配置告警，大幅降低日志分析的学习成本与操作复杂度。
沉浸式工作台，告别控制台切换：在 WorkBuddy 等工具内一站式完成日志全生命周期管理，排查问题时无需在 CLS 控制台多个页面间反复跳转，保持专注、提升排障连贯性。
多轮上下文交互，精准定位问题：支持基于对话上下文的连续分析，例如先查询错误日志，再分析错误分布趋势，最后展开关键日志的上下文详情，层层下钻直至定位根因。
并行诊断能力，全链路快速排查：在采集链路排查等复杂场景中，可同时检查机器组状态、Agent 运行情况、采集配置及绑定关系，多维度并行诊断，缩短故障定位时间。
CLS Skill 可为您提供以下能力：
功能分类 | 核心子功能 | 详细说明 |
日志检索与分析 | 关键词检索 | 支持全文检索、键值检索、模糊匹配、范围查询等多种检索方式，快速定位目标日志 |
| 上下文查看 | 查看任意一条日志的前后 N 条记录，还原问题发生的完整上下文 |
| 统计分析 | 支持 SQL 聚合分析（GROUP BY、ORDER BY、LIMIT 等），对海量日志进行分组统计和趋势分析 |
资源管理 | 日志主题管理 | 按名称、ID、标签、存储类型等条件搜索和查看日志主题 |
| 日志集管理 | 搜索和查看日志集，了解日志资源的组织层级 |
| 索引管理 | 查看索引配置信息、追踪索引重建任务的状态和进度 |
机器组与采集 | 机器组管理 | 查看机器组列表和成员状态（在线/离线），支持按 IP、操作系统、版本等条件筛选 |
| 采集配置 | 查看采集规则配置、检查采集配置与机器组的绑定关系 |
指标查询 | 指标标签查询 | 查看指标的标签维度，支持按匹配规则过滤 |
| PromQL 查询 | 使用 PromQL 语法对指标数据进行范围查询，兼容 Prometheus 生态 |
告警运维 | 告警策略管理 | 查看告警策略列表，支持按名称、状态等条件过滤 |
| 告警历史 | 查看告警触发和恢复记录，支持按告警级别（警告/提醒/紧急）、恢复状态筛选 |
| 执行详情 | 深入查看告警策略的执行日志，分析告警触发原因 |
| 屏蔽规则 | 查看告警屏蔽配置，排查告警是否被静默 |
前置条件
开通服务
获取密钥
注意：
SecretKey 属于敏感信息，请妥善保管，切勿在 AI 对话中直接发送。
如果使用子账号，需确保子账号已授予 CLS 相关 CAM 权限。最小权限策略参考：
日志检索：QcloudCLSReadOnlyAccess
日志检索 + 管理操作：QcloudCLSFullAccess
如需更细粒度控制，请参考 CLS CAM 授权 自定义策略。
安装 Skill
方式一：在 WorkBuddy 中安装
1. 打开 WorkBuddy 客户端，在左侧选择专家·技能·链接器，进入管理页面。
2. 在技能市场中搜索 腾讯云日志服务 CLS。
3. 单击安装，等待完成即可。您也可以在对话中直接输入：帮我安装腾讯云 CLS 技能。
方式二：通过 SkillHub 安装
适用于非 WorkBuddy 的 AI 工具用户，复制以下内容到 AI 聊天窗口，即可安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 tencentcloud-cls。
配置凭证
安装完成后，需要配置 SecretId、SecretKey 才能正常使用 CLS Skill。请根据 AI 提示或按以下方法将 SecretId、SecretKey 配置到系统的环境变量中。
macOS / Linux 配置指南
请先在终端中执行以下命令，确认您的 Shell 类型：
echo $SHELL
如果输出 /bin/zsh，请执行以下命令将密钥写入 ~/.zshrc 并立即生效：
# 1. 将环境变量追加到 ~/.zshrcecho 'export TENCENTCLOUD_SECRET_ID="您的 SecretId"' >> ~/.zshrcecho 'export TENCENTCLOUD_SECRET_KEY="您的 SecretKey"' >> ~/.zshrc# 2. 使配置在当前终端立即生效source ~/.zshrc
如果输出 /bin/bash，请执行以下命令将密钥写入 ~/.bashrc 并立即生效：
# 1. 将环境变量追加到 ~/.bashrcecho 'export TENCENTCLOUD_SECRET_ID="您的 SecretId"' >> ~/.bashrcecho 'export TENCENTCLOUD_SECRET_KEY="您的 SecretKey"' >> ~/.bashrc# 2. 使配置在当前终端立即生效source ~/.bashrc
Windows 配置指南
执行以下命令将密钥写入系统环境变量。注意：配置仅对新打开的终端窗口生效，请重启终端或 AI 工具以应用更改。
setx TENCENTCLOUD_SECRET_ID "您的 SecretId"setx TENCENTCLOUD_SECRET_KEY "您的 SecretKey"
验证安装
在对话中输入：列出我所有地域的日志主题。如果返回日志主题列表（含空列表），说明安装成功。
注意：
如果账号下没有任何日志主题，返回空列表也属于成功。如有疑问，可输入"查看广州地域的日志主题"进一步验证。
使用指南
配置完成后，在对话窗口中用自然语言直接描述您的需求即可。描述需求时建议包含以下要素，越具体结果越精准：
要素 | 说明 | 示例 |
① 地域 | 广州 / 上海 / 北京等 | 广州 |
② 对象 | 主题名称 / 服务名 / 日志类型 | payment-topic |
③ 时间范围 | 最近1小时 / 今天 / 最近7天 | 最近1小时 |
④ 要做什么 | 检索错误 / 统计分析 / 查上下文 | 错误日志 |
完整示例："帮我在广州地域，查一下 payment-topic 最近1小时的错误日志，然后统计每种错误的数量"
模糊提问示例："广州那个有日志的主题，最近有没有报错？"
说明：
对于模糊提问，会先列出该地域的所有主题，再逐个检查最近的错误日志。
场景实践
场景一：30秒检索错误日志
线上突然报错时，快速定位出了什么问题、什么时候开始的、影响范围有多大。
场景描述 | 示例自然语言 |
基础检索 | "查询广州地域的 default-topic 主题今天下午6点的错误日志" |
加过滤条件 | "只看 payment-service 的超时错误，最近30分钟的" |
按状态码筛选 | "找出所有 statusCode 为500的请求，按时间倒序排列" |
适用场景：早会前查看昨晚的错误、收到告警后定位问题、排期复盘时拉取历史错误数据。
场景二：深入分析错误分布
不仅展示错误列表，还可以按服务、错误码、时间维度进行统计分析。
分析目标 | 示例自然语言 |
按服务分组统计 | "统计一下各类错误的数量，按服务分组" |
错误分类 TOP N | "按错误码分组统计，只看 TOP 10" |
时间趋势 | "每小时错误率变化曲线，最近24小时" |
多维交叉 | "按服务和错误级别两个维度交叉统计" |
场景三：一键查看日志上下文
找到一条关键错误日志后，可以查看出错前后发生了什么，无需手动调整时间范围去翻页查找。
场景描述 | 示例自然语言 |
查看上下文 | "展开这条 DB_CONNECTION_TIMEOUT 日志的上下文，前后各2条" |
返回以目标日志为中心的前后日志，用于还原级联故障链路。
场景四：采集链路快速排查
日志未采集时，无需逐台 SSH 登录机器排查，一句指令即可完成诊断。
场景描述 | 示例自然语言 |
一键诊断采集链路 | "帮我检查一下这个主题对应的机器组和采集配置" |
自动并行检查：机器组列表 → 每台机器 Agent 在线状态 → 采集配置 → 配置绑定关系，输出完整诊断结果。
计费说明
常见问题
配置密钥后 Skill 报认证失败？
1. 确认环境变量名拼写正确：TENCENTCLOUD_SECRET_ID 和 TENCENTCLOUD_SECRET_KEY。
2. 确认配置后已重启终端或 AI 工具。
3. 确认密钥未过期：可登录 访问管理控制台 检查状态。
查询返回空结果？
1. 确认日志主题名称正确、地域匹配。
2. 确认时间范围内确实有日志写入。
3. 确认主题已开启全文索引或键值索引（否则无法检索）。
SubUser 子账号报权限错误？
确保子账号至少绑定了 QcloudCLSReadOnlyAccess 策略。如需执行管理操作，需 QcloudCLSFullAccess。
查询超时或返回过慢？
缩小时间范围或增加过滤条件。
文档反馈