在 VS Code 中使用 Agents 构建 AI 驱动的工作流#
概述#
Visual Studio Code 内置 AI agents。只需用自然语言描述任务，agent 会规划实现步骤、跨工程修改文件、运行命令并自我修复直至完成任务。Agents 与你现有的开发流程保持一致，让你专注意图与审查，而不是逐行输入代码。
注意：确保在 VS Code 设置中启用了 agents（chat.agent.enabled）。该设置可由组织集中管理（ORG）。如果你的组织禁用了 agents，请联系 GitHub 组织管理员。
可以用 agents 做什么#
Agents 能端到端处理真实的编码任务，常见用例包括：
- 计划实现方案：使用 Plan agent 生成可审阅的逐步实现计划。
- 构建新功能：描述想要的功能，agent 可以搭建 UI、连接状态并更新测试用例。
- 原型与并行变体探索：快速生成 PoC 或多个设计变体，然后保留最优解。
- 大规模重构：在整个工作区中重命名、重构或迁移代码，同时跟踪剩余工作项。
- 构建并测试 Web 应用：通过集成浏览器从 chat 驱动并做端到端验证。
- 调试与修复失败的测试：将 agent 指向堆栈跟踪或失败测试，定位根因并尝试修复。
相关文档：
- Plan agent：http://code.visualstudio.com/docs/agents/planning
- 浏览器测试指南（Browser Agent Testing）：http://code.visualstudio.com/docs/agents/guides/browser-agent-testing-guide
快速入门#
AI 功能已内置在 VS Code 中。启用并开始使用的步骤：
在 VS Code 标题栏选择 Sign In，或将鼠标悬停在状态栏的 Copilot 图标上并选择 Enable AI features。如果没有订阅，你会自动收到带有每月配额的免费计划。
从 VS Code 标题栏选择 Open in Agents。
选择工作区文件夹，然后选择 Copilot CLI agent 启动会话。
在提示框中输入自然语言描述，例如：
“Add a dark mode toggle to the header and make sure it works on mobile”
提示：你也可以使用自己的 API key 来调用任意模型供应商（无需 Copilot 订阅）。详见语言模型配置：http://code.visualstudio.com/docs/agent-customization/language-models
Agents 窗口 和 Chat 视图#
VS Code 提供两种主要交互界面：Agents window（Agent 优先）和 Chat view（代码优先）。你可以根据任务特点在两者间自由切换，它们共享同一 agent 会话上下文。
Agents window（推荐用于高层任务与多工程并行管理）
- 以 agent 为中心，从单一窗口跨所有工作区协同多个 agent。
- 适合分配高层任务、评估多个结果并并行运行 agent。
- 预览图：
文档：http://code.visualstudio.com/docs/agents/agents-window
Chat view（推荐用于紧贴代码的开发场景）
- 作为侧边栏的聊天面板，范围限定为当前打开的工作区。
- 适合给 agent 具体的代码修改任务、即时审查生成的代码并持续互动。
文档：http://code.visualstudio.com/docs/agents/chat-view
配置 agent 会话#
在每次启动会话时，你可以选择并随时调整下列设置来控制 agent 的运行方式：
| 选项 | 描述 |
|---|---|
| Agent type（代理类型） | 决定 agent 在何处运行及交互方式：本地 agent（Local Agents）、在后台运行的 Copilot CLI、本地无法访问但在 GitHub 基础设施上运行的 Cloud Agents，或 Anthropic/OpenAI 等第三方提供的 agents。会话可在不同类型间移交（例如把本地 Plan 会话移交给 Copilot CLI）。 |
| Agent（角色） | 决定 agent 的“人格”与可用工具：内置角色（Agent、Plan、Ask）或自定义 agent（如安全专家、文档撰写者）。 |
| Language model（语言模型） | 驱动 agent 思考能力的模型：可选更快的模型用于快速编辑或更强的模型用于复杂多步推理或研究。详见语言模型配置。 |
| Permission level（权限级别） | agent 运行工具和终端命令的自主程度：从每一步都需你批准到完全自动化运行。详见审批与权限文档（Approvals & Permissions）。 |
相关链接：
- Agent 类型概览：http://code.visualstudio.com/docs/agents/agent-types/local-agents
- 权限与审批：http://code.visualstudio.com/docs/agents/approvals
针对你的代码库定制 agents#
为了让 agent 产出的代码更契合项目约定，VS Code 提供多种定制方式：
- 定义编码规范：使用 custom instructions 指定项目风格与规则。
- 自动化常见流程：将常用提示保存为 prompt files；或把多步工作流封装为 agent skills。
- 专门化 agent：创建 custom agents，例如代码评审、漏洞分析或测试专员角色。
- 连接外部工具与数据源：使用 MCP servers 访问数据库与 API，用 hooks 在关键时刻运行脚本。
- 安装插件：从 Marketplace 获取预打包的定制插件（agent-plugins）。
更多概念性指导：http://code.visualstudio.com/docs/agents/concepts/customization
信任与控制（Trust & Safety）#
Agents 可以读取/修改文件、运行终端命令并调用外部服务。VS Code 提供多层控制以保证安全：
- 在运行前批准或拒绝 agent 发起的工具调用。
- 通过权限级别控制 agent 的自主性。
- 启用操作系统层面的 sandbox（沙箱）以限制文件系统和网络访问。
组织可以集中管理可用的 AI 功能、模型与工具：管理员能定义策略来限制 agent 能力、MCP 服务器或扩展，满足合规要求，从而为开发者提供一致且受治理的体验。
相关文档：
- Trust and safety：https://code.visualstudio.com/docs/agents/concepts/trust-and-safety
- 企业 AI 策略：https://code.visualstudio.com/docs/enterprise/ai-settings
参考资源#
- 跟随 agents 教程：http://code.visualstudio.com/docs/agents/agents-tutorial
- 学习 agent 最佳实践：http://code.visualstudio.com/docs/agents/best-practices
- 深入 agent 概念：http://code.visualstudio.com/docs/agents/concepts/overview