Merge pull request #7004 from MicrosoftDocs/main

Auto Publish – main to live - 2025-09-09 22:09 UTC

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

articles/ai-foundry/agents/how-to/tools/bing-code-samples.md

@@ -6,7 +6,7 @@ services: cognitive-services
 manager: nitinme
 ms.service: azure-ai-agent-service
 ms.topic: how-to
-ms.date: 07/11/2025
+ms.date: 09/09/2025
 author: aahill
 ms.author: aahi
 zone_pivot_groups: selection-bing-grounding-code
@@ -173,8 +173,8 @@ using Azure.AI.Agents.Persistent;
 using Azure.Identity;
 
 var projectEndpoint = System.Environment.GetEnvironmentVariable("ProjectEndpoint");
-var projectEndpoint = System.Environment.GetEnvironmentVariable("ModelDeploymentName");
-var projectEndpoint = System.Environment.GetEnvironmentVariable("BingConnectionId");
+var modelDeploymentName = System.Environment.GetEnvironmentVariable("ModelDeploymentName");
+var bingConnectionId = System.Environment.GetEnvironmentVariable("BingConnectionId");
 
 // Create the Agent Client
 PersistentAgentsClient agentClient = new(projectEndpoint, new DefaultAzureCredential());

articles/ai-foundry/concepts/rbac-azure-ai-foundry.md

@@ -99,7 +99,7 @@ Here are the permissions for the **Azure AI User** role:
 ```
 
 > [!NOTE]
-> If only the Azure AI User role is assigned to your user principal and no other Azure built-in roles are assigned, also assign the Reader role on the Azure AI Foundry resource to meet least privilege requirements.
+> If only the Azure AI User role is assigned to your user principal and no other Azure built-in roles are assigned, also assign the Reader role on the Azure AI Foundry resource to view your Foundry resource in the Foundry portal. This only applies to the Foundry Portal UX experience.
 
 ### Azure AI Project Manager
 

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

@@ -56,7 +56,7 @@ The upgrade converts your Azure OpenAI resource type to Azure AI Foundry resourc
 
 ## How to upgrade
 
-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.
+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 (recommended for resource configurations with custom security settings such as private networking).
 
 # [Foundry portal](#tab/portal)
 
@@ -183,6 +183,19 @@ To rollback, convert your template configuration back to 'OpenAI' as kind.
 
 ---
 
+## Troubleshooting Common Issues
+
+Azure resource limits and organizational configurations may require additional steps to complete the upgrade. The table below outlines some of the most common issues along with recommended solutions to help troubleshooting.
+
+|Issue|Solution/mitigation|
+|---|---|
+|User principal lacks account/write permissions|Obtain a privileged Azure RBAC role to manage top-level Azure resources e.g. Owner, Contributor, Azure AI Administrator.| 
+|Managed identity is not enabled on the Azure OpenAI resource|Configure managed identity on your resource via templates or Azure portal.|
+|No permissions to create agents, while you are the owner/contributor on the resource.|An EntraID data plane role is required for development actions including agents. Examples include Azure AI User or Azure AI Project Manager role. Owner and Contributor roles only grant access to management operations in Azure such as managing deployments.|
+|An Azure Policy conflict occurred.|Your organization may have put constraints on resource configurations. Inspect the details of the policy violation error. Then upgrade your resource via template options for further customization. For example, network configurations for Agents can only be configured via template options such as Azure Bicep.|
+|Exceeded number of Azure OpenAI instances of 30 per subscription per region when rolling back.|Delete an Azure OpenAI resource or upgrade it to the Azure AI Foundry. Then retry rolling back your current resource.|
+|Exceeded number of AIServices instances of 100 per subscription per region.|Delete an Azure AI Foundry resource you may not use in this subscription. Then retry upgrading your current resource.|
+
 ## How to inspect whether a resource has been upgraded
 
 The following Azure resource property is available to inspect whether a resource was previously upgraded to AI Foundry.

articles/ai-services/luis/luis-concept-data-alteration.md

@@ -36,9 +36,9 @@ The endpoint requires two params for spelling corrections to work:
 |Param|Value|
 |--|--|
 |`spellCheck`|boolean|
-|`bing-spell-check-subscription-key`|[Bing Spell Check API V7](https://azure.microsoft.com/services/cognitive-services/spell-check/) endpoint key|
+|`bing-spell-check-subscription-key`|[Bing Spell Check API V7](/previous-versions/bing/search-apis/bing-spell-check/reference/endpoints) endpoint key|
 
-When [Bing Spell Check API V7](https://azure.microsoft.com/services/cognitive-services/spell-check/) detects an error, the original utterance, and the corrected utterance are returned along with predictions from the endpoint.
+When [Bing Spell Check API V7](/previous-versions/bing/search-apis/bing-spell-check/reference/endpoints) detects an error, the original utterance, and the corrected utterance are returned along with predictions from the endpoint.
 
 #### [V2 prediction endpoint response](#tab/V2)
 

articles/ai-services/translator/custom-translator/faq.md

@@ -46,7 +46,7 @@ If the number of extracted sentences doesn't match the two files with the same b
 
 ## I tried uploading my Translation Memory Exchange (TMX) file, but it says "document processing failed"
 
-Ensure that the TMX conforms to the [TMX 1.4b Specification](https://www.gala-global.org/tmx-14b).
+Ensure that the TMX conforms to the [TMX 1.4b Specification](https://www.ttt.org/oscarStandards/tmx/tmx14b.html).
 
 ## Next steps
 

articles/machine-learning/component-reference/apply-sql-transformation.md

@@ -73,7 +73,7 @@ Although SQLite supports much of the ANSI SQL standard, it does not include many
 - You can create a VIEW within SQLite, but thereafter views are read-only. You cannot execute a `DELETE`, `INSERT`, or `UPDATE` statement on a view. However, you can create a trigger that fires on an attempt to `DELETE`, `INSERT`, or `UPDATE` on a view and perform other operations in the body of the trigger.  
 
 
-In addition to the list of non-supported functions provided on the official SQLite site, the following wiki provides a list of other unsupported features: [SQLite - Unsupported SQL](http://www2.sqlite.org/cvstrac/wiki?p=UnsupportedSql)  
+In addition to the list of non-supported functions provided on the official SQLite site, the following wiki provides a list of other unsupported features: [SQLite - Unsupported SQL](https://www.sqlite.org/omitted.html)  
 
 ## Next steps
 

articles/machine-learning/concept-designer.md

@@ -8,15 +8,15 @@ ms.topic: concept-article
 ms.author: lagayhar
 ms.reviewer: lagayhar
 author: lgayhardt
-ms.date: 05/21/2024
+ms.date: 09/09/2025
 ms.custom:
   - designer
   - sfi-image-nochange
 ---
 
 # What is Designer (v2) in Azure Machine Learning?
 
-Designer in Azure Machine Learning studio is a drag-and-drop user interface for building machine learning pipelines in Azure Machine Learning workspaces.
+Designer in Azure Machine Learning studio is a drag-and-drop interface for building machine learning pipelines in Azure Machine Learning workspaces.
 
 > [!IMPORTANT]
 > Designer in Azure Machine Learning supports two types of pipelines, which use classic prebuilt (v1) or custom (v2) components. The two component types aren't compatible within pipelines. **This article applies to Designer (v2) with custom components.** 
@@ -31,17 +31,17 @@ The following animated GIF shows how you can build a pipeline visually in Design
 
 ## Asset libraries
 
-Designer uses building blocks from Azure Machine Learning asset libraries to create pipelines. The asset libraries include the following pipeline building blocks:
+Designer creates pipelines using building blocks from Azure Machine Learning asset libraries. The asset libraries include these pipeline building blocks:
 
  - [Data](concept-data.md)
  - [Models](how-to-manage-models.md?view=azureml-api-2&preserve-view=true&tabs=cli)
  - [Components](concept-component.md)
 
-The **Data**, **Model**, and **Component** tabs on the left side of Designer show assets in your workspace and in all Azure Machine Learning [registries](./how-to-share-models-pipelines-across-workspaces-with-registries.md) that you have access to.
+The **Data**, **Model**, and **Component** tabs on the left side of Designer show assets in your workspace and in all Azure Machine Learning [registries](./how-to-share-models-pipelines-across-workspaces-with-registries.md) that you can access.
 
 :::image type="content" source="./media/concept-designer/asset-library.png" alt-text="Screenshot of the asset libraries filtered for one registry." lightbox= "./media/concept-designer/asset-library.png":::
 
-To view assets from specific registries, select the **Registry name** filter. The assets you created in your current workspace are in the **Workspace** registry. The assets provided by Azure Machine Learning are in the **azureml** registry.
+To view assets from specific registries, select the **Registry name** filter. Assets you created in your current workspace are in the **Workspace** registry. Assets provided by Azure Machine Learning are in the **azureml** registry.
 
 To learn how to create data and component assets in your workspace, see the following articles:
 
@@ -50,11 +50,11 @@ To learn how to create data and component assets in your workspace, see the foll
 
 ## Pipelines
 
-You can use Designer to visually build pipelines with your assets. You can either create new pipelines or clone and build on existing pipeline jobs.
+You can use Designer to visually build pipelines with your assets. Create new pipelines or clone and build on existing pipeline jobs.
 
 ### New pipelines
 
-Selecting the **+** symbol under **New pipeline** at the top of the Designer screen creates a new pipeline to build from scratch. Be sure to select the **Custom** option so you can use custom components.
+Select the **+** symbol under **New pipeline** at the top of the Designer screen to create a new pipeline from scratch. Be sure to select the **Custom** option so you can use custom components.
 
 :::image type="content" source="./media/concept-designer/new-pipeline.png" alt-text="Screenshot of selecting new pipeline with custom components." lightbox= "./media/concept-designer/new-pipeline.png":::
 
@@ -70,18 +70,18 @@ You can edit a pipeline draft anytime by adding or removing components, configur
 
 :::image type="content" source="./media/concept-designer/edit-pipeline.png" alt-text="Screenshot of a draft pipeline being edited." lightbox= "./media/concept-designer/edit-pipeline.png":::
 
-A valid pipeline draft has the following characteristics:
+A valid pipeline draft has these characteristics:
 
 - Data assets can connect only to components.
-- Components can connect only to either data assets or to other components.
+- Components can connect only to data assets or to other components.
 - All required input ports for components must have some connection to the data flow.
 - All required parameters for each component must be set.
 
-When you're ready to run your pipeline draft, you save it and submit it as a pipeline job.
+When you're ready to run your pipeline draft, save it and submit it as a pipeline job.
 
 ### Pipeline jobs
 
-Each time you run a pipeline, the pipeline configuration and results are stored in your workspace as a pipeline job. You can resubmit any past pipeline job, inspect it for troubleshooting or auditing, or clone it to create a new pipeline draft for further editing.
+Each time you run a pipeline, the pipeline configuration and results are stored in your workspace as a pipeline job. You can resubmit any past pipeline job, inspect it for troubleshooting or auditing, or clone it to create a new pipeline draft for editing.
 
 :::image type="content" source="./media/concept-designer/pipeline-job.png" alt-text="Screenshot of pipeline job list." lightbox= "./media/concept-designer/pipeline-job.png":::
 
@@ -91,10 +91,10 @@ You can edit and resubmit your pipelines. After submitting, you can see the line
 
 ### Cloned pipeline jobs
 
-If you want to base a new pipeline on an existing pipeline job in the workspace, you can clone the job into a new pipeline draft to continue editing.
+To base a new pipeline on an existing pipeline job in the workspace, clone the job into a new pipeline draft to continue editing.
 
 :::image type="content" source="./media/concept-designer/pipeline-clone.png" alt-text="Screenshot of a pipeline job in the workspace with the clone button highlighted." lightbox= "./media/concept-designer/pipeline-clone.png":::
-After cloning, you can find out which pipeline job the new pipeline was cloned from by selecting **Show lineage**.
+After cloning, you can find which pipeline job the new pipeline was cloned from by selecting **Show lineage**.
 
 :::image type="content" source="./media/concept-designer/draft-show-lineage.png" alt-text="Screenshot showing the draft lineage after selecting Show lineage." lightbox= "./media/concept-designer/draft-show-lineage.png":::