Skip to content

Commit

Permalink
mark some steps optional, and hide the steps to deploy existing AI (#162
Browse files Browse the repository at this point in the history
)

as title

## Purpose
refine the process

## Does this introduce a breaking change?
<!-- Mark one with an "x". -->
```
[ ] Yes
[x] No
```

## Pull Request Type
What kind of change does this Pull Request introduce?

<!-- Please check the one that applies to this PR using "x". -->
```
[ ] Bugfix
[ ] Feature
[ ] Code style update (formatting, local variables)
[ ] Refactoring (no functional changes, no api changes)
[x] Documentation content changes
[ ] Other... Please describe:
```
  • Loading branch information
sonwan2020 authored Jan 7, 2025
1 parent 1a08cbe commit a62b170
Show file tree
Hide file tree
Showing 4 changed files with 9 additions and 27 deletions.
2 changes: 1 addition & 1 deletion docs/03_lab_monitor/0303.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: '3. Application Insights'
title: '3. Application Insights (Optional)'
layout: default
nav_order: 3
parent: 'Lab 3: Enable monitoring'
Expand Down
2 changes: 1 addition & 1 deletion docs/03_lab_monitor/0304.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: '4. Azure Managed Grafana'
title: '4. Azure Managed Grafana (Optional)'
layout: default
nav_order: 4
parent: 'Lab 3: Enable monitoring'
Expand Down
31 changes: 6 additions & 25 deletions docs/05_lab_openai/0501.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: '1. Create Azure OpenAI resources'
title: 'Create Azure OpenAI resources (Optional)'
layout: default
nav_order: 1
parent: 'Lab 5: Integrate with Azure OpenAI'
Expand All @@ -23,19 +23,9 @@ To add AI capablities to the application, you need create an Azure OpenAI accoun
--custom-domain $OPEN_AI_SERVICE_NAME
```

2. Deploy language models in your Azure OpenAI service instance. Use the following commands to deploy two language models `text-embedding-ada-002` and `gpt-4o`.
1. Deploy language models in your Azure OpenAI service instance. Use the following commands to deploy model `gpt-4o`.

```bash
az cognitiveservices account deployment create \
--resource-group $RESOURCE_GROUP \
--name $OPEN_AI_SERVICE_NAME \
--deployment-name text-embedding-ada-002 \
--model-name text-embedding-ada-002 \
--model-version "2" \
--model-format OpenAI \
--sku-name "Standard" \
--sku-capacity 30

az cognitiveservices account deployment create \
--resource-group $RESOURCE_GROUP \
--name $OPEN_AI_SERVICE_NAME \
Expand All @@ -44,22 +34,13 @@ To add AI capablities to the application, you need create an Azure OpenAI accoun
--model-version 2024-08-06 \
--model-format OpenAI \
--sku-name "GlobalStandard" \
--sku-capacity 30
--sku-capacity 10
```

{: .note }
> In Azure OpenAI, model availability varies by region. Please check [related information](https://learn.microsoft.com/en-us/azure/ai-services/openai/concepts/models) to choose the model version.
1. Navigate to your open AI instance and get the endpoint and api-key.

3. To securely access Azure OpenAI API call, you need assign `Cognitive Services OpenAI User` role for your managed identity.

```bash
OPEN_AI_RESOURCE_ID=$(az cognitiveservices account show --name $OPEN_AI_SERVICE_NAME --resource-group $RESOURCE_GROUP --query id --output tsv)

APPS_IDENTITY_SP_ID=$(az identity show --resource-group $RESOURCE_GROUP --name $APPS_IDENTITY --query principalId --output tsv)

az role assignment create \
--role "Cognitive Services OpenAI User" \
--scope $OPEN_AI_RESOURCE_ID \
--assignee $APPS_IDENTITY_SP_ID
```
{: .note }
Ask the subscription administrator for help if you see errors like `{"error":{"code":"BadRequest","message":"Failed to list key. disableLocalAuth is set to be true"}}`.
1 change: 1 addition & 0 deletions docs/05_lab_openai/0502.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,7 @@
title: '2. Deploy sample AI application chat-agent'
layout: default
nav_order: 2
nav_exclude: true
parent: 'Lab 5: Integrate with Azure OpenAI'
---

Expand Down

0 comments on commit a62b170

Please sign in to comment.