运枢:服务运维

助手能做什么与授权

运枢向助手开放的操作,以及资源和动作怎样授权。

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_beforechange.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 的归属人员确认。

进一步交流

带一件正在做的事来聊

告诉我们你想让智能体接哪一类系统。我们在演示环境里把这件事走一遍,再一起判断合不合适。