为 Azure AI Foundry 创建项目（Foundry 项目）

• 拥有有效订阅的 Azure 帐户。 如果没有帐户，请创建一个 免费的 Azure 帐户，其中包括免费试用订阅。
• 要拥有创建作为项目父级的 Azure AI Foundry 资源所需的适当访问控制，您必须是订阅的所有者。 如果没有此访问权限，请让管理员 创建 AI Foundry 资源 供你使用。 然后跳到 在同一资源上创建多个项目 来创建项目。

• 拥有有效订阅的 Azure 帐户。 如果没有帐户，请创建一个 免费的 Azure 帐户，其中包括免费试用订阅。
• 必须是订阅的 所有者 才能接收使用项目所需的适当访问控制。
• 设置开发环境
• 在运行代码之前，在你的环境中使用 az login 或 az login --use-device-code 进行身份验证。
• 完成以下步骤以启动 Python 脚本：

  1. 安装包：pip install azure-identity azure-mgmt-cognitiveservices~=13.7.0b1 如果在笔记本单元格中，请改用 %pip install 而不是 `。

  2. 请使用 pip show azure-mgmt-cognitiveservices 验证您的版本是否为 13.7 或更高版本。

  3. 使用以下代码启动脚本，以创建本文中将使用的client连接和变量。 此示例在美国东部区域创建项目：

     from azure.identity import DefaultAzureCredential
     from azure.mgmt.cognitiveservices import CognitiveServicesManagementClient
     
     subscription_id = 'your-subscription-id'
     resource_group_name = 'your-resource-group-name'
     foundry_resource_name = 'your-foundry-resource-name'
     foundry_project_name = 'your-foundry-project-name'
     location = 'eastus'
     
     client = CognitiveServicesManagementClient(
         credential=DefaultAzureCredential(), 
         subscription_id=subscription_id,
         api_version="2025-04-01-preview"
     )
     

  4. （可选）如果您有多个帐户，请在 DefaultAzureCredential中添加您希望使用的 Microsoft Entra ID 的租户 ID。 在 Azure 门户 中，在 Microsoft Entra ID，外部标识 下找到你的租户 ID。

     DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
     

  5. （可选）如果您在 Azure 美国政府版 或由 世纪互联运营的 Azure 区域中工作，请指定您希望进行身份验证的区域。 可以使用 DefaultAzureCredential 指定区域。 以下示例向 Azure 政府 - 美国区域进行身份验证：

     from azure.identity import AzureAuthorityHosts
     DefaultAzureCredential(authority=AzureAuthorityHosts.AZURE_GOVERNMENT)
     

• 拥有有效订阅的 Azure 帐户。 如果没有帐户，请创建一个 免费的 Azure 帐户，其中包括免费试用订阅。
• 必须是订阅的 所有者 才能接收使用项目所需的适当访问控制。
• Azure CLI

这些步骤提供了一种创建具有基本设置、默认设置的新 Azure 资源的方法。

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

1. 登录到 Azure AI Foundry。

2. 接下来的步骤取决于你所处的位置：

   • 如果没有任何现有项目：请按照快速入门中的步骤作 ：开始使用 Azure AI Foundry 创建第一个项目。

   • 如果在项目中：选择项目痕迹导航，然后选择“创建新资源”。

     

   • 如果你不在项目中：选择右上角的“新建”以创建新的 Azure AI Foundry 项目

     

3. 选择 Azure AI Foundry 资源，然后选择“ 下一步”。

4. 提供项目的名称，然后选择“ 创建”。 或参阅下一部分了解高级选项。

高级选项

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

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

1. 在 “创建项目 ”窗体中，选择“ 高级”选项。

2. 选择要使用的现有资源组，或保留默认值以创建新资源组。

   小窍门

   尤其是在刚开始时，我们建议为您的项目创建一个新的资源组。 通过资源组，可以轻松管理项目及其所有资源。

3. 选择“位置”或使用默认值。 位置是中心所在的区域。 Azure AI 服务可用性因区域而异。 例如，某些模型在某些区域中可能不可用。

4. 选择 创建。 可以看到资源创建进度，该过程完成时项目便创建完毕。

创建 Foundry 项目：

1. 添加此代码以使用client中的变量和连接创建 Foundry 项目。

   # Create resource
   resource = client.accounts.begin_create(
       resource_group_name=resource_group_name,
       account_name=foundry_resource_name,
       account={
           "location": location,
           "kind": "AIServices",
           "sku": {"name": "S0",},
           "identity": {"type": "SystemAssigned"},
           "properties": {
               "allowProjectManagement": True,
               "customSubDomainName": foundry_resource_name
           }
       }
   )
   
   # Wait for the resource creation to complete
   resource_result = resource.result()
   
   # Create default project
   project = client.projects.begin_create(
       resource_group_name=resource_group_name,
       account_name=foundry_resource_name,
       project_name=foundry_project_name,
       project={
           "location": location,
           "identity": {
               "type": "SystemAssigned"
           },
           "properties": {}
       }
   )
   

CLI 命令当前不可用于创建 Foundry 项目。

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

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

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

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

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