本文档面向 乐维 社区用户，说明如何通过 AI 对话安装乐维告警故障自动诊断技能，并在安装后配置乐维平台 API 信息。完成后，你可以输入告警内容，让 WorkBuddy 自动生成诊断报告、处理建议和复查结果。
准备工作
在 WorkBuddy 中自动安装技能
新建任务并发送安装指令
在 WorkBuddy 中新建任务，把下面的安装指令和技能页面链接一起发给 AI。
图 1 WorkBuddy 读取技能页面并检查安装条件
等待 AI 检查并安装
WorkBuddy 会读取技能内容，识别 alert-clinic（告警故障自动诊断）技能，检查脚本能力和安全要求，然后完成安装。安装过程中保持当前任务打开，等待 AI 返回结果即可。
确认安装结果和配置提示
安装完成后，WorkBuddy 会展示技能名称、版本、安装路径和依赖信息，并提示继续配置乐维 API 地址和密钥。安装路径通常为 ~/.workbuddy/skills/alert-clinic/，配置文件位于 scripts/config.json。
图 2 WorkBuddy 输出安装结果和配置要求
配置乐维 API 凭据
由管理员提供 API 信息
管理员登录乐维平台部署服务器，在平台应用目录的 .env 文件中找到 API_SECRET_KEY。该值对应 WorkBuddy 配置中的 LERWEE_SECRET。普通用户只需接收管理员提供的 API 地址和 Secret，无需查看或公开服务器口令。把 API 地址和 Secret 发给 WorkBuddy
把管理员提供的乐维平台 API 地址和 Secret 按下面格式发到当前任务中。/api/v6 是接口路径，地址和端口以实际部署为准。
图 3 WorkBuddy 写入 config.json 并提示技能可用
确认技能可用
WorkBuddy 提示“API 凭据已配置完成”后，技能即可正常使用。后续只需要在任务中发送告警内容，例如 CPU、磁盘、服务异常等告警，AI 会自动触发 alert-clinic 技能进行诊断。无法自动安装时：手动上传技能包
只有当 WorkBuddy 无法通过链接完成自动安装，或企业要求先人工审核技能包时，才使用本方式。下载技能包
打开 AgentScope 技能页面，确认技能名称为 alert-clinic 后下载技能包。也可以使用 SkillHub 入口；该入口可能需要先登录。
图 4 AgentScope 技能页：手动下载 alert-clinic 技能包
进入技能中心
打开 WorkBuddy，点击左侧“专家·技能·连接器”，进入能力管理页面。
图 5 进入“专家·技能·连接器”
打开技能页签
在顶部切换到“技能”，确认页面右上角可以看到“我安装的”和“添加技能”。
图 6 切换到“技能”页签
选择上传技能
点击右上角“添加技能”，在下拉菜单中选择“上传技能”。
图 7 选择“上传技能”
上传技能包
在“导入技能”弹窗中，将下载的 alert-clinic.zip 拖入上传区域，或点击上传区域选择文件。上传完成后，到“我安装的”中确认技能已安装。
图 8 导入技能弹窗
发起告警诊断
新建任务
回到 WorkBuddy 首页或任务输入框，输入“告警诊断”以及完整告警标题。
图 9 在 WorkBuddy 中发起任务
输入完整告警内容
告警内容建议包含监控类型、主机或对象、异常指标和阈值。信息越完整，技能匹配越准确。查看诊断报告
技能会根据告警内容查询上下文，确认是否为真实故障，并输出诊断报告。报告通常包含告警信息、诊断结果、根因分析和处理建议。
图 10 告警诊断报告示例