你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
仅适用于：
Foundry （经典版）门户。 本文不适用于新的 Foundry 门户。
详细了解新门户。
注意
本文中的链接可能会打开新 Microsoft Foundry 文档中的内容，而不是你现在正在查看的 Foundry （经典）文档。
本文介绍如何在 Foundry Agent Service 中添加并使用模型上下文协议（MCP）服务器工具和代理。 使用 Microsoft Foundry for Visual Studio Code 扩展来配置和测试 MCP 工具调用代理。
注意
本文介绍代理 API 的经典版本。
使用 Visual Studio Code （VS Code） 扩展在代理服务中生成代理后，可以将 MCP 工具添加到代理。 添加 MCP 服务器可以使您的代理能够：
- 访问 API 和服务中的最新信息。
- 检索相关上下文，以提高 AI 模型中的响应质量。
先决条件
- 一个 Azure 订阅。 如果没有 ，请免费创建一个。
- 包含已部署模型的 Foundry 项目。
- Visual Studio Code安装了 Microsoft Foundry for Visual Studio Code extension。
- 通过 VS Code 扩展创建的现有代理。 若要创建一个代理服务，请按照 Visual Studio Code 中的步骤进行操作。
- 用于连接到代理的远程 MCP 服务器 URL。
在设计器中创建代理
若要创建代理，请按照 设计器中的“创建代理”中的步骤操作。
将 MCP 服务器工具添加到代理
创建代理后，可以向其添加工具，包括 MCP 工具。 有关可用工具的详细信息，请参阅 适用于代理的工具。
可以通过将它们添加为工具来引入多个远程 MCP 服务器。 对于每个工具，你需要在同一代理中提供唯一 的服务器标签 值，以及指向远程 MCP 服务器的 服务器 URL 值。
警告
本文中用于 MCP 工具的远程 MCP 服务器不是来自Microsoft。 Microsoft不会测试或验证这些服务器。 有关详细信息，请参阅非Microsoft服务及服务器的注意事项。
若要将 MCP 服务器工具添加到代理，请执行以下步骤：
在设计器的 “工具 ”部分右上角，选择“ 添加工具 ”按钮。 在下拉列表中，选择 MCP 服务器 工具。
查找要连接到的远程 MCP 服务器，例如GitHub MCP 服务器。 使用以下信息通过 MCP 工具创建或更新 Foundry 代理：
Server URL：MCP 服务器的 URL;例如，
https://gitmcp.io/Azure/azure-rest-api-specs。服务器标签：此 MCP 服务器的唯一标识符到代理;例如，
fetch_rest_api_docs.
在 “允许的工具 ”下拉列表中，选择 MCP 服务器可以使用的工具。
输入所需信息后，选择“ 创建工具 ”按钮。 MCP 工具显示在代理设计器的 TOOL 部分中。
将代理部署到 Foundry
添加 MCP 工具后，将代理部署到 Foundry，以便可用于测试和使用。
在设计器中，选择 Microsoft Foundry 上的 Create Agent 按钮。
在 VS Code 中，刷新 “资源 ”视图。 部署的代理显示在 经典代理 子节中。
查看已部署的代理详细信息
部署代理后，可以检查其配置并与之交互。 在 “资源 ”视图中选择已部署的代理，以在仅查看模式下打开 “代理首选项 ”窗格。 您可以：
- 选择 “编辑代理 ”按钮以查看代理设计器和代理的 .yaml 定义以供编辑。
- 选择 “查看代码 ”按钮以创建使用代理的示例代码文件。
- 选择 “打开操场 ”按钮以打开代理操场。
编辑已部署的代理
若要在部署后修改代理的配置，请执行以下步骤：
在 “代理首选项 ”窗格中，选择 “编辑代理 ”按钮。 代理设计器以代理的 .yaml 文件启动。
编辑代理的配置，例如模型、工具和说明。
编辑完成后，选择 Microsoft Foundry 上的 Update 代理按钮以保存更改。 更新后的配置会部署到 Foundry。
在操场中使用 MCP 工具测试代理
使用代理操场验证 MCP 服务器工具是否与已部署的代理正确配合工作。
右键单击具有 MCP 服务器 工具的已部署代理，然后选择 “打开操场 ”选项。 此操作启动与您的客服代表的线程，以便您可以发送消息。
在 “远程代理操场”窗格 中，输入一个提示，例如 "给我一个创建容器应用的示例"，然后发送。
选择 MCP 服务器工具的身份验证方法，然后继续操作。 身份验证方法因 MCP 服务器而异。 常见选项包括 API 密钥、OAuth 或公共服务器无需身份验证。
选择 MCP 服务器工具的审批首选项，然后继续操作。 可以选择 每次询问 以便审查每个工具调用，或选择 始终允许 以让代理自动调用 MCP 工具。
如果选择“每次都询问”作为审批首选项，则需要在智能体继续之前批准或拒绝每个工具调用。
代理使用你配置为检索信息的模型和 MCP 服务器工具。 智能体完成处理后，响应将显示在操场中。 信息的来源显示在代理批注的部分中。
排查 MCP 服务器连接问题
如果在代理中使用 MCP 服务器工具时遇到问题，请尝试以下解决方法。
| 问题 | 分辨率 |
|---|---|
| MCP 服务器 URL 无法访问 | 验证 URL 是否正确，并且服务器正在运行。 检查网络连接以及可能阻止来自 VS Code 的出站请求的任何防火墙规则。 |
| 身份验证失败 | 确认为 MCP 服务器选择了正确的身份验证方法。 如果服务器需要 API 密钥或 OAuth 令牌，请验证凭据是否有效且未过期。 |
| 工具不会显示在允许的工具列表中 | 通过关闭并重新打开 MCP 工具对话框来刷新工具列表。 验证 MCP 服务器是否通过标准 MCP 协议正确公开其工具。 |
| 代理在调用 MCP 工具时返回错误 | 检查操作中的智能体注释，以了解错误详细信息。 MCP 服务器可能会返回错误响应。 验证服务器是否正常，以及工具调用参数是否正确。 |
清理资源
你在本文中创建的 Azure 资源将会向你的 Azure 订阅进行计费。 如果不希望将来需要这些资源，请将其删除，以避免产生更多费用。
删除代理
若要删除不再需要的代理，请执行以下操作：
在 VS Code 中，刷新 “资源 ”视图。 展开 经典代理 子部分以显示已部署代理的列表。
右键单击要删除的已部署代理，然后选择“ 删除”。
删除您的模型
删除不再需要的已部署模型：
在 VS Code 中，刷新 “资源 ”视图。 展开 “模型 ”子部分以显示已部署模型的列表。
右键单击要删除的已部署模型，然后选择“ 删除”。
删除连接的工具
若要删除不再需要的连接工具资源，请在 Azure 门户中单独删除它们：
打开 Azure 门户。
转到包含 Foundry 项目的资源组。
找到要删除的特定工具资源，然后选择它。
选择“ 删除 ”按钮并确认删除。
警告
除非要删除该资源组中的所有资源，否则不要删除整个资源组。 删除资源组会删除它包含的所有资源，包括 Foundry 项目和已部署的模型。