你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
在本快速入门中，你将创建一个 Microsoft Foundry project 并部署模型。 如果您管理团队，那么也要授予团队成员访问权限。 完成这些步骤后，你或你的团队就可以开始使用已部署的模型生成 AI 应用程序。
小窍门
本快速入门介绍如何创建资源以使用基本设置生成代理。 有关使用自己的资源的更高级方案，请参阅 设置环境进行代理开发。
先决条件
- 具有活动订阅的Azure帐户。 如果没有订阅，请创建一个 free Azure 帐户，其中包括免费试用订阅。
- 如果您正在为自己创建项目：
- 拥有允许创建 Foundry 资源的角色访问权限，例如订阅或资源组上的 Azure 帐户 AI 所有者或 Azure AI 所有者。 有关权限的详细信息，请参阅 Microsoft Foundry 的基于角色的访问控制。
- 如果您正在为团队创建项目：
- 拥有允许完成角色分配的角色访问权限，例如所有者。 有关权限的详细信息，请参阅 Microsoft Foundry 的基于角色的访问控制。
- 需要访问权限的团队成员的用户电子邮箱地址或Microsoft Entra安全组ID列表。
使用以下选项卡选择首选方法：
安装 Azure CLI 2.67.0 或更高版本（请查看
az version）。登录到Azure：
az login
创建项目
创建 Foundry 项目来组织工作。 项目包含该团队使用的模型、代理和其他资源。
创建资源组或使用现有资源组。 例如，在
my-foundry-rg中创建eastus：az group create --name my-foundry-rg --location eastus创建 Foundry 资源。 例如， 在
my-foundry-resource资源组中创建my-foundry-rg：az cognitiveservices account create \ --name my-foundry-resource \ --resource-group my-foundry-rg \ --kind AIServices \ --sku s0 \ --location eastus \ --allow-project-management--allow-project-management标志允许在此资源中创建项目。为资源创建自定义子域。 自定义域名必须是全局唯一的。 如果
my-foundry-resource已被使用，请尝试使用更具特色的名称。az cognitiveservices account update \ --name my-foundry-resource \ --resource-group my-foundry-rg \ --custom-domain my-foundry-resource创建项目。 例如，在
my-foundry-project中创建my-foundry-resource：az cognitiveservices account project create \ --name my-foundry-resource \ --resource-group my-foundry-rg \ --project-name my-foundry-project \ --location eastus验证项目是否已创建：
az cognitiveservices account project show \ --name my-foundry-resource \ --resource-group my-foundry-rg \ --project-name my-foundry-project输出显示项目的属性，包括它的资源 ID。
部署模型
部署可以使用的模型。 此示例使用 gpt-4.1-mini，但可以选择任何可用的模型。
az cognitiveservices account deployment create \
--name my-foundry-resource \
--resource-group my-foundry-rg \
--deployment-name gpt-4.1-mini \
--model-name gpt-4.1-mini \
--model-version "2025-04-14" \
--model-format OpenAI \
--sku-capacity 10 \
--sku-name Standard
验证部署是否成功：
az cognitiveservices account deployment show \
--name my-foundry-resource \
--resource-group my-foundry-rg \
--deployment-name gpt-4.1-mini
部署准备就绪后，输出会显示 "provisioningState": "Succeeded"。
获取项目的连接详细信息
需要项目终结点以便从代码进行连接。 如果要为其他人管理此project，请向其发送此终结点以及部署名称。
- 使用 Azure 帐户登录到 Microsoft Foundry。
- 选择项目。
- 在项目的欢迎界面查找您的端点。
- 复制终结点值。 在其他快速入门和教程中使用此值。
对于管理员：授予访问权限
如果要管理团队，请将 Azure AI 用户角色分配给团队成员，以便他们可以使用project和已部署的模型。 此角色提供生成和测试 AI 应用程序所需的最低权限。 有关可能需要分配的其他角色，请参阅 Microsoft Foundry 的基于角色的访问控制。
获取项目的资源 ID
PROJECT_ID=$(az cognitiveservices account project show \ --name my-foundry-resource \ --resource-group my-foundry-rg \ --project-name my-foundry-project \ --query id -o tsv)将 Azure AI 用户角色分配给团队成员：
az role assignment create \ --role "Azure AI User" \ --assignee "user@contoso.com" \ --scope $PROJECT_ID要添加安全组而非单个用户：
az role assignment create \ --role "Azure AI User" \ --assignee-object-id "<security-group-object-id>" \ --assignee-principal-type Group \ --scope $PROJECT_ID验证角色分配：
az role assignment list \ --scope $PROJECT_ID \ --role "Azure AI User" \ --output table
验证团队成员访问权限
请让团队成员通过登录到Microsoft Foundry来验证他们的访问权限，从项目列表中选择项目，并确认已部署的模型显示在Build>Models下。
如果团队成员无法访问项目，请验证角色分配是否已成功完成。 检查是否使用了正确的电子邮件地址或安全组 ID。 确保团队成员的Azure帐户位于同一Microsoft Entra 租户中。
清理资源
如果不再需要此project，请删除资源组以删除与其关联的所有资源。
az group delete --name my-foundry-rg --yes --no-wait