Merge pull request #8145 from MicrosoftDocs/main

Auto Publish – main to live - 2025-11-04 23:06 UTC

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

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

@@ -6,7 +6,7 @@ manager: nitinme
 ms.service: azure-ai-foundry
 ms.subservice: azure-ai-foundry-agent-service
 ms.topic: how-to
-ms.date: 07/11/2025
+ms.date: 11/04/2025
 author: aahill
 ms.author: aahi
 recommendations: false
@@ -16,7 +16,7 @@ zone_pivot_groups: selection-connected-agents
 
 # Build collaborative, multi-agent systems with Connected Agents
 
-Connected agents in Azure AI Foundry Agent Service let you break down complex tasks into coordinated, specialized roles—without the need for a custom orchestrator or hand-coded routing logic. With this capability, you can design systems where a primary agent intelligently delegates to purpose-built sub-agents, streamlining workflows like customer support, market research, legal summarization, and financial analysis.
+Connected agents in Azure AI Foundry Agent Service let you break down complex tasks into coordinated, specialized roles—without the need for a custom orchestrator or hand-coded routing logic. With this capability, you can design systems where a primary agent intelligently delegates to purpose-built subagents, streamlining workflows like customer support, market research, legal summarization, and financial analysis.
 
 Rather than overloading one agent with too many skills, you can build focused, reusable agents that collaborate seamlessly—scaling both performance and maintainability.
 
@@ -74,7 +74,8 @@ Checks the contract against internal standards or uploaded guidelines to identif
 ## Limitations
 
 * Connected agents cannot call local functions using the function calling tool. We recommend using the [OpenAPI tool](tools\openapi-spec.md) or [Azure Functions](tools\azure-functions.md) instead.
-* It is currently not possible to guarantee citations will be passed from connected agents. You can try using prompt engineering combined with different models to try and improve the possibility that citations will be outputted by the main agent, but results are subject to variability. 
+*  It is currently not possible to guarantee citations will be passed from connected agents. You can try using prompt engineering combined with different models to try and improve the possibility that citations will be outputted by the main agent, but results are subject to variability.
+* Connected agents have a maximum depth of 2. A parent agent can have multiple subagent siblings, but subagents cannot have their own subagents. Exceeding this depth results in an `Assistant Tool Call Depth Error`. 
 
 :::zone pivot="portal"
 
@@ -83,7 +84,7 @@ Checks the contract against internal standards or uploaded guidelines to identif
 
 1. Navigate to the **Agents** page in the portal
 2. Select an existing agent from the list or create a new one.
-3. Scroll down to the **Connected agents** section in the agent's setup panel and select **Add +**.
+3. Scroll down to the **Connected agents** section in the agent's set up panel and select **Add +**.
 
 :::image type="content" source="../media\connected-agents\connected-agents-foundry.png" alt-text="A screenshot of the agents page in the Azure AI Foundry." lightbox="../media\connected-agents\connected-agents-foundry.png":::
 
@@ -93,7 +94,7 @@ Checks the contract against internal standards or uploaded guidelines to identif
    - Add a clear **description** of when and why the connected agent should be invoked. This helps guide the main agent’s decision-making on when to hand off tasks to connected agents during runtime.
 5. Select **Add +**
 6. Repeat steps 3–5 to add additional specialized agents to the main agent.
-7. Once the connected agent(s) appear in the setup panel, scroll up and select **Try in Playground**
+7. Once the connected agents appear in the setup panel, scroll up and select **Try in Playground**
 8. Use test prompts in the Agent Playground to validate that the main agent correctly routes tasks to the connected agents when applicable. For example, if you’ve created a main agent called `research_agent`, which doesn't have any tools configured, and connected an agent named `stock_price_bot`, try a prompt like:
 
     **"What is the current stock price of Microsoft?"**

articles/ai-foundry/agents/how-to/tools/deep-research-samples.md

@@ -574,7 +574,8 @@ with project_client:
 :::zone-end 
 
 > [!NOTE]
-> Limitation: The Deep Research tool is currently recommended only in nonstreaming scenarios. Using it with streaming can work, but it might occasionally time out and is therefore not recommended.
+> * Limitation: The Deep Research tool is currently recommended only in nonstreaming scenarios. Using it with streaming can work, but it might occasionally time out and is therefore not recommended.
+> * Currently, Azure AI Foundry Agent Playground UI only supports starting runs in streaming mode, and as a result, users might experience connection drops and timeouts. Use the supported methods above which uses runs in non-streaming mode.
 
 ## Next steps
 

articles/ai-foundry/agents/how-to/tools/fabric.md

@@ -22,6 +22,9 @@ You need to first build and publish a Fabric data agent and then connect your Fa
 
 ## Usage support
 
+> [!NOTE] 
+> The Fabric data agent only supports user identity authentication. Service Principal Name (SPN) authentication is not supported.
+
 |Azure AI foundry support  | Python SDK |	C# SDK | JavaScript SDK | REST API |Basic agent setup | Standard agent setup |
 |---------|---------|---------|---------|---------|---------|---------|
 | ✔️ | ✔️ |  |  | ✔️ | ✔️ | ✔️ |

articles/ai-foundry/agents/how-to/tools/sharepoint.md

@@ -42,7 +42,9 @@ Customers rely on data security in SharePoint to access, create, and share docum
 
 > [!NOTE]
 > * Supported document types: text data in the following format: `.pdf`, `.docx`, `.ppt`, `.txt`, `.aspx` 
-> * We recommend you start with SharePoint sites that have: a simple folder structure and a small number of short documents. 
+> > * We recommend you start with SharePoint sites that have: a simple folder structure and a small number of short documents.
+> * The SharePoint tool only supports user identity authentication. Service Principal Name (SPN) authentication is not supported.
+> * Your SharePoint site and Azure AI Foundry agent need to be in the same tenant.
 
 1. Create an agent by following the steps in the [quickstart](../../quickstart.md).
 

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

@@ -8,7 +8,7 @@ ms.service: azure-ai-foundry
 ms.subservice: azure-ai-foundry-openai
 ms.custom: build-2023, build-2023-dataai, devx-track-python
 ms.topic: how-to
-ms.date: 09/01/2025
+ms.date: 11/04/2025
 manager: nitinme
 keywords: ChatGPT
 ---