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

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

Azure AI Foundry 正在过渡到统一的平台即服务，取代了需要管理多个 Azure 服务的以前的资源模型。 我们看到 AI 工作负载变得更加复杂，Azure AI Foundry 项目：

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

了解详细信息。

新铸造厂项目概述

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

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

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

新功能包括：

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

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

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

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

如何切换到 Foundry 项目

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

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

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

Limitations:

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

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

1. 定位现有的 AI Foundry 资源
2. 在 AI 资源上创建一个新的 Azure AI Foundry 项目。

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

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

1.查找现有的 AI Foundry 资源

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

2.创建新项目

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

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

（可选）重新创建连接

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

（可选）迁移代码代理

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

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

2. 更新项目客户端以使用 Foundry API。 现在使用 Azure AI 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 订阅中删除。

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

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

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

Learn more

• Azure AI Foundry 在我的组织内全面推出

• 示例 Bicep 模板

• 示例 Terraform 模板

• SDK 迁移指南