你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
在本快速入门中，你将创建 Azure AI Foundry 资源并验证访问权限。
了解如何创建和管理 Azure AI Foundry 资源。 它是用于生成、部署和管理生成式 AI 模型和应用程序（包括 Azure 中的代理） 的主要 Azure 资源类型 。
在 Azure 中使用和管理服务需要 Azure 资源。 它定义配置访问、安全性（例如网络、计费和监视）的范围。
Azure AI Foundry 资源是前“Azure AI 服务”的下一个版本和重命名。 它提供用于托管代理、模型部署、评估等的应用程序环境。
Azure AI Foundry 资源可以组织多个用例的工作，通常在处理类似业务或数据域中用例的开发人员团队之间 共享 。 项目充当文件夹来对相关工作进行分组。
想要配置具有高级安全设置的 AI Foundry？ 请参阅 高级 AI Foundry 创建选项
想要使用 Azure AI 搜索技能？ 请参阅 将 Azure AI Foundry 与 Azure AI 搜索技能配合使用。
创建第一个资源
若要使用基本 Azure 设置创建第一个资源，请使用 Azure 门户、Azure CLI 或 PowerShell 执行以下步骤。
Prerequisites
- 一个有效的 Azure 订阅 - 免费创建订阅。
- 用于创建资源的 Azure RBAC 角色。 需要在 Azure 订阅或资源组上分配以下角色之一：
- 贡献者
- 所有者
- 具有
Microsoft.CognitiveServices/accounts/write权限的自定义角色
创建新的 Azure AI Foundry 资源
如果组织需要自定义 Azure 配置（例如备用名称、安全控制或成本标签），可能需要使用 Azure 门户或模板选项来遵守组织的 Azure 策略合规性。
Azure AI Foundry 资源在 Azure 门户中的“AI Foundry AI Foundry”下列出>。 API 类型为 AIServices。 查找如下所示的徽标：
提示
Azure AI Foundry 门户提供了一种使用基本默认设置创建新的 Azure AI Foundry 资源的方法。
若要在 Azure 门户中创建 AI Foundry 资源，请按照以下说明操作：
选择此 AI Foundry 资源链接：https://portal.azure.com/#create/Microsoft.CognitiveServicesAIFoundry
在“创建”页中提供以下信息：
项目详细信息 说明 订阅 选择一个可用的 Azure 订阅。 资源组 将包含 Azure AI Foundry 资源的 Azure 资源组。 可以创建新组或将其添加到预先存在的组。 区域 Azure AI 服务实例的位置。 不同位置可能会导致延迟，但不会影响资源的运行时可用性。 名称 您的 Azure AI Foundry 资源的一个描述性名称。 例如，MyAIServicesResource。 根据需要为资源配置其他设置，阅读并接受条件（如果适用），然后选择“查看 + 创建”。
提示
如果订阅不允许创建 AI Foundry 资源，则可能需要使用 Azure 门户、PowerShell 命令或 Azure CLI 命令启用该 Azure 资源提供程序的特权。 如果你不是订阅所有者，可请求具有所有者或管理员角色的人员帮助你完成注册，或请求向你的帐户授予 /register/action 特权。
清理资源
如果要清理和删除 AI Foundry 资源，可以删除资源或资源组。 删除资源组时也会删除资源组中包含的任何其他资源。
- 在 Azure 门户中展开左侧的菜单，打开服务菜单，然后选择“资源组”以显示资源组的列表。
- 找到包含要删除的资源的资源组。
- 如果要删除整个资源组，请选择资源组名称。 在下一页上，选择“删除资源组”并进行确认。
- 如果只想删除 Azure AI Foundry 资源，请选择资源组以查看其中的所有资源。 在下一页上，依次选择要删除的资源、该行的省略号菜单、“删除”。
使用本快速入门，以通过 Azure 命令行接口 (CLI) 命令创建 AI Foundry 资源。
Prerequisites
- 一个有效的 Azure 订阅 - 免费创建订阅。
- Azure CLI 2.0 或更高版本。
- 用于创建资源的 Azure RBAC 角色。 需要在 Azure 订阅或资源组上分配以下角色之一：
- 贡献者
- 所有者
- 具有
Microsoft.CognitiveServices/accounts/write权限的自定义角色
安装 Azure CLI 并登录
安装 Azure CLI。 若要登录到本地安装的 CLI，请运行 az login 命令：
az login
创建新的资源组
在创建 AI Foundry 资源之前，必须有一个 Azure 资源组才能包含该资源。 在创建新资源时，可以新建资源组，也可以使用现有资源组。 本文介绍如何创建新资源组。
若要创建资源，需要为订阅提供一个可用的 Azure 位置。 可以使用 az account list-locations 命令检索可用位置的列表。 可以从多个位置访问大部分 Azure AI 服务。 选择离你最近的位置，或查看哪些位置可供服务使用。
重要说明
- 请记住 Azure 位置，因为调用 Azure AI Foundry 资源时需要它。
- 某些 Azure AI 服务的可用性因区域而异。 有关详细信息，请参阅 Azure 产品在各区域中的推出情况。
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 服务资源种类。 请确保创建一个 kind 为 AIServices 的资源。
可以使用以下命令创建一个名为 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 资源。
Prerequisites
- 一个有效的 Azure 订阅 - 免费创建订阅。
- Azure PowerShell 5.0 或更高版本。
- 用于创建资源的 Azure RBAC 角色。 需要在 Azure 订阅或资源组上分配以下角色之一：
- 贡献者
- 所有者
- 具有
Microsoft.CognitiveServices/accounts/write权限的自定义角色
安装 Azure PowerShell 并登录
安装 Azure PowerShell。 要登录，请运行 Connect-AzAccount 命令：
Connect-AzAccount
创建新的 Azure AI Foundry 资源组
在创建 AI Foundry 资源之前，必须有一个 Azure 资源组才能包含该资源。 在创建新资源时，可以新建资源组，也可以使用现有资源组。 本文介绍如何创建新资源组。
若要创建资源，需要为订阅提供一个可用的 Azure 位置。 可以使用 Get-AzLocation 命令检索可用位置的列表。 可以从多个位置访问大部分 Azure AI 服务。 选择离你最近的位置，或查看哪些位置可供服务使用。
重要说明
- 请记住 Azure 位置，因为调用 Azure AI Foundry 资源时需要它。
- 某些 Azure AI 服务的可用性因区域而异。 有关详细信息，请参阅 Azure 产品在各区域中的推出情况。
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
访问资源
创建第一个资源后，可以通过 Foundry Portal 进行 UX 原型制作、 Foundry SDK 进行开发，或通过 Azure 门户进行管理访问。
验证设置
可以使用 Azure AI Projects SDK 连接和列出项目来验证资源是否已正确设置。 此最小示例确认身份验证和访问。
# Install the SDK: pip install azure-ai-projects azure-identity
from azure.ai.projects import AIProjectClient
from azure.identity import DefaultAzureCredential
# Replace with your actual values from Azure portal
client = AIProjectClient(
subscription_id="<your-subscription-id>",
resource_group_name="<your-resource-group>",
project_name="<your-project-name>",
credential=DefaultAzureCredential()
)
# List projects to verify connection
projects = client.projects.list()
print(f"Successfully connected. Found {len(list(projects))} projects.")
预期输出： Successfully connected. Found X projects. 其中 X 是资源中的项目数。
参考：
授予或获取开发人员权限
Azure 基于角色的访问控制 （RBAC）区分管理和开发作之间的权限。 若要使用 Foundry 构建，您的用户帐户必须被分配开发权限（“数据操作”）。 可以使用其中一个内置 RBAC 角色，也可以使用自定义 RBAC 角色。
Foundry 的内置 Azure RBAC 开发人员角色包括：
| 角色 | 说明 |
|---|---|
| Azure AI 项目经理 | 授予开发权限和项目管理权限。 可以邀请其他用户以“Azure AI 用户”身份协作处理项目。 |
| Azure AI 用户 | 授予开发权限。 |
只有授权用户（通常是 Azure 订阅或资源组所有者）可以通过 [Azure 门户] 或 [AI Foundry 门户通过管理中心] 分配角色。 详细了解基于角色的访问控制。
重要说明
Azure 所有者和参与者角色仅包括管理权限，而不包括开发权限。 需要开发权限才能使用 Foundry 中的所有功能进行生成。
开始构建你的第一个项目
设置权限后，即可开始构建 Foundry。 在 Azure AI Foundry 门户中 打开或 创建第一个项目。 项目在 Foundry 中组织智能体和模型自定义工作，可以在同一资源下创建多个。
浏览与你的资源捆绑的一些服务：
| 服务 | 说明 |
|---|---|
Azure AI Foundry 代理服务 |
将生成式 AI 模型的强大功能与支持代理访问和与真实数据源交互的工具相结合。 |
|
Azure AI 模型推理 |
对 Azure AI Foundry 模型目录中的旗舰模型执行模型推理。 |
Azure OpenAI |
执行各种自然语言任务。 |
内容安全 |
用于检测不需要的内容的 AI 服务。 |
文档智能 |
将文档转换为智能数据驱动解决方案。 |
语言 |
使用行业领先的自然语言理解功能构建应用。 |
语音 |
语音转文本、文本转语音、翻译和说话人辨识。 |
翻译器 |
使用 AI 支持的翻译技术翻译超过 100 种正在使用、处于危险和濒危的语言和方言。 |
后续步骤
- 创建项目 以组织工作。
- 连接工具 以生成更丰富的应用程序。
- 了解 AI Foundry 中的访问控制 ，以邀请其他人加入工作环境。
- 使用专用网络保护资源
- 将 Azure AI Foundry 与 Azure AI 搜索技能配合使用