日志服务 通过 Skill 使用 CLS

一、概述

核心价值：

·AI 智能分析，自动定位根因：自动理解日志内容、识别异常、定位根因，把「人工翻日志」变成「AI 帮你查」。

·自然语言交互，零语法门槛：无需学习 CQL、PromQL 等查询语法，用日常语言即可检索日志、查询指标、排查告警。

·数据不出域，安全有保障：CLS 专家技能从 CLS 侧获取日志、指标、trace 分析结果，对于需要结合本地数据分析的场景，则在本地分析，保证数据安全。

·一站式工作台，告别控制台跳转：在 WorkBuddy 等工具内完成日志检索、分析与告警排查，排障过程不被打断。

腾讯云 CLS 专家技能可为你提供智能分析和自动化操作能力：

二、前置条件

需开通服务，参考 快速入门 完成账号注册并开通腾讯云日志服务 CLS。

三、安装 Skill

CLS Skill 已上架 WorkBuddy 和 SkillHub，你可以根据自己的使用场景选择安装方式。

四、方式一：在 WorkBuddy 中安装

·对话指令安装：

在 WorkBuddy 的对话窗口中，直接输入指令：“帮我安装腾讯云 CLS 专家技能”，系统会自动执行安装流程。

·图形化界面安装：

1.1 打开 WorkBuddy 客户端，在左侧选择专家·技能·连接器 > 技能，进入管理页面，右上角搜索腾讯云 CLS 专家技能。

1.2 单击安装，等待完成即可。

五、方式二：通过 SkillHub 安装

适用于非 WorkBuddy 的 AI 工具用户，复制以下内容到 AI 聊天窗口，即可安装：

请先检查是否已安装 SkillHub 商店，若未安装，请根据 https://skillhub.cn/install/skillhub.md 安装 SkillHub 商店，但是只安装 CLI，然后安装 @org-bv6b8qcb/tencentcloud-cls 技能。若已安装，则直接安装 @org-bv6b8qcb/tencentcloud-cls 技能。

六、授权

安装完成后，首次使用腾讯云 CLS 专家技能需进行授权操作，支持2种授权方式。

七、方式一：浏览器授权（推荐）

不需要填任何密钥。首次调用时将自动检测是否已登录腾讯云，如未登录将弹出浏览器授权，请登录你的腾讯云账号并单击授权，即可完成授权。一次授权有效期为2小时，到期将自动续期。

八、方式二：秘钥授权

1. 进入 访问管理控制台，获取云 API 密钥（SecretId、SecretKey）。详情可参考 主账号访问密钥管理。

2. 请按以下方法将 SecretId、SecretKey 配置到系统的环境变量中。

macOS / Linux 配置指南Windows 配置指南

请先在终端中执行以下命令，确认你的 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

执行以下命令将密钥写入系统环境变量。注意：配置仅对新打开的终端窗口生效，请重启终端或 AI 工具以应用更改。setx TENCENTCLOUD_SECRET_ID "你的 SecretId"setx TENCENTCLOUD_SECRET_KEY "你的 SecretKey"

九、验证安装

在对话中输入：列出我所有地域的日志主题。如果返回日志主题列表（含空列表），说明安装成功。

注意：如果账号下没有任何日志主题，返回空列表也属于成功。如有疑问，可输入"查看广州地域的日志主题"进一步验证。

十、使用指南

配置完成后，在对话窗口中用自然语言直接描述你的需求即可。描述需求时建议包含以下要素，越具体结果越精准：

·完整示例："帮我在广州地域，查一下 payment-topic 最近1小时的错误日志，然后统计每种错误的数量"

·模糊提问示例："广州那个有日志的主题，最近有没有报错？"

注意：说明：

注意：对于模糊提问，会先列出该地域的所有主题，再逐个检查最近的错误日志。

十一、场景一：30秒检索错误日志

线上突然报错时，快速定位出了什么问题、什么时候开始的、影响范围有多大。

适用场景：早会前查看昨晚的错误、收到告警后定位问题、排期复盘时拉取历史错误数据。

十二、场景二：深入分析错误分布

不仅展示错误列表，还可以按服务、错误码、时间维度进行统计分析。

十三、场景三：一键查看日志上下文

找到一条关键错误日志后，可以查看出错前后发生了什么，无需手动调整时间范围去翻页查找。

返回以目标日志为中心的前后日志，用于还原级联故障链路。

十四、场景四：采集链路快速排查

日志未采集时，无需逐台 SSH 登录机器排查，一句指令即可完成诊断。

自动并行检查：机器组列表 → 每台机器 Agent 在线状态 → 采集配置 → 配置绑定关系，输出完整诊断结果。

十五、计费说明

CLS 智能助手本身为免费使用的 AI 技能包，不产生额外费用。但通过 Skill 使用的 CLS 服务将按实际用量产生费用，计费详情请查看 CLS 计费概述。