Agent Builder 的三种工作模式:Agent、Plan、Ask
模式总览
Agent Builder 的对话框里有三个模式切换选项,决定了 AI 对你的请求做什么:
| 模式 | 行为 | 什么时候用 |
|---|---|---|
| Agent(默认) | 规划改动 → 展示计划卡片 → 批准后自动应用 | 绝大多数构建场景 |
| Plan | 只规划 → 展示计划卡片 → 不应用 | 想对比不同方案、或者还没准备好执行 |
| Ask | 只读查询 → 回答关于你项目的问题 | 探索、分析、理解现有配置 |
默认模式是 Agent。你可以在每个请求前显式切换,或者在对话框顶部的模式选择器里改默认值。
Agent 模式(默认)
这是之前介绍的完整工作流:请求 → 澄清 → 计划 → 批准 → 应用到 Branch。Agent 模式下,AI 的主要产出是一个可以被执行的改动集合。
关键行为:
- 所有改动写入一个新建的 Branch,Main 分支完全不受影响
- 应用后会显示 changes-made 卡片,列出每处具体改动
- 不会自动发布到 Live——你还需要手动走 Deployments 流程
Plan 模式(只规划不应用)
Plan 模式下 AI 做的事和 Agent 模式完全一样——读取项目配置、澄清模糊点、生成计划卡片——但不会自动应用到 Branch。计划生成后就停在那里等你 review。
适合场景:
- 你不确定方案对不对,想先看看 AI 打算怎么改
- 你想让 AI 生成两套不同方案对比一下(第一次"Plan 模式,帮我设计方案 A",第二次"Plan 模式,帮我设计方案 B")
- 改动涉及敏感区域(比如 payment Flow),想先过一遍再执行
Plan 模式下生成的计划可以手动点击"Apply"应用到 Branch,或者切换到 Agent 模式重新请求让 AI 执行。
Ask 模式(只读查询)
Ask 模式下 Agent Builder 变成一个项目知识查询助手——它会读取你的项目配置(Flows、Topics、Entities、Functions)和最近的对话日志,然后回答你的问题。不会产生任何改动。
适合场景:
- "我的 billing Flow 是怎么路由的?"
- "最近一周里,Containment 率下降最明显的是哪个话题?"
- "我有哪些还没配置动作的 FAQ 话题?"
- "昨天有多少用户说想转人工?主要原因是什么?"
Ask 模式的回答会引用你项目里的真实配置和日志数据,不是泛泛的解释。它会展示底层用了什么工具(read、explore 等)来获取信息,类似 Webchat 里的 tool call 展示。
模式切换的两种方式
- 对话框顶部选择器:在发送按钮旁边有一个模式下拉框,可以切换默认模式
- 单次请求前缀:在输入里加
[Plan]或[Ask]前缀临时改变这一次请求的模式,不影响默认值
三种模式的边界
Agent Builder 永远不会自动发布到 Live——不管用哪个模式,改动都停留在 Branch 上,发布必须手动在 Deployments 面板里完成。这是一个刻意设计的安全边界,避免 AI 不小心把草稿推到生产环境。