Visual Studio Code 中的本地智能体 (Local agents)

本地智能体在您机器上的 Visual Studio Code 中以交互方式运行。它们在您当前的工作区中工作，并有权访问 VS Code 中提供的全套工具和模型，包括扩展提供的工具和 MCP 服务器。通过创建自定义智能体，您可以让智能体针对特定任务担任特定的角色或身份，例如代码审查员、测试人员或文档编写者。

本地智能体在 VS Code 的聊天界面中运行。当您关闭聊天会话时，本地智能体会保持活动状态，您可以在会话视图中跟踪它。

为什么要使用本地智能体？

• 需要即时反馈的交互式对话，例如头脑风暴、规划或尚未完全定义的任务
• 需要来自开发环境上下文的任务，例如代码检查错误 (linting errors)、堆栈跟踪、单元测试结果
• 需要访问 VS Code 扩展或 MCP 服务器中的特定工具，或者需要使用特定模型（如 BYOK 模型）的任务
• 不需要其他团队成员协作的任务

主要特性

• 在本地机器上的 VS Code 内运行，并处理当前工作区
• 基于交互式聊天的界面，用于实时反馈和迭代
• 完全访问您的工作区、文件和上下文
• 可以访问 VS Code 中配置的所有智能体工具，例如内置工具、MCP 工具和扩展提供的工具
• 可以使用您在 VS Code 中可用的所有模型，包括 BYOK 模型和其他提供商的模型

内置智能体

本地智能体会话使用三种内置智能体之一，每种智能体都针对不同类型的任务进行了优化。您可以在聊天会话期间随时通过从聊天视图的智能体选择器中选择不同的智能体来切换它们。对于更专业的工作流程，您可以创建自己的自定义智能体。

代理

该智能体针对基于高层需求的复杂编码任务进行了优化，这些任务可能需要运行终端命令和工具。AI 自主运行，确定相关的上下文和要编辑的文件，规划所需的工作，并进行迭代以解决出现的问题。

VS Code 直接在编辑器中应用代码更改，编辑器覆盖层控件使您能够浏览建议的编辑内容并进行审查。该智能体可能会调用多个工具来完成不同的任务。

您可以通过添加 MCP 服务器或安装贡献工具的扩展来使用额外工具自定义聊天。

使用 Agent 打开聊天：稳定版 (Stable) | 预览版 (Insiders)

规划 (Plan)

计划智能体 (Plan agent) 专为创建编码任务的结构化实施计划而优化。当您想在实施之前将复杂的功能或更改分解为更小、可管理的步骤时，请使用计划智能体。

计划智能体生成一份详细的计划，概述所需的步骤，并提出澄清问题以确保对任务有全面的了解。然后，您可以将该计划移交给实施智能体，或将其用作指南。

使用 Plan 打开聊天：稳定版 (Stable) | 预览版 (Insiders)

了解更多关于使用代理进行规划的信息。

询问 (Ask)

“询问”功能最适合回答有关您的代码库、编码和通用技术概念的问题。当您想了解某事物的工作原理、探索想法或在编码任务中寻求帮助时，请使用“询问”。

“询问”使用智能体能力来研究您的代码库并收集相关上下文。响应可以包含您可以单独应用到代码库的代码块。要应用代码块，请将鼠标悬停在代码块上，然后选择在编辑器中应用 (Apply in Editor) 按钮。

通过使用“询问”打开聊天：稳定版 (Stable) | 预览版 (Insiders)

编辑模式 (Edit mode)（已弃用）

编辑模式已弃用。请改用智能体模式 (Agent mode) 进行多文件代码编辑。您可以通过启用 chat.editMode.hidden 在 VS Code 中打开 在 VS Code Insiders 中打开 设置来恢复编辑模式。

开始使用

启动本地智能体会话

1. 在聊天视图的智能体选择器中选择 Agent。

2. 在聊天输入框中输入一个高层提示。例如，您可以询问

   Implement a user authentication system with OAuth2 and JWT.
   

   或

   Set up a CI/CD pipeline for this project.
   

3. 使用工具选择器来启用工具并赋予智能体更多功能。

4. 选择 发送 (Send) 或按 Enter 提交您的提示。

5. 当智能体处理您的请求时，查看并确认代码更改和工具调用。

   您可以在智能体工作时发送后续提示。将消息排队供稍后处理、引导智能体朝新方向发展，或停止并立即发送。了解更多关于在请求运行时发送消息的信息。

   提示

   VS Code 可帮助您防止对敏感文件（如工作区配置设置或环境设置）进行意外编辑。了解更多关于编辑敏感文件的信息。

开始使用“询问”

1. 在聊天输入框中输入您的提示。例如，您可以询问

   Provide 3 ways to implement a search feature in React.
   

   或

   Where is the db connection configured in this project? #codebase
   

2. 在聊天视图的智能体选择器中选择 Ask。

3. （可选）为您的提示添加上下文以获得更准确的响应。

4. 选择 发送 (Send) 或按 Enter 提交您的提示。

相关资源

• 智能体概述：选择智能体、配置权限以及在不同智能体类型之间切换。
• 管理聊天会话：创建、切换和组织您的会话。
• 智能体教程：使用不同智能体类型的实践教程。
• 工具：使用内置工具、MCP 和扩展工具扩展智能体。
• 自定义智能体：创建您自己的 AI 智能体和扩展。