Skip to content

Commit 5bae966

Browse files
committed
updating quickstart
1 parent 5988bfa commit 5bae966

File tree

1 file changed

+31
-6
lines changed

1 file changed

+31
-6
lines changed

articles/ai-services/agents/includes/quickstart-foundry.md

Lines changed: 31 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -13,17 +13,29 @@ ms.date: 01/21/2025
1313
- An [Azure AI project](../../../ai-studio/how-to/create-projects.md) in Azure AI Foundry portal.
1414
- Make sure you have the **Azure AI Developer** [RBAC role](../../../ai-studio/concepts/rbac-ai-studio.md) assigned.
1515

16-
## Go to the Azure AI Foundry portal (Preview)
16+
## Choose basic or standard agent setup
17+
18+
Before getting started, determine if you want to perform a basic agent setup or a standard agent setup.
19+
20+
**Basic Setup**: Agents use multitenant search and storage resources fully managed by Microsoft. You don't have visibility or control over these underlying Azure resources. A basic setup can be created using the Azure AI Foundry portal or an automated bicep template.
21+
22+
**Standard Setup**: Agents use customer-owned, single-tenant search and storage resources. With this setup, you have full control and visibility over these resources, but you incur costs based on your usage. Standard setup can only be performed using an automated bicep template.
23+
24+
## [Basic setup](#tab/basic)
25+
26+
## Use a bicep template
27+
28+
| Description and Autodeploy | Diagram (click to zoom in) |
29+
| -----------------------------------------------| -----------------------|
30+
| Deploy a basic agent setup that uses Managed Identity for authentication. Resources for the AI hub, AI project, storage account, and AI Services are created for you. <br><br> The AI Services account is connected to your project and hub, and a gpt-4o-mini model is deployed in the eastus region. A Microsoft-managed key vault is used by default. <br><br> [![Deploy to Azure](https://aka.ms/deploytoazurebutton)](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2Fazure-quickstart-templates%2Fmaster%2Fquickstarts%2Fmicrosoft.azure-ai-agent-service%2Fbasic-agent-identity%2Fazuredeploy.json) | :::image type="content" source="../media/quickstart/basic-agent-setup-resources.png" alt-text="An architecture diagram for basic agent setup." lightbox="../media/quickstart/basic-agent-setup-resources.png"::: |
31+
32+
## Use the Azure AI Foundry portal
1733

1834
1. Sign in to [Azure AI Foundry](https://ai.azure.com).
1935
1. Go to your project or [create a new project](../../../ai-studio//how-to/create-projects.md) in Azure AI Foundry portal.
2036
1. From your project overview, select **Agents**, located under **playgrounds**. The Agents playground allows you to explore, prototype, and test AI Agents without needing to run any code. From this page, you can quickly iterate and experiment with new ideas.
2137

22-
1. Select your Azure OpenAI resource and optionally an Azure AI Search resource.
23-
24-
> [!IMPORTANT]
25-
> * If you don't select an Azure AI Search resource, A Microsoft-managed storage will be used to contain your data. If you do select an Azure AI Search resource, then customer-managed storage will be used.
26-
> * If you don't select an Azure AI Search resource now, and begin using customer-managed storage later, the data stored in the Microsoft-managed storage will be lost.
38+
1. Select your Azure OpenAI resource.
2739

2840
:::image type="content" source="../media/quickstart/agents-foundry.png" alt-text="A screenshot of the initial Agents screen." lightbox="../media/quickstart/agents-foundry.png":::
2941

@@ -33,6 +45,19 @@ ms.date: 01/21/2025
3345

3446
:::image type="content" source="../media/quickstart/model-list.png" alt-text="A screenshot of the available models." lightbox="../media/quickstart/model-list.png":::
3547

48+
## [Standard setup](#tab/standard)
49+
50+
## Bicep deployment
51+
52+
| Description and Autodeploy | Diagram (click to zoom in) |
53+
| -----------------------------------------------| -----------------------|
54+
| Deploy a standard agent setup that uses Managed Identity for authentication. <br><br> Resources for the AI hub, AI project, key vault, storage account, AI Services, and AI Search are created for you. <br><br>The AI Services, AI Search, key vault, and storage account are connected to your project and hub. A gpt-4o-mini model is deployed in eastus region. <br><br> [![Deploy to Azure](https://aka.ms/deploytoazurebutton)](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2Fazure-quickstart-templates%2Frefs%2Fheads%2Fmaster%2Fquickstarts%2Fmicrosoft.azure-ai-agent-service%2Fstandard-agent%2Fazuredeploy.json) | :::image type="content" source="../media/quickstart/standard-agent-setup-resources.png" alt-text="An architecture diagram for standard agent setup." lightbox="../media/quickstart/standard-agent-setup-resources.png"::: |
55+
56+
---
57+
58+
## Go to the Azure AI Foundry portal (Preview)
59+
60+
3661
1. In the **Create and debug your agents** screen that appears, select **New agent**. This will create a new agent, and open a **Setup** pane where you can change its parameters and tools.
3762

3863
You can optionally give your agent a name other than the one generated for it, and add instructions to help improve its performance. Give your agent clear directions on what to do and how to do it. Include specific tasks, their order, and any special instructions like tone or engagement style.

0 commit comments

Comments
 (0)