GitHub Copilot新版本智能体与工作区指南

GitHub Copilot 此次更新将智能体（Agent）完全绑定至特定工作区（Workspace），脱离项目上下文的独立操作模式已不再适用。若 VS Code 仅打开单个纯文本文件而未挂载包含工程文件或 Git 仓库的文件夹，多数高级功能将无法正常启用。

要充分发挥其能力，必须摒弃“打开聊天框随意提问”的旧习惯，转而构建以项目上下文为核心的操作流程。

启用新版智能体并绑定当前工作区

核心操作：确保 VS Code 工作区已加载包含 .git 目录或至少一个源码文件的有效本地文件夹。若工作区为空或仅临时打开单文件，即便调用了 @modernize-dotnet 专用智能体，系统也会报错并拒绝加载评估模块。

此项为硬性前置条件，无法绕过。

操作步骤：按下 ⌘⇧P（macOS）或 Ctrl+Shift+P（Windows/Linux），输入“Copilot: Open Chat”打开聊天面板。在输入框中键入 @modernize-dotnet 后按空格。状态栏将显示“Loading agent context…”，约2-4秒后右下角出现绿色对勾并提示“Ready in workspace: my-project”。

注意先后顺序：若先输入自然语言指令再提及智能体名称，系统将调用默认通用助手而非 .NET 专项评估逻辑。

切换智能体工作模式：自动 vs 引导

模式切换需在智能体加载完成且处于空闲状态（聊天框底部无“…”加载提示）时进行。

两种操作方法：
方法一：输入快捷指令 /mode auto 启用自动模式，/mode guided 切换为引导模式。输入后无需回车，Copilot 会即时响应并确认。

方法二：通过设置面板调整。打开设置（⌘,），搜索“copilot agent mode”，定位到“Copilot > Agent: Default Mode”，在下拉菜单中选择“guided”或“auto”。注意：该设置仅作用于新启动的智能体会话，不影响当前会话。

区别明确：引导模式下，每个阶段结束后智能体强制暂停，需输入 /continue 方可继续；自动模式下，除非遇到权限不足或 Git 冲突，任务将一次性完成。

让智能体识别并利用工作区特征

此步骤是释放智能体潜力的核心。

首先验证工作区元数据是否被正确解析。输入 /status，检查返回内容是否包含“Solution file: MySolution.sln”、“Target framework: net8.0”、“EF Core version: 8.0.4”等字段。若仅显示“No solution detected”，表明智能体未成功解析项目结构，需确认工作区根目录下是否存在 .sln 文件或全局 JSON 配置文件。

其次，下达指令时必须明确关键约束。例如升级项目时，不应简单说“帮我升级”，而应具体表述为：“升级 WebApi.csproj 到 net10.0，保留 ASP.NET Core 8 兼容性层，不修改 Program.cs 的 HostBuilder 初始化方式。”若缺少目标框架和兼容性声明，智能体将执行破坏性升级，直接以新版中间件注册方式覆盖原有代码。

最后，验证文件访问权限。输入 /list files src/，确认是否列出所有子目录及 .cs 文件。若返回“Access denied to folder src/”，说明 VS Code 工作区未授予 Copilot 文件系统读取权限，需点击右下角通知栏中的“Allow access”按钮重新授权。

多工作区协同场景下的智能体隔离控制

实际项目中常需同时打开多个 VS Code 窗口，每个窗口对应独立工作区。此时 Copilot 智能体完全隔离——窗口 A 的智能体无法访问窗口 B 的任何文件或 Git 状态。

若需跨工作区操作（例如同步更新两个微服务的共享 SDK 版本），必须手动切换上下文：

• 在窗口 A 的 Copilot 聊天中输入 /switch-to-workspace ../shared-sdk
• 等待状态栏更新为“Active workspace: shared-sdk”
• 输入指令，例如“将 Version.props 中的 PackageVersion 更新为 3.2.1”
• 完成后输入 /switch-back 返回原工作区

需注意：/switch-to-workspace 后必须使用相对于当前工作区根目录的相对路径，绝对路径或 ~ 符号无效。

来源：互联网