Merging changes synced from https://github.com/MicrosoftDocs/azure-ai-docs-pr (branch live)

Author: Learn Build Service GitHub App

articles/ai-foundry/agents/concepts/threads-runs-messages.md

@@ -14,6 +14,8 @@ ms.custom: azure-ai-agents
 
 # Threads, runs, and messages in Foundry Agent Service
 
+[!INCLUDE [classic-banner](../../includes/classic-banner.md)]
+
 Foundry Agent Service supports persistent threads, runs, and messages, which are essential components for managing conversation states and interactions with users.
 
 ## Agent components

articles/ai-foundry/agents/how-to/connected-agents.md

@@ -16,6 +16,8 @@ zone_pivot_groups: selection-connected-agents
 
 # Build collaborative, multi-agent systems with Connected Agents
 
+[!INCLUDE [classic-banner](../../includes/classic-banner.md)]
+
 > [!NOTE]
 > This tool is only available in `2025-05-15-preview` API. We highly recommend you to migrate to use the `2025-11-15-preview` API version [workflows](../../default/agents/concepts/workflow.md) for multi-agent orchestration.
 

articles/ai-foundry/agents/how-to/tools/azure-ai-search-samples.md

@@ -7,7 +7,7 @@ manager: nitinme
 ms.service: azure-ai-foundry
 ms.subservice: azure-ai-foundry-agent-service
 ms.topic: how-to
-ms.date: 11/06/2025
+ms.date: 11/20/2025
 author: haileytap
 ms.author: haileytapia
 ms.reviewer: aahi
@@ -18,7 +18,7 @@ zone_pivot_groups: selection-azure-ai-search
 # How to use an existing index with the Azure AI Search tool
 
 > [!NOTE]
-> There are new ways to add knowledge to your agent. For the latest recommended approach, see [Connect a Foundry IQ knowledge base to Foundry Agent Service](../../../default/agents/how-to/tools/knowledge-retrieval.md).
+> Code uses **Agents v1 API** and is incompatible with Agents v2 (preview). Switch to [Foundry (new)](../../../default/agents/how-to/tools/ai-search.md) for the Agents v2 API (preview) version.
 
 This article explains how to use an existing search index with the [Azure AI Search](/azure/search/search-what-is-azure-search) tool.
 

articles/ai-foundry/agents/how-to/tools/azure-ai-search.md

@@ -7,7 +7,7 @@ manager: nitinme
 ms.service: azure-ai-foundry
 ms.subservice: azure-ai-foundry-agent-service
 ms.topic: how-to
-ms.date: 11/04/2025
+ms.date: 11/20/2025
 author: haileytap
 ms.author: haileytapia
 ms.reviewer: aahi
@@ -17,7 +17,7 @@ ms.custom: azure-ai-agents
 # Azure AI Search tool
 
 > [!NOTE]
-> There are new ways to add knowledge to your agent. For the latest recommended approach, see [Connect a Foundry IQ knowledge base to Foundry Agent Service](../../../default/agents/how-to/tools/knowledge-retrieval.md).
+> Code uses **Agents v1 API** and is incompatible with Agents v2 (preview). Switch to [Foundry (new)](../../../default/agents/how-to/tools/ai-search.md) for the Agents v2 API (preview) version.
 
 The [Azure AI Search](/azure/search/search-what-is-azure-search) tool in Agent Service connects an agent to a new or existing search index. You can use this tool to retrieve and summarize your indexed documents, grounding the agent's responses in your proprietary content.
 

articles/ai-foundry/agents/how-to/tools/azure-functions-samples.md

@@ -7,7 +7,7 @@ manager: nitinme
 ms.service: azure-ai-foundry
 ms.subservice: azure-ai-foundry-agent-service
 ms.topic: how-to
-ms.date: 11/06/2025
+ms.date: 11/20/2025
 author: aahill
 ms.author: aahi
 ms.custom: azure-ai-agents
@@ -16,6 +16,9 @@ zone_pivot_groups: selection-azure-functions-samples
 
 # How to use queue-based Azure Functions with Azure AI Foundry agents
 
+> [!NOTE]
+> This document refers to the agents v1 API. Azure Functions are currently not supported in the agents v2 API (preview).
+
 This article shows how to use a queue-based integrated tool approach to enable Azure AI Foundry agents to access code deployed to Azure Functions. In this approach, agents access tool code asynchronously in Azure Functions by means of separate input and output message queues in Azure Queue storage. 
 
 AI Foundry agents connect directly to the input queue monitored by Azure Functions by using a tool definition provided by `AzureFunctionsTool`. When an agent needs to use this Azure Functions hosted tool, it uses the tool definition to place a message in an input queue that's monitored by the function app in Azure Functions. An Azure Storage queue trigger invokes the function code to process the message and return a result through an output queue binding. The agent reads the message from the output queue to continue the conversation. 

articles/ai-foundry/agents/how-to/tools/azure-functions.md

@@ -7,14 +7,18 @@ manager: nitinme
 ms.service: azure-ai-foundry
 ms.subservice: azure-ai-foundry-agent-service
 ms.topic: how-to
-ms.date: 11/04/2025
+ms.date: 11/20/2025
 author: aahill
 ms.author: aahi
 ms.custom: azure-ai-agents
 ---
 
 # Use Azure Functions with Azure AI Foundry Agent Service
 
+> [!NOTE]
+> This document refers to the agents v1 API. Azure Functions are currently not supported in the agents v2 API (preview).
+
+
 [Azure Functions](/azure/azure-functions/functions-overview) is a serverless compute service that you can use to extend your Foundry Agent Service agents with custom tools built using code. This approach is especially useful when you need your agent to integrate with systems within your enterprise.
 
 Functions offer several hosting plans. The [Flex Consumption plan](/azure/azure-functions/flex-consumption-plan) is ideal for hosting your custom tools because it provides:

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

@@ -7,7 +7,7 @@ manager: nitinme
 ms.service: azure-ai-foundry
 ms.subservice: azure-ai-foundry-agent-service
 ms.topic: how-to
-ms.date: 09/09/2025
+ms.date: 11/20/2025
 author: aahill
 ms.author: aahi
 zone_pivot_groups: selection-bing-grounding-code
@@ -16,6 +16,9 @@ ms.custom: azure-ai-agents-code
 
 # How to use Grounding with Bing Search
 
+> [!NOTE]
+> Code uses **Agents v1 API** and is incompatible with Agents v2 (preview). Switch to [Foundry (new)](../../../default/agents/how-to/tools/bing-tools.md) for the Agents v2 API (preview) version.
+
 Use this article to find step-by-step instructions and code samples for Grounding with Bing search.
 
 ## Prerequisites

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

@@ -17,6 +17,10 @@ zone_pivot_groups: selection-bing-custom-grounding
 
 # How to use Grounding with Bing Custom Search (preview)
 
+> [!NOTE]
+> Code uses **Agents v1 API** and is incompatible with Agents v2 (preview). Switch to [Foundry (new)](../../../default/agents/how-to/tools/bing-tools.md) for the Agents v2 API (preview) version.
+
+
 Use this article to find step-by-step instructions and code samples for using the Grounding with Bing Custom Search tool in the Foundry Agent Service.
 
 ::: zone pivot="portal"

articles/ai-foundry/agents/how-to/tools/bing-custom-search.md

@@ -15,6 +15,9 @@ ms.custom: azure-ai-agents
 
 # Grounding with Bing Custom Search (preview)
 
+> [!NOTE]
+> Code uses **Agents v1 API** and is incompatible with Agents v2 (preview). Switch to [Foundry (new)](../../../default/agents/how-to/tools/bing-tools.md) for the Agents v2 API (preview) version.
+
 Grounding with Bing Custom Search tool allows your Azure AI Agents to search within a configurable set of public web domains. It allows you to define the parts of the web you want to draw from so users only see relevant results from the domains and subdomains of your choosing. You need to first create a Grounding with Bing Custom Search resource in Azure portal. 
 
 Once the resource is deployed, go to **Configurations** in the Microsoft Foundry portal, and create a configuration instance to include content only from websites that your users care about. Instructions about how to create your custom configuration can be found in the [setup section](#setup).

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

@@ -13,8 +13,12 @@ ms.author: aahi
 ms.custom: azure-ai-agents
 ---
 
+
 # Grounding with Bing Search 
 
+> [!NOTE]
+> Code uses **Agents v1 API** and is incompatible with Agents v2 (preview). Switch to [Foundry (new)](../../../default/agents/how-to/tools/bing-tools.md) for the Agents v2 API (preview) version.
+
 **Grounding with Bing Search** allows your Azure AI Agents to incorporate real-time public web data when generating responses. You need to create a Grounding with Bing Search resource, and then connect this resource to your Azure AI Agents. When a user sends a query, Azure AI Agents decide if Grounding with Bing Search should be used or not. If so, it uses Bing to search over public web data and return relevant chunks. Lastly, Azure AI Agents will use returned chunks to generate a response.  
 
 You can ask questions such as "*what is the top news today*" or "*what is the recent update in the retail industry in the US?*", which require real-time public data.