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