> ## Documentation Index
> Fetch the complete documentation index at: https://doc.lwops.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# Workbuddy整合方案

> 基于Lerwee Agentic Ops × WorkBuddy 整合方案，实现告警自动诊断 本文档面向 乐维 社区用户，说明如何通过 AI 对话安装乐维告警故障自动诊断技能，并在安装后配置乐维平台 API 信息。完成后，你可以输入告警内容，让 WorkBuddy 自动生成诊断报告、处理建议和...

\*\*基于Lerwee Agentic Ops × WorkBuddy 整合方案，实现告警自动诊断  \*\*\
本文档面向 乐维 社区用户，说明如何通过 AI 对话安装乐维告警故障自动诊断技能，并在安装后配置乐维平台 API 信息。完成后，你可以输入告警内容，让 WorkBuddy 自动生成诊断报告、处理建议和复查结果。

## 准备工作

| 准备项           | 说明                                                      |
| ------------- | ------------------------------------------------------- |
| WorkBuddy 客户端 | 已安装并登录，可新建任务并与 AI 对话。                                   |
| 技能页面链接        | 使用本文提供的 AgentScope 技能页面链接，直接交给 WorkBuddy 读取并安装。         |
| 乐维 API 信息     | 由管理员提供 LERWEE\_BASE\_URL 和 LERWEE\_SECRET；普通用户无需查看真实密钥。 |
| 操作权限          | 生产环境涉及删除、清理、重启等动作时，需要人工确认或审批。                           |

## 在 WorkBuddy 中自动安装技能

### 新建任务并发送安装指令

在 WorkBuddy 中新建任务，把下面的安装指令和技能页面链接一起发给 AI。

```latex theme={null}
下载并安装这个 skills
https://platform.agentscope.io/skills/019f031f-5bef-7593-aac0-4de354410bf8
```

![Workbuddy整合方案 操作截图 1](https://lwweb.oss-cn-shenzhen.aliyuncs.com/docs/images/yuque/workbuddy-integration-plan/image-01.png)

*图 1 WorkBuddy 读取技能页面并检查安装条件*

### 等待 AI 检查并安装

WorkBuddy 会读取技能内容，识别 alert-clinic（告警故障自动诊断）技能，检查脚本能力和安全要求，然后完成安装。安装过程中保持当前任务打开，等待 AI 返回结果即可。

![Workbuddy整合方案 操作截图 2](https://lwweb.oss-cn-shenzhen.aliyuncs.com/docs/images/yuque/workbuddy-integration-plan/image-02.png)

### 确认安装结果和配置提示

安装完成后，WorkBuddy 会展示技能名称、版本、安装路径和依赖信息，并提示继续配置乐维 API 地址和密钥。安装路径通常为 \~/.workbuddy/skills/alert-clinic/，配置文件位于 scripts/config.json。

![Workbuddy整合方案 操作截图 3](https://lwweb.oss-cn-shenzhen.aliyuncs.com/docs/images/yuque/workbuddy-integration-plan/image-03.png)

*图 2 WorkBuddy 输出安装结果和配置要求*

## 配置乐维 API 凭据

### 由管理员提供 API 信息

管理员登录乐维平台部署服务器，在平台应用目录的 .env 文件中找到 API\_SECRET\_KEY。该值对应 WorkBuddy 配置中的 LERWEE\_SECRET。普通用户只需接收管理员提供的 API 地址和 Secret，无需查看或公开服务器口令。

```latex theme={null}
服务器路径示例：
/itops/nginx/html/lwjk_app/.env

需要查找的配置项：
API_SECRET_KEY=<不要写入公开文档的真实密钥>
```

### 把 API 地址和 Secret 发给 WorkBuddy

把管理员提供的乐维平台 API 地址和 Secret 按下面格式发到当前任务中。/api/v6 是接口路径，地址和端口以实际部署为准。

```latex theme={null}
LERWEE_BASE_URL=http://<乐维平台 API 地址>/backend_api/api/v6
LERWEE_SECRET=<管理员提供的 API_SECRET_KEY>
```

![Workbuddy整合方案 操作截图 4](https://lwweb.oss-cn-shenzhen.aliyuncs.com/docs/images/yuque/workbuddy-integration-plan/image-04.png)

*图 3 WorkBuddy 写入 config.json 并提示技能可用*

### 确认技能可用

WorkBuddy 提示“API 凭据已配置完成”后，技能即可正常使用。后续只需要在任务中发送告警内容，例如 CPU、磁盘、服务异常等告警，AI 会自动触发 alert-clinic 技能进行诊断。

## 无法自动安装时：手动上传技能包

只有当 WorkBuddy 无法通过链接完成自动安装，或企业要求先人工审核技能包时，才使用本方式。

### 下载技能包

打开 AgentScope 技能页面，确认技能名称为 alert-clinic 后下载技能包。也可以使用 SkillHub 入口；该入口可能需要先登录。

![Workbuddy整合方案 操作截图 5](https://lwweb.oss-cn-shenzhen.aliyuncs.com/docs/images/yuque/workbuddy-integration-plan/image-05.png)

*图 4 AgentScope 技能页：手动下载 alert-clinic 技能包*

### 进入技能中心

打开 WorkBuddy，点击左侧“专家·技能·连接器”，进入能力管理页面。

![Workbuddy整合方案 操作截图 6](https://lwweb.oss-cn-shenzhen.aliyuncs.com/docs/images/yuque/workbuddy-integration-plan/image-06.jpg)

*图 5 进入“专家·技能·连接器”*

### 打开技能页签

在顶部切换到“技能”，确认页面右上角可以看到“我安装的”和“添加技能”。

![Workbuddy整合方案 操作截图 7](https://lwweb.oss-cn-shenzhen.aliyuncs.com/docs/images/yuque/workbuddy-integration-plan/image-07.jpg)

*图 6 切换到“技能”页签*

### 选择上传技能

点击右上角“添加技能”，在下拉菜单中选择“上传技能”。

![Workbuddy整合方案 操作截图 8](https://lwweb.oss-cn-shenzhen.aliyuncs.com/docs/images/yuque/workbuddy-integration-plan/image-08.jpg)

*图 7 选择“上传技能”*

### 上传技能包

在“导入技能”弹窗中，将下载的 alert-clinic.zip 拖入上传区域，或点击上传区域选择文件。上传完成后，到“我安装的”中确认技能已安装。

![Workbuddy整合方案 操作截图 9](https://lwweb.oss-cn-shenzhen.aliyuncs.com/docs/images/yuque/workbuddy-integration-plan/image-09.png)

*图 8 导入技能弹窗*

```latex theme={null}
上传要求
文件夹或 .zip 包需要包含 SKILL.md 文件；.md 文件需要包含 YAML 格式的技能名称和描述。
首次导入运维类技能时，不建议勾选“非高风险自动安装”。
```

## 发起告警诊断

### 新建任务

回到 WorkBuddy 首页或任务输入框，输入“告警诊断”以及完整告警标题。

![Workbuddy整合方案 操作截图 10](https://lwweb.oss-cn-shenzhen.aliyuncs.com/docs/images/yuque/workbuddy-integration-plan/image-10.jpg)

*图 9 在 WorkBuddy 中发起任务*

### 输入完整告警内容

告警内容建议包含监控类型、主机或对象、异常指标和阈值。信息越完整，技能匹配越准确。

```latex theme={null}
告警诊断
[操作系统]AI故障自愈演示-192.168.6.6上/分区磁盘空间使用率高于90%
```

### 查看诊断报告

技能会根据告警内容查询上下文，确认是否为真实故障，并输出诊断报告。报告通常包含告警信息、诊断结果、根因分析和处理建议。

![Workbuddy整合方案 操作截图 11](https://lwweb.oss-cn-shenzhen.aliyuncs.com/docs/images/yuque/workbuddy-integration-plan/image-11.png)

*图 10 告警诊断报告示例*

## 确认并执行处理动作

当报告中出现清理、删除、重启、修改配置等动作时，先确认命令和影响范围，再执行。对外发布或生产环境中，建议默认使用“先展示方案、再人工确认”的方式。

| 动作类型    | 建议处理方式                    |
| ------- | ------------------------- |
| 查看类诊断   | 可直接执行，例如查看磁盘、内存、CPU、服务状态。 |
| 清理临时文件  | 确认目录、匹配规则和目标主机后再执行。       |
| 重启服务    | 确认业务影响、执行窗口和回滚方式后再执行。     |
| 删除或修改配置 | 必须经过人工确认或审批。              |

## 判断是否完成

一次完整的告警诊断应包含输入、诊断、处理和复查四个环节。完成后，你可以按下面的清单确认结果。

| 检查项  | 完成标准                            |
| ---- | ------------------------------- |
| 技能导入 | 在“我安装的”中可以看到乐维告警故障自动诊断技能。       |
| 参数配置 | 管理员已配置接口地址和密钥，普通用户无需接触密钥。       |
| 告警输入 | 输入内容包含监控类型、主机或对象、异常指标。          |
| 诊断报告 | 报告包含告警信息、诊断结果、根因分析和建议动作。        |
| 处理复查 | 执行处理后有复查结果，例如磁盘使用率从 92% 降至 74%。 |
| 安全确认 | 危险操作已在执行前经过人工确认或审批。             |