updating tools

Author: aahill

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

@@ -16,6 +16,7 @@ zone_pivot_groups: selection-bing-custom-grounding
 
 # How to use Grounding with Bing Custom Search (preview)
 
+Use this article to find step-by-step instructions and code samples for using the Grounding with Bing Custom Search tool in the Azure AI Foundry Agent Service.
 
 ::: zone pivot="portal"
 
@@ -38,6 +39,20 @@ zone_pivot_groups: selection-bing-custom-grounding
 
 ::: zone pivot="python"
 
+## Prerequisites
+
+* Your Azure AI Foundry Project endpoint.
+
+    [!INCLUDE [endpoint-string-portal](../../includes/endpoint-string-portal.md)]
+
+    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 resource name to an environment variable named `BING_CUSTOM_CONNECTION_NAME`. 
+
 ## Create a project client
 
 Create a client object, which will contain the connection string for connecting to your AI project and other resources.
@@ -55,15 +70,15 @@ project_endpoint = os.environ["PROJECT_ENDPOINT"]  # Ensure the PROJECT_ENDPOINT
 
 # Create an AIProjectClient instance
 project_client = AIProjectClient(
-    endpoint=os.environ["PROJECT_ENDPOINT"],
+    endpoint=project_endpoint,
     credential=DefaultAzureCredential(),
 )
 ```
 
 
 ## Create an Agent with the Grounding with Bing Custom Search tool enabled
 
-To make the Grounding with Bing Custom Search tool available to your agent, use a connection to initialize the tool and attach it to the agent. You can find your connection in the **connected resources** section of your project in the [Azure AI Foundry portal](https://ai.azure.com/?cid=learnDocs).
+To make the Grounding with Bing Custom Search tool available to your agent, use a connection to initialize the tool and attach it to the agent.
 
 ```python
 bing_custom_connection = project_client.connections.get(connection_name=os.environ["BING_CUSTOM_CONNECTION_NAME"])

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

@@ -29,9 +29,8 @@ Use this article to learn how to use the Deep Research tool with the Azure AI Pr
 
 * 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 **Endpoint and keys** > **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":::
+    
+    [!INCLUDE [endpoint-string-portal](../../includes/endpoint-string-portal.md)]
 
     Save this endpoint to an environment variable named `PROJECT_ENDPOINT`. 
 

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

@@ -22,6 +22,20 @@ Use this article to find step-by-step instructions and code samples for using th
 
 :::zone pivot="python"
 
+## Prerequisites
+
+* Your Azure AI Foundry Project endpoint.
+
+    [!INCLUDE [endpoint-string-portal](../../includes/endpoint-string-portal.md)]
+
+    Save this endpoint to an environment variable named `PROJECT_ENDPOINT`. 
+
+
+* The name of your SharePoint connection 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/sharepoint-connection.png" alt-text="A screenshot showing the SharePoint connection name. " lightbox="../../media/tools/sharepoint-connection.png":::
+
+    Save this endpoint to an environment variable named `SHAREPOINT_RESOURCE_NAME`
 
 ## Create a project client
 
@@ -48,11 +62,8 @@ project_client = AIProjectClient(
 To make the Microsoft Fabric tool available to your agent, use a connection to initialize the tool and attach it to the agent. You can find your connection in the **connected resources** section of your project in the Azure AI Foundry portal.
 
 ```python
-# The Fabric connection id can be found in the Azure AI Foundry project as a property of the Fabric tool
-# Your connection id is in the format /subscriptions/<your-subscription-id>/resourceGroups/<your-resource-group>/providers/Microsoft.MachineLearningServices/workspaces/<your-project-name>/connections/<your-fabric-connection-name>
 
-# Retrieve the Fabric connection ID from environment variables
-conn_id = os.environ["SHAREPOINT_CONNECTION_ID"] # Ensure the environment variable is set
+conn_id = project_client.connections.get(name=os.environ["SHAREPOINT_RESOURCE_NAME"]).id
 
 # Initialize Sharepoint tool with connection id
 sharepoint = SharepointTool(connection_id=conn_id)

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

@@ -7,6 +7,6 @@ ms.topic: include
 ms.date: 12/11/2024
 ---
 
-> [!TIP]
-> 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":::
+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":::