Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
63 changes: 45 additions & 18 deletions docs/create_azure_ai_service.md
Original file line number Diff line number Diff line change
@@ -1,21 +1,48 @@
# How To Create Azure AI Service
1. Navigate to https://aka.ms/CognitiveServicesAIServices .
2. Select your Azure subscription.
3. Select the available Resource group.
4. Choose the region which support Content Understanding service from below tables.
| Geography | Region | Region Identifier|
| --------- | -------------- | ---------------- |
| US | West US | westus |
| Europe | Sweden Central | swedencentral |
| Australia | Australia East | australiaeast |
5. Enter a name for your resource.
6. Choose a price plan.

This guide covers the latest configuration using **Azure AI Foundry**, including creating a Foundry Hub and Project, and deploying Azure AI Content Understanding.

## 1. Create a Foundry Hub
- Go to [Azure Portal AI Foundry Resource](https://portal.azure.com/#create/Microsoft.CognitiveServicesAIFoundry).
- Select your Azure subscription.
- Choose or create a Resource Group.
- **Choose a supported region** from the table below:

| Geography | Region | Region Identifier |
| --------- | -------------- | ------------------ |
| US | West US | westus |
| Europe | Sweden Central | swedencentral |
| Australia | Australia East | australiaeast |

- Enter a name for your Content Understanding resource.
- Select a pricing plan.
<img src="./create_srv_1.png" width="600" />
7. Configure other settings for your resource as needed, read, and accept the conditions (as applicable), and then select Review + create.
- Configure additional settings as needed, read and accept the terms, then click **Create**.
<img src="./create_srv_2.png" width="600" />
8. Azure will run a quick validation check, after a few seconds you should see a green banner that says Validation Passed.
9. Once the validation banner appears, select the Create button from the bottom-left corner.
10. After you select create, you'll be redirected to a new page that says Deployment in progress. After a few seconds, you'll see a message that says, Your deployment is complete.
11. Navigate to the resouce. In the left navigation menu, select "Keys and Endpoint", then get the **key** and **endpoint**.
<img src="./create_srv_3.png" width="600" />
Now,you could start with these information to run the samples.
- Wait for Azure's validation (look for a green "Validation Passed" banner).
- Click **Create**. Deployment will begin, and after a few seconds, you should see "Your deployment is complete."

## 2. Get Keys and Endpoint
- Navigate to your deployed resource.
- In the left menu, select **Keys and Endpoint**.
- Copy the following information:
- **Endpoint**: Format is
```
AZURE_AI_ENDPOINT = "https://<AzureAIContentUnderstandingResourceName>.services.ai.azure.com/"
```
- **Primary Key**:
```
AZURE_AI_API_KEY = <your_primary_key>
```
- **API Version**:
```
AZURE_AI_API_VERSION = "2025-05-01-preview"
```
<img src="./create_srv_3.png" width="600" />

Now you are ready to use these credentials to run the samples.

---
**Note:**
- Always use the **Foundry Hub > Foundry Project** structure for Azure AI Content Understanding configuration.
- Make sure to select a supported region for Content Understanding during deployment.
4 changes: 2 additions & 2 deletions docs/create_srv_1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
4 changes: 2 additions & 2 deletions docs/create_srv_2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
4 changes: 2 additions & 2 deletions docs/create_srv_3.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.