从基于中心的项目迁移到 Foundry 项目

本指南可帮助具有基于中心的项目的现有客户迁移到新的 Foundry 项目，以访问最新的平台功能。

Microsoft Foundry 正在转换为统一的平台即服务，取代了需要管理多个 Azure 服务的以前的资源模型。 随着我们发现 AI 工作负载变得越来越复杂，Foundry 项目：

• 简化平台设置和治理
• 增强跨多个模型和 Foundry 工具的工作流
• 强化治理功能

了解详细信息。

新铸造厂项目概述

Foundry 项目旨在统一和简化开发人员工作流的构成，以及管理 AI 应用程序的核心构建基块：

• Models
• 代理及其工具
• 可观测性、安全性和信任性

以前，Foundry 项目的功能需要管理后端工作流的多个 Azure 资源和 SDK，以便撰写这些组件。

新功能包括：

• 访问 Foundry API ，该 API 旨在构建和评估以 API 为核心的代理应用程序，能够整合代理、评估、模型索引和数据，提供统一的使用体验，并在不同模型提供商之间保持一致的协议。

• Microsoft Foundry SDK 包装 Foundry API，以便轻松地将功能集成到代码中，无论应用程序是内置于 Python、C#、JavaScript/TypeScript 还是 Java 中。

• 代理、模型和工具连接 在 Foundry 上共同管理，用于权限管理、网络、成本分析和策略配置。 以前，某些工具和模型是通过 Azure 机器学习的中心访问的，这还需要预配额外的存储和密钥保管库资源。

• 项目现在是子资源;他们可能会分配自己的管理员控件（如 Azure RBAC），但默认情况下共享其父资源的常用设置。 此原则旨在使 IT 管理员摆脱日常循环。 在资源级别建立安全性、资源连接和治理后，作为开发人员，您可以创建自己的项目文件夹来组织工作。

如何切换到 Foundry 项目

你将在你的基于中心的项目中，依托 Foundry 模型资源，创建新的 Foundry 项目。 此过程允许新项目访问最初在基于中心的项目中完成的工作。

可以将哪些内容带入新项目类型？

• 模型部署
• 数据文件
• 微调的模型
• Assistants
• 矢量存储

Limitations:

• 预览代理的状态（包括消息、线程和文件）无法移动。 但是，可以使用新项目中的代码重新创建代理。
• Foundry 项目中当前不支持开源模型部署。
• 基于中心的项目将无法访问在 Foundry 模型资源上创建的任何新项目。

在以下部分中，我们将逐步介绍如何从基于中心的项目移动到 Foundry 项目：

1. 找到现有的 Foundry 资源
2. 在 AI 资源上创建新的 Foundry 项目。

获得新项目后，可能需要：

• （可选） 重新创建连接
• （可选）迁移代理

1.定位现有的 Foundry 资源

大多数 Foundry 用户已经有一个“Foundry”（以前称为“AI Services”）资源，该资源以前是与基于中心的项目一起创建的，用于访问模型部署。

2.创建新项目

新功能（包括代理服务）只能通过项目进行访问，这些项目将开发工作组织为每个用例的文件夹。 可以创建多个示例，以组织具有类似设置和连接要求的用例的工作。

现在，您已准备好开始创建具有最新功能的正式可用代理。 开始使用 SDK 或代理体验区。

（可选）重新创建连接

如果你的基于中心的项目使用连接来访问工具、数据源或模型，则可以在 Foundry 资源上重新创建这些连接，而无需使用中心。

（可选）迁移代码代理

使用代理服务的预览版生成的任何代码代理都需要在 Foundry 项目的正式版中迁移到代理服务时进行以下升级：

1. 安装首选 SDK 客户端的 最新版本 。

2. 更新项目客户端以使用 Foundry API。 现在使用 Foundry 项目终结点，而不是连接字符串。 例如，在 Python 中：

   from azure.identity import DefaultAzureCredential
   from azure.ai.projects import AIProjectClient
   
   project = AIProjectClient(
     endpoint="your_project_endpoint",  # Replace with your endpoint
     credential=DefaultAzureCredential())
   

3. 更新脚本以反映预览版和稳定 SDK 包之间的任何类结构更改。

请参阅 SDK 迁移指南 ，了解如何更新现有代码。

（可选）清理基于中心的项目

如果不再需要访问基于中心的项目，请将其从 Azure 订阅中删除。

出于下面的一些原因，你可能希望保留订阅中的中心和基于中心的项目：

• 访问 Foundry 项目中尚不支持的功能。 请参阅 此支持矩阵。

• 侧重于自定义机器学习模型训练的用例。 基于中心的项目构建在 Azure 机器学习堆栈上，并可继续通过 Azure 机器学习工作室/CLI/SDK 进行访问。

Learn more

• 在整个组织中推出 Foundry

• 示例 Bicep 模板

• 示例 Terraform 模板

• SDK 迁移指南