Agent 权限模式
选好权限档位再动手,先规划复杂工作,用来源和技能组合出专门能力,并把代码改动与协作平台对齐。
权限模式
工作台用权限模式决定 Agent 执行工具调用时要不要先问你。档位从只读到全自动共四档:Explore(只读探索)、Ask to Edit(改动前询问)、Guarded(自动执行,有风险的操作先问)、Execute(全自动执行)。
在输入区按 SHIFT+TAB 就能在档位之间循环切换,当前档位显示在输入区的模式标记上。
- Explore:只读探索,禁止写入,也不会弹窗。
- Ask to Edit:执行改动前先征求你的同意。
- Guarded:照常自动执行,被判定为有风险的操作才询问。
- Execute:自动执行,不再询问。
设置新会话的默认档位
默认档位决定新建会话时预选哪一个权限模式,需要临时换一种时也可以在输入区单独切换。
真正生效的是输入区里显示的那个模式,发送第一条消息前先核对它。
- 打开“设置 → 工作区”,查看默认权限模式与代码模式的开关。
- 选择希望用于新会话的默认权限模式;需要了解各档位的行为时,参考“权限模式”一节。
- 新建会话后,检查输入区显示的档位,再开始发送任务。
复杂工作先做规划
规划模式适合先澄清目标、检查现状和审阅方案,再决定是否实施。
你可以直接把任务要求附在 /plan 消息里,Agent 会先处理这份任务,在改动任何内容之前给出方案。
- 输入 /plan,或发送带有任务说明的 /plan 消息。
- 阅读 Agent 提交的方案,选择批准,或补充反馈继续规划。
- 需要手动结束规划时,输入 /plan off,并再次确认当前权限范围。
/plan 请先阅读这个项目,提出优化首页加载速度的方案。说明需要修改的位置、预期收益和验证方法,等我审阅后再实施。
用来源和技能组合专门能力
- 工作台里没有智能体市场,也没有可以安装的智能体条目。专门的能力由来源和技能拼出来:来源提供工具,技能提供做法。
- 把服务接成来源,它的工具就会进入当前会话的工具列表。
- 在技能的 requiredSources 里声明依赖的来源,调用该技能时会自动启用这个来源。
面向代码的会话
面向代码的会话是常规会话的精简形态:Agent 使用更短的系统提示,只保留编码工作真正需要的工具。
因此每一轮携带的内容更少,模型的注意力也更多地留在代码上,而不是分散到工作台的各种能力上。
它默认关闭,只在你在第一条消息之前手动打开的会话里生效。
模型、思考等级、权限档位、来源以及工作目录里的 Git 上下文都照常使用。
- 在发送第一条消息之前,打开输入区里紧挨文件夹标记的代码模式选项。
- 选择这次会话的工作位置:从一个仓库新建工作树,或者直接使用已有文件夹。
- 直接关闭菜单就保持当前文件夹与当前模式,不做改动。
- 希望所有新会话都以代码模式开始时,在“设置 → 工作区”中打开对应开关;每个会话仍可在首条消息前单独切换。
| 维度 | 常规会话 | 面向代码的会话 |
|---|---|---|
| 系统提示 | 完整的工作台说明:来源、素材、自动化等。 | 精简的编码说明:先读项目上下文文件,保持小改动,完成前跑通项目自带的检查,未经要求不提交。 |
| 会话工具 | 覆盖工作台各类能力的完整工具集。 | 计划与后台任务、已启用来源提供的工具,以及项目内的长期记忆。 |
| 每条消息的上下文 | 工作区的全部来源与能力。 | 仅本次会话真正用到的来源。 |
把代码改动与协作平台对齐
面向代码的会话在会话头部内置拉取请求状态标记,数据取自本机的 GitHub 命令行工具(gh)。
把协作平台接成来源,可以让 Agent 读取更完整的状态并汇报给你。
Agent 在工作目录指向的本地副本上工作,而不是直接在平台上操作。
除非你明确要求,它不会推送分支、回复评审意见,也不会改动 issue 状态。
- 把 GitHub 或你的问题跟踪平台接成来源,并配置好它需要的访问权限。
- 让 Agent 读取当前分支的状态:关联的 issue、尚未结束的评审讨论、仍在运行的检查。
- 把汇报结果和本地差异对照,确认还有哪些事项没有收尾。
- 逐项安排修复;评审期间保持较窄的权限档位,让改动逐项可复核。
| 核对项 | 确认什么 |
|---|---|
| 改动范围 | 本地差异与约定好的 issue 一致,没有夹带无关改动。 |
| issue 状态 | 跟踪平台上的目标与当前任务仍然一致,没有并行的同类任务。 |
| 评审意见 | 每条未结束的评审讨论都已处理,或明确说明推迟处理。 |
| 检查结果 | 本地检查已通过;仍在运行的远端检查如实标为进行中。 |
| 未发布的工作 | 尚未推送的提交被列出来,避免改动悄悄停在本地。 |
请用已连接的 GitHub 来源读取当前分支的状态:关联 issue、未结束的评审意见和正在运行的检查。然后与本地差异对照,列出还没处理的事项。先只读,不要改动代码。
对话开始后切换代码模式
代码模式在会话开始时就确定下来,因此不能在中途就地切换。
在已有会话里打开代码模式时,工作台会另开一个新会话继续。
新会话保留原会话的工作目录、模型、来源与权限档位。
它在第一轮会收到一段前情摘要,原会话保持原样,方便回看。
- 在会话输入区里打开代码模式开关。
- 工作台会按新的代码模式另开一个会话。
- 阅读第一轮给出的前情摘要,补充代码会话需要的说明。
- 把两个会话都保留下来做对照。
让 Agent 协助整理会话
会话整理也可以交给 Agent:直接说「把登录缺陷那条会话归档」,它会在当前工作区内处理,不用你离开正在进行的对话。
- 作用范围限于 Agent 当前所在的工作区,它无法处理其他工作区的会话。
- 会话不能归档自己;需要归档当前这条时,请从另一条会话发起。
- 正在执行回合的会话不会被归档,进行中的任务不会被打断。
- 归档只是从默认视图收起,需要时可以再取消归档。