跳到正文

权限模式

Permission Mode

中级通用

权限模式(Permission Mode)是 AI Agent 运行时决定哪些操作可直接执行、哪些需要你确认的设置。它解决的是代理写代码时的执行边界问题,比如修改文件可以放行,部署上线先征求同意。

你可能会说:「让 AI 帮我改网站代码,但删文件和发布上线前先问我一声。」

读之前建议先了解

动手看看

代码助手 · 官网工作台
常规模式
正在处理发布任务
代理准备执行下一步;权限模式决定它能否直接继续。
修改 src/pages/Home.tsx更新首页的发布提示文案
部署官网到生产环境新版本将对所有访客可见
已自动执行,无需确认
需要你确认
代理已暂停。允许本次操作后,才会继续执行。
暂不允许
允许本次操作
权限模式
待执行操作

切换权限模式和待执行操作,看看代理何时直接继续、何时停下来等你确认。出现弹窗时,也可以悬停按钮或用 Tab 聚焦。

常规模式允许代理直接改文件,但部署到生产环境仍会暂停,等你决定是否放行。

要点

  1. 1

    先区分建议和实际执行

    Agent 说“我打算删除旧文件”只是提出计划;真正调用工具删文件才会产生影响。权限模式主要管执行这一步,让你决定哪些动作可以由它接着做,哪些动作要先停下来问你。

  2. 2

    按操作风险设置确认边界

    读代码、运行测试和部署上线的后果不同,所以确认边界也可以不同。比如你让 Agent 修网站页面,可以允许它读取和修改项目文件,但在安装依赖或发布到线上前请求确认。

  3. 3

    模式生效范围取决于运行工具

    不同 Agent 工具提供的模式名称和拦截范围不一样。有的控制文件写入,有的还控制命令执行或网络访问。你需要看当前工具实际拦截了什么,不能只凭模式名称判断它一定安全。

容易混淆的地方

权限模式管的是 Agent 执行操作前,是否能直接继续、需要你确认,还是被阻止;沙箱管的是操作即使执行了,能接触到哪些文件和资源。它也不同于产品里的权限控制:后者决定登录用户能否访问后台功能,而不是你协作写代码时 Agent 能否运行命令。

什么时候用

适合用

  • 让 Agent 在现有项目里连续修改页面和运行测试,同时把删除文件等高影响操作留给你确认。
  • 让 Agent 排查线上问题时先读取日志和配置,但在改动服务设置或重新部署前停下来问你。
  • 让 Agent 批量整理仓库文件时减少逐项确认,又保留对项目外文件操作的人工把关。

不适合用

  • 你要解决的是后台用户能否查看订单或修改价格,用产品的权限控制设计角色和访问规则。
  • 你要防止 Agent 接触本机私密文件,仅靠执行前确认不够;给它隔离的沙箱或受限环境。
  • 你只是想让 AI 给出修改建议,不打算让它调用工具执行操作;让它输出方案或差异对比即可。

练一练

你让 Agent 修复网站结账页:希望它能读代码、改文件和跑测试,但不能自行安装依赖或部署上线。该怎么表达?

让 AI 帮你做

请按权限模式执行这次结账页修复:你可以读取和修改当前项目文件、运行现有测试;删除文件、安装依赖、访问项目外路径或部署上线前,先说明具体操作和影响,等我确认。也请告诉我当前工具有哪些操作无法按此拦截。

接下来学什么