PolyAI 中文文档 下载 App

Agent Builder 的三种工作模式:Agent、Plan、Ask

模式总览

Agent Builder 的对话框里有三个模式切换选项,决定了 AI 对你的请求做什么:

模式行为什么时候用
Agent(默认)规划改动 → 展示计划卡片 → 批准后自动应用绝大多数构建场景
Plan只规划 → 展示计划卡片 → 不应用想对比不同方案、或者还没准备好执行
Ask只读查询 → 回答关于你项目的问题探索、分析、理解现有配置

默认模式是 Agent。你可以在每个请求前显式切换,或者在对话框顶部的模式选择器里改默认值。

Agent 模式(默认)

这是之前介绍的完整工作流:请求 → 澄清 → 计划 → 批准 → 应用到 Branch。Agent 模式下,AI 的主要产出是一个可以被执行的改动集合。

关键行为:

Plan 模式(只规划不应用)

Plan 模式下 AI 做的事和 Agent 模式完全一样——读取项目配置、澄清模糊点、生成计划卡片——但不会自动应用到 Branch。计划生成后就停在那里等你 review。

适合场景:

Plan 模式下生成的计划可以手动点击"Apply"应用到 Branch,或者切换到 Agent 模式重新请求让 AI 执行。

Ask 模式(只读查询)

Ask 模式下 Agent Builder 变成一个项目知识查询助手——它会读取你的项目配置(Flows、Topics、Entities、Functions)和最近的对话日志,然后回答你的问题。不会产生任何改动。

适合场景:

Ask 模式的回答会引用你项目里的真实配置和日志数据,不是泛泛的解释。它会展示底层用了什么工具(read、explore 等)来获取信息,类似 Webchat 里的 tool call 展示。

模式切换的两种方式

  1. 对话框顶部选择器:在发送按钮旁边有一个模式下拉框,可以切换默认模式
  2. 单次请求前缀:在输入里加 [Plan] 或 [Ask] 前缀临时改变这一次请求的模式,不影响默认值

三种模式的边界

Agent Builder 永远不会自动发布到 Live——不管用哪个模式,改动都停留在 Branch 上,发布必须手动在 Deployments 面板里完成。这是一个刻意设计的安全边界,避免 AI 不小心把草稿推到生产环境。