Merge pull request #26 from sanjeev3/deep-researcher

Deep research tool overview updates

Author: aahill

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

@@ -12,25 +12,54 @@ ms.topic: how-to
 
 # Deep Research tool (preview)
 
-The Deep Research model in the Azure AI Foundry Agent Service enables you to use an advanced agentic research capability, and integrate it with your data and systems.
+The Deep Research model in the Azure AI Foundry Agent Service enables you to use web-based research capability, and integrate it with your systems.
 
 > [!IMPORTANT]
-> * Deep Research uses **Grounding with Bing Search**. Be sure to read and understand all stipulations of its use, including potential [costs](https://www.microsoft.com/bing/apis/grounding-pricing) that can be incurred, the [terms of use](https://www.microsoft.com/bing/apis/grounding-legal), and [use and display requirements](./bing-grounding.md#how-to-display-grounding-with-bing-search-results). See the [Grounding with Bing Search](./bing-grounding.md) documentation for more information.
-> * Deep Research is not available in Azure OpenAI. 
+> * The Deep Research tool uses **Grounding with Bing Search**. Be sure to read and understand all stipulations of its use, including potential [costs](https://www.microsoft.com/bing/apis/grounding-pricing) that can be incurred, the [terms of use](https://www.microsoft.com/bing/apis/grounding-legal), and [use and display requirements](./bing-grounding.md#how-to-display-grounding-with-bing-search-results). See the [Grounding with Bing Search](./bing-grounding.md) documentation for more information.
+> * The Deep Research tool uses the Azure OpenAI `o3-deep-research` model. This model is not available in Azure OpenAi service.
 
-## Usage support
+> [!NOTE]
+> When using Grounding with Bing Search, only the Bing search query, tool parameters, and your resource key are sent to Bing, and no end user-specific information is included. Your resource key is sent to Bing solely for billing and rate limiting purposes. 
 
+## Usage support
+The deep research tool is a **code-only release** and available for use via the Agents Python SDK once you complete the AI Foundry project setup described in the following sections.
 |Azure AI foundry support  | Python SDK |	C# SDK | JavaScript SDK | REST API |Basic agent setup | Standard agent setup |
 |---------|---------|---------|---------|---------|---------|---------|
 |  | ✔️ |  |  |  | ✔️  | ✔️ |
 
+> [!NOTE]
+> Once the agent is running via code, some elements of the agent and thread runs may show up in the Foundry user interface.
+
+## Knowledge source support
+The deep research tool is tightly integrated with Grounding with Bing Search and only supports web-based research.
+|Grounding with Bing Search|
+|---------|
+| ✔️ | 
+
 ## How Deep Research works
 
-At its core, the Deep Research tool orchestrates a multi-step research pipeline that’s tightly integrated with Grounding with Bing Search and Azure OpenAI models
+At its core, the Deep Research tool orchestrates a multi-step research pipeline that’s tightly integrated with Grounding with Bing Search and the Azure OpenAI deep research model.
+
+### Deep research model deployment
+
+The Deep research tool uses the `o3-deep-research` model for its research tasks. It is a fine-tuned version of the `o3` model designed to perform automated detailed analysis of knowledge sources and create detailed research reports.
+
+**Key features**:
+- Handles text, images and PDFs as part of its research tasks
+- 200K context length, 100K completion tokens, and May 31, 2024 knowledge cutoff
+- Outputs its thinking as reasoning summary as it analyzes information
+- Delivers a synthesized report at the end of the research task
+
+**Deployment information**:
+- Deployment type: Global Standard
+- Regions: West US, Norway East
+- Quotas and limits: Enterprise: 30 K RPS/ 30 M TPM, Default: 3 K RPS/ 3 M TPM
 
-### Clarifying intent and scoping the task
+### GPT model deployment for clarifying intent
 
-When a user or downstream app submits a research query, the agent uses GPT-series models including GPT-4o and GPT-4.1 to clarify the question, gather additional context if needed, and precisely scope the research task. This ensures the agent’s output is both relevant and actionable, and that every search is optimized for your business scenario.
+The deep research tool uses a second model deployment to clarify the question, gather additional context if needed, and precisely scope the research task. This ensures the agent’s output is both relevant and actionable, and that every search is optimized for your business scenario.
+
+This second model can be any of the GPT-series models including GPT-4o and GPT-4.1.
 
 ### Grounding with Bing Search
 
@@ -42,48 +71,47 @@ The Deep Research model then starts the research task execution. This involves t
 
 ### Transparency, safety, and compliance
 
-Every stage of the process is safeguarded by input/output classifiers and chain-of-thought (CoT) summarizers. The final output is a structured report that documents not only the answer, but also the model's reasoning path, source citations, and any clarifications requested during the session. This makes every answer fully auditable.
+The output is a structured report that documents not only the answer, but also the model's reasoning path, source citations, and any clarifications requested during the session. This makes every answer fully auditable.
 
 ## Prerequisites
-- A basic or standard agent [environment setup](../../environment-setup.md)
-- Access to the Deep Research model is gated. Fill out the [request form](https://aka.ms/OAI/deepresearchaccess) for access. If you have already have access to the o3 model no request is required.
-
-To use Deep Research, you will create the following in this article:
-
-- The [Grounding with Bing Search tool](./bing-grounding.md)
-- A [deployed models](../../../model-inference/how-to/create-model-deployments.md) and the following model
+- If you already have access to the `o3` model no request is required for the deep research model. Otherwise, fill out the [request form](https://aka.ms/OAI/deepresearchaccess). 
+- An Azure subscription with the ability to create resources [Set up your environment](../../articles/ai-foundry/agents/environment-setup.md)
+- [Grounding with Bing Search tool](./bing-grounding.md) resource for connecting to your 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 GPT model like the `gpt-4o` for intent clarification.
 
 ## Setup 
 
-To use the Deep Research model, you need to create a new project and add your Grounding with Bing Search resource as a new connection. In the [AI Foundry portal](https://ai.azure.com/?cid=learnDocs):
-
-1. :::image type="content" source="../../media/tools/deep-research/project-creation.png" alt-text="A screenshot of  project creation in Azure AI Foundry." lightbox="../../media/tools/deep-research/project-creation.png":::
-
-1. Navigate to the project you created in the agent setup. Click on **Open in management center**.
-    :::image type="content" source="../../media/tools/ai-search/project-studio.png" alt-text="A screenshot of a project in Azure AI Foundry." lightbox="../../media/tools/ai-search/project-studio.png":::
-
-1. Select **Create connection**.
-
-    :::image type="content" source="../../media/create-connection.png" alt-text="A screenshot showing the connection creation screen in the Azure AI Foundry portal" lightbox="../../media/create-connection.png":::
-
-1. In the screen that appears, select **Grounding with Bing Search**. Then enter your connection details.
+To use the Deep Research tool, you need to create the Ai Foundry type project, add your Grounding with Bing Search resource as a new connection, deploy the deep research model, and deploy the GPT model. 
 
-    :::image type="content" source="../../media/tools/deep-research/bing-connection.png" alt-text="A screenshot of the screen to select Grounding with Bing Search." lightbox="../../media/tools/deep-research/bing-connection.png":::
+:::image type="content" source="../../media/tools/deep-research/setup-deep-research-tool.png" alt-text="Steps to set up the deep research tool." lightbox="../../media/tools/deep-research/setup-deep-research-tool.png":::
 
-    :::image type="content" source="../../media/tools/bing/add-connection.png" alt-text="A screenshot of the screen to add a Grounding with Bing Search connection." lightbox="../../media/tools/bing/add-connection.png":::
+1. Start here: [AI Foundry portal](https://ai.azure.com/?cid=learnDocs):
+   
+   :::image type="content" source="../../media/tools/deep-research/deep-research-tool-step1.png" alt-text="Steps to set up the deep research tool." lightbox="../../media/tools/deep-research/deep-research-tool-step1.png":::
 
-1. Deploy the Deep Research model. Select **Models + Endpoints**. Then select **Deploy model**. 
+1. Select the Azure AI Foundry project type:
+   
+    :::image type="content" source="../../media/tools/deep-research/deep-research-tool-step2.PNG" alt-text="Steps to set up the deep research tool." lightbox="../../media/tools/deep-research/deep-research-tool-step2.PNG":::
 
-    :::image type="content" source="../../media/deploy-model.png" alt-text="A screenshot of the screen to deploy a model." lightbox="../../media/deploy-model.png":::
+1. Update the project name and description:
+   
+    :::image type="content" source="../../media/tools/deep-research/deep-research-tool-step3.PNG" alt-text="Steps to set up the deep research tool." lightbox="../../media/tools/deep-research/deep-research-tool-step3.PNG":::
 
-1. Search for the `o3-deep-research` model, and confirm the model deployment.
+1. Connect a Grounding with Bing Search account:
+   
+    :::image type="content" source="../../media/tools/deep-research/deep-research-tool-step4.png" alt-text="Steps to set up the deep research tool." lightbox="../../media/tools/deep-research/deep-research-tool-step4.png":::
 
-    > [!NOTE]
-    > You also need to deploy a GPT chat model in your project, for example GPT-4o.
+1. Navigate to the Models +  Endpoints tab:
+   
+    :::image type="content" source="../../media/tools/deep-research/deep-research-tool-step5.png" alt-text="Steps to set up the deep research tool." lightbox="../../media/tools/deep-research/deep-research-tool-step5.png":::
 
-    :::image type="content" source="../../media/tools/deep-research/deep-research-model.png" alt-text="A screenshot of the model deployment." lightbox="../../media/tools/deep-research/deep-research-model.png":::
+1. Deploy the deep research model and a GPT model:
+   
+    :::image type="content" source="../../media/tools/deep-research/deep-research-tool-step6.PNG" alt-text="Steps to set up the deep research tool." lightbox="../../media/tools/deep-research/deep-research-tool-step6.PNG":::
+    :::image type="content" source="../../media/tools/deep-research/deep-research-tool-step7.PNG" alt-text="Steps to set up the deep research tool." lightbox="../../media/tools/deep-research/deep-research-tool-step7.PNG":::
 
 ## Next steps
 
-Learn [how to use the Deep Research tool](./deep-research-samples.md). 
+Learn [how to use the Deep Research tool](./deep-research-samples.md). 

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

@@ -30,6 +30,7 @@ To keep your AI agent informed with richer context from various data sources. Th
 
 To streamline workflows with your AI agent with capabilities to take actions. The Foundry Agent Service provides different action tools for you with different level of flexibility, control, and ease of integration:
 
+- **Deep Research tool**: Web-based integrated deep research pipeline with the `o3-deep-research` model and Grounding with Bing Search.
 - **Azure Logic Apps**: Low-code / no-code solution to add a workflow to your AI Agent
 - **OpenAPI Spec tool**: Bring an existing OpenAPI specification of a service API you want to add to your AI agent, with no or minor changes.
 - **MCP tool**: Bring an existing Model Context Protocol (MCP) endpoint that you want to add to your AI agent.
@@ -121,4 +122,4 @@ Grounding with Bing Search tool
 - Use: Gather external trends or news to enrich the post with real-time insights. 
 - Trigger this when:
     - The user asks to reference recent data or competitive context.
-    - Example: "Can you reference the latest industry trends?" or "What are competitors doing?".
+    - Example: "Can you reference the latest industry trends?" or "What are competitors doing?".