为 Azure AI Foundry 创建项目

2025-06-10

本文介绍如何创建 Azure AI Foundry 项目。项目让您能够组织工作，以探索新想法，并在特定的用例上创建原型。

Azure AI Foundry 支持两种类型的项目： Foundry 项目 和 基于中心的项目。有关这两个项目类型之间的差异的详细信息，请参阅项目类型。

小窍门

本文的其余部分介绍如何创建 基于中心的项目。如果想创建 Foundry 项目，请选择本文顶部的 Foundry 项目。

基于中心的项目由 Azure AI Foundry 中心托管。如果你的公司有一个为你创建中心的管理团队，则可以从该中心创建项目。如果您在独自工作，可以创建一个项目，系统会为您自动创建一个默认中心。
将此项目类型用于：
- 提示流
- 托管计算
- Azure 机器学习兼容性
此项目还可用于：
- 代理（预览版）
- 文件和输出的项目级隔离
- 评估
- 操场

先决条件

使用以下选项卡选择要用于创建基于中心的项目的方法：

一份 Azure 订阅。如果没有 Azure 订阅，可以创建一个免费帐户。

创建基于中心的项目

若要在 Azure AI Foundry 中创建基于中心的项目，请执行以下步骤：

小窍门

由于可以在 Azure AI Foundry 门户中自定义左窗格，因此你可能会看到与这些步骤中显示的项不同。如果未看到要查找的内容，请选择 ... 左窗格底部的更多内容。

登录到 Azure AI Foundry。
如果您尚未处于任何项目中，请选择一个现有项目。

重要

在执行以下步骤之前，必须具有现有 Foundry 项目或基于中心的项目。如果您没有现有项目，请按照快速入门：Azure AI Foundry 入门指南中的步骤来创建您的第一个 Foundry 项目。
在左窗格底部，选择 管理中心。
在页面顶部，选择 “所有资源”。
选择创建。
选择 人工智能中心资源。
输入项目的名称。
如果你有一个中心，会选择最近使用过的中心。
- 如果你有权访问多个中心，可以从下拉列表中选择一个不同的中心。
- 如果要创建新中心，请选择“创建新中心”并输入名称。
如果没有中心，则会为你创建一个默认中心。
选择创建。

或者，如果要自定义新的中心点，请在选择创建之前，按照下一部分中的步骤进行操作。

对中心进行自定义

中心内存在基于中心的项目。通过中心，你可以与所有项目共享数据连接等配置，并集中管理安全设置和支出。如果你是团队的一员，则中心会在订阅中的其他团队成员之间共享。有关中心和项目之间的关系的更多信息，请参阅中心和项目概述文档。

新建中心时，必须对所选资源组具有“所有者”或“参与者”权限。如果你是团队的一员但没有这些权限，管理员应为你创建一个中心。

小窍门

虽然可以在项目创建过程中创建中心，但如果单独创建，则可以对中心拥有更多控制权，并可以为其设置更高级的设置。例如，可以自定义网络安全或基础 Azure 存储帐户。有关详细信息，请参阅如何创建和管理 Azure AI Foundry 中心。

在项目创建过程中创建新中心时，会提供默认设置。如果要自定义这些设置，请在创建项目之前这样操作：

在 “创建项目 ”窗体中，选择右侧的箭头。
选择要使用的现有资源组，或保留默认值以创建新资源组。

小窍门

尤其是在刚开始时，我们建议为您的项目创建一个新的资源组。通过资源组，可以轻松管理项目及其所有资源。创建项目时，会在资源组中创建多个资源，包括中心、容器注册表和存储帐户。
选择“位置”或使用默认值。位置是中心所在的区域。枢纽的位置也是项目的位置。 Azure AI 服务可用性因区域而异。例如，某些模型在某些区域中可能不可用。
选择“创建项目”。可以看到资源创建进度。流程完成后便创建项目。

本部分中的代码假定你已有一个中心。如果没有中心，请参阅如何创建和管理 Azure AI Foundry 中心以创建一个。

安装 azure-identity：pip install azure-identity。如果在笔记本单元格中，请使用 %pip install azure-identity。

提供订阅的详细信息：

# Enter details of your subscription
subscription_id = "<SUBSCRIPTION_ID>"
resource_group = "<RESOURCE_GROUP>"

获取订阅的句柄。本文中的所有 Python 代码都使用 ml_client：

# get a handle to the subscription

from azure.ai.ml import MLClient
from azure.identity import DefaultAzureCredential

ml_client = MLClient(DefaultAzureCredential(), subscription_id, resource_group)

（可选）如果您有多个帐户，请在 DefaultAzureCredential中添加您希望使用的 Microsoft Entra ID 的租户 ID。在 Azure 门户中，在 Microsoft Entra ID，外部标识 下找到你的租户 ID。
```
DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
```
（可选）如果你在 Azure 政府 - 美国或 Azure 中国世纪互联区域工作，请指定要在其中进行身份验证的区域。可以使用 DefaultAzureCredential 指定区域。以下示例向 Azure 政府 - 美国区域进行身份验证：
```
from azure.identity import AzureAuthorityHosts
DefaultAzureCredential(authority=AzureAuthorityHosts.AZURE_GOVERNMENT)
```

使用以下代码在你或你的管理员之前创建的中心中创建项目。将示例字符串值替换为自己的值：

from azure.ai.ml.entities import Project

my_project_name = "myexampleproject"
my_display_name = "My Example Project"
hub_name = "myhubname" # Azure resource manager ID of the hub
hub_id=f"/subscriptions/{subscription_id}/resourceGroups/{resource_group}/providers/Microsoft.MachineLearningServices/workspaces/{hub_name}"

my_project = Project(name=my_project_name, 
                display_name=my_display_name,
                hub_id=hub_id)

created_project = ml_client.workspaces.begin_create(workspace=my_project).result()

本部分中的代码假定你已有一个中心。如果没有中心，请参阅如何创建和管理 Azure AI Foundry 中心以创建一个。

要从 Azure CLI 向 Azure 订阅进行身份验证，请使用以下命令：
```
az login
```
有关身份验证的详细信息，请参阅身份验证方法。
安装扩展并向 Azure 订阅进行身份验证后，使用以下命令从现有 Azure AI Foundry 中心创建一个新的 Azure AI Foundry 项目：
```
az ml workspace create --kind project --hub-id {my_hub_ID} --resource-group {my_resource_group} --name {my_project_name}
```
使用以下语法创建 my_hub_ID：/subscriptions/{subscription_id}/resourceGroups/{resource_group}/providers/Microsoft.MachineLearningServices/workspaces/{hub_name}。

查看项目设置

在“项目概述 ”页上，可以找到有关项目的信息。

名称：项目名称显示在左上角。
订阅：托管项目的中心所在的订阅。
资源组：托管项目的中心所在的资源组。

选择“管理中心”以导航到 Azure AI Foundry 门户中的项目资源。选择“在 Azure 门户中管理”，以导航到 Azure 门户中的项目资源。

若要管理或使用新项目，请将其包含在 MLClient 中：

ml_client = MLClient(workspace_name=my_project_name, resource_group_name=resource_group, subscription_id=subscription_id,credential=DefaultAzureCredential())

若要查看项目的设置，请使用 az ml workspace show 命令。例如：

az ml workspace show --name {my_project_name} --resource-group {my_resource_group}

访问项目资源

系统会与项目共享中心上的常见配置，包括连接、计算实例和网络访问，以便你可以立即开始开发。

此外，许多资源只能由项目工作区中的用户访问：

组件包括数据集、流程、索引、部署的模型 API 端点（开放和无服务器）。
在“项目设置”下创建的连接。

Azure 存储 Blob 容器和用于在项目中上传数据的文件共享。使用以下连接访问存储：

数据连接	存储位置	目的
workspaceblobstore	{project-GUID}-azureml-blobstore	数据上传的默认容器
workspaceartifactstore	{project-GUID}-azureml	存储项目的组件和元数据，例如模型权重
workspacefilestore	{project-GUID}-代码	托管在计算机上创建并使用提示流的文件

注释

当存储帐户的公共网络访问设置为禁用时，存储连接不会直接与项目创建。当第一个用户通过专用网络连接访问 Azure AI Foundry 时，系统会改为创建这些内容。排查存储连接问题

小窍门

本文的其余部分介绍如何创建 Foundry 项目。如果要转而创建基于中心的项目，请在本文顶部选择“基于中心的项目”。

Foundry 项目基于 Azure AI Foundry 资源构建。这种项目类型允许简单设置、访问代理，以及使用 OpenAI、Mistral、Meta 等提供的行业领先模型。
此项目类型为你提供了以下最佳支持：
- 代理人
- AI 模型推理，包括 Azure OpenAI
- 适用于代理和跨模型的 AI Foundry API
- 项目文件（直接上传文件和开始试验）
- 评估
- 微调
- 操场
还可以使用 Bicep 文件创建 Foundry 项目。

先决条件

使用以下选项卡选择要用于创建 Foundry 项目的方法：

一份 Azure 订阅。如果没有 Azure 订阅，可以创建一个免费帐户。
必须是订阅的 所有者 才能接收使用项目所需的适当访问控制。

创建 Foundry 项目

若要在 Azure AI Foundry 中创建 Foundry 项目，请执行以下步骤：

转到 Azure AI Foundry。
接下来的步骤取决于你所处的位置：
- 如果没有任何现有项目：请按照快速入门中的步骤作：开始使用 Azure AI Foundry 创建第一个项目。
- 如果在项目中：选择项目痕迹导航，然后选择“创建新资源”。
- 如果你不在项目中：选择右上角 的“新建 ”以创建新的 Foundry 项目

高级选项

在 AI Foundry 资源上创建 Foundry 项目。创建项目时会自动创建此资源。

若要自定义项目的设置，请执行以下步骤：

在 “创建项目 ”窗体中，选择“ 高级”选项。
选择要使用的现有资源组，或保留默认值以创建新资源组。

小窍门

尤其是在刚开始时，我们建议为您的项目创建一个新的资源组。通过资源组，可以轻松管理项目及其所有资源。
选择“位置”或使用默认值。位置是中心所在的区域。 Azure AI 服务可用性因区域而异。例如，某些模型在某些区域中可能不可用。
选择创建。可以看到资源创建进度，该过程完成时项目便创建完毕。

若要创建 Foundry 项目，请执行以下操作：

安装包：pip install azure-identity azure-mgmt-cognitiveservices 如果在笔记本单元格中，请使用 %pip install azure-identity azure-mgmt-cognitiveservices。
请使用 pip show azure-mgmt-cognitiveservices 验证您的版本是否为 13.7 或更高版本。

使用以下代码创建 Foundry 项目。此示例在美国西部区域创建项目：

from azure.identity import DefaultAzureCredential
from azure.mgmt.cognitiveservices import CognitiveServicesManagementClient
import os
import json

sub_id = 'your-sub'
rgp = 'your-resource-group'
resource_name = 'your-resource'
project_name = 'your-project'
___location = 'westus'

client = CognitiveServicesManagementClient(
    credential=DefaultAzureCredential(), 
    subscription_id=sub_id,
    api_version="2025-04-01-preview"
)
# Create resource
resource = client.accounts.begin_create(
    resource_group_name=rgp,
    account_name=resource_name,
    account={
        "___location": ___location,
        "kind": "AIServices",
        "sku": {"name": "S0",},
        "identity": {"type": "SystemAssigned"},
        "properties": {"allowProjectManagement": True}
    }
)
# Create default project
project = client.projects.begin_create(
    resource_group_name=rgp,
    account_name=resource_name,
    project_name=project_name,
    project={
        "___location": ___location,
        "identity": {"type": "SystemAssigned"},
        "properties": {}
    }
)

（可选）如果您有多个帐户，请在 DefaultAzureCredential中添加您希望使用的 Microsoft Entra ID 的租户 ID。在 Azure 门户中，在 Microsoft Entra ID，外部标识 下找到你的租户 ID。
```
DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
```
（可选）如果你在 Azure 政府 - 美国或 Azure 中国世纪互联区域工作，请指定要在其中进行身份验证的区域。可以使用 DefaultAzureCredential 指定区域。以下示例向 Azure 政府 - 美国区域进行身份验证：
```
from azure.identity import AzureAuthorityHosts
DefaultAzureCredential(authority=AzureAuthorityHosts.AZURE_GOVERNMENT)
```

在同一资源上创建多个项目

在现有 AI Foundry 资源上创建多个 Foundry 项目，以便你可以与团队共享环境进行协作。

作为 Azure 子资源的 Foundry 项目可能会分配自己的访问控制，但从其父资源共享常见设置，例如网络安全、部署和 Azure 工具集成。

你的第一个项目（默认项目）扮演了一个特殊角色，并且可以访问更多功能：

功能 / 特点	默认 Foundry 项目	非默认 Foundry 项目
模型推理	✅	✅
操场	✅	✅
代理人	✅	✅
评估	✅	✅
连接	✅	✅
适用于代理和跨模型的 AI Foundry API	✅	✅
文件和输出的项目级隔离	✅	✅
Azure OpenAI 与批处理、存储补全、微调	✅
与无项目 {account}.cognitiveservices.com 数据平面 API 向后兼容	✅
Content Safety	✅

将非默认项目添加到资源：
小窍门

由于可以在 Azure AI Foundry 门户中自定义左窗格，因此你可能会看到与这些步骤中显示的项不同。如果未看到要查找的内容，请选择 ... 左窗格底部的更多内容。
1. 在 Azure AI Foundry 中，选择 Foundry 项目或其关联的资源。
2. 在左窗格中，选择 管理中心。
3. 在资源部分中，选择“ 概述”。
4. 选择 “新建项目 ”并提供名称。
```
new_project_name = 'your-new-project-name'

project = client.projects.begin_create(
  resource_group_name=resource_group_name,
  account_name=foundry_resource_name,
  project_name=new_project_name,
  project={
      "___location": ___location,
      "identity": {
          "type": "SystemAssigned"
      },
      "properties": {}
  }
)
```
CLI 命令当前不可用于创建 Foundry 项目。
如果删除 Foundry 资源的默认项目，则创建的下一个项目将成为默认项目。

查看项目设置

在项目主页上，可以找到有关项目的信息。

名称：项目名称显示在左上角。
订阅：托管项目的中心所在的订阅。
资源组：托管项目的中心所在的资源组。

    # Get project
    project = client.projects.get(
        resource_group_name=rgp,
        account_name=account_name,
        project_name=project_name
    )
    print(project)

若要查看项目的设置，请使用 az cognitiveservices account connection show 命令。例如：

az cognitiveservices account connection show --name {my_project_name} --resource-group {my_resource_group}

通过

为 Azure AI Foundry 创建项目

先决条件

创建基于中心的项目

对中心进行自定义

查看项目设置

访问项目资源

相关内容

先决条件

创建 Foundry 项目

高级选项

在同一资源上创建多个项目

查看项目设置

相关内容

反馈

其他资源