Merge pull request #7291 from MicrosoftDocs/main

learn-build-service-prod[bot] · web-flow · commit 6353a0ff5312 · 2025-09-26T05:07:57.000Z
Auto Publish – main to live - 2025-09-26 05:05 UTC
diff --git a/articles/ai-foundry/agents/how-to/tools/azure-ai-search-samples.md b/articles/ai-foundry/agents/how-to/tools/azure-ai-search-samples.md
@@ -464,7 +464,7 @@ for await (const m of messagesIterator) {
 
 :::zone pivot="rest"
 
-+ Completion of the [REST API quickstart](../../quickstart.md?pivots=rest-api#api-call-information) to get values for the `AGENT_TOKEN`, `AZURE_AI_FOUNDRY_PROJECT_ENDPOINT`, and `API_VERSION` environment variables.
++ Completion of the [REST API quickstart](../../quickstart.md?pivots=rest-api) to get values for the `AGENT_TOKEN`, `AZURE_AI_FOUNDRY_PROJECT_ENDPOINT`, and `API_VERSION` environment variables.
 
 ## Get the connection ID for the Azure AI Search resource
 
diff --git a/articles/ai-foundry/agents/how-to/tools/azure-functions-samples.md b/articles/ai-foundry/agents/how-to/tools/azure-functions-samples.md
@@ -176,7 +176,7 @@ For any issues with the Python code, create an issue on the [sample code reposit
 
 In the sample below we create a client and an agent that has the tools definition for the Azure Function
 
-Follow the [REST API Quickstart](../../quickstart.md?pivots=rest-api#api-call-information) to set the right values for the environment variables `AGENT_TOKEN`, `AZURE_AI_FOUNDRY_PROJECT_ENDPOINT` and `API_VERSION`. 
+Follow the [REST API Quickstart](../../quickstart.md?pivots=rest-api) to set the right values for the environment variables `AGENT_TOKEN`, `AZURE_AI_FOUNDRY_PROJECT_ENDPOINT` and `API_VERSION`. 
 
 ```bash
 curl --request POST \
diff --git a/articles/ai-foundry/agents/how-to/tools/bing-code-samples.md b/articles/ai-foundry/agents/how-to/tools/bing-code-samples.md
@@ -423,7 +423,7 @@ if (!firstMessage.done && firstMessage.value) {
 >[!IMPORTANT]
 > 1. This REST API allows developers to invoke the Grounding with Bing Search tool through the Azure AI Foundry Agent Service. It does not send calls to the Grounding with Bing Search API directly. 
 
-Follow the [REST API Quickstart](../../quickstart.md?pivots=rest-api#api-call-information) to set the right values for the environment variables `AGENT_TOKEN`, `AZURE_AI_FOUNDRY_PROJECT_ENDPOINT` and `API_VERSION`.
+Follow the [REST API Quickstart](../../quickstart.md?pivots=rest-api) to set the right values for the environment variables `AGENT_TOKEN`, `AZURE_AI_FOUNDRY_PROJECT_ENDPOINT` and `API_VERSION`.
 
 
 ## Create an Agent with the Grounding with Bing search tool enabled
diff --git a/articles/ai-foundry/agents/how-to/tools/bing-custom-search-samples.md b/articles/ai-foundry/agents/how-to/tools/bing-custom-search-samples.md
@@ -413,7 +413,7 @@ Create a run and observe that the model uses the Grounding with Bing Custom Sear
 > * The following samples are applicable if you are using **Azure AI Foundry Project** resource with Microsoft Fabric tool through REST API call
 > * Your connection ID should be in this format: `/subscriptions/<sub-id>/resourceGroups/<your-rg-name>/providers/Microsoft.CognitiveServices/accounts/<your-ai-services-name>/projects/<your-project-name>/connections/<your-bing-connection-name>`
 
-Follow the [REST API Quickstart](../../quickstart.md?pivots=rest-api#api-call-information) to set the right values for the environment variables `AGENT_TOKEN`, `AZURE_AI_FOUNDRY_PROJECT_ENDPOINT` and `API_VERSION`.
+Follow the [REST API Quickstart](../../quickstart.md?pivots=rest-api) to set the right values for the environment variables `AGENT_TOKEN`, `AZURE_AI_FOUNDRY_PROJECT_ENDPOINT` and `API_VERSION`.
 
 
 ## Create an Agent with the Grounding with Bing Custom Search tool enabled
diff --git a/articles/ai-foundry/agents/how-to/tools/code-interpreter-samples.md b/articles/ai-foundry/agents/how-to/tools/code-interpreter-samples.md
@@ -432,7 +432,7 @@ console.log(`Saved image file to: ${imageFileName}`);
 
 :::zone pivot="rest-api" 
 
-Follow the [REST API Quickstart](../../quickstart.md?pivots=rest-api#api-call-information) to set the right values for the environment variables `AGENT_TOKEN`, `AZURE_AI_FOUNDRY_PROJECT_ENDPOINT` and `API_VERSION`.
+Follow the [REST API Quickstart](../../quickstart.md?pivots=rest-api) to set the right values for the environment variables `AGENT_TOKEN`, `AZURE_AI_FOUNDRY_PROJECT_ENDPOINT` and `API_VERSION`.
 
 ## Upload a file 
 
diff --git a/articles/ai-foundry/agents/how-to/tools/fabric.md b/articles/ai-foundry/agents/how-to/tools/fabric.md
@@ -397,7 +397,7 @@ for await (const m of messagesIterator) {
 -->
 :::zone pivot="rest"
 
-Follow the [REST API Quickstart](../../quickstart.md?pivots=rest-api#api-call-information) to set the right values for the environment variables `AGENT_TOKEN`, `AZURE_AI_FOUNDRY_PROJECT_ENDPOINT` and `API_VERSION`. For `API_VERSION`, make sure you are using `2025-05-15-preview`.
+Follow the [REST API Quickstart](../../quickstart.md?pivots=rest-api) to set the right values for the environment variables `AGENT_TOKEN`, `AZURE_AI_FOUNDRY_PROJECT_ENDPOINT` and `API_VERSION`. For `API_VERSION`, make sure you are using `2025-05-15-preview`.
 > [!IMPORTANT]
 > The following samples are applicable if you are using **Azure AI Foundry Project** resource with Microsoft Fabric tool through REST API call
 > Your connection ID should be in this format: `/subscriptions/<sub-id>/resourceGroups/<your-rg-name>/providers/Microsoft.CognitiveServices/accounts/<your-ai-services-name>/projects/<your-project-name>/connections/<your-fabric-connection-name>`
diff --git a/articles/ai-foundry/agents/how-to/tools/file-search-upload-files.md b/articles/ai-foundry/agents/how-to/tools/file-search-upload-files.md
@@ -470,7 +470,7 @@ console.log(`Deleted agent, agent ID: ${agent.id}`);
 
 To access your files, the file search tool uses the vector store object. Upload your files and create a vector store. After creating the vector store, poll its status until all files are out of the in_progress state to ensure that all content is fully processed. The SDK provides helpers for uploading and polling.
 
-Follow the [REST API Quickstart](../../quickstart.md?pivots=rest-api#api-call-information) to set the right values for the environment variables `AGENT_TOKEN`, `AZURE_AI_FOUNDRY_PROJECT_ENDPOINT` and `API_VERSION`.
+Follow the [REST API Quickstart](../../quickstart.md?pivots=rest-api) to set the right values for the environment variables `AGENT_TOKEN`, `AZURE_AI_FOUNDRY_PROJECT_ENDPOINT` and `API_VERSION`.
 
 ### Upload a file
 
diff --git a/articles/ai-foundry/agents/how-to/tools/function-calling.md b/articles/ai-foundry/agents/how-to/tools/function-calling.md
@@ -586,7 +586,7 @@ Start by defining a function for your agent to call. When you create a function
 
 ## Create an agent
 
-Follow the [REST API Quickstart](../../quickstart.md?pivots=rest-api#api-call-information) to set the right values for the environment variables `AGENT_TOKEN`, `AZURE_AI_FOUNDRY_PROJECT_ENDPOINT` and `API_VERSION`.
+Follow the [REST API Quickstart](../../quickstart.md?pivots=rest-api) to set the right values for the environment variables `AGENT_TOKEN`, `AZURE_AI_FOUNDRY_PROJECT_ENDPOINT` and `API_VERSION`.
 
 ```bash
 curl --request POST \
diff --git a/articles/ai-foundry/agents/how-to/tools/model-context-protocol-samples.md b/articles/ai-foundry/agents/how-to/tools/model-context-protocol-samples.md
@@ -335,7 +335,7 @@ with project_client:
 
 :::zone pivot="rest"
 
-Follow the [REST API quickstart](../../quickstart.md?pivots=rest-api#api-call-information) to set the right values for the environment variables `AGENT_TOKEN`, `AZURE_AI_FOUNDRY_PROJECT_ENDPOINT`, and `API_VERSION`.
+Follow the [REST API quickstart](../../quickstart.md?pivots=rest-api) to set the right values for the environment variables `AGENT_TOKEN`, `AZURE_AI_FOUNDRY_PROJECT_ENDPOINT`, and `API_VERSION`.
 
 ## Create an agent with the MCP tool enabled
 
diff --git a/articles/ai-foundry/agents/how-to/tools/openapi-spec-samples.md b/articles/ai-foundry/agents/how-to/tools/openapi-spec-samples.md
@@ -383,7 +383,7 @@ client.Administration.DeleteAgent(agent.Id);
 
 :::zone pivot="rest-api"
 
-Follow the [REST API Quickstart](../../quickstart.md?pivots=rest-api#api-call-information) to set the right values for the environment variables `AGENT_TOKEN`, `AZURE_AI_FOUNDRY_PROJECT_ENDPOINT` and `API_VERSION`.
+Follow the [REST API Quickstart](../../quickstart.md?pivots=rest-api) to set the right values for the environment variables `AGENT_TOKEN`, `AZURE_AI_FOUNDRY_PROJECT_ENDPOINT` and `API_VERSION`.
 
 ## Create the OpenAPI Spec tool definition, agent, and thread
  
diff --git a/articles/ai-foundry/agents/how-to/tools/sharepoint-samples.md b/articles/ai-foundry/agents/how-to/tools/sharepoint-samples.md
@@ -134,7 +134,7 @@ for msg in messages:
 
 ## Create an agent
 
-Follow the [REST API Quickstart](../../quickstart.md?pivots=rest-api#api-call-information) to set the right values for the environment variables `AGENT_TOKEN`, `AZURE_AI_FOUNDRY_PROJECT_ENDPOINT` and `API_VERSION`.
+Follow the [REST API Quickstart](../../quickstart.md?pivots=rest-api) to set the right values for the environment variables `AGENT_TOKEN`, `AZURE_AI_FOUNDRY_PROJECT_ENDPOINT` and `API_VERSION`.
 
 ```bash
 curl --request POST \
diff --git a/articles/ai-foundry/agents/includes/quickstart-csharp.md b/articles/ai-foundry/agents/includes/quickstart-csharp.md
@@ -16,14 +16,6 @@ ms.date: 08/29/2025
 
 ## Configure and run an agent
 
-| Component | Description                                                                                                                                                                                                                               |
-| --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Agent     | Custom AI that uses AI models in conjunction with tools.                                                                                                                                                                                  |
-| Tool      | Tools help extend an agent’s ability to reliably and accurately respond during conversation. Such as connecting to user-defined knowledge bases to ground the model, or enabling web search to provide current information.               |
-| Thread    | A conversation session between an agent and a user. Threads store Messages and automatically handle truncation to fit content into a model’s context.                                                                                     |
-| Message   | A message created by an agent or a user. Messages can include text, images, and other files. Messages are stored as a list on the Thread.                                                                                                 |
-| Run       | Activation of an agent to begin running based on the contents of Thread. The agent uses its configuration and Thread’s Messages to perform tasks by calling models and tools. As part of a Run, the agent appends Messages to the Thread. |
-
 Create a .NET Console project.
 
 ```console
diff --git a/articles/ai-foundry/agents/includes/quickstart-java.md b/articles/ai-foundry/agents/includes/quickstart-java.md
@@ -5,7 +5,7 @@ ms.author: aahi
 ms.service: azure-ai-foundry
 ms.subservice: azure-ai-foundry-agent-service
 ms.topic: include
-ms.date: 08/07/2025
+ms.date: 09/25/2025
 ---
 
 | [Reference documentation](/java/api/overview/azure/ai-agents-persistent-readme) | [Samples](https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/ai/azure-ai-agents-persistent/src/samples/java/com/azure/ai/agents/persistent) | [Library source code](https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/ai/azure-ai-agents-persistent) | [Package (Maven)](https://central.sonatype.com/artifact/com.azure/azure-ai-agents-persistent) |
@@ -16,15 +16,7 @@ ms.date: 08/07/2025
 
 ## Configure and run an agent
 
-| Component | Description                                                                                                                                                                                                                               |
-| --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Agent     | Custom AI that uses AI models in conjunction with tools.                                                                                                                                                                                  |
-| Tool      | Tools help extend an agent’s ability to reliably and accurately respond during conversation. Such as connecting to user-defined knowledge bases to ground the model, or enabling web search to provide current information.               |
-| Thread    | A conversation session between an agent and a user. Threads store Messages and automatically handle truncation to fit content into a model’s context.                                                                                     |
-| Message   | A message created by an agent or a user. Messages can include text, images, and other files. Messages are stored as a list on the Thread.                                                                                                 |
-| Run       | Activation of an agent to begin running based on the contents of Thread. The agent uses its configuration and Thread’s Messages to perform tasks by calling models and tools. As part of a Run, the agent appends Messages to the Thread. |
-
-First, create a New Java console project. You will need the following dependencies to run the code:
+First, create a New Java console project. You'll need the following dependencies to run the code:
     
 ```xml
 <dependencies>
@@ -47,7 +39,7 @@ Next, to authenticate your API requests and run the program, use the [az login](
 az login
 ```
 
-Use the following code to create and run an agent. To run this code, you will need to get the endpoint for your project. This string is in the format:
+Use the following code to create and run an agent. To run this code, you'll need to get the endpoint for your project. This string is in the format:
 
 `https://<AIFoundryResourceName>.services.ai.azure.com/api/projects/<ProjectName>`
 
diff --git a/articles/ai-foundry/agents/includes/quickstart-python.md b/articles/ai-foundry/agents/includes/quickstart-python.md
@@ -5,7 +5,7 @@ ms.author: aahi
 ms.service: azure-ai-foundry
 ms.subservice: azure-ai-foundry-agent-service
 ms.topic: include
-ms.date: 08/29/2025
+ms.date: 09/25/2025
 ---
 
 
@@ -19,15 +19,6 @@ ms.date: 08/29/2025
 
 ## Configure and run an agent
 
-| Component | Description                                                                                                                                                                                                                               |
-| --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Agent     | Custom AI that uses AI models in conjunction with tools.                                                                                                                                                                                  |
-| Tool      | Tools help extend an agent’s ability to reliably and accurately respond during conversation. Such as connecting to user-defined knowledge bases to ground the model, or enabling web search to provide current information.               |
-| Thread    | A conversation session between an agent and a user. Threads store Messages and automatically handle truncation to fit content into a model’s context.                                                                                     |
-| Message   | A message created by an agent or a user. Messages can include text, images, and other files. Messages are stored as a list on the Thread.                                                                                                 |
-| Run       | Activation of an agent to begin running based on the contents of Thread. The agent uses its configuration and Thread’s Messages to perform tasks by calling models and tools. As part of a Run, the agent appends Messages to the Thread. |
-| Run Step  | A detailed list of steps the agent took as part of a Run. An agent can call tools or create Messages during its run. Examining Run Steps allows you to understand how the agent is getting to its results.                                |
-
 Run the following commands to install the python packages.
 
 ```console
diff --git a/articles/ai-foundry/agents/includes/quickstart-rest.md b/articles/ai-foundry/agents/includes/quickstart-rest.md
@@ -5,7 +5,7 @@ ms.author: pranavp
 ms.service: azure-ai-foundry
 ms.subservice: azure-ai-foundry-agent-service
 ms.topic: include
-ms.date: 02/15/2025
+ms.date: 09/25/2025
 ---
 | [Reference documentation](/rest/api/aifoundry/aiagents/) |
 
@@ -17,34 +17,23 @@ ms.date: 02/15/2025
 
 ## Configure and run an agent
 
-| Component | Description                                                                                                                                                                                                                               |
-| --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Agent     | Custom AI that uses AI models in conjunction with tools.                                                                                                                                                                                  |
-| Tool      | Tools help extend an agent’s ability to reliably and accurately respond during conversation. Such as connecting to user-defined knowledge bases to ground the model, or enabling web search to provide current information.               |
-| Thread    | A conversation session between an agent and a user. Threads store Messages and automatically handle truncation to fit content into a model’s context.                                                                                     |
-| Message   | A message created by an agent or a user. Messages can include text, images, and other files. Messages are stored as a list on the Thread.                                                                                                 |
-| Run       | Activation of an agent to begin running based on the contents of Thread. The agent uses its configuration and Thread’s Messages to perform tasks by calling models and tools. As part of a Run, the agent appends Messages to the Thread. |
-| Run Step  | A detailed list of steps the agent took as part of a Run. An agent can call tools or create Messages during its run. Examining Run Steps allows you to understand how the agent is getting to its results.                                |
-
-## API call information
-
 To authenticate your API requests, use the [az login](/cli/azure/authenticate-azure-cli-interactively) command to sign into your Azure subscription.
 
 ```azurecli
 az login
 ```
 
-Next, you will need to fetch the Entra ID token to provide as authorization to the API calls. Fetch the token using the CLI command:
+Next, you'll need to fetch the Entra ID token to provide as authorization to the API calls. Fetch the token using the CLI command:
 ```azurecli
 az account get-access-token --resource 'https://ai.azure.com' | jq -r .accessToken | tr -d '"'
 ```
 Set the access token as an environment variable named `AGENT_TOKEN`.
 
-To successfully make REST API calls to Azure AI Foundry Agent Service, you will need to use the endpoint as below:
+To successfully make REST API calls to Azure AI Foundry Agent Service, you will need to use your project's endpoint:
 
 `https://<your_ai_service_name>.services.ai.azure.com/api/projects/<your_project_name>`
 
-For example, your endpoint may look something like:
+For example, your endpoint will look something like:
 
 `https://exampleaiservice.services.ai.azure.com/api/projects/project`
 
@@ -57,7 +46,7 @@ Set this endpoint as an environment variable named `AZURE_AI_FOUNDRY_PROJECT_END
 ### Create an agent
 
 > [!NOTE]
-> With Azure AI Agents Service the `model` parameter requires model deployment name. If your model deployment name is different than the underlying model name then you would adjust your code to ` "model": "{your-custom-model-deployment-name}"`.
+> With Azure AI Agents Service the `model` parameter requires model deployment name. If your model deployment name is different than the underlying model name, then you would adjust your code to ` "model": "{your-custom-model-deployment-name}"`.
 
 ```console
 curl --request POST \
diff --git a/articles/ai-foundry/agents/includes/quickstart-typescript.md b/articles/ai-foundry/agents/includes/quickstart-typescript.md
diff --git a/articles/ai-foundry/agents/quickstart.md b/articles/ai-foundry/agents/quickstart.md
diff --git a/articles/ai-foundry/concepts/rbac-azure-ai-foundry.md b/articles/ai-foundry/concepts/rbac-azure-ai-foundry.md
diff --git a/articles/ai-foundry/how-to/develop/trace-application.md b/articles/ai-foundry/how-to/develop/trace-application.md
diff --git a/articles/ai-services/speech-service/includes/release-notes/release-notes-cli.md b/articles/ai-services/speech-service/includes/release-notes/release-notes-cli.md
