Skip to content

Commit 17d477c

Browse files
learn-build-service-prod[bot]learn-build-service-prod[bot]
authored
Merge pull request #6924 from MicrosoftDocs/main
Auto Publish – main to live - 2025-09-04 05:02 UTC
2 parents 9037dee + 2452230 commit 17d477c

File tree

9 files changed

+274
-95
lines changed

9 files changed

+274
-95
lines changed

‎articles/ai-foundry/concepts/resource-types.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ Azure AI Foundry portal and SDK clients support multiple distinct Azure resource
3030

3131
* **Azure AI Search** – A resource used to index and retrieve data for grounding AI applications. It can be [connected](../how-to/connections-add.md) to Azure AI Foundry agents to enable retrieval-augmented generation (RAG) and semantic search experiences.
3232

33-
* **Azure OpenAI** – A specialized resource type that provides access to OpenAI models such as GPT-4 and GPT-4o. It offers a subset of the capabilities available in Azure AI Foundry and provides solely access to Azure OpenAI APIs.
33+
* **Azure OpenAI** – A specialized resource type that provides access to OpenAI models such as GPT-4 and GPT-4o. It offers a subset of the capabilities available in Azure AI Foundry and provides solely access to Azure OpenAI APIs. [Upgrade from Azure OpenAI to Azure AI Foundry](../how-to/upgrade-azure-openai.md) to gain access to more capabilities while keeping the existing Azure OpenAI API endpoint, state of work, and security configurations.
3434

3535
## References
3636

‎articles/ai-foundry/foundry-models/concepts/models.md‎

Lines changed: 58 additions & 72 deletions
Large diffs are not rendered by default.

‎articles/ai-foundry/how-to/upgrade-azure-openai.md‎

Lines changed: 183 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,183 @@
1+
---
2+
title: Upgrade from Azure OpenAI to Azure AI Foundry
3+
titleSuffix: Azure AI Foundry
4+
description: Upgrade seamlessly from Azure OpenAI to Azure AI Foundry and unlock advanced capabilities like a broader model catalog, agents service, and evaluation tools.
5+
ms.author: sgilley
6+
author: sdgilley
7+
ms.reviewer: deeikele
8+
ms.date: 09/03/2025
9+
ms.service: azure-ai-foundry
10+
ms.topic: how-to
11+
---
12+
13+
# Upgrade from Azure OpenAI to Azure AI Foundry
14+
15+
The Azure AI Foundry resource type offers a superset of capabilities compared to the Azure OpenAI resource type. It enables access to a broader model catalog, agents service, and evaluation capabilities.
16+
17+
An upgrade option is available for you to keep your existing Azure OpenAI API endpoint, state of work, and security configurations, without creating a new Azure AI Foundry resource.
18+
19+
20+
## Benefits of upgrading
21+
22+
Upgrading to Azure AI Foundry unlocks the following capabilities.
23+
24+
|Feature|Azure OpenAI|Azure AI Foundry|
25+
|---|---|---|
26+
| Models sold directly by Azure | Azure OpenAI only | Azure OpenAI, Black Forest Labs, DeepSeek, Meta, xAI, Mistral, Microsoft |
27+
| Partner & Community Models sold through Marketplace - Stability, Bria, Cohere, etc.| | ✅ |
28+
| Azure OpenAI API (batch, stored completions, fine-tuning, evaluation, etc.) | ✅ | ✅ |
29+
| Agent service | | ✅ |
30+
| Azure Foundry API | | ✅ |
31+
| AI Services (Speech, Vision, Language, Content Understanding) | | ✅ |
32+
33+
Your existing resource configurations and state remain preserved including:
34+
35+
* Resource name
36+
* Azure resource tags
37+
* Network configurations
38+
* Access and identity configurations
39+
* API endpoint and API key
40+
* Custom Domain Name
41+
* Existing state including fine-tuning jobs, batch, stored completions, etc.
42+
43+
## Limitations
44+
45+
Backend limitations:
46+
47+
* Azure OpenAI resources using **customer-managed keys** for encryption aren't supported for upgrade.
48+
* The AI Foundry resource type doesn't support configuring Weights & Biases.
49+
50+
Foundry portal limitations:
51+
52+
* The evaluations view doesn't yet support all the capabilities available in the Azure OpenAI evaluations view.
53+
54+
## Support level post-upgrade
55+
56+
The upgrade converts your Azure OpenAI resource type to Azure AI Foundry resource type. Both services are generally available and supported before and after the upgrade. This is an early access feature. If needed, you can [roll back to your previous setup](#rollback-to-azure-openai).
57+
58+
## How to upgrade
59+
60+
As a prerequisite to upgrade, managed identity must be enabled on your Azure OpenAI resource. Upgrade can be completed via the Azure AI Foundry portal or using Azure Bicep or Resource Manager templates.
61+
62+
# [Foundry portal](#tab/portal)
63+
64+
**Option 1: Use Azure AI Foundry portal**
65+
66+
1. Sign in to [Azure AI Foundry](https://ai.azure.com/?cid=learnDocs).
67+
1. Select your Azure OpenAI resource.
68+
1. On the overview page, find the banner **Make the switch to AI Foundry** and select **Switch now.**
69+
1. Provide the name for your first project. A project is a folder to organize your work in Azure AI Foundry. Your first 'default' project has backwards compatibility with your previous work in Azure OpenAI.
70+
1. Confirm to start the upgrade. The upgrade takes up to two minutes.
71+
72+
> [!NOTE]
73+
> While the upgrade capability is rolling out to all users, you might not see the upgrade action yet in the portal for your resource. Use Azure Bicep or wait until you see the banner.
74+
75+
# [Azure Bicep](#tab/bicep)
76+
77+
**Option 2: Use an Azure Bicep template**
78+
79+
Starting with your existing Azure OpenAI template configuration, set the following properties:
80+
81+
* Update kind from value 'OpenAI' => 'AIServices'
82+
* Set allowProjectManagement: True
83+
* Configure managed identity
84+
85+
Sample configuration:
86+
87+
```bicep
88+
resource aiFoundry 'Microsoft.CognitiveServices/accounts@2025-06-01' = {
89+
name: aiFoundryName // Your existing resource name
90+
location: location
91+
identity: {
92+
type: 'SystemAssigned'
93+
}
94+
sku: {
95+
name: 'S0'
96+
}
97+
kind: 'AIServices' // Update from 'OpenAI'
98+
properties: {
99+
// required to work in AI Foundry
100+
allowProjectManagement: true
101+
102+
// Needed for capabilities that require EntraID authentication
103+
customSubDomainName: aiFoundryName
104+
disableLocalAuth: true
105+
}
106+
}
107+
```
108+
109+
Run the template using Azure CLI options or your VS Code extension for Bicep as a patch operation on your current resource.
110+
111+
---
112+
113+
## Rollback to Azure OpenAI
114+
115+
In case you run into any issues, a rollback option is available. As prerequisite to rollback, you're required to delete any of the following configurations first:
116+
117+
* Projects
118+
* Connections
119+
* Non-Azure OpenAI model deployments
120+
121+
Then, use either AI Foundry Portal or ARM template to rollback:
122+
123+
# [Foundry portal](#tab/portal)
124+
125+
**Option 1: Use Azure AI Foundry portal**
126+
127+
1. Navigate to management center in the left bottom of your screen.
128+
1. On your resource overview page, find the rollback option.
129+
1. Select **Rollback**.
130+
131+
:::image type="content" source="../media/upgrade-azure-openai/rollback.png" alt-text="Screenshot shows the rollback option in the Azure AI Foundry portal." lightbox = "../media/upgrade-azure-openai/rollback.png":::
132+
133+
# [Azure Bicep](#tab/bicep)
134+
135+
**Option 2: Use an Azure Bicep template**
136+
137+
To rollback, convert your template configuration back to 'OpenAI' as kind.
138+
139+
```bicep
140+
resource aiFoundry 'Microsoft.CognitiveServices/accounts@2025-06-01' = {
141+
name: aiFoundryName
142+
location: location
143+
identity: {
144+
type: 'SystemAssigned'
145+
}
146+
sku: {
147+
name: 'S0'
148+
}
149+
kind: 'OpenAI'
150+
properties: {
151+
152+
// Defines developer API endpoint subdomain
153+
customSubDomainName: aiFoundryName
154+
disableLocalAuth: true
155+
}
156+
```
157+
158+
Run the template using Azure CLI options or your VS Code extension for Bicep as a patch operation on your current resource.
159+
160+
---
161+
162+
## How to inspect whether a resource has been upgraded
163+
164+
The following Azure resource property is available to inspect whether a resource was previously upgraded to AI Foundry.
165+
166+
```bicep
167+
{
168+
{
169+
// Read only properties if your resource was upgraded:
170+
previouskind: "OpenAI"
171+
}
172+
}
173+
```
174+
175+
Not sure who upgraded your resource to Azure AI Foundry? You can inspect the activity sign in the Azure portal:
176+
177+
1. Use Azure Activity Logs (under "Monitoring") to see if an upgrade operation was performed.
178+
1. Filter by "Write" operations on the storage account.
179+
1. Look for operations listed as `Microsoft.CognitiveServices/accounts/write`.
180+
181+
## Related content
182+
183+
* [Choose an Azure resource type for AI foundry](../concepts/resource-types.md)

‎articles/ai-foundry/media/upgrade-azure-openai/rollback.png‎

86.9 KB
Loading

‎articles/ai-foundry/openai/concepts/models.md‎

Lines changed: 1 addition & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -18,23 +18,7 @@ ms.custom:
1818

1919
# Azure OpenAI in Azure AI Foundry models
2020

21-
Azure OpenAI is powered by a diverse set of models with different capabilities and price points. Model availability varies by region and cloud. For Azure Government model availability, refer to [Azure OpenAI in Azure Government](../azure-government.md).
22-
23-
| Models | Description |
24-
|--|--|
25-
| [`GPT-5 series`](#gpt-5) | **NEW** `gpt-5`, `gpt-5-mini`, `gpt-5-nano`, `gpt-5-chat` |
26-
| [gpt-oss](#gpt-oss) | **NEW** open-weight reasoning models |
27-
| [`codex-mini`](#o-series-models) | Fine-tuned version of o4-mini. |
28-
| [`GPT-4.1 series`](#gpt-41-series) | `gpt-4.1`, `gpt-4.1-mini`, `gpt-4.1-nano` |
29-
| [`model-router`](#model-router) | A model that intelligently selects from a set of underlying chat models to respond to a given prompt. |
30-
| [`computer-use-preview`](#computer-use-preview) | An experimental model trained for use with the Responses API computer use tool. |
31-
| [`o-series models`](#o-series-models) |[`Reasoning models`](../how-to/reasoning.md) with advanced problem solving and increased focus and capability. |
32-
| [`GPT-4o, GPT-4o mini, and GPT-4 Turbo`](#gpt-4o-and-gpt-4-turbo) | Capable Azure OpenAI models with multimodal versions, which can accept both text and images as input. |
33-
| [`GPT-4`](#gpt-4) | A set of models that improve on GPT-3.5 and can understand and generate natural language and code. |
34-
| [`GPT-3.5`](#gpt-35) | A set of models that improve on GPT-3 and can understand and generate natural language and code. |
35-
| [Embeddings](#embeddings) | A set of models that can convert text into numerical vector form to facilitate text similarity. |
36-
| [`Image generation`](#image-generation-models) | A series of models that can generate original images from natural language. |
37-
| [`Audio`](#audio-models) | A series of models for speech to text, translation, and text to speech. GPT-4o audio models support either low latency *speech in, speech out* conversational interactions or audio generation. |
21+
[!INCLUDE [azure-open-ai-models-list](../includes/azure-openai-models-list.md)]
3822

3923
## GPT-5
4024

‎articles/ai-foundry/openai/how-to/model-router.md‎

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -20,9 +20,6 @@ Use model router through the Completions API like you use a single base model su
2020

2121
## Deploy a model router model
2222

23-
> [!NOTE]
24-
> The latest version of model router is currently limited access only. You can request access using the `gpt-5 access` form: [gpt-5 limited access model application](https://aka.ms/oai/gpt5access). If you already have `o3 access` no request is required.
25-
2623
Model router is packaged as a single Azure AI Foundry model that you deploy. Follow the steps in the [resource deployment guide](/azure/ai-foundry/openai/how-to/create-resource). In the **Create new deployment** step, find `model-router` in the **Models** list. Select it, and then complete the rest of the deployment steps.
2724

2825
> [!NOTE]

‎articles/ai-foundry/openai/includes/azure-openai-models-list.md‎

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
---
2+
manager: nitinme
3+
author: mrbullwinkle
4+
ms.author: mbullwin
5+
ms.service: azure-ai-openai
6+
ms.topic: include
7+
ms.date: 09/03/2025
8+
---
9+
10+
Azure OpenAI is powered by a diverse set of models with different capabilities and price points. Model availability varies by region and cloud. For Azure Government model availability, refer to [Azure OpenAI in Azure Government](../azure-government.md).
11+
12+
| Models | Description |
13+
|--|--|
14+
| [GPT-5 series](../concepts/models.md#gpt-5) | **NEW** gpt-5, gpt-5-mini, gpt-5-nano, gpt-5-chat |
15+
| [gpt-oss](../concepts/models.md#gpt-oss) | **NEW** open-weight reasoning models |
16+
| [codex-mini](../concepts/models.md#o-series-models) | Fine-tuned version of o4-mini. |
17+
| [GPT-4.1 series](../concepts/models.md#gpt-41-series) | gpt-4.1, gpt-4.1-mini, gpt-4.1-nano |
18+
| [model-router](../concepts/models.md#model-router) | A model that intelligently selects from a set of underlying chat models to respond to a given prompt. |
19+
| [computer-use-preview](../concepts/models.md#computer-use-preview) | An experimental model trained for use with the Responses API computer use tool. |
20+
| [o-series models](../concepts/models.md#o-series-models) |[Reasoning models](../how-to/reasoning.md) with advanced problem solving and increased focus and capability. |
21+
| [GPT-4o, GPT-4o mini, and GPT-4 Turbo](../concepts/models.md#gpt-4o-and-gpt-4-turbo) | Capable Azure OpenAI models with multimodal versions, which can accept both text and images as input. |
22+
| [GPT-4](../concepts/models.md#gpt-4) | A set of models that improve on GPT-3.5 and can understand and generate natural language and code. |
23+
| [GPT-3.5](../concepts/models.md#gpt-35) | A set of models that improve on GPT-3 and can understand and generate natural language and code. |
24+
| [Embeddings](../concepts/models.md#embeddings) | A set of models that can convert text into numerical vector form to facilitate text similarity. |
25+
| [Image generation](../concepts/models.md#image-generation-models) | A series of models that can generate original images from natural language. |
26+
| [Audio](../concepts/models.md#audio-models) | A series of models for speech to text, translation, and text to speech. GPT-4o audio models support either low latency *speech in, speech out* conversational interactions or audio generation. |

‎articles/ai-foundry/openai/overview.md‎

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -146,6 +146,7 @@ The audio API models can be used to transcribe and translate speech to text. The
146146

147147
Learn more about each model on our [models concept page](./concepts/models.md).
148148

149-
## Next steps
149+
## Related content
150150

151-
Learn more about the [underlying models that power Azure OpenAI](./concepts/models.md).
151+
- Learn more about the [underlying models that power Azure OpenAI](./concepts/models.md).
152+
- [Upgrade from Azure OpenAI to Azure AI Foundry](../how-to/upgrade-azure-openai.md)

‎articles/ai-foundry/toc-files/models/toc.yml‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -105,6 +105,8 @@ items:
105105
items:
106106
- name: Azure OpenAI
107107
href: ../../openai/overview.md
108+
- name: Upgrade from Azure OpenAI Service
109+
href: ../../how-to/upgrade-azure-openai.md
108110
- name: Quotas and limits
109111
href: ../../openai/quotas-limits.md
110112
displayName: openai

0 commit comments

Comments
 (0)