Skip to content

Commit b9fc254

Browse files
Merge pull request #6298 from gmndrg/main
Improve documentation to show URL with openai.azure.com works with AOAI embedding functionality
2 parents bf85e69 + 13966fb commit b9fc254

File tree

2 files changed

+7
-6
lines changed

2 files changed

+7
-6
lines changed

articles/search/cognitive-search-skill-azure-openai-embedding.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,14 +2,14 @@
22
title: Azure OpenAI Embedding skill
33
titleSuffix: Azure AI Search
44
description: Connects to a deployed model on your Azure OpenAI resource.
5-
author: dharun1995
6-
ms.author: dhanasekars
5+
author: gmndrg
6+
ms.author: gimondra
77
ms.service: azure-ai-search
88
ms.custom:
99
- ignite-2023
1010
- build-2024
1111
ms.topic: reference
12-
ms.date: 05/08/2025
12+
ms.date: 07/29/2025
1313
---
1414

1515
# Azure OpenAI Embedding skill
@@ -20,7 +20,7 @@ The **Azure OpenAI Embedding** skill connects to a deployed embedding model on y
2020

2121
Your Azure OpenAI in Azure AI Foundry Models resource must have an associated [custom subdomain](/azure/ai-services/cognitive-services-custom-subdomains). If the service was created through the Azure portal, this subdomain is automatically generated as part of your service setup. Ensure that your service includes a custom subdomain before using it with the Azure AI Search integration.
2222

23-
Azure OpenAI resources (with access to embedding models) that were created in Azure AI Foundry portal aren't supported. Only the Azure OpenAI resources created in the Azure portal are compatible with the **Azure OpenAI Embedding** skill integration.
23+
If you create an AI Service using Azure AI Foundry, it will automatically generate an endpoint with the domain cognitiveservices.azure.com. When you deploy an Azure OpenAI embedding model in this service, you can change the endpoint to use openai.azure.com domain instead, when using it in this skill. For example, change your endpoint from `https://<yourendpoint>.cognitiveservices.azure.com` to `https://<yourendpoint>.openai.azure.com`. Use this updated endpoint as the value for the `resourceUri` property for this skill.
2424

2525
The [Import and vectorize data wizard](search-get-started-portal-import-vectors.md) in the Azure portal uses the **Azure OpenAI Embedding** skill to vectorize content. You can run the wizard and review the generated skillset to see how the wizard builds the skill for embedding models.
2626

articles/search/vector-search-vectorizer-azure-open-ai.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,12 +4,11 @@ titleSuffix: Azure AI Search
44
description: Connects to a deployed model on your Azure OpenAI resource at query time.
55
author: HeidiSteen
66
ms.author: heidist
7-
ms.reviewer: chalton
87
ms.service: azure-ai-search
98
ms.custom:
109
- build-2024
1110
ms.topic: reference
12-
ms.date: 10/16/2024
11+
ms.date: 07/29/2025
1312
---
1413

1514
# Azure OpenAI vectorizer
@@ -29,6 +28,8 @@ Vectorizers are used at query time, but specified in index definitions, and refe
2928

3029
Your Azure OpenAI in Azure AI Foundry Models must have an associated [custom subdomain](/azure/ai-services/cognitive-services-custom-subdomains). If the service was created through the Azure portal, this subdomain is automatically generated as part of your service setup. Ensure that your service includes a custom subdomain before using it with the Azure AI Search integration.
3130

31+
If you create an AI Service using Azure AI Foundry, it will automatically generate an endpoint with the domain cognitiveservices.azure.com. When you deploy an Azure OpenAI embedding model in this service, you can change the endpoint to use openai.azure.com domain instead, when using it in this skill. For example, change your endpoint from `https://<yourendpoint>.cognitiveservices.azure.com` to `https://<yourendpoint>.openai.azure.com`. Use this updated endpoint as the value for the `resourceUri` property for this skill.
32+
3233
Azure OpenAI resources (with access to embedding models) that were created in Azure AI Foundry portal aren't supported. Only the Azure OpenAI resources created in the Azure portal are compatible with the **Azure OpenAI Embedding** skill integration.
3334

3435
## Vectorizer parameters

0 commit comments

Comments
 (0)