Merge pull request #6076 from aahill/deep-researcher

Deep researcher

Author: prmerger-automator[bot]

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

@@ -50,14 +50,14 @@ Use this article to learn how to use the Deep Research tool with the Azure AI Pr
 
     Save this endpoint to an environment variable named `BING_RESOURCE_NAME`. 
 
-* The names of your `o3-deep-research-model` deployment name and Azure OpenAI GPT model deployment name. You can find them in **Models + Endpoints** in the left navigation menu. 
+* The deployment names of your `o3-deep-research-model` and `gpt-4o` models. You can find them in **Models + Endpoints** in the left navigation menu.
 
-    :::image type="content" source="../../media/tools/deep-research/model-deployments.png" alt-text="A screenshot showing the model deployment screen the AI Foundry portal." lightbox="../../media/tools/deep-research/model-deployments.png":::
+   :::image type="content" source="../../media/tools/deep-research/model-deployments.png" alt-text="A screenshot showing the model deployment screen the AI Foundry portal." lightbox="../../media/tools/deep-research/model-deployments.png":::
     
-    Save the name of your `o3-deep-research-model` deployment name as an environment variable named `DEEP_RESEARCH_MODEL_DEPLOYMENT_NAME` and Azure OpenAI GPT model deployment name as an environment variable named `MODEL_DEPLOYMENT_NAME`. 
+    Save the name of your `o3-deep-research` deployment name as an environment variable named `DEEP_RESEARCH_MODEL_DEPLOYMENT_NAME` and the `gpt-4o` deployment name as an environment variable named `MODEL_DEPLOYMENT_NAME`.
 
 > [!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.
+> Other GPT-series models including GPT-4o-mini and the GPT-4.1 series are not supported for scope clarification.
 
 ## Create an agent with the Deep Research tool
 
@@ -197,6 +197,9 @@ with project_client:
         print("Deleted agent")
 ```
 
+> [!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.
+
 ## Next steps
 
 * [Reference documentation](https://aka.ms/azsdk/azure-ai-projects/python/reference)

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

@@ -47,11 +47,14 @@ The Deep Research tool is supported in the following regions where the deep rese
 |---------|---------|
 | ✔️ | ✔️ | 
 
-## GPT model for clarifying research scope
+## GPT-4o model for clarifying research scope
 
-The Deep Research tool uses a GPT model to clarify the question contained in the user prompt, gather additional context if needed, and precisely scope the research task. This model is deployed during configuration of the Deep Research tool and can be one of the GPT-series models including GPT-4o, **except** the GPT-4.1 family, The 4.1 family is not supported by the Agents service.
+The Deep Research tool uses the `gpt-4o` model to clarify the question contained in the user prompt, gather additional context if needed, and precisely scope the research task. This model is deployed during configuration of the Deep Research tool. 
 
-## Deep research model for deep analysis
+> [!NOTE]
+> Other GPT-series models including GPT-4o-mini and the GPT-4.1 series are not supported for scope clarification.
+
+## Deep research model for analysis
 
 - **Model name**: `o3-deep-research`
 - **Deployment type**: Global Standard
@@ -64,7 +67,7 @@ The Deep Research tool uses a GPT model to clarify the question contained in the
 - [Grounding with Bing Search tool](./bing-grounding.md) resource for connecting to your Azure AI Foundry project.
 - [Model deployments](../../../model-inference/how-to/create-model-deployments.md) for the following models
     - `o3-deep-research` version `2025-06-26`. This model is available in `West US` and `Norway East`.
-    - Any Azure OpenAI GPT model like `gpt-4o` for intent clarification. Deploy in the same regions.
+    - The `gpt-4o` model for intent clarification. Deploy this model in the same region.
 
 ## Research tool setup