本站点文档内容均翻译自code.visualstudio.com,仅供个人学习,如有差异请以官网为准。

Visual Studio Code 中的本地代理

本地代理直接在您机器上的 VS Code 中运行。您通过聊天与本地代理互动,以获得对您提示的即时结果。本地代理在您的工作区上运行,并可以访问 VS Code 中提供的全部工具和模型。创建自定义代理,您可以让代理为某个任务假设一个特定的角色或个性,例如代码审查员、测试员或文档编写者。

本地代理在 VS Code 的聊天界面中运行。当你关闭聊天会话时,本地代理仍然保持活动状态,你可以在会话视图中跟踪它。

为什么使用本地代理?

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

关键特征

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

内置代理

本地代理会话使用三种内置代理之一,每种代理都针对不同类型的任务进行了优化。在聊天过程中,您可以在聊天视图中的代理选择器中选择不同的代理,随时切换代理。对于更专业的流程,您可以创建自己的自定义代理

Agent

代理旨在根据高级要求优化复杂的编码任务,可能需要运行终端命令和工具。人工智能自主运作,确定相关的上下文和文件进行编辑,规划所需的工作,并在问题出现时进行迭代解决。

VS Code 直接在编辑器中应用代码更改,并且编辑器覆盖控件使您能够导航到建议的编辑并进行审查。代理可能会调用多个工具来完成不同的任务。

你可以通过添加MCP服务器或安装提供工具的扩展来自定义聊天

与代理开启聊天:稳定 | 内幕

重要

如果你没有看到代理选项,请确保在 VS Code 设置中启用了代理 (

聊天代理启用
  • 在 VS Code 中打开
  • 在 VS Code Insiders 中打开
ORG)。您的组织可能也会禁用代理。请联系您的管理员启用此功能。

计划

计划代理用于创建编码任务的结构化实施计划。在实施之前,当你想将复杂的功能或变更分解成更小、更可管理的步骤时,使用计划代理。

计划代理生成详细的计划,概述所需的步骤,并提出澄清问题以确保对任务的全面理解。然后,您可以将计划交给执行代理或作为指导使用。

打开与计划的聊天:稳定 | 内部人士

了解更多关于与Agents的规划

“问”功能最适合用来回答关于你的代码库、编码和一般技术概念的问题。当你想要了解某事物的工作原理、探索想法或获得编码任务的帮助时,请使用“问”。

Ask uses agentic capabilities to research your codebase and gather relevant context. Responses can contain code blocks that you apply individually to your codebase. To apply a code block, hover over the code block and select the Apply in Editor button.

通过使用Ask打开聊天:稳定 | 内部人士

开始使用

小贴士

有关于使用不同类型的代理(包括后台和云代理)的实践教程,请参阅代理教程

要启动本地代理会话:

  1. 选择Agent从聊天视图中的代理选择器中。

  2. 在聊天输入框中输入一个高级提示。例如,你可能会问:

    实现一个使用OAuth2和JWT的用户认证系统。
    

    为这个项目设置CI/CD管道。
    
  3. 使用工具选择器来启用工具并赋予代理更多能力。

  4. 选择 发送 或按 回车 提交您的提示。

  5. 在代理处理您的请求时,审查并确认代码更改和工具调用。

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

    小贴士

    VS Code 帮助您保护敏感文件不被意外编辑,例如工作区配置设置或环境设置。了解更多关于编辑敏感文件的信息。

首先问:

  1. 在聊天输入框中输入你的提示。例如,你可能会问:

    提供在 React 中实现搜索功能的三种方法。
    

    这个项目中的db连接是在哪里配置的? #codebase
    
  2. 选择询问在聊天视图中的代理选择器中。

  3. 可选地,为你的提示添加上下文以获得更准确的回复。

  4. 选择 发送 或按 回车 提交您的提示。

  • 代理概述:代理类型和会话管理概述。
  • 代理教程:处理不同代理类型的实践教程。
  • 工具:通过内置工具、MCP和扩展工具来扩展代理。
  • 定制代理:创建你自己的AI代理和扩展。
  • 聊天:了解聊天界面和互动功能。