You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/ai-services/includes/quickstarts/management-azportal.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -24,7 +24,7 @@ keywords:
24
24
25
25
If your organization requires customized Azure configurations like alternative names, security controls or cost tags, you might need to use the [Azure portal](https://portal.azure.com) or [template options](../../../ai-foundry/how-to/create-resource-template.md) to comply with your organization's Azure Policy compliance.
26
26
27
-
The Azure AI Foundry multi-service resource is listed under **AI Foundry** > **AI Foundry** in the Azure portal. The API kind is **AIServices**. Look for the logo as shown here:
27
+
The Azure AI Foundry resource is listed under **AI Foundry** > **AI Foundry** in the Azure portal. The API kind is **AIServices**. Look for the logo as shown here:
28
28
29
29
:::image type="content" source="../../media/ai-services-resource-portal.png" alt-text="Screenshot of the Azure AI Foundry resource in the Azure portal." lightbox="../../media/ai-services-resource-portal.png":::
# Quickstart: Create your first AI Foundry resource
19
+
# Quickstart: Set up your first AI Foundry resource
20
20
21
-
Learn how to create and manage an AI Foundry resource. It is the primary resource type for designing, deploying, and managing generative AI applications and agents. It provides access to agent service, models that are hosted using a serverless hosting model, evaluations and Azure OpenAI service. This is the recommended resource type for most applications built in Azure AI Foundry.
21
+
Learn how to create and manage an Azure AI Foundry resource. It's the [primary Azure resource type](../ai-foundry/concepts/resource-types.md) for building, deploying, and managing generative AI models and applications including agents in Azure.
22
22
23
-
Azure AI Foundry is the next version and renaming of former 'Azure AI Services'. All its previous capabilities are supported including Azure AI Services models for Speech, Vision, Language capabilities. New capabilities include AI Foundry API which lets you access Agent service and Evaluations, [projects](../ai-foundry/how-to/create-projects.md) as folders to organize your work, and [connections](../ai-foundry/how-to/connections-add.md) to integrate with other Azure services.
23
+
An Azure resource is required to use and manage services in Azure. It defines the scope for configuring access, security such as networking, billing, and monitoring.
24
24
25
-
Looking to use AI Foundry with advanced security settings? See [advanced AI Foundry creation options](../ai-foundry/how-to/create-resource-template.md)
25
+
Azure AI Foundry resource is the next version and renaming of former "Azure AI Services". It provides the application environment for hosting your agents, model deployments, evaluations, and more.
26
+
27
+
Looking to configure AI Foundry with advanced security settings? See [advanced AI Foundry creation options](../ai-foundry/how-to/create-resource-template.md)
26
28
27
29
Looking to use [Azure AI Search skills?](../search/tutorial-skillset.md) See [Use Azure AI Foundry with Azure AI Search skills](multi-services-resource-search-skills.md).
28
30
31
+
## Create your first resource
32
+
33
+
An Azure AI Foundry resource can organize the work for multiple use cases, and is [typically shared](../ai-foundry/concepts/planning.md) between a team of developers that work on use cases in a similar business or data domain. Projects acts as folders to group related work.
34
+
35
+
:::image type="content" source="../ai-foundry/media/how-to/projects/projects-multi-setup.png" alt-text="Diagram explaining concepts of an Azure AI Foundry setup.":::
36
+
37
+
To create your first resource, with basic Azure settings, follow the below steps using either Azure portal, Azure CLI, or PowerShell.
@@ -44,43 +54,47 @@ Looking to use [Azure AI Search skills?](../search/tutorial-skillset.md) See [Us
44
54
45
55
::: zone-end
46
56
47
-
## Default project
57
+
## Access your resource
58
+
59
+
With your first resource created, you can access it via [Foundry Portal for UX prototyping](https://ai.azure.com/), [Foundry SDK for development](), or via [Azure portal for administrative management](https://portal.azure.com).
60
+
61
+
## Grant or obtain developer permissions
62
+
63
+
[Azure Role Based Access Control](/azure/role-based-access-control/resource-provider-operations) (RBAC) differentiates permissions between management and development actions. To build with Foundry, your user account must be assigned developer permissions ("data actions"). You can either use one of the built-in RBAC roles, or use a custom RBAC role.
48
64
49
-
In AI Foundry, projects provide access to developer APIs, and act as folders to organize your work. A default project is created for you when you create your resource in Azure portal or Azure AI Foundry Portal. The default project has a special notion - it provides backwards compatibility with developer APIs that are supported on the parent resource level. Typically these are AI Services and Azure OpenAI APIs for model customization. Newer APIs including Agents and Evaluations are accessible from any project. For more information, see [Types of projects](../ai-foundry/what-is-azure-ai-foundry.md#project-types).
65
+
Built-in Azure RBAC developer roles for Foundry include:
50
66
51
-
Your AI Foundry resource might or might not be associated with an AI Foundry project:
52
-
- If your AI Foundry resources was created using Azure CLI, PowerShell, Bicep template, Terraform, or SDKs. In those cases, the AI Foundry resource by default isn't associated with a project. You can create a project later as a child resource.
53
-
- If your AI Foundry resource was created as a connection. For example, when you try to deploy a model that is not available in the region of your current AI Foundry resource.
54
-
- A [project can be created in the Azure AI Foundry portal](../ai-foundry/how-to/create-projects.md) and automatically associated as a dependent of a new AI Foundry resource.
55
-
- An AI Foundry resource might have been created in the AI Foundry portal, but as a dependent resource of an [Azure AI Foundry hub](../ai-foundry/concepts/ai-resources.md). In this case, the resource is automatically associated with the project you create in the hub.
67
+
|Role|Description|
68
+
|---|---|
69
+
|Azure AI project manager|Grants development permissions, and project management permissions. Can invite other users to collaborate on a project as 'Azure AI user'.|
70
+
|Azure AI user|Grants development permissions.|
56
71
57
-
## Supported services with an AI Foundry resource
72
+
Only authorized users, typically the Azure subscription or resource group owner, can assign a role via either [Azure portal] or [AI Foundry Portal via management center]. [Learn more about role-based access control](../ai-foundry/concepts/rbac-azure-ai-foundry.md).
58
73
59
-
The AI Foundry resource enables access to the following Azure AI services with a single set of credentials. Some services are available via the AI Foundry resource and single-service resource.
74
+
> [!IMPORTANT]
75
+
> Azure Owner and Contributor roles do only include management permissions, and not development permissions. Development permissions are required to build with all capabilities in Foundry.
60
76
61
-
> [!TIP]
62
-
> We recommend whenever possible to use the **AI Foundry** resource (where the API kind is `AIServices`) to access multiple Azure AI services with a single set of credentials. For services not available via the AI Foundry resource (such as Face and Custom Vision), you can alternatively create a single-service resource.
77
+
## Start building in your first project
63
78
64
-
| Service | Description | Kind (via API) |
65
-
| --- | --- | --- |
66
-
|[Azure AI Foundry Agent Service](./agents/index.yml)| Combine the power of generative AI models with tools that allow agents to access and interact with real-world data sources. |`AIServices`|
67
-
|[Azure AI Model Inference](../ai-foundry/model-inference/index.yml)| Performs model inference for flagship models in the Azure AI Foundry model catalog. |`AIServices`|
68
-
|[Azure OpenAI](../ai-foundry/openai/index.yml)| Perform a wide variety of natural language tasks. |`AIServices`<br/>`OpenAI`|
69
-
|[Content Safety](./content-safety/index.yml)| An AI service that detects unwanted contents. |`AIServices`<br/>`ContentSafety`|
70
-
|[Custom Vision](./custom-vision-service/index.yml)| Customize image recognition for your business. |`CustomVision.Prediction` (Prediction only)<br/>`CustomVision.Training` (Training only) |
|[Face](./computer-vision/overview-identity.md)| Detect and identify people and emotions in images. |`Face`|
73
-
|[Language](./language-service/index.yml)| Build apps with industry-leading natural language understanding capabilities. |`AIServices`<br/>`TextAnalytics`|
74
-
|[Speech](./speech-service/index.yml)| Speech to text, text to speech, translation, and speaker recognition. |`AIServices`<br/>`Speech`|
75
-
|[Translator](./translator/index.yml)| Use AI-powered translation technology to translate more than 100 in-use, at-risk, and endangered languages and dialects. |`AIServices`<br/>`TextTranslation`|
76
-
|[Vision](./computer-vision/index.yml)| Analyze content in images and videos. |`AIServices` (Training and Prediction)<br/>`ComputerVision`|
79
+
With permissions set up, you're now ready to start building Foundry. In [Azure AI Foundry Portal](https://ai.azure.com/) open or [create your first project](../ai-foundry/how-to/create-projects.md). Projects organize your agent and model customization work in Foundry, and you can create multiple under the same resource.
77
80
78
-
## Pricing
81
+
Explore some of the services that come bundled with your resource:
79
82
80
-
[!INCLUDE [SKUs and pricing](./includes/quickstarts/sku-pricing.md)]
83
+
| Service | Description |
84
+
| --- | --- |
85
+
|[Azure AI Foundry Agent Service](./agents/index.yml)| Combine the power of generative AI models with tools that allow agents to access and interact with real-world data sources. |
86
+
|[Azure AI Model Inference](../ai-foundry/model-inference/index.yml)| Performs model inference for flagship models in the Azure AI Foundry model catalog. |
87
+
|[Azure OpenAI](../ai-foundry/openai/index.yml)| Perform a wide variety of natural language tasks. |
88
+
|[Content Safety](./content-safety/index.yml)| An AI service that detects unwanted contents. |
|[Language](./language-service/index.yml)| Build apps with industry-leading natural language understanding capabilities. |
91
+
|[Speech](./speech-service/index.yml)| Speech to text, text to speech, translation, and speaker recognition. |
92
+
|[Translator](./translator/index.yml)| Use AI-powered translation technology to translate more than 100 in-use, at-risk, and endangered languages and dialects. |
81
93
82
-
## Related content
94
+
## Next steps
83
95
84
-
-[Azure AI services hub page](../ai-services/index.yml)
85
-
-[Azure AI Foundry portal](../ai-services/connect-services-ai-foundry-portal.md)
96
+
-[Create a project](../ai-foundry/how-to/create-projects.md) to organize your work.
97
+
-[Connect tools](../ai-foundry/how-to/connections-add.md) to build more rich applications.
98
+
- Learn about [access control in AI Foundry](../ai-foundry/concepts/rbac-azure-ai-foundry.md) to invite others to your working environment.
99
+
-[Secure your resource using private networking](../ai-foundry/how-to/configure-private-link.md)
86
100
-[Use Azure AI Foundry with Azure AI Search skills](multi-services-resource-search-skills.md)
0 commit comments