你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

快速入门:创建第一个 AI Foundry 资源

了解如何创建和管理 AI Foundry 资源。 它是用于设计、部署和管理生成式 AI 应用程序和代理的主要资源类型。 它提供对代理服务、使用无服务器托管模型、评估和 Azure OpenAI 服务托管的模型的访问权限。 这是 Azure AI Foundry 中生成的大多数应用程序的建议资源类型。

Azure AI Foundry 是下一个版本并重命名以前的“Azure AI 服务”。 支持其以前的所有功能,包括用于语音、视觉、语言功能的 Azure AI 服务模型。 新功能包括 AI Foundry API,可用于访问代理服务和评估、 将项目 作为文件夹来组织工作以及与其他 Azure 服务集成的 连接

想要将 AI Foundry 与高级安全设置配合使用? 请参阅 高级 AI Foundry 创建选项

想要使用 Azure AI 搜索技能? 请参阅经典 Azure AI 多服务资源

先决条件

创建新的 Azure AI Foundry 资源

AI Foundry 门户提供了一种使用基本设置、默认设置创建新的 Azure 资源的方法。 如果你的组织需要自定义的 Azure 配置(如替代名称、安全控制或成本标记),可能需要使用 Azure 门户或 模板选项 来符合组织的 Azure Policy 合规性。

Azure AI Foundry 多服务资源列在门户的 AI Foundry>AI Foundry 下。 API 类型为 AIServices。 查找如下所示的徽标:

Azure 门户中 Azure AI Foundry 资源的屏幕截图。

重要

Azure 提供了多个名为 Azure AI 服务的资源种类。 请务必选择列在 AI Foundry>AI Foundry 下并带有此前展示的徽标的那个。

若要创建 AI Foundry 资源,请按照以下说明作:

提示

如果需要创建基于 Foundry 项目或中心的项目资源,也可以使用 Azure Foundry 门户 创建资源。 如需了解更多信息,请参阅以下文章:

  1. 选择此链接以创建 AI Foundry 资源: https://portal.azure.com/#create/Microsoft.CognitiveServicesAIFoundry

  2. 在“创建”页中提供以下信息:

    项目详细信息 说明
    订阅 选择一个可用的 Azure 订阅。
    资源组 将包含 Azure AI Foundry 资源的 Azure 资源组。 可以创建新组或将其添加到预先存在的组。
    区域 Azure AI 服务实例的位置。 不同位置可能会导致延迟,但不会影响资源的运行时可用性。
    名称 您的 Azure AI Foundry 资源的一个描述性名称。 例如,MyAIServicesResource
  3. 根据需要为资源配置其他设置,阅读并接受条件(如果适用),然后选择“查看 + 创建”。

提示

如果订阅不允许创建 AI Foundry 资源,则可能需要使用 Azure 门户PowerShell 命令Azure CLI 命令启用该 Azure 资源提供程序的特权。 如果你不是订阅所有者,可请求具有所有者或管理员角色的人员帮助你完成注册,或请求向你的帐户授予 /register/action 特权

清理资源

如果要清理和删除 AI Foundry 资源,可以删除资源或资源组。 删除资源组也会删除该组中包含的任何其他资源。

  1. 在 Azure 门户中展开左侧的菜单,打开服务菜单,然后选择“资源组”以显示资源组的列表。
  2. 找到包含要删除的资源的资源组。
  3. 如果要删除整个资源组,请选择资源组名称。 在下一页上,选择“删除资源组”并进行确认。
  4. 如果只想删除 Azure AI Foundry 资源,请选择资源组以查看其中的所有资源。 在下一页上,依次选择要删除的资源、该行的省略号菜单、“删除”。

使用本快速入门,以通过 Azure 命令行接口 (CLI) 命令创建 AI Foundry 资源。

先决条件

安装 Azure CLI 并登录

安装 Azure CLI。 若要登录到本地安装的 CLI,请运行 az login 命令:

az login

创建新的资源组

在创建 AI Foundry 资源之前,必须有一个 Azure 资源组才能包含该资源。 在创建新资源时,可以新建资源组,也可以使用现有资源组。 本文介绍如何创建新资源组。

若要创建资源,需要为订阅提供一个可用的 Azure 位置。 可以使用 az account list-locations 命令检索可用位置的列表。 可以从多个位置访问大部分 Azure AI 服务。 选择离你最近的位置,或查看哪些位置可供服务使用。

重要

az account list-locations --query "[].{Region:name}" --out table

选择 Azure 位置后,在 Azure CLI 中使用 az group create 命令创建新的资源组。 在以下示例中,请将 Azure 位置 westus2 替换为你的订阅可用的某个 Azure 位置。

az group create --name ai-services-resource-group --___location westus2

创建 AI Foundry 资源

若要创建并订阅新的 Azure AI Foundry 资源,请使用 az cognitiveservices account create 命令。 此命令会将新的可计费资源添加到前面创建的资源组。 创建新资源时,需要知道要使用的服务的种类,以及其定价层(或 SKU)和 Azure 位置。

重要

Azure 提供了多个 Azure AI 服务资源种类。 请确保创建的资源种类的 kindAIServices

可以使用以下命令创建一个名为 foundry-multi-service-resource 的 AI Foundry 资源。

az cognitiveservices account create --name foundry-multi-service-resource --resource-group ai-services-resource-group  --kind AIServices --sku S0 --___location westus2 --yes

提示

如果订阅不允许创建 AI Foundry 资源,则可能需要使用 Azure 门户PowerShell 命令Azure CLI 命令启用该 Azure 资源提供程序的特权。 如果你不是订阅所有者,可请求具有所有者或管理员角色的人员帮助你完成注册,或请求向你的帐户授予 /register/action 特权

获取资源的当前配额使用情况

使用 az cognitiveservices account list-usage 命令获取资源的使用情况。

az cognitiveservices account list-usage --name foundry-multi-service-resource --resource-group ai-services-resource-group --subscription subscription-name

清理资源

如果想要清理并删除 AI Foundry 资源,可以删除此资源或其所在的资源组。 删除资源组也会删除该组中包含的任何其他资源。

若要删除资源组及其关联的资源,请使用 az group delete command

az group delete --name ai-services-resource-group

请使用本快速入门,通过 Azure PowerShell 命令创建 AI Foundry 资源。

先决条件

安装 Azure PowerShell 并登录

安装 Azure PowerShell。 若要登录,请运行 Connect-AzAccount 命令:

Connect-AzAccount

创建新的 Azure AI Foundry 资源组

在创建 AI Foundry 资源之前,必须有一个 Azure 资源组才能包含该资源。 在创建新资源时,可以新建资源组,也可以使用现有资源组。 本文介绍如何创建新资源组。

若要创建资源,需要为订阅提供一个可用的 Azure 位置。 可以使用 Get-AzLocation 命令检索可用位置的列表。 可以从多个位置访问大部分 Azure AI 服务。 选择离你最近的位置,或查看哪些位置可供服务使用。

重要

Get-AzLocation | Select-Object -Property Location, DisplayName

获得 Azure 位置后,使用 New-AzResourceGroup 命令在 Azure PowerShell 创建新的资源组。 在以下示例中,请将 Azure 位置 westus2 替换为你的订阅可用的某个 Azure 位置。

New-AzResourceGroup -Name ai-services-resource-group -Location westus2

创建 AI Foundry 资源

若要创建和订阅新的 Azure AI Foundry 资源,请使用 New-AzCognitiveServicesAccount 命令。 此命令会将新的可计费资源添加到前面创建的资源组。 创建新资源时,需要知道要使用的服务的种类,以及其定价层(或 SKU)和 Azure 位置:

重要

Azure 提供了多个 Azure AI 服务资源种类。 请确保创建的资源种类的 Type(种类)为 AIServices

可以使用以下命令创建一个名为 foundry-multi-service-resource 的 AI Foundry 资源。

New-AzCognitiveServicesAccount -ResourceGroupName ai-services-resource-group -Name foundry-multi-service-resource -Type AIServices -SkuName S0 -Location westus2

提示

如果订阅不允许创建 AI Foundry 资源,则可能需要使用 Azure 门户PowerShell 命令Azure CLI 命令启用该 Azure 资源提供程序的特权。 如果你不是订阅所有者,可请求具有所有者或管理员角色的人员帮助你完成注册,或请求向你的帐户授予 /register/action 特权

获取资源的当前配额使用情况

使用 Get-AzCognitiveServicesAccountUsage 命令获取资源的使用情况。

Get-AzCognitiveServicesAccountUsage -ResourceGroupName ai-services-resource-group -Name foundry-multi-service-resource

清理资源

如果想要清理并删除 AI Foundry 资源,可以删除此资源或其所在的资源组。 删除资源组也会删除该组中包含的任何其他资源。

若要删除资源组及其关联的资源,请使用 Remove-AzResourceGroup 命令。

Remove-AzResourceGroup -Name ai-services-resource-group

默认项目

在 AI Foundry 中,项目提供对开发人员 API 的访问权限,并充当文件夹来组织工作。 在 Azure 门户或 Azure AI Foundry 门户中创建资源时,会创建默认项目。 默认项目有一个特殊概念 - 它提供与父资源级别支持的开发人员 API 的向后兼容性。 通常这些是用于模型自定义的 AI 服务和 Azure OpenAI API。 可从任何项目访问包括代理和评估在内的较新的 API。 有关详细信息,请参阅 项目类型

AI Foundry 资源可能与 AI Foundry 项目关联或不关联:

  • 如果 AI Foundry 资源是使用 Azure CLI、PowerShell、Bicep 模板、Terraform 或 SDK 创建的。 在这些情况下,AI Foundry 资源默认不与项目关联。 稍后可以创建项目作为子资源。
  • 如果 AI Foundry 资源已创建为连接。 例如,尝试部署当前 AI Foundry 资源所在区域中不可用的模型时。
  • 可以在 Azure AI Foundry 门户中创建项目,并自动关联为新 AI Foundry 资源的依赖项。
  • AI Foundry 资源可能已在 AI Foundry 门户中创建,但作为 Azure AI Foundry 中心的依赖资源存在。 在这种情况下,资源会自动与在中心中创建的项目相关联。

AI Foundry 资源支持的服务

借助 AI Foundry 资源,可以使用一组凭据访问以下 Azure AI 服务。 某些服务通过 AI Foundry 资源和单服务资源提供。

提示

我们建议尽可能使用 AI Foundry 资源(API 类型为 AIServices),可以使用一组凭据访问多个 Azure AI 服务。 对于无法通过 AI Foundry 资源(如人脸和自定义视觉)提供的服务,也可以创建单服务资源。

服务 说明 种类(通过 API)
Azure AI Foundry 图标Azure AI Foundry 代理服务 将生成式 AI 模型的强大功能与支持代理访问和与真实数据源交互的工具相结合。 AIServices
Azure AI Foundry 图标Azure AI 模型推理 对 Azure AI Foundry 模型目录中的旗舰模型执行模型推理。 AIServices
Azure AI Foundry 模型中的 Azure OpenAI 图标Azure OpenAI 执行各种自然语言任务。 AIServices
OpenAI
Content Safety 图标内容安全 用于检测不需要的内容的 AI 服务。 AIServices
ContentSafety
自定义视觉图标自定义视觉 为你的业务自定义图像识别。 CustomVision.Prediction(仅限预测)
CustomVision.Training(仅限训练)
文档智能图标文档智能 将文档转换为智能数据驱动解决方案。 AIServices
FormRecognizer
人脸图标人脸 检测和识别图像中的人和情感。 Face
语言图标语言 使用行业领先的自然语言理解功能构建应用。 AIServices
TextAnalytics
语音图标语音 语音转文本、文本转语音、翻译和说话人辨识。 AIServices
Speech
翻译器图标翻译工具 使用 AI 支持的翻译技术翻译超过 100 种正在使用、处于危险和濒危的语言和方言。 AIServices
TextTranslation
视觉图标视觉 分析图像和视频中的内容。 AIServices(训练和预测)
ComputerVision

适用于 Azure AI 搜索技能的 Azure AI 多服务资源

如本文前面所述,Azure AI 搜索技能不支持 AI Foundry 资源。 必须为 Azure AI 搜索技能创建不同类型的多服务资源。

可与 Azure AI 搜索技能一起使用的多服务资源在门户中列为 AI Foundry>经典 AI 服务>Azure AI 服务多服务帐户(经典)。 查找如下所示的徽标:

Azure 门户中 Azure AI 服务多服务帐户的屏幕截图。

若要为 Azure AI 搜索创建多服务资源,请按照以下说明作:

  1. 选择此链接可创建 Azure AI 服务多服务帐户(经典) 资源: https://portal.azure.com/#create/Microsoft.CognitiveServicesAllInOne

  2. 在“创建”页中提供以下信息:

    项目详细信息 说明
    订阅 选择一个可用的 Azure 订阅。
    资源组 将用于容纳 Azure AI 服务多服务帐户资源的 Azure 资源组。 可以创建新组或将其添加到预先存在的组。
    区域 Azure AI 服务多服务帐户实例的位置。 不同位置可能会导致延迟,但不会影响资源的运行时可用性。
    名称 Azure AI 服务的多服务帐户资源的描述性名称。 例如,MyCognitiveServicesResource
    定价层 Azure AI 服务多服务帐户的成本取决于选择的选项和使用情况。 有关详细信息,请参阅 API 定价详细信息
  3. 根据需要为资源配置其他设置,阅读并接受条件(如果适用),然后选择“查看 + 创建”。

提示

如果订阅不允许创建 AI Foundry 资源,则可能需要使用 Azure 门户PowerShell 命令Azure CLI 命令启用该 Azure 资源提供程序的特权。 如果你不是订阅所有者,可请求具有所有者或管理员角色的人员帮助你完成注册,或请求向你的帐户授予 /register/action 特权

定价

定价层(以及你的账单金额)基于你使用身份验证信息发送的事务数。 每个定价层指定:

  • 每秒允许的最大事务数 (TPS)。
  • 在定价层中启用的服务功能。
  • 预定义事务数的成本。 根据定价详细信息中为服务所指定的内容,超过此数字将导致额外费用。