Skip to content

Commit af53a52

Browse files
committed
setup more details
1 parent 7113a04 commit af53a52

File tree

1 file changed

+44
-5
lines changed

1 file changed

+44
-5
lines changed

articles/ai-services/agents/includes/bicep-setup.md

Lines changed: 44 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -24,15 +24,54 @@ The following section shows you how to set up the required resources for getting
2424

2525
**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.
2626

27-
| Description | Autodeploy |
28-
| -----------------------------------------------| -----------------------|
29-
| Deploy a basic agent setup that uses Managed Identity for authentication. | [![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)
30-
| Deploy a standard agent setup that uses Managed Identity for authentication. | [![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)
27+
| Description | Resources | Autodeploy |
28+
| -----------------------------------------------| -----------------------|----------------------|
29+
| Deploy a basic agent setup that uses Managed Identity authentication on the AI Services and storage account connections. | AI hub, AI project, AI Services | [![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) |
30+
| Deploy a standard agent setup that uses Managed Identity authentication on the AI Services, storage account, and Azure AI Search connections. |AI hub, AI project, storage account, key vault,Azure AI Search, | [![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)|
31+
32+
### [Optional] Use your own resources in agent setup
33+
34+
35+
#### Basic agent setup: use an existing AI Services resource
36+
37+
Replace the parameter value for `aiServiceAccountResourceId` with the full arm resource id of the AI Services account you want to use.
38+
39+
1. To get the AI Services account resource id, run the following commands in the Azure CLI:
40+
- az login
41+
- Replace `<your-resource-group>` with the resource group containing your resource and `your-ai-service-resource-name` with the name of your AI Service resource, and run:
42+
43+
```az cognitiveservices account show --resource-group <your-resource-group> --name <your-ai-service-resource-name> --query "id" --output tsv```
44+
45+
The value returned is the `aiServiceAccountResourceId` you need to use in the template.
46+
47+
2. In the basic agent template::
48+
- aiServiceAccountResourceId:/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{serviceName}"
49+
50+
#### Standard agent setup: use existing AI Services, Storage, and/or Azure AI Search resources
51+
52+
Use an existing AI Search, storage accont, and/or Azure AI Search resource by providing the full arm resource id in the standard agent template file.
53+
54+
Use an existing AI Services resource:
55+
- aiServiceAccountResourceId:/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{serviceName}
56+
57+
Use an existing storage account:
58+
- To get your storage account resource id run the following Azure CLI commands:
59+
- az login
60+
- ```az search service show --resource-group <your-resource-group> --name <your-storage-account> --query "id" --output tsv```
61+
- In the template file set:
62+
- aistorageAccountResourceId:/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{storageAccountName}
63+
64+
Use an existing Azure AI Search resource:
65+
- To get your Azure AI Search resource id run the following Azure CLI commands:
66+
- az login
67+
- ```az search service show --resource-group <your-resource-group> --name <your-search-service> --query "id" --output tsv```
68+
- In the template file set parameter:
69+
- aiSearchServiceResourceId:/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Search/searchServices/{searchServiceName}
3170

3271
## Basic agent setup resource architecture
3372
:::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":::
3473

35-
Resources for the AI hub, AI project, storage account, and AI Services are created for you. The AI Services account is connected to your project/hub and a gpt-4o-mini model is deployed in the eastus region. A Microsoft-managed key vault is used by default.
74+
Resources for the AI hub, AI project, and AI Services are created for you. A storage account is created because it is a required resource for hubs, but this is not used by agents. The AI Services account is connected to your project/hub and a gpt-4o-mini model is deployed in the eastus region. A Microsoft-managed key vault, storage account, and search resource is used by default.
3675

3776
## Standard agent setup resource architecture
3877
:::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":::

0 commit comments

Comments
 (0)