为 Microsoft Foundry 创建项目

注释

本文档引用 Microsoft Foundry （经典） 门户。

🔄 如果你使用的是新门户，请切换到 Microsoft Foundry（新）文档。

本文介绍如何在 Microsoft Foundry 中创建 Foundry 项目。 项目允许你在构建有状态应用并探索新想法时组织工作，例如代理、评估和文件。

• Foundry 项目在 Microsoft Foundry 资源下管理。 它是用于访问管理、数据上传和集成以及监视的容器。 这样，便可以在用例之间保持工作隔离，而无需创建额外的 Azure 资源。

• 此项目类型使你能够访问 Foundry 中最新的生成 AI 功能，包括：

  • 代理人
  • Foundry SDK 和 API，用于生成代理并在模型之间轻松切换
  • Azure 直接销售的模型 - Azure OpenAI、Mistral、xAI、DeepSeek 等。
  • 通过市场销售的合作伙伴模型和社区模型 - Stability、Cohere 等。
  • 内容理解
  • 评估
  • 微调
  • OpenAI SDK 和 API（包括批处理和存储的完成）
  • Foundry 工具

• 是否需要访问开源模型或 PromptFlow？ 请改为创建一个集线器项目类型。

• 有关不同项目类型的详细信息，请参阅 项目类型 。

如果你的组织需要自定义的 Azure 配置（如替代名称、安全控制或成本标记），则可能需要使用 Azure 门户 或 模板选项 来符合组织的 Azure Policy 要求。

先决条件

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

Foundry 门户

• 拥有有效订阅的 Azure 帐户。 如果没有帐户，请创建一个 免费的 Azure 帐户，其中包括免费试用订阅。

• 你必须是订阅的 所有者 ，才能拥有创建项目父级的 Foundry 资源所需的相应访问控制。 如果没有此访问权限，请让管理员 创建一个 Foundry 资源 供你使用。 然后跳到 在同一资源上创建多个项目 来创建项目。

Python SDK

• 拥有有效订阅的 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. （可选）如果你有多个帐户，请将要使用的 Microsoft Entra ID 的租户 ID 添加到 DefaultAzureCredential 中。

     DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
     

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

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

Azure CLI

• 拥有有效订阅的 Azure 帐户。 如果没有帐户，请创建一个 免费的 Azure 帐户，其中包括免费试用订阅。

• 必须是订阅的 所有者 才能接收使用项目所需的适当访问控制。

• 安装 Azure CLI

• 为subscription和resource group设置默认值。

    # Set your default subscription
    az account set --subscription "{subscription-name}"
  
    # Set default resource group
    az config set defaults.group={resource-group-name}
  

创建 Foundry 项目

Foundry 门户

这些步骤提供了使用基本默认设置创建新的 Azure 资源的方法。

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

1. 登录到 Microsoft Foundry。 确保 New Foundry 开关处于关闭状态。 这些步骤涉及到 Foundry（经典）。

   

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

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

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

     

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

     

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

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

高级选项

1. 在 Foundry 资源上创建一个 Foundry 项目。 创建项目时会自动创建此资源。 选择要使用的现有资源组，或保留默认值以创建新资源组。

   小窍门

   特别是对于初学者，我们建议为项目创建新的资源组。 通过资源组，可以轻松管理项目及其所有资源。

2. 选择“位置”或使用默认值。 位置是托管项目中资源的区域。

3. 选择 创建。 可以看到资源创建进度。 流程完成后便创建项目。

Python SDK

创建 Foundry 项目：

• 通过使用变量以及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": {}
      }
  )
  

Azure CLI

1. 使用以下命令从 Azure CLI 向 Azure 订阅进行身份验证：

   az login
   

   有关身份验证的详细信息，请参阅身份验证方法。

2. 创建资源组，例如在美国东部：

   az group create --name {my_resource_group} --location eastus
   

3. 创建 Foundry 资源

   az cognitiveservices account create \
   --name {your-foundry-resource-name} \
   --kind AIServices \
   --location eastus \
   --sku s0 \
   --allow-project-management
   

4. 创建项目：

   az cognitiveservices account project create \
   --name {your-foundry-resource-name} \
   --project-name {your-project-name} \
   --location eastus
   

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

在现有 Foundry 资源上创建多个 Foundry 项目，以启用团队协作和共享资源访问，包括安全、部署和连接工具。 此设置非常适合在受限的 Azure 订阅中，开发人员需要在预配置环境的设置中提供自助探索功能。

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

虽然并非所有 Foundry 功能都支持在项目中组织工作，但资源的第一个“默认”项目更强大。 使用代码选项时，可以通过 UX 体验中的标记“default”以及资源属性“is_default”来标识它。

功能 / 特点	默认项目	其他项目
模型推理	✅	✅
操场	✅	✅
代理人	✅	✅
评估	✅	✅
跟踪	✅	✅
数据集	✅	✅
Indexes	✅	✅
Foundry SDK 和 API	✅	✅
内容理解	✅	✅
OpenAI SDK 和 API	✅	响应、文件、对话
OpenAI批处理 \\ 微调 \\ 存储完成	✅	-
语言微调	✅	✅
语音微调	✅	-
连接	✅	✅

• 将项目添加到 Foundry 资源中：

  Foundry 门户

  小窍门

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

  1. 登录到 Microsoft Foundry。 确保 New Foundry 开关处于关闭状态。 这些步骤涉及到 Foundry（经典）。

     

  2. 选择 Foundry 项目或其关联的资源。

  3. 在左窗格中，选择 管理中心。

  4. 在资源部分中，选择“ 概述”。

  5. 选择 “新建项目 ”并提供名称。

     

  Python SDK

  将此代码添加到脚本，以在现有资源上创建新项目：

  # Create additional project
  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": {}
      }
  )
  

  Azure CLI

  使用 {foundry_resource_name} 的现有值将另一个项目添加到资源：

   az cognitiveservices account project create \
   --name {foundry_resource_name} \
   --project-name {my_project_name} \
   --location {location}
  

• 如果删除 Foundry 资源的默认项目，则创建的下一个项目将成为默认项目。

查看项目设置

Foundry 门户

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

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

Python SDK

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

Azure CLI

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

az cognitiveservices account connection show \
--name <my_project_name> \
--resource-group <my_resource_group>

删除项目

Foundry 门户

1. 登录到 Microsoft Foundry。 确保 New Foundry 开关处于关闭状态。 这些步骤涉及到 Foundry（经典）。
2. 打开项目。
3. 选择“管理中心”。
4. 在 “资源”下，选择“ 概述”。
5. 选择不再想要保留的任何项目。
6. 选择“ 删除项目”。

删除 Foundry 资源及其所有项目：

1. 在管理中心中，从“概述”部分选择资源名称，转到 Azure 门户。
2. 在 Azure 门户中，选择“ 删除” 以删除资源及其所有关联的项目。

Python SDK

此代码使用先决条件中的变量和 client connection。 首先创建客户端连接：

client.projects.begin_delete(
    resource_group_name, foundry_resource_name, foundry_project_name
)

删除 Foundry 资源及其所有项目：

# Delete projects
projects = client.projects.list(resource_group_name, foundry_resource_name)

for project in projects: 
    print("Deleting project:", project.name)
    client.projects.begin_delete(resource_group_name, foundry_resource_name,
        project_name=project.name.split('/')[-1]
    ).wait()

# Delete resource
print("Deleting resource:", foundry_resource_name)
client.accounts.begin_delete(resource_group_name, foundry_resource_name).wait()

Azure CLI

运行下面的命令：

az cognitiveservices account project delete \
--name {foundry_resource_name} \
--project-name {my_project_name}

相关内容

• 快速入门：Foundry 入门
• 什么是 Foundry？