Merge pull request #7278 from MicrosoftDocs/main

Auto Publish – main to live - 2025-09-25 17:11 UTC

Author: learn-build-service-prod[bot]

articles/ai-foundry/index.yml

@@ -44,7 +44,7 @@ productDirectory:
       links:
         - url: /azure/developer/ai/intelligent-app-templates
           text: Start with an AI template
-        - url: ./quickstarts/get-started-code.md
+        - url: ./how-to/develop/ai-template-get-started.md
           text: Quickstart for Azure AI Foundry
     # Card
     - title: Azure AI Foundry Models

articles/ai-foundry/openai/how-to/codex.md

@@ -69,7 +69,7 @@ codex --version # verify installation
     ```text
     model = "gpt-5-codex"  # Replace with your actual Azure model deployment name
     model_provider = "azure"
-    model_reasoning_effort = "high"
+    model_reasoning_effort = "medium"
     
     [model_providers.azure]
     name = "Azure OpenAI"

articles/ai-foundry/openai/how-to/responses.md

@@ -48,6 +48,7 @@ The responses API is currently available in the following regions:
 - `gpt-5-mini` (Version: `2025-08-07`)
 - `gpt-5-nano` (Version: `2025-08-07`)
 - `gpt-5-chat` (Version: `2025-08-07`)
+- `gpt-5-codex` (Version: `2025-09-15`)
 - `gpt-4o` (Versions: `2024-11-20`, `2024-08-06`, `2024-05-13`)
 - `gpt-4o-mini` (Version: `2024-07-18`)
 - `computer-use-preview`

articles/ai-services/.openpublishing.redirection.ai-services.json

@@ -2829,6 +2829,11 @@
       "source_path_from_root": "/articles/ai-services/qnamaker/tutorials/integrate-with-power-virtual-assistant-fallback-topic.md",
       "redirect_url": "/azure/ai-services/language-service/tutorials/power-automate",
       "redirect_document_id": true
+    },
+    {
+      "source_path_from_root": "/articles/ai-services/language-service/conversational-language-understanding/how-to/configure-azure-resources.md",
+      "redirect_url": "/azure/ai-services/language-service/concepts/configure-azure-resources",
+      "redirect_document_id": true
     }
 
   ]

articles/ai-services/language-service/conversational-language-understanding/how-to/configure-azure-resources.md renamed to articles/ai-services/language-service/concepts/configure-azure-resources.md

@@ -11,7 +11,7 @@ ms.custom: language-service-question-answering
 
 # Configure your environment for Azure AI resources and permissions
 
-In this guide, we walk you through configuring your Azure AI resources and permissions for conversational language understanding (CLU) projects. We present two options:
+In this guide, we walk you through configuring your Azure AI resources and permissions for Azure AI Foundry tasks. We present two options:
 
 * [**Option 1: Configure an Azure AI Foundry resource**](#option-1-configure-an-azure-ai-foundry-resource). Azure AI Foundry offers a unified environment for building generative AI applications and using Azure AI services. All essential tools are together in one environment for all stages of AI app development.
 
@@ -26,8 +26,8 @@ In addition, we show you how to assign the correct roles and permissions within
 Before you can set up your resources, you need:
 
 * **An active Azure subscription**. If you don't have one, you can [create one for free](https://azure.microsoft.com/free/cognitive-services).
-* **Requisite permissions**. Make sure the person establishing the account and project is assigned as the Azure AI Account Owner role at the subscription level. Alternatively, having either the **Contributor** or **Cognitive Services Contributor** role at the subscription scope also meets this requirement. For more information, *see* [Role based access control (RBAC)](../../../openai/how-to/role-based-access-control.md#cognitive-services-contributor).
-* An [Azure AI Foundry resource](../../../multi-service-resource.md) or an [Azure AI Language resource](https://portal.azure.com/?Microsoft_Azure_PIMCommon=true#create/Microsoft.CognitiveServicesTextAnalytics).
+* **Requisite permissions**. Make sure the person establishing the account and project is assigned as the Azure AI Account Owner role at the subscription level. Alternatively, having either the **Contributor** or **Cognitive Services Contributor** role at the subscription scope also meets this requirement. For more information, *see* [Role based access control (RBAC)](/azure/ai-foundry/openai/how-to/role-based-access-control#cognitive-services-contributor).
+* An [Azure AI Foundry resource](/azure/ai-services/multi-service-resource) or an [Azure AI Language resource](https://portal.azure.com/?Microsoft_Azure_PIMCommon=true#create/Microsoft.CognitiveServicesTextAnalytics).
 
 * An [Azure OpenAI resource](https://portal.azure.com/#create/Microsoft.CognitiveServicesOpenAI) (optional but required for [option 2](#option-2-configure-azure-language-resource-and-azure-openai-resources))
 
@@ -37,29 +37,29 @@ Before you can set up your resources, you need:
 
 ## Option 1: Configure an Azure AI Foundry resource
 
-Azure AI Foundry offers a unified platform for building, managing, and deploying AI solutions with a wide array of models and tools. With this integration, you gain access to features like **Quick Deploy** for rapid model **fine-tuning** and **suggest utterances** to expand your training data with generative AI. New features are continually added, making Azure AI Foundry the recommended choice for scalable CLU solutions.
+Azure AI Foundry offers a unified platform for building, managing, and deploying AI solutions with a wide array of models and tools. With this integration, you gain access to features like **Quick Deploy** for rapid model **fine-tuning** and **suggest utterances** to expand your training data with generative AI. New features are continually added, making Azure AI Foundry is the recommended choice for scalable solutions.
 
 1. Navigate to the [Azure portal](https://azure.microsoft.com/#home).
 
 1. Go to your Azure AI Foundry resource (select **All resources** to locate your resource).
 
 1. Next, select **Access Control (IAM)** on the left panel, then select **Add role assignment**.
 
-   :::image type="content" source="../media/configure-resources/add-role-assignment.png" alt-text="Screenshot of add role assignment selector in the Azure portal.":::
+   :::image type="content" source="../conversational-language-understanding/media/configure-resources/add-role-assignment.png" alt-text="Screenshot of add role assignment selector in the Azure portal.":::
 
 1. Search and select the **Cognitive Services User** role. Select **Next**.
 
-   :::image type="content" source="../media/configure-resources/cognitive-services-user.png" alt-text="Screenshot of Cognitive Services User from the job function roles list in the Azure portal.":::
+   :::image type="content" source="../conversational-language-understanding/media/configure-resources/cognitive-services-user.png" alt-text="Screenshot of Cognitive Services User from the job function roles list in the Azure portal.":::
 
 1. Navigate to the **Members** tab and then select **Managed Identity**.
 
-   :::image type="content" source="../media/configure-resources/managed-identity.png" alt-text="Screenshot of assign member access selector in the Azure portal.":::
+   :::image type="content" source="../conversational-language-understanding/media/configure-resources/managed-identity.png" alt-text="Screenshot of assign member access selector in the Azure portal.":::
 
-1. Select **Select members**, then in the right panel, search for and choose your Azure AI Foundry resource (the one you're using for this project), and choose **Select**.
+1. Choose **Select members**, then in the right panel, search for and choose your Azure AI Foundry resource (the one you're using for this project), and choose **Select**.
 
 1. Finally, select **Review + assign** to confirm your selection.
 
-1. Your resources are now set up properly. Continue with setting up the fine-tuning task and continue customizing your CLU project.
+1. Your resources are now set up properly. Proceed with initializing the fine-tuning process and optimizing your AI models and solutions for advanced customization and deployment.
 
 ## Option 2: Configure Azure Language resource and Azure OpenAI resources
 
@@ -73,15 +73,15 @@ Azure OpenAI is a cloud-based solution that brings the advanced capabilities of
 
 1. Next, select **Access Control (IAM)** on the left panel, then select **Add role assignment**.
 
-   :::image type="content" source="../media/configure-resources/add-role-assignment.png" alt-text="Screenshot of add role assignment selector in the Azure portal.":::
+   :::image type="content" source="../conversational-language-understanding/media/configure-resources/add-role-assignment.png" alt-text="Screenshot of add role assignment selector in the Azure portal.":::
 
 1. Search and select the **Cognitive Services User** role, then select **Next**.
 
-   :::image type="content" source="../media/configure-resources/cognitive-services-user.png" alt-text="Screenshot of Cognitive Services User from the job function roles list in the Azure portal.":::
+   :::image type="content" source="../conversational-language-understanding/media/configure-resources/cognitive-services-user.png" alt-text="Screenshot of Cognitive Services User from the job function roles list in the Azure portal.":::
 
 1. Navigate to the **Members** tab and then select **Managed Identity**.
 
-   :::image type="content" source="../media/configure-resources/managed-identity.png" alt-text="Screenshot of assign member access selector in the Azure portal.":::
+   :::image type="content" source="../conversational-language-understanding/media/configure-resources/managed-identity.png" alt-text="Screenshot of assign member access selector in the Azure portal.":::
 
 1. Select **Select members**, then in the right panel, search for and choose your Azure AI Foundry resource (the one you're using for this project), and choose **Select**.
 
@@ -98,12 +98,12 @@ Azure AI Foundry offers a unified platform where you can easily build, manage, a
 
 1. Scroll to the **Connected resources** section of the Management center.
 
-    :::image type="content" source="../media/configure-resources/ai-foundry-management-center.png" alt-text="Screenshot of the management center selector in the Azure AI Foundry.":::
+    :::image type="content" source="../conversational-language-understanding/media/configure-resources/ai-foundry-management-center.png" alt-text="Screenshot of the management center selector in the Azure AI Foundry.":::
 
 
 1. Select the  **+ New connection** button.
 
-   :::image type="content" source="../media/configure-resources/new-connection.png" alt-text="Screenshot of the new connection button in the Azure AI Foundry.":::
+   :::image type="content" source="../conversational-language-understanding/media/configure-resources/new-connection.png" alt-text="Screenshot of the new connection button in the Azure AI Foundry.":::
 
 
 1. In the new window, select **Azure AI Language** as the resource type, then find your Azure AI Language resource.
@@ -116,29 +116,29 @@ Azure AI Foundry offers a unified platform where you can easily build, manage, a
 
 1. Select **Add connection**, then select **Close**.
 
-   :::image type="content" source="../media/configure-resources/connect-language-resource.png" alt-text="Screenshot of connect search resource selector in the Azure AI Foundry.":::
+   :::image type="content" source="../conversational-language-understanding/media/configure-resources/connect-language-resource.png" alt-text="Screenshot of connect search resource selector in the Azure AI Foundry.":::
 
 ## Import an existing Azure AI project
 
 Azure AI Foundry allows you to connect to your existing Azure AI services resources. This means you can establish a connection within your Azure AI Foundry project to the Azure AI Language resource where your custom models are stored.
 
-To import an existing Azure AI services project with Azure AI Foundry, you need to create a connection to the Azure AI services resource within your Azure AI Foundry project. For more information, *see* [Connect Azure AI Services projects to Azure AI Foundry](../../../../ai-services/connect-services-ai-foundry-portal.md)
+To import an existing Azure AI services project with Azure AI Foundry, you need to create a connection to the Azure AI services resource within your Azure AI Foundry project. For more information, *see* [Connect Azure AI Services projects to Azure AI Foundry](/azure/ai-services/connect-services-ai-foundry-portal)
 
 ## Export a project
 
-You can download a CLU project as a **config.json** file:
+You can download a project as a **config.json** file:
 
 1. Navigate to your project home page.
 1. At the top of the page, select your project from the right page ribbon area.
 1. Select **Download config file**.
 
-    :::image type="content" source="../media/create-project/download-config-json.png" alt-text="Screenshot of project drop-down menu with the download config file hyperlink in the Azure AI Foundry.":::
+    :::image type="content" source="../conversational-language-understanding/media/create-project/download-config-json.png" alt-text="Screenshot of project drop-down menu with the download config file hyperlink in the Azure AI Foundry.":::
 
 
 
 That's it! Your resources are now set up properly. Continue with setting up the fine-tuning task and customizing your CLU project.
 
 ## Next Steps
 
-[Create a CLU fine-tuning task](train-model.md#train-your-model)
+[Model lifecycle](../concepts/model-lifecycle.md)
 

articles/ai-services/language-service/concepts/developer-guide.md

@@ -22,7 +22,7 @@ The Language service provides support through a REST API, and client libraries i
 
 ## Client libraries (Azure SDK)
 
-The Language service provides three namespaces for using the available features. Depending on which features and programming language you're using, you'll need to download one or more of the following packages, and have the following framework/language version support:
+The Language service provides three namespaces for using the available features. Depending on which features and programming language you're using, you need to download one or more of the following packages, and have the following framework/language version support:
 
 |Framework/Language  | Minimum supported version  |
 |---------|---------|
@@ -34,13 +34,13 @@ The Language service provides three namespaces for using the available features.
 ### Azure.AI.TextAnalytics  
 
 >[!NOTE] 
-> If you're using custom named entity recognition or custom text classification, you will need to create a project and train a model before using the SDK. The SDK only provides the ability to analyze text using models you create. See the following quickstarts for information on creating a model. 
+> If you're using custom named entity recognition or custom text classification, you need to create a project and train a model before using the SDK. The SDK only allows for you to analyze text using models you create. See the following quickstarts for information on creating a model. 
 > * [Custom named entity recognition](../custom-named-entity-recognition/quickstart.md)
 > * [Custom text classification](../custom-text-classification/quickstart.md)
 
 The `Azure.AI.TextAnalytics` namespace enables you to use the following Language features. Use the following links for articles to help you send API requests using the SDK.
 
-* [Custom named entity recognition](../custom-named-entity-recognition/how-to/call-api.md?tabs=client#send-an-entity-recognition-request-to-your-model)
+* [Custom named entity recognition](../custom-named-entity-recognition/how-to/call-api.md?tabs=client)
 * [Custom text classification](../custom-text-classification/how-to/call-api.md?tabs=client-libraries#send-a-text-classification-request-to-your-model)
 * [Document summarization](../summarization/quickstart.md)
 * [Entity linking](../entity-linking/quickstart.md)
@@ -63,7 +63,7 @@ As you use these features in your application, use the following documentation a
 ### Azure.AI.Language.Conversations 
 
 > [!NOTE] 
-> If you're using conversational language understanding or orchestration workflow, you'll need to create a project and train a model before using the SDK. The SDK only provides the ability to analyze text using models you create. See the following quickstarts for more information. 
+> If you're using conversational language understanding or orchestration workflow, you need to create a project and train a model before using the SDK. The SDK only allows you to analyze text using models you create. For more information, *see*: 
 > * [Conversational language understanding](../conversational-language-understanding/quickstart.md)
 > * [Orchestration workflow](../orchestration-workflow/quickstart.md)
 
@@ -108,19 +108,19 @@ The conversation analysis authoring API enables you to author custom models and
 * [Conversational language understanding](../conversational-language-understanding/quickstart.md?pivots=rest-api)
 * [Orchestration workflow](../orchestration-workflow/quickstart.md?pivots=rest-api)
 
-As you use this API in your application, see the [reference documentation](/rest/api/language/2023-04-01/conversational-analysis-authoring) for additional information.
+For more information, *see* the [reference documentation](/rest/api/language/2023-04-01/conversational-analysis-authoring).
 
 ### Conversation analysis runtime API
 
-The conversation analysis runtime API enables you to send requests to custom models you've created for:
+The conversation analysis runtime API enables you to send requests to custom models you create for the following features:
 * [Conversational language understanding](../conversational-language-understanding/how-to/call-api.md?tabs=REST-APIs#send-a-conversational-language-understanding-request)
 * [Orchestration workflow](../orchestration-workflow/how-to/call-api.md?tabs=REST-APIs#send-an-orchestration-workflow-request)
 
 It additionally enables you to use the following features, without creating any models:
 * [Conversation summarization](../summarization/quickstart.md?pivots=rest-api&tabs=conversation-summarization)
 * [Personally Identifiable Information (PII) detection for conversations](../personally-identifiable-information/how-to-call-for-conversations.md?tabs=rest-api#examples)
 
-As you use this API in your application, see the [reference documentation](/rest/api/language) for additional information.
+For more information, *see* the [reference documentation](/rest/api/language).
 
 
 ### Text analysis authoring API
@@ -129,11 +129,10 @@ The text analysis authoring API enables you to author custom models and create/m
 * [Custom named entity recognition](../custom-named-entity-recognition/quickstart.md?pivots=rest-api)
 * [Custom text classification](../custom-text-classification/quickstart.md?pivots=rest-api)
 
-As you use this API in your application, see the [reference documentation](/rest/api/language/2023-04-01/text-analysis-authoring) for additional information.
-
+For more information, *see* the [reference documentation](/rest/api/language/2023-04-01/text-analysis-authoring).
 ### Text analysis runtime API
 
-The text analysis runtime API enables you to send requests to custom models you've created for:
+The text analysis runtime API enables you to send requests to custom models you create for the following features:
 
 * [Custom named entity recognition](../custom-named-entity-recognition/quickstart.md?pivots=rest-api)
 * [Custom text classification](../custom-text-classification/quickstart.md?pivots=rest-api)
@@ -148,15 +147,15 @@ It additionally enables you to use the following features, without creating any
 * [Sentiment analysis and opinion mining](../sentiment-opinion-mining/quickstart.md?pivots=rest-api)
 * [Text analytics for health](../text-analytics-for-health/quickstart.md?pivots=rest-api)
 
-As you use this API in your application, see the [reference documentation](https://go.microsoft.com/fwlink/?linkid=2239169) for additional information.
+For more information, *see* the [reference documentation](https://go.microsoft.com/fwlink/?linkid=2239169).
 
 ### Question answering APIs
 
 The question answering APIs enables you to use the [question answering](../question-answering/quickstart/sdk.md?pivots=rest) feature. 
 
 #### Reference documentation
 
-As you use this API in your application, see the following reference documentation for additional information.
+For more information, *see* the following reference documentation:
 
 * [Prebuilt API](/azure/ai-services/language-service/question-answering/how-to/prebuilt) - Use the prebuilt runtime API to answer specified question using text provided by users.
 * [Custom authoring API](/azure/ai-services/language-service/question-answering/how-to/authoring) - Create a knowledge base to answer questions.