联枢:接口与工具

助手能做什么与授权

联枢向助手开放的操作,以及工具和工作流怎样授权。

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。它决定谁能在审批页批准这个工具或工作流的调用。授权的完整做法见授权、审批与审计。

进一步交流

带一件正在做的事来聊

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