操作场景

日志服务提供了 AI Agent Skill, 可以在您的 agent 客户端中使用自然语言与日志服务进行交互。本文指导您在 agent 中配置和使用 BLS Skill。

BLS Skill 使用场景

查询和操作百度智能云日志服务(BLS, Baidu Log Service)。当用户需要以下操作时可以使用此 skill：

(1) 查询日志组(Project)列表

(2) 查询日志集(LogStore)列表或详情

(3) 查询日志集的索引(Index)配置情况

(4) 根据用户描述的查询意图，生成 BLS 检索/SQL 查询语句

(5) 调用 BLS API 检索分析日志并返回结果

触发关键词：BLS、日志服务、日志查询、LogStore、日志集、检索日志

前提条件

提前安装部署支持 Skill 的 AI Agent 服务，本文将以 openclaw 为例进行说明。

环境需要 python3。

操作步骤

步骤一：安装 BLS skill到 AI Agent

为AI Agent安装日志服务skill的操作步骤如下：

1.下载 BLS skill 压缩包。

下载地址：https://bls-skill.bj.bcebos.com/latest/bce-bls.zip

2.执行以下命令将日志服务 skill 压缩包解压到 openclaw skills 目录下（其他 agent 平台类似，把 skill 安装到 agent 的 skills 目录下）。

unzip -o bce-bls.zip -d {your_agent_path}/skills/

3.从 openclaw 的技能列表中查找 bce-bls 技能（其他 agent 也有类似 skill 列表功能）

可以主动告知 agent 获取 skill 列表，如果发现没有日志服务的技能，可以尝试重启 agent 或者其他方式重新加载 skill。

步骤二：在 agent 中使用 BLS skill 请求日志服务

1. 第一次使用 BLS skill，需要提供百度云 AK/SK，用于获取账号信息，确保 AK/SK 有相关日志集的读权限。

认证方式（三选一）：

方式一：直接在对话中提供：--ak YOUR_AK --sk YOUR_SK

方式二：设置环境变量：export BCE_BLS_ACCESS_KEY=YOUR_AK; export BCE_BLS_SECRET_KEY=YOUR_SK

方式三：配置文件：在 home 目录的 .bce_bls/credentials 文件中配置， 即 {your_home_path}/.bce_bls/credentials 文件，支持配置多AK/SK，用于切换不同用户，按如下格式填写 AK/SK。

1[default]
2bce_access_key_id = DEFAULT_AK
3bce_secret_access_key = DEFAULT_SK
4
5[prod]
6bce_access_key_id = PRODUCTION_AK
7bce_secret_access_key = PRODUCTION_SK

可以设置环境变量 BCE_PROFILE 切换不同AK/SK，不配置时默认使用 default。

配置 BCE_BLS_PROFILE 为 prod。

1export BCE_BLS_PROFILE=prod

建议使用环境变量和配置文件的方式配置，防止 AK/SK 泄漏。

2. 使用 BLS skill 查看当前有哪些日志项目和日志集。

BLS 是多地域部署的，因此用户需要在对话中指定地域。

3. 使用 BLS skill 查询日志，向大模型描述您的日志查询需求，可以尽量补充日志特征，有利于大模型生成准确的查询语句

如果有多个同名日志集，需要指定日志集 project，便于大模型精准使用目标日志集。