你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
本教程介绍如何使用 Microsoft Dev Box 模型上下文协议 （MCP） 服务器通过 AI 代理管理开发框。 了解如何使用自然语言命令执行常见的开发框作，而不是浏览多个接口。
在本教程中，你将：
- 通过 AI 代理连接到 Dev Box 资源
- 列出并浏览可用项目和开发框
- 使用会话命令执行基本开发环境操作
- 确认操作已成功完成
先决条件
在开始本教程之前，请确保具备：
| Requirement | 详细信息 |
|---|---|
| 已安装 Dev Box MCP 服务器 | 按照 Dev Box MCP Server 存储库中的安装步骤进行操作。 |
| Dev Box 资源 | - 至少有一个 Dev Box 项目具有已配置的池 - 要管理的现有 Dev Box（可选，但建议） |
| 身份验证 | 通过 Azure CLI、Visual Studio Code 或 Windows SSO 登录 |
| 所需的权限 | Dev Box 资源的 Dev Box 用户角色或更高级别的角色 |
步骤 1：打开 AI 代理并测试连接
首先打开 AI 代理并测试与 Dev Box 资源的连接。
在 IDE 中打开 GitHub Copilot 聊天（VS Code 或 Visual Studio）
输入以下提示来测试 MCP 服务器连接：
List my Dev Box projects验证响应：应看到有权访问的项目列表。 如果收到错误，请检查是否已通过 Azure CLI （
az login） 或 Windows SSO 进行身份验证。
预期输出：显示项目名称、说明和资源组的列表。
步骤 2：探索 Dev Box 环境
确认连接后，请浏览 Dev Box 资源以了解环境。
查看所有项目的开发框 ：
Show me all my dev boxes
获取有关特定项目的详细信息 （将“YourProjectName”替换为实际项目名称）：
Show me details about the YourProjectName project
列出项目中可用的开发框池 ：
What dev box pools are available in the YourProjectName project?
预期输出：有关开发框的信息，包括其名称、状态（正在运行、已停止等）、项目和池配置。
步骤 3：执行 Dev Box 基本操作
使用自然语言命令练习常见的开发框管理任务。
检查 Dev Box 状态
检查特定开发框的状态：
What's the status of my DevBoxName dev box?
获取 有关开发框的详细信息：
Show me detailed information about DevBoxName including its configuration and current state
启动或停止开发框
启动停止的开发环境：
Start my DevBoxName dev box
停止正在运行的开发框：
Stop my DevBoxName dev box
注释
启动和停止开发环境是长时间运行的操作，可能需要几分钟才能完成。
按计划工作
检查停机时间表：
When is my DevBoxName dev box scheduled to shut down?
延迟计划的关闭：
Delay the shutdown of my DevBoxName dev box until 6 PM today
步骤 4：验证工作
通过检查结果确认操作成功完成。
检查长时间运行任务的操作状态：
What's the status of the operation I just started?
验证开发框状态更改：
Show me the current status of DevBoxName
确认计划更改：
Show me the updated schedule for DevBoxName
要查找的内容：
- 作应在完成后显示“成功”状态
- 开发框电源状态应反映启动/停止命令
- 计划修改应在计划信息中可见
步骤 5：试用高级方案（可选）
熟悉基本操作后，请尝试以下更高级的情境：
创建新的开发框
Create a new dev box called "FeatureWork" in the DevelopmentProject using the StandardPool
应用自定义项
What customization tasks are available for my project?
Install the development tools customization on my FeatureWork dev box
监视自定义进度
What's the status of the customization running on my FeatureWork dev box?
Troubleshooting
如果在本教程中遇到问题：
身份验证问题
- 验证是否已登录：
az account show - 在 Azure 门户中检查权限
- 请尝试注销并重新登录：
az logoutaz login
工具注册错误
- 按
Ctrl+Shift+P（VS Code） 或Ctrl+Shift+P（Visual Studio） - 运行 MCP：重置缓存的工具
- 重启 IDE
操作失败
- 检查开发框名称和项目名称是否正确
- 验证您是否具有执行该操作的适当权限。
- 某些操作可能需要时间 - 定期检查操作的状态
清理资源（可选）
如果在本教程期间创建了测试资源：
删除不再需要的测试开发框 ：
Delete the FeatureWork dev box from DevelopmentProject
停止运行开发框 以节省成本：
Stop all my running dev boxes
后续步骤
完成本教程后，可以：
- 浏览各种受支持的操作
- 将 Dev Box MCP Server 命令集成到日常开发工作流中
- 与团队共享自然语言命令以执行常见操作