智能运维
本章覆盖：模型接入 / 工具管理 / 技能管理 / 数字专家 / 智能问答 / 根因分析。 智能运维是 Supulse 在统一观测（指标 / 日志 / 链路）之上叠加的 AI 能力层。它以可插拔的大模型为底座，通过 MCP 工具接入平台的查询能力，用"技能"沉淀领域排查经验，再由"数字专家"把工具、技能、提示词组合成可复用的角色，最终服务于智能问答（会话式运维）与根因分析（Agentic 多步自动诊断），把"观测 → 检测 → 定位 → 建议"的排障链路串成闭环，缩短故障平均定位时间（MTTR），降低对个人专家经验的依赖。
本章各能力页面均位于左侧导航「智能运维」分组下，配置类操作（新增 / 编辑 / 删除 / 运行）需要 ai:write 权限，查看与提问需要 ai:read 权限。无写权限时相关按钮呈灰色不可点击状态。
各能力之间的依赖关系建议按下面顺序配置：先在模型接入配好大模型底座 → 在工具管理接入 MCP 工具 → 在技能管理沉淀排查经验 → 用数字专家把工具与技能编排成角色 → 在智能问答与根因分析中调用。
模型接入
. 功能简介
模型接入用于配置平台调用的大语言模型，作为智能问答、根因分析、数字专家等所有 AI 能力的运算底座。平台只对接 OpenAI 兼容协议的模型，可以是公有云模型（如 OpenAI、Azure OpenAI、DeepSeek、通义千问等），也可以是私有化部署的本地模型（如本地 Ollama、Qwen）。API Key 脱敏存储，页面与接口均不回显明文。
. 进入路径
左侧导航 →「智能运维」→「模型接入」（路径 /ai/providers）。
. 界面总览
初次进入且尚未配置任何模型时，列表为空态，提示"暂无模型，点右上角新增"。 点击右上角「新增模型」，右侧滑出配置抽屉：
. 界面元素说明
模型列表（新增后展示）字段：
| 字段 | 含义 |
|---|---|
| 名称 | 模型的自定义显示名，如 DeepSeek-V3、本地Qwen |
| Base URL | 模型服务的 OpenAI 兼容接口地址，如 https://api.example.com/v1 |
| 模型 | 实际调用的模型名，如 deepseek-chat |
| 默认 | 标注为「默认」的模型将作为未显式指定时的兜底模型 |
| 启用 | 「是 / 否」，停用后不参与任何 AI 调用 |
| 操作 | 测试连通、编辑、删除 |
「新增模型」抽屉字段：
| 字段 | 含义 |
|---|---|
| 名称 | 必填，模型显示名 |
| Base URL | 必填，OpenAI 兼容接口地址（一般以 /v1 结尾） |
| 模型名 | 必填，服务端识别的模型标识 |
| API Key | 模型访问密钥（OpenAI 兼容的 Key）；编辑时留空表示不修改已存的 Key |
| 设为默认 | 开关，开启后设为默认模型 |
| 启用 | 开关，是否立即启用该模型 |
. 操作步骤
- 在模型接入页点击右上角「新增模型」。
- 在抽屉中填写「名称」「Base URL」「模型名」「API Key」，示例：名称
DeepSeek-V3、Base URLhttps://api.example.com/v1、模型名deepseek-chat、API Keysk-****（占位示意）。 - 按需打开「设为默认」和「启用」开关。
- 点击右上角「保存」，页面提示"已新增"，模型出现在列表中。
- 在列表该行点击「测试连通」，验证 Base URL、Key 与模型名是否可用；连通成功会提示响应延迟（毫秒）与一小段返回内容。
- 如需修改，点击「编辑」；如需下线，关闭「启用」或点击「删除」。
. 常见问题 / 注意事项
- 平台仅支持 OpenAI 兼容协议。若模型服务不提供该协议，需自行部署兼容网关后再接入。
- Base URL 通常需带
/v1版本路径，具体以模型服务商文档为准。 - API Key 脱敏存储，编辑时 Key 输入框留空即保留原有 Key，不会被清空。
- 建议至少配置一个模型并「设为默认」，否则依赖默认模型的 AI 能力将无法运行。
- 新增或修改后务必点「测试连通」确认可用，避免在问答 / 根因分析时才发现底座不通。
工具管理（MCP）
. 功能简介
工具管理用于接入 MCP（Model Context Protocol）工具服务。MCP 是大模型与外部工具 / 数据对接的标准协议，平台通过它把指标查询、日志检索、链路分析等能力"暴露"给 AI 使用。接入后的 MCP 工具可被数字专家、智能问答、根因分析选用，让 AI 不只是"聊天"，而是能真正查询实时数据、给出有据可依的结论。
. 进入路径
左侧导航 →「智能运维」→「工具管理」（路径 /ai/mcp）。
. 界面总览
页面顶部为统计卡（工具总数 / 已启用 / 已停用），中部为搜索与状态筛选，左侧为工具分类导航，右侧按分类分组展示 MCP 列表。 点击右上角「新增 MCP」，右侧滑出配置抽屉：
. 界面元素说明
MCP 列表字段：
| 字段 | 含义 |
|---|---|
| 名称 | MCP 服务显示名，如 Prometheus、外部MCP |
| 用途 | 一句话说明该 MCP 提供什么能力，便于挑选 |
| 标签 | 检索与分组用的标签，超过 3 个折叠为 +N |
| URL | MCP 服务访问地址（含 /mcp 路径） |
| 传输 | 通信协议，streamable_http（推荐）或 sse |
| 鉴权 | 「已配置 / 无」，是否设置了 Bearer Token |
| 状态 | 「已启用 / 未启用」，停用后不会被问答 / 根因分析选用 |
| 操作 | 测试连通、编辑、删除 |
顶部工具栏：统计卡（工具总数 / 已启用 / 已停用）、搜索框（可搜名称、URL、用途或标签）、状态分段筛选（全部 / 启用 / 停用）、左侧「工具分类」导航。
「新增 MCP」抽屉字段：
| 字段 | 含义 |
|---|---|
| 名称 | 必填，MCP 服务显示名 |
| URL | 必填，MCP server 访问地址，需包含 /mcp 路径 |
| 用途 | 一句话能力说明，便于在编排时挑选 |
| 分类 | 用于左侧分类导航，可选已有分类或直接输入新分类（如 指标 / 日志 / 链路） |
| 传输 | streamable_http 适用大多数 MCP；旧服务可选 sse |
| Bearer Token | 外部 MCP 的鉴权 token，内部无鉴权可留空；编辑时留空不修改 |
| 标签 | 输入后回车添加，用于检索与分组 |
| 启用 | 开关，关闭后该 MCP 不会被根因分析 / 智能问答选用 |
. 操作步骤
- 点击右上角「新增 MCP」。
- 填写「名称」「URL」，URL 需含
/mcp路径，如http://prometheus-mcp.internal:8080/mcp（占位示意）。 - 填写「用途」与「分类」，方便后续检索与编排。
- 选择「传输」协议（默认
streamable_http）；若为需要鉴权的外部 MCP，填写「Bearer Token」。 - 按需添加「标签」，打开「启用」开关。
- 点击「保存」，列表按分类分组展示新增的 MCP。
- 在该行点击「测试连通」，成功后会提示可用工具数量与部分工具名，确认接入无误。
. 常见问题 / 注意事项
- URL 必须包含
/mcp路径，仅填服务根地址会导致连通失败。 - 内部部署的 MCP 若无鉴权，Bearer Token 留空即可；外部 MCP 一般需要 token。
- 「停用」的 MCP 不会出现在智能问答的可选工具与根因分析 / 数字专家的能力候选中。
- 建议先「测试连通」再交给 AI 使用，避免调用时工具不可用导致分析中断。
技能管理
. 功能简介
技能（Skill）是给 AI 的领域知识与排查指令，用 Markdown 描述"某类问题该查哪些指标、看哪些日志关键词、常见根因是什么、排查步骤怎么走"。它把资深运维的经验沉淀为可复用的知识片段，注入到数字专家或根因分析工作流中，让 AI 的排查更贴合本企业的实际场景。平台内置若干预置 Skill，可一键导入后在此基础上修改。
. 进入路径
左侧导航 →「智能运维」→「技能管理」（路径 /ai/skills）。
. 界面总览
页面结构与工具管理类似：顶部统计卡（Skill 总数 / 已启用 / 内置 Skill）、搜索与状态筛选、左侧「Skill 分类」导航、右侧按分类分组的列表。右上角提供「导入预置 skill」和「新增 Skill」两个按钮。
. 界面元素说明
Skill 列表字段：
| 字段 | 含义 |
|---|---|
| 名称 | 技能名，如 MySQL 慢查询排查 |
| 用途 | 一句话说明该技能做什么 |
| 标签 | 用于检索与按异常上下文匹配（如 cpu / mysql / disk） |
| 注入方式 | 「通用」= 总是注入到所有根因分析 agent；「按需」= 仅在工作流显式选择时生效 |
| 效果 | 使用与有用统计，形如 用过 N · 有用 M |
| 状态 | 「已启用 / 未启用」 |
| 来源 | 「内置 / 自定义」 |
| 操作 | 编辑、删除 |
「新增 Skill」抽屉字段：
| 字段 | 含义 |
|---|---|
| 名称 | 必填，技能名 |
| 用途 | 一句话能力说明，便于在工作流 / 专家中挑选 |
| 分类 | 用于左侧分类导航，可选已有或输入新分类（如 主机 / 存储 / 网络） |
| 指令内容（markdown） | 必填，给 AI 的领域知识与排查指令：查哪些指标、看哪些日志关键词、常见根因、排查步骤 |
| 标签 | 输入后回车添加，用于检索与异常上下文匹配 |
| 通用（总是注入） | 开关，开启后注入到所有根因分析 agent；关闭则仅在显式选择时生效 |
| 启用 | 开关，关闭后不会被任何 agent 使用 |
. 操作步骤
- 首次使用可点击右上角「导入预置 skill」，一键导入平台内置技能，完成后提示导入与跳过的数量。
- 如需新增，点击「新增 Skill」。
- 填写「名称」「用途」「分类」。
- 在「指令内容（markdown）」中，用 Markdown 写清关注指标、日志关键词、常见根因与排查步骤。
- 添加「标签」（便于按异常上下文自动匹配），按需打开「通用（总是注入）」。
- 打开「启用」，点击「保存」。列表按分类分组展示，可随时「编辑」或「删除」。
. 常见问题 / 注意事项
- 「通用」技能会注入到所有根因分析 agent，请仅对普适性强的通用排查思路开启；场景化技能建议保持「按需」，在专家或工作流中显式选择。
- 「效果」列的"用过 / 有用"统计可帮助判断技能是否真正发挥作用，便于持续优化指令内容。
- 内置技能可直接编辑改成贴合本企业的版本；「导入预置 skill」对已存在的同名技能会自动跳过，不会覆盖你的修改。
- 指令内容以 Markdown 书写，结构清晰（分标题、列表）更利于模型理解。
数字专家
. 功能简介
数字专家把「工具（MCP）+ 技能（Skill）+ 系统提示词 + 运行参数」封装成一个可复用的 AI 角色，例如"数据分析专家""健康巡检专家"。配置一次后，即可在智能问答中直接选用，免去每次重复勾选工具和设定角色。专家支持三种类型，其中 BRAIN（大脑）型可编排多个成员专家协同完成复杂任务。
. 进入路径
左侧导航 →「智能运维」→「数字专家」（路径 /ai/experts）。
. 界面总览
顶部统计卡（专家总数 / 已启用 / 分类数）、搜索与状态筛选、左侧「专家分类」导航、右侧按分类分组的列表。 点击右上角「新建专家」，右侧滑出配置抽屉：
. 界面元素说明
专家列表字段：
| 字段 | 含义 |
|---|---|
| 名称 | 专家显示名 |
| 类型 | SPECIALIST（领域专家）/ CUSTOM（自定义）/ BRAIN（大脑，编排成员专家） |
| 能力 | 汇总所配置的工具与技能数量，形如 N Tools · M Skills |
| 状态 | 「已启用 / 未启用」 |
| 操作 | 编辑、调试、删除 |
「新建专家」抽屉字段：
| 字段 | 含义 |
|---|---|
| 名称 | 必填，专家名 |
| 类型 | SPECIALIST / CUSTOM / BRAIN |
| 分类 | 用于左侧分类导航，可选已有或输入新分类 |
| 状态 | 开关，关闭后该专家不可用 |
| 描述 | 说明专家职责、适用场景和边界 |
| Tools（MCP） | 多选，该专家可用的 MCP 工具（整服务） |
| 工具模式 | 「全部 / 白名单 / 黑名单」：全部 = 所选服务的全部工具；白名单 = 只用选中工具；黑名单 = 排除选中工具 |
| 允许的工具 / 禁用的工具 | 工具模式非「全部」时出现；先选 MCP 服务再点「加载工具」拉取具体工具名 |
| 成员专家 | 仅 BRAIN 类型出现，大脑会把子任务派给这些专家 |
| Skills | 多选，注入该专家的技能（领域知识） |
| Prompt | 专家的系统提示词，技能内容会自动追加其后 |
| Max Iters | 运行参数，最大迭代次数 |
| Timeout(s) | 运行参数，超时时间（秒） |
| Temperature | 运行参数，采样温度（越低越确定） |
| Max Subtasks | 仅 BRAIN 类型出现，大脑最多派发的子任务数 |
. 操作步骤
- 点击右上角「新建专家」。
- 填写「名称」，选择「类型」「分类」，填写「描述」界定职责与边界。
- 在「Tools（MCP）」选择该专家可用的 MCP 工具；如需精细控制，切换「工具模式」到白名单 / 黑名单，点「加载工具」拉取具体工具名后勾选。
- 在「Skills」选择要注入的技能，在「Prompt」写清专家的系统提示词。
- 按需调整「Max Iters」「Timeout(s)」「Temperature」等运行参数（根因类任务建议低温）。
- 若类型为 BRAIN，另需选择「成员专家」并设置「Max Subtasks」。
- 点击「保存」。回到列表可点「调试」，输入一个问题（如"帮我查一下最近主机 CPU 是否有异常"）点「运行」，用该专家的完整配置试跑一次并查看回答。
. 常见问题 / 注意事项
- 「加载工具」依赖对应 MCP 的连通，若拉取失败请先到工具管理确认该 MCP 可用。
- 白名单 / 黑名单可有效收窄工具范围，避免专家误用不相关的能力。
- BRAIN 型专家用于复杂任务拆解，成员专家各自携带自己的工具 / 技能 / 参数；普通场景用 SPECIALIST 或 CUSTOM 即可。
- 「调试」用于配置验证，运行会真实调用工具与模型，请注意其对被查询系统的影响。
智能问答
. 功能简介
智能问答是面向运维的会话式助手：用自然语言提问，AI 借助已接入的 MCP 工具实时查询指标、检索日志、分析告警，并给出处置建议。既可直接选用一个「数字专家」（自动带上其工具、技能与角色），也可临时勾选若干 MCP 工具并自定义角色设定后提问。
. 进入路径
左侧导航 →「智能运维」→「智能问答」（路径 /ai/qa）。
. 界面总览
顶部为配置栏（选择专家 / 挑选 MCP / 角色设定），中部为对话区（首次进入展示引导与建议提问），底部为输入框。
. 界面元素说明
| 区域 / 元素 | 含义 |
|---|---|
| 专家 | 顶部下拉，选择一个数字专家后，能力（工具 + 技能 + 角色）由该专家提供 |
| MCP | 未选专家时出现，以标签形式管理本次对话使用的 MCP 工具，可点「添加」增选、点标签上的 × 移除 |
| 角色设定 | 未选专家时可展开，设定助手角色与回答风格（systemMessage），并调节「温度」与「迭代步数」 |
| 建议提问 | 空态下的快捷卡片（如"排查节点离线原因""查询 CPU 热点""汇总今日告警""检索错误日志"），点击直接发起 |
| 调用了 N 个工具 | 回答上方的可展开标签，点开可查看 AI 本轮调用的工具、参数与返回摘要 |
| 输入框 | 底部输入区，Enter 发送、Shift+Enter 换行，右下角显示"N 个工具已接入"与「发送」按钮 |
| 清空对话 | 对话进行中出现，清除当前会话重新开始 |
. 操作步骤
- （方式一）在顶部「专家」下拉选择一个数字专家，其工具与技能会自动生效。
- （方式二）不选专家时，在「MCP」区点「添加」挑选本次要用的工具；可展开「角色设定」自定义角色、调节温度与迭代步数。
- 在底部输入框输入问题，或直接点击空态中的「建议提问」卡片。
- 按 Enter 发送（Shift+Enter 换行），等待 AI 回答；回答上方的「调用了 N 个工具」可展开查看证据。
- 可继续多轮追问；需要重新开始时点「清空对话」。
. 常见问题 / 注意事项
- 对话仅保存在本页，刷新即开始新对话，不会持久化历史记录。
- AI 回答可能有误，请结合实际数据核验后再决策。
- 选定专家后，MCP 与角色设定由专家接管，顶部不再单独显示工具挑选与角色设定项。
- 若提示无可用工具，请先到工具管理接入并启用 MCP，或选择一个已配置能力的专家。
- 该页至少需要
ai:read权限，无权限会提示"你没有 ai:read 权限"。
根因分析
. 功能简介
根因分析（RCA）以 Agentic 方式对故障做多步自动诊断。你把一段告警信息（JSON）作为输入，工作流按设定的角色、可用的 MCP 工具与注入的技能，自动多轮迭代地查数据、缩小范围，最终输出根因结论与完整的调查过程（证据链）。相比人工跨系统排查，可显著缩短 MTTR。诊断带最大迭代步数保护，结论附证据便于人工核验。
. 进入路径
左侧导航 →「智能运维」→「根因分析」（路径 /ai/rca-workflows）。
. 界面总览
页面以工作流列表呈现，右上角「新增工作流」。 点击右上角「新增工作流」，右侧滑出配置抽屉：
. 界面元素说明
工作流列表字段：
| 字段 | 含义 |
|---|---|
| 名称 | 工作流名，如 CPU 异常根因分析 |
| 用途 | 工作流用途说明 |
| 迭代上限 | agent 调查的工具调用步数上限 |
| 启用 | 「是 / 否」 |
| 操作 | 运行、编辑、删除 |
「新增工作流」抽屉字段：
| 字段 | 含义 |
|---|---|
| 名称 | 必填，工作流名 |
| 用途 | 工作流说明 |
| 角色设定（systemMessage） | 必填，描述该根因分析工作流的角色与职责 |
| MCP | 多选，工作流可用的 MCP 工具 |
| Skills | 多选，注入的技能 |
| 最大迭代步数 | agent 调查的工具调用上限，调查越复杂可设越大 |
| 温度 | 0 = 最确定 / 可复现，越高越发散；根因调查建议低温（默认 0.2） |
| 输出通知渠道 | run 完成后把根因结论推送到该渠道（飞书 / 钉钉 / 企微），可不选 |
| 启用 | 开关 |
| Webhook URL | 编辑已有工作流时出现，告警渠道可 POST 告警 JSON 到此 URL 触发本工作流 |
. 操作步骤
- 点击右上角「新增工作流」。
- 填写「名称」「用途」，在「角色设定（systemMessage）」中描述这个根因分析角色的职责。
- 在「MCP」选择可用工具，在「Skills」选择注入的技能。
- 设置「最大迭代步数」（调查越复杂设越大）与「温度」（建议低温），可选「输出通知渠道」。
- 打开「启用」，点击「保存」。
- 在列表该行点「运行」，在弹窗中贴入一段告警 JSON，点「运行」。
- 运行后弹出「运行结果」：进行中显示"AI 调查中…"，完成后展示「根因分析结论」，并可展开「调查过程（N 步）」查看每一步调用的工具与参数。
. 常见问题 / 注意事项
- 运行输入必须是合法的告警 JSON，格式错误会提示"告警 JSON 格式不正确"。
- 当前触发方式为手动贴入告警 JSON。告警规则自动触发、结论自动推送到通知渠道，以及通过 Webhook URL 由告警渠道 POST 触发的能力，将在后续版本逐步完善。
- 「最大迭代步数」是 agent 的调查上限，也是防止无限调用的保护；简单场景不必设太大。
- 根因结论由 AI 生成，请结合「调查过程」中的证据链人工确认后再执行处置。
- 配置与运行需要
ai:write权限。