在 VS Code 的 Foundry Toolkit 中创建并部署托管代理 (Hosted Agent)

Name: Visual Studio Code
Author: Microsoft

托管代理是运行在 Microsoft Foundry Agent Service 中的基于代码的 AI 代理，它提供托管服务、自动扩缩容、可观测性以及安全的执行环境，让您可以专注于代理逻辑而非基础设施。利用适用于 Visual Studio Code 的 Microsoft Foundry Toolkit，您可以快速从多种 Python 或 .NET 项目模板中创建新的托管代理，在本地进行开发和测试，并将其直接部署到您的 Foundry 项目中。

创建一个新的托管代理

要创建一个新的托管代理：

在 Foundry Toolkit 的主侧边栏中，导航至 MY RESOURCES（我的资源） > Your project name（您的项目名称） > Hosted Agents (Preview)（托管代理（预览版）），并选择该树状节点右侧的 + 号。
Visual Studio Code 的主区域将显示“从示例创建托管代理”设计器。

在第一步中，您需要选择代理的详细信息：
- Programming language（编程语言）- 选择 Python 或 C#。
- Framework（框架）- 选择一个框架或选择不使用框架。
- Protocol Type（协议类型）- 选择一种协议类型。
- Sample（示例）- 您将用作新托管代理起点的示例项目。
根据您的选择，下拉列表中会显示不同的示例项目。

注意
某些字段可能会根据您的工作区上下文（如编程语言、项目等）在设计器中预先填充。因此，您可能不需要为每个字段都“手动选择”值。

选择 Next（下一步）按钮。

在第二步中，您需要选择：
- Workspace folder（工作区文件夹）- 本地驱动器上用于存储新项目文件的位置。
- Environment setup（环境设置）- 如果您想提前为新托管代理选择部署目标，请选中此项。这将显示 Subscription and project name（订阅和项目名称）和 Model deployment（模型部署）选项。
- Subscription and project name（订阅和项目名称）- 可选步骤。选择您要部署到的 Azure 订阅和 Foundry 项目名称。
- Model deployment（模型部署）- 选择您要为该托管代理指定的目标模型。

选择 Create（创建）按钮。

Visual Studio Code 将打开一个新的实例，其中包含您生成的文件。文件的数量和名称取决于您选择的示例。
阅读 README.md 文件以获取关于示例的说明、部署新托管代理的指南以及故障排除步骤。

部署您的托管代理

在修改示例项目以实现您自己的自定义逻辑后，您就可以将代理部署到 Foundry 了。

在 Foundry Toolkit 侧边栏中，选择 DEVELOPER TOOLS（开发者工具） > Build（构建） > Deploy to Microsoft Foundry（部署到 Microsoft Foundry）。
如果您没有选择默认项目，主区域将显示“部署托管代理”设计器的第一步：“Foundry 项目设置”。选择您的 Azure 订阅和 Foundry 项目名称（或创建一个新项目）。

选择 Next（下一步）按钮。

在“基础”步骤中，选择您的部署方法。您可以选择：
- 代码 (Code)
- 容器 (Container)

根据您的选择，系统会要求您在后续步骤中填写不同的信息。

将您的托管代理作为 ZIP 包中的源代码进行部署

如果您选择了 Code（代码）选项：

接下来，您需要在以下选项中进行选择：
- Remote（远程）- Azure 在供应期间根据 requirements.txt 或项目文件安装依赖项。
- Bundled（捆绑）- 直接运行 ZIP 包，并包含位于 packages/ 或 publish 输出中的依赖项。
您将选择部署到：

New agent（新代理）- 输入新托管代理的名称。
Existing agent（现有代理）- 从包含您现有托管代理的列表中选择。

选择 Next（下一步）按钮。

在“审查 + 部署”步骤中，您需要选择：
- Language（语言）- Python 或 C#。
- Runtime Version（运行时版本）- 您要使用的运行时版本。
- Entry point（入口点）- 启动代理的命令。
- CPU and Memory（CPU 和内存）- 您希望托管代理使用的计算资源和内存量。
注意
您选择的 CPU 和内存配置将影响托管代理的计费。
选择 Deploy（部署）按钮。继续阅读部署进度与成功部分。

通过 ACR 将您的托管代理作为 Docker 容器进行部署

如果您选择了 Container（容器）选项：

接下来，您需要在以下选项中进行选择：
- Default ACR（默认 ACR）- Foundry 为您创建并管理容器注册表。
- Custom ACR（自定义 ACR）- 使用您在 Azure 中拥有的容器注册表。
- Custom ACR image（自定义 ACR 镜像）- 使用预构建的 ACR 镜像 URL。