# Plan 与 Execute 模式

> 先分析方案，再执行操作，把讨论与行动分开。

---

LLMS 索引： [llms.txt](/zh/llms.txt)

---

## 先想清楚，再动手

准备修改代码或执行复杂任务时，可以先让 Agent 分析现状和提出方案，再决定是否进入执行阶段。在自定义 Agent 或 Project 上配置 Mode ToolBlock 后，自定义 Agent 支持 Plan 与 Execute 两种工作模式；配置在 Project 上时，该 Project 中运行的自定义 Agent 都会获得这项能力。

| 模式 | 适合做什么 | 工具行为 |
| --- | --- | --- |
| Plan | 了解现状、分析问题、整理方案 | 只允许声明可在 Plan 中使用的工具 |
| Execute | 按确认的方案完成工作 | 可使用已配置的工具，仍需遵守权限与审批规则 |

## 一个文档修改的例子

先在 Plan 中要求：“阅读文档，指出术语不清和缺少示例的地方，先给修改建议。”查看方案并确认范围后，再进入 Execute，让 Agent 按方案修改文件。完成后检查差异，确认原有事实和限制被保留。

能否读取或修改文件仍取决于配置的工具。只切换模式，不会自动添加缺少的文件能力。

## 开始使用

1. 在自定义 Agent 或 Project 的 **Tools** 中配置 Mode ToolBlock 和任务所需工具。
2. 新回合默认处于 Execute。在 Chat 输入框点击 **+**，选择 **Plan mode**，输入框中出现 **Plan** 标记后，再要求 Agent 分析问题。
3. Agent 提出的方案显示为 **Plan** 卡片，可以复制。确认方案后点击 Plan 标记上的 × 回到 Execute；Agent 请求切换模式时，在界面中回应确认。
4. 检查实际改动和执行结果，必要时回到 Plan 继续讨论。

```mermaid
flowchart LR
    A["Plan：分析与方案"] --> B["用户确认切换"]
    B --> C["Execute：执行任务"]
    C --> D["检查结果"]
    D --> A
```

Plan 限制由工具的声明和执行检查决定，不能仅靠提示词保证。Execute 也不等于自动批准所有操作：工作模式决定哪些工具能用，审批设置决定调用时是否需要你确认。外部 Agent 使用各自支持的模式与权限能力，不能直接假设与自定义 Agent 完全一致。

[了解工具审批](/zh/docs/features/tool-approval/) · [配置 Tools 与 Skills](/zh/docs/guides/tools-skills/)

---

反链：

- [Tools 与 Skills](/zh/docs/guides/tools-skills/)