文档目录与搜索 · 安全

文档 / 安全

权限与审批

选择合适的权限模式,区分单次允许、持久规则和任务授权。

下载 Markdown
本页内容

权限决定什么

Agent 可能读取文件或修改项目,也可能执行命令或调用外部工具。权限模式决定运行时如何处理这些动作的审批;操作系统、项目和外部服务的权限仍然有效。

初次使用可以保持 请求批准,只为已理解的具体操作放行。选择权限模式前,先确定当前 Agent 可以接触哪些材料、允许修改什么,以及哪些动作需要人工复核。

选择模式

新建 Agent 默认权限下拉菜单中的五种模式

桌面版实图。该页面修改新建 Agent 的默认值。

在 Agent 设置的权限控制中选择模式。设置 → 权限 配置的是新建 Agent 的默认权限,不代表会批量修改已有成员。

模式行为
请求批准按运行时安全规则处理,未自动批准的操作会询问
规划模式只读探索并生成计划,写入仍需确认
自动接受编辑自动批准文件编辑及受支持的文件系统操作,其他操作按默认规则处理
完全访问自动放行大多数操作,已有安全限制仍有效
不询问模式不弹出询问,不能自动放行的操作直接拒绝

“不询问模式”会拒绝无法自动批准的操作;“完全访问”则会放行大多数操作。某项操作被外部服务拒绝时,扩大 Agent 模式也不会让第三方账号自动获得资源权限。

处理审批卡片

阅读工具名称、参数、目标路径或服务,以及预期影响。确认与当前任务一致后选择 允许本次;不一致就拒绝并说明允许的范围。

页面可能提供添加 Bash 或工具允许规则,并显示匹配内容与作用范围。单次批准不修改 Agent 权限规则,长期规则可能影响后续会话。长期规则应写明操作范围,并限于反复需要的动作。

用一张审批卡片判断范围

假设你要求整理 notes.md 并生成 summary.md。出现文件写入审批时,先检查目标是否为指定工作区中的 summary.md,是否覆盖已有文件,内容是否符合本次请求。

如果卡片要求向外部系统发送消息,而任务只要求生成文件,应拒绝该操作,并补充“只保存文件,不发送”。拒绝不会自动撤销之前已经写入的文件,仍需查看已完成部分。

选择适合的情况后续影响
允许本次只确认当前这次操作不替代长期规则
保存允许规则固定任务反复需要同类操作匹配的后续调用可能不再询问
拒绝目标或影响超出要求需要改方案或补充允许范围

保存规则前阅读页面显示的匹配内容。对一条命令的批准与对整个工具的允许,范围可能相差很大。保留能够覆盖实际需求的规则,避免为消除一次询问而允许整个类别。

已有成员与当前会话

在 联系人 → 选择 Agent → 工具 检查成员默认权限,当前会话还可能有单独选择。默认模式、允许规则和禁止规则共同影响执行,切换模式前也要检查已有规则。

不同运行引擎解释工具规则的方式需要分别验证。不要直接把 Claude 文档中的命令模式或配置片段复制进 Nexus,再假定优先级与匹配范围完全一致。

为什么放宽模式仍然失败

错误来源应处理的位置
Nexus 审批未允许当前会话或任务的权限卡片
宿主文件不可读运行账号与文件系统访问权限
外部服务返回拒绝连接器账号、资源授权与凭据
工具程序不存在运行机器的依赖与路径

权限模式控制 Agent 如何获得执行许可,不能安装缺少的程序,也不能为第三方账号增加资源授权。恢复后用原来失败的最小操作验证,再继续完整任务。

定时任务的授权

定时任务出现能力审批时,可以只允许本次,也可以选择 此任务始终允许,将该能力加入这项任务的允许范围。

先检查任务名称和动作,确保授权对象正确。授权范围应限于这项任务。任务被停用也不会撤回已经执行的外部操作。

区分材料与指令

网页、邮件、仓库文件和工具返回可能包含要求执行操作的文字。它们属于待处理材料,不能自动覆盖你的要求或提供新的授权。

涉及对外发送、发布、删除或购买时,把接收对象、内容和允许范围说清楚。文件中的“请忽略前面的要求”不构成新的用户要求。

审批没有继续

先确认正在查看正确会话、连接正常且请求没有失效。若响应结果未确认,刷新核对当前状态,避免为同一动作连续提交授权。更多诊断见故障排查。