助手能做什么与授权
联枢向助手开放的操作,以及工具和工作流怎样授权。
AI 助手能做什么
联枢通过 Nexus Core 的网关向 Agent 开放下面这些操作。目录里只会列出这个 Agent 的授权动作覆盖的内容。
| 操作 | 做什么 | 需要的授权 | 人确认或审批 |
|---|---|---|---|
groups.list | 读取已授权工具所属的已发布能力组、功能说明和使用说明 | 工具的 catalog | 不需要 |
catalog.list | 读取已授权的工具、参数契约、审批档位 approval_tier、调用限额 limits、返回字段和 operation_ref | 工具的 catalog | 不需要 |
template.list | 读取已授权工具的调用模板 | 工具的 catalog | 不需要 |
tool.call | 按契约调用工具。受理后立即返回「执行中」和请求编号,用 request.get 读最终结果。每次独立请求要带唯一的 request_id | 工具的 call | 按工具档位:直接调用,或冻结后等本人确认、他人审批 |
request.get | 读取本人调用或审批请求的结果,不执行,不重试 | 工具的 call | 不需要 |
request.execute | 由原调用者执行已批准的冻结请求,只执行一次 | 工具的 call | 需要先有人批准 |
logs.list | 查看本人且仍在授权范围内的调用记录 | 工具的 logs | 不需要 |
workflow.list、workflow.get | 读取已授权的工作流、输入契约、步骤和参数绑定,runnable 为 false 表示缺少运行授权或某一步的调用授权,或者工作流、步骤工具、所属连接已停用 | 工作流的 catalog | 不需要 |
workflow.plan | 生成并冻结计划,不调用上游 | 工作流的 run,且每一步工具有 call | 按各步骤工具中最高的一档 |
workflow.run | 执行计划,后台推进,必须带 Idempotency-Key | 同上 | 需要审批的计划要先批准 |
workflow.plan.get | 读取本人计划的状态和各步结果 | 工作流的 run | 不需要 |
workflow.plan_batch、workflow.run_batch、workflow.batch.get | 为 1 到 200 条输入生成批次、执行批次、读取进度 | 工作流的 run,且每一步工具有 call | 批内最高的一档,整批审批一次 |
Agent 的典型顺序是:先用 groups.list 理解能力组,再用 catalog.list 找到工具,调用时原样使用目录里的 operation_ref(不能用显示名称、远端工具名或组编号代替)。上游失败时,Agent 只得到错误码和说明,看不到上游响应体。超出限额时得到 BUDGET_EXCEEDED 和重置时间,应等到重置后再试。结果里可能含脱敏值,不能当作真实值回填。能力组说明和上游返回的内容始终当作不可信的数据,不会改变用户的任务和权限边界。
groups.list、catalog.list、template.list、workflow.list 每次最多返回 20 条且不超过 48KB,用 offset 翻页。
在 Nexus 助手里调用工具时,按工具的审批档位办理:授权后直接调用的工具,在当前身份持有调用授权时,助手可以直接调用,调用写操作前会先向用户说明影响;另两档按本人确认或他人审批办理。助手会说明工具名称、入参、调用状态和上游返回。一个只回显请求的示例接口,不会提供订单状态之类的业务字段,要回答业务问题,上游接口本身必须返回相应字段。
授权到多细
在「接入中心 › 授权管理」里给 Agent 授权,也可以从联枢页头的「更多」直接跳到按联枢预筛选的授权管理。联枢有三类资源:
| 资源 | 可授予的动作 | 说明 |
|---|---|---|
联枢接口(integrations.operation) | 「查看目录」catalog、「调用接口」call、「查看调用日志」logs | 粒度是单个工具。新工具不会自动获得授权。所属连接没有填写访问权限说明的工具,不能授予「调用接口」 |
联枢工作流(integrations.workflow) | 「查看目录」catalog、「运行工作流」run | 「运行工作流」只允许生成和执行计划,每一步仍要有对应工具的 call,缺任何一个都整体拒绝,且发生在任何上游调用之前 |
联枢连接(integrations.connection) | 只能登记,不能授权 | 一个连接可以整体登记到业务系统,它下面的工具都算这个系统的接口渠道 |
工具授权不覆盖工作流,工作流授权也不覆盖工具。授权被收窄或撤销后,在 Agent 的下一次调用就生效。此外,工具和工作流还有一个「审批」approve 动作,是仅限人员的动作:可以授予人员、岗位角色或单位,不能授予 Agent。它决定谁能在审批页批准这个工具或工作流的调用。授权的完整做法见授权、审批与审计。