updating samples page

Author: aahill

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

@@ -24,6 +24,25 @@ Use this article to learn how to use the Deep Research tool with the Azure AI Pr
     pip install --pre azure-ai-projects
     ```
 
+* Your Azure AI Foundry Project endpoint.
+
+    You can find your endpoint in the main project **overview** for your project in the [Azure AI Foundry portal](https://ai.azure.com/?cid=learnDocs), under **Libraries** > **Azure AI Foundry**.
+
+    :::image type="content" source="../../media/quickstart/portal-endpoint-string.png" alt-text="A screenshot showing the endpoint in the Azure AI Foundry portal." lightbox="../../media/quickstart/portal-endpoint-string.png":::
+
+    Save this endpoint to an environment variable named `PROJECT_ENDPOINT`. 
+
+* The name of your Grounding with Bing Search resource name. You can find it in the Azure AI Foundry portal by selecting **Management center** from the left navigation menu. Then selecting **Connected resources**.
+    
+    :::image type="content" source="../../media/tools/deep-research/bing-resource-name.png" alt-text="A screenshot showing the Grounding with Bing Search resource name. " lightbox="../../media/tools/deep-research/bing-resource-name.png":::
+
+    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. 
+
+    :::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`. 
 
 > [!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.
@@ -92,7 +111,8 @@ project_client = AIProjectClient(
     credential=DefaultAzureCredential(),
 )
 
-conn_id = os.environ["AZURE_BING_CONNECTION_ID"]
+conn_id = project_client.connections.get(name=os.environ["BING_RESOURCE_NAME"]).id
+
 
 # Initialize a Deep Research tool with Bing Connection ID and Deep Research model deployment name
 deep_research_tool = DeepResearchTool(

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

@@ -17,6 +17,9 @@ The Deep Research tool in the Azure AI Foundry Agent Service enables you to inte
 > [!IMPORTANT]
 > * 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 Agents service and SDK use the Azure OpenAI `o3-deep-research` model. This model is not accessible from Azure OpenAI Chat Completions and Responses APIs.
+> * When you use Grounding with Bing Search, your customer data is transferred outside of the Azure compliance boundary to the Grounding with Bing Search service. Grounding with Bing Search is not subject to the same data processing terms (including location of processing) and does not have the same compliance standards and certifications as the Azure AI Foundry Agent Service, as described in the [Grounding with Bing Search Terms of Use](https://www.microsoft.com/en-us/bing/apis/grounding-legal). It is your responsibility to assess whether use of Grounding with Bing Search in your agent meets your needs and requirements.
+
+> [!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

articles/ai-foundry/agents/includes/endpoint-string-portal.md

@@ -8,5 +8,5 @@ ms.date: 12/11/2024
 ---
 
 > [!TIP]
-> You can also find your endpoint in the **overview** for your project in the [Azure AI Foundry portal](https://ai.azure.com/?cid=learnDocs), under **Libraries** > **Azure AI Foundry**.
+> You can find your endpoint in the **overview** for your project in the [Azure AI Foundry portal](https://ai.azure.com/?cid=learnDocs), under **Libraries** > **Azure AI Foundry**.
 > :::image type="content" source="../media/quickstart/portal-endpoint-string.png" alt-text="A screenshot showing the endpoint in the Azure AI Foundry portal." lightbox="../media/quickstart/portal-endpoint-string.png":::

articles/ai-foundry/agents/media/quickstart/portal-endpoint-string.png

@@ -54,8 +54,8 @@ items:
           - name: Overview
             href: how-to/tools/bing-custom-search.md
             displayName: bing, grounding with bing custom search
-        - name: How to use Grounding with Bing Custom Search
-          href: how-to/tools/bing-custom-search-samples.md
+          - name: How to use Grounding with Bing Custom Search
+            href: how-to/tools/bing-custom-search-samples.md
         - name: File search
           items:
           - name: Overview