助手能做什么与授权
运枢向助手开放的操作,以及资源和动作怎样授权。
AI 助手能做什么
下表列出运枢向 Agent 开放的操作。没有对应授权的操作,Agent 在发现和调用时都看不到。资源相关的操作按资源逐个鉴权,批量请求里混进未授权的资源时整体拒绝。
| 操作 | 做什么 | 需要的授权 | 人确认或审批 |
|---|---|---|---|
resources.list | 列出已授权的资源,包括各资源开放的变更和扩缩容范围 | resources.read | 不需要 |
status.get | 只读检查已授权服务的当前状态 | status.read | 不需要 |
logs.read | 读取一个资源的限定行数日志,已脱敏 | logs.read | 不需要 |
logs.search | 按时间窗口和关键词检索最多 10 个资源的日志 | logs.read | 不需要 |
status.history | 读取状态采样历史 | status.read | 不需要 |
diagnose.timeline | 合并状态、预警、变更和巡检发现的证据时间线 | status.read,按来源另需 alerts.read、task.read、inspection.read、logs.read | 不需要 |
inspection.run | 启动只读巡检,传资源列表,或只传 template_ref 运行巡检模板,返回报告引用 | inspection.run,模板里的资源还需 status.read,含日志时需 logs.read | 不需要 |
inspection.get | 读取本人发起且仍有权限的巡检报告 | inspection.read | 不需要 |
inspection.template.list | 列出当前 Key 可以运行的巡检模板 | inspection.run | 不需要 |
attention.list | 列出授权资源上未恢复的预警和关注建议,区分已确认、采集过期和监控暂停,只读,不会确认预警 | alerts.read | 不需要 |
change.plan | 冻结变更计划(重启、扩缩容、回滚、重载)并申请审批,可带 not_before | change.plan,加目标上该类型的 <类型>.plan | 计划本身需要人批准,档位按资源配置 |
change.submit | 只凭 plan_ref 提交已批准的计划,返回持久任务,必须带幂等键 | change.submit,加每个目标该类型的 <类型>.submit | 计划必须已被人批准,且只能由原发起人提交 |
restart.plan、restart.submit | 重启计划和提交,是上面两个操作的 restart 别名,保留给已有的 Agent 和技能 | restart.plan、restart.submit | 同上 |
plan.list | 读取本人发起的计划当前状态,最多 30 个:待批准、需重新批准、已批准、已提交、已拒绝、已撤销、已失效 | task.read | 不需要 |
runbook.list | 列出运行手册,以及展开后当前 Key 具备授权的目标 | runbook.plan | 不需要 |
runbook.plan | 把一个运行手册冻结成一个计划并申请整体审批 | runbook.plan,加每个步骤类型的 <类型>.plan | 整体批准;设为步骤间确认时,每步还需确认 |
task.get | 读取本人任务;等待逐步确认时给出确认链接 | task.read | 不需要 |
task.stop | 停止尚未派发的后续目标,已派发的动作仍要核验 | task.stop | 不需要 |
task.reconcile | 按原回执只读对账,不重新执行 | task.reconcile | 不需要 |
Agent 没有任何批准或放行类的操作。change.plan 返回的结果里有审批档位、审批页链接和下一步的提示:本人确认的计划,请用户在对话里的审批卡片上本人确认,卡片没出现时把审批页链接交给用户;他人审批的计划,由其他有权的人在自己的客户端或审批页批准。人批准后,Agent 再用 plan.list 核对状态,然后用原来的 plan_ref 提交一次。
在 Nexus 助手里查看资源状态
在 Nexus 助手里打开「Nexus 管理」,进入运枢,可以看到当前 Key 获授权的资源,按环境、业务、资源组、资源展开,并标出未处理的提醒。点「读取全部状态」,或选中某个资源点「读取当前状态」,会实时连到资源读取,每次读取都记入运维审计。资源详情会显示平台、产品、项目、管理方式、验证状态和支持的操作,验证状态分实验环境、协议模拟、实机和不可用。验证状态标为实验环境或协议模拟的资源,结果只代表演示或模拟,生产资源要以真实连接环境的验证为准。
授权到多细
运枢授权的资源类型是「运维资源」,粒度是单个资源,每个资源上可以逐项授予下面这些动作,没有行列或数量上的约束。授权在「接入中心 › 授权管理」里配置,授权对象可以是 Agent,也可以是单位、岗位角色或人员,合并规则见授权、审批与审计。
| 授权动作 | 含义 |
|---|---|
resources.read | 查看资源 |
status.read | 读取状态,也是状态历史和证据时间线的基础 |
logs.read | 读取服务日志,包括日志检索,与状态读取分开授权 |
alerts.read | 读取待关注的预警 |
inspection.run、inspection.read | 发起只读巡检,查看本人的巡检报告 |
restart.plan、restart.submit | 创建重启计划,提交已批准的重启计划 |
scale.plan、scale.submit | 扩缩容计划和提交 |
rollback.plan、rollback.submit | 回滚计划和提交 |
reload.plan、reload.submit | 重载计划和提交 |
change.plan、change.submit | 通过通用变更入口创建和提交计划,还要同时有对应类型的授权 |
runbook.plan | 按运行手册创建计划,每个步骤类型的计划授权也要有 |
task.read、task.stop、task.reconcile | 查看本人任务,停止后续目标,只读核验 |
| 审批 | 在审批页批准这个资源上的计划。只能授予人员、岗位角色或单位,不能授予 Agent,属于这个单位的 Agent 也不会继承。一个计划有多个目标时,审批人要在每个目标上都有这项授权。 |
- 某个类型的提交授权只能授予支持这个类型的资源,例如扩缩容的提交授权只能给开放了扩缩容的资源。
- 授权只对明确选中的资源有效,新登记的资源不会自动继承。授权可以随时修改,改动后下一次调用就生效,已有的 Key 不会因为登记了新资源而自动扩权。
- 资源的归属变化后,这个资源原来的 Key 授权会被撤销,需要重新授权。
- 授权要覆盖整条链路。例如让一个 Agent 重启服务,需要它在资源上有
restart.plan和restart.submit,资源上开启了重启;资源设为「需要他人审批」时,还要有人在这个资源上持有「审批」。设为「需要本人确认」时不需要审批授权,由发起 Agent 的归属人员确认。