什么是 GitHub Copilot Agent 模式
GitHub Copilot Agent 模式是 Visual Studio 中引入的一种高级协作方式。与传统 Copilot 仅提供单行代码建议不同，它更像是一个智能自动化助手，能够理解自然语言提示，自动拆解任务并规划执行步骤。
其核心能力包括修改代码、运行命令、调用工具，并能持续监控执行效果，自动迭代直至满足目标。这意味着它可以处理多步骤的复杂任务，而不仅仅是单次单向响应。
工作原理：自动执行与迭代
Agent 模式的核心在于自动执行与反馈循环。当你提交一个自然语言提示时，系统会根据任务复杂度决定处理方式：
- 如果任务是单步请求，则直接生成代码建议；
- 如果任务涉及多个步骤，Copilot 会进入规划模式（Planning Mode），分解任务并建立执行计划。
这种机制使得 AI 能够在执行过程中自我修正，而不是像传统模式那样只输出一次建议就结束。
执行流程详解
计划创建
Agent 在后台维持两种形式的计划：
- Markdown 计划：人类可读，展示任务结构、步骤和进度，便于开发者理解当前状态。
- JSON 计划：机器可读，用于内部状态跟踪和步骤协调。
Markdown 计划提供可视化视图，而 JSON 计划则是支撑结构化执行逻辑的基础。
逐步执行与反馈
Agent 按计划分步骤执行，关键特点如下：
- 实时在编辑器显示建议代码；
- 在需要时运行终端命令或调用工具；
- 检测运行结果（如编译失败、测试未通过等）；
- 基于新上下文调整后续计划。
这种反馈循环确保了任务执行的可靠性，即使遇到错误也能动态调整策略。
内部工具体系
Agent 模式依赖以下关键内部工具来完成任务：
| 工具 | 作用 |
|---|---|
| plan | 生成执行计划 |
| adapt_plan | 动态调整计划 |
| update_plan_progress | 更新步骤完成状态 |
| record_observation | 捕获运行结果反馈 |
| finish_plan | 标记计划执行完成 |
当规划开启时，这些工具会自动激活，并在聊天窗口的工具列表中显示，用户可以根据需要启用或禁用。
工具调用与确认机制
为了保障安全与控制权，Copilot 在执行终端命令或外部工具前会请求确认。你可以选择授权范围：
- 仅本会话允许
- 本解决方案允许
- 所有未来都允许
在 Tools > Options > GitHub > Copilot > Tools 中可以重置这些授权设置。需要注意的是，终端命令权限与 Visual Studio 进程一致，请在执行前仔细审核。
文件访问权限
Agent 模式的文件访问受到严格限制，只能访问：
- 当前解决方案中的本地文件
- 位于解决方案根目录及其子目录下的本地文件
被排除的文件或文件夹无法访问或修改，这有助于防止意外破坏项目结构。
Ask 模式 vs Agent 模式
| 模式 | 特点 |
|---|---|
| Ask 模式 | 生成建议，不自动应用代码；适合审慎修改 |
| Agent 模式 | 可自动执行、规划和修复复杂任务；适合流程化自动化 |
| MCP 工具 | 仅在 Agent 模式下可用 |
如果只想查看建议而不希望自动更改，建议使用 Ask 模式。对于需要自动化处理的流程，Agent 模式更为合适。
规划工具启用与管理
如何启用规划功能？
- 打开 Tools > Options
- 进入 All Settings > GitHub > Copilot > Copilot Chat
- 勾选 Enable Planning
启用后，规划相关工具会出现在 Tools 面板中，方便随时调用。
限制与注意事项
使用 Agent 模式时需注意以下几点：
- 规划文件是临时的，会话结束后删除（除非手动保存）
- 存在轻微延迟开销（用于状态追踪）
- 目前某些专用 Agent 可能尚不支持规划功能
- Visual Studio 自动化权限需谨慎授权
实际示例：一个典型 Agent 流程
假设我们有一个需求：为项目添加一个 REST API 端点 GET /products，支持分页、返回 JSON 格式，并添加单元测试。如果失败，尝试处理错误并返回 500。
Agent 可能的执行流程如下：
- 解析需求，生成计划
- 创建新控制器和路由
- 添加分页逻辑
- 写返回 JSON 的逻辑
- 添加测试
- 运行测试
- 检测错误并调整修复逻辑
- 最终完成并提交更改
这个过程会持续监控构建结果与单元测试，能动态修复失败项直到达成目标。
管理与权限控制
作为管理员，可以在 GitHub Copilot 控制台中关闭 Editor Preview Features。这样用户将无法使用 Agent 模式，从而确保开发环境的安全性和一致性。
