include file

Author: aahill

articles/ai-foundry/agents/includes/connection-string-deprecation.md

@@ -0,0 +1,15 @@
+---
+manager: nitinme
+author: aahill
+ms.author: aahi
+ms.service: azure-ai-agent-service
+ms.topic: include
+ms.date: 07/23/2025
+---
+
+> [!IMPORTANT]
+> Starting in May 2025, the Azure AI Agent Service uses an endpoint for [Foundry projects](../../what-is-azure-ai-foundry.md#project-types) instead of the connection string that were used for hub-based projects before this time. Connection strings are no longer supported in current versions of the SDKs and REST API. We recommend creating a new foundry project.
+>
+> If you want to continue using your hub-based project and connection string, you will need to use one of the previous versions of the SDK:
+> * C#: `1.0.0-beta.2` or earlier
+> * Python: `1.0.0b10` or earlier

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

@@ -9,11 +9,4 @@ ms.date: 12/11/2024
 
 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**.
 
-> [!IMPORTANT]
-> Starting in May 2025, the Azure AI Agent Service uses an endpoint for [Foundry projects](../../what-is-azure-ai-foundry.md#project-types) instead of the connection string that were used for hub-based projects before this time. Connection strings are no longer supported in current versions of the SDKs and REST API. We recommend creating a new foundry project.
->
-> If you want to continue using your hub-based project and connection string, you will need to use one of the previous versions of the SDK:
-> * C#: `1.0.0-beta.2` or earlier
-> * Python: `1.0.0b10` or earlier
-
 :::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/includes/quickstart-csharp.md

@@ -48,12 +48,10 @@ Use the following code to create and run an agent. To run this code, you will ne
 
 [!INCLUDE [endpoint-string-portal](endpoint-string-portal.md)]
 
-For example, your endpoint may look something like:
-
-`https://myresource.services.ai.azure.com/api/projects/myproject`
-
 Set this endpoint in an environment variable variable named `ProjectEndpoint`.
 
+[!INCLUDE [endpoint-string-portal](connection-string-deprecation.md.md)]
+
 [!INCLUDE [model-name-portal](model-name-portal.md)]
 
 Save the name of your model deployment name as an environment variable named `ModelDeploymentName`. 

articles/ai-foundry/agents/includes/quickstart-python.md

@@ -45,11 +45,13 @@ Use the following code to create and run an agent. To run this code, you will ne
 
 [!INCLUDE [endpoint-string-portal](endpoint-string-portal.md)]
 
-For example, your endpoint may look something like:
+Set this endpoint as an environment variable named `PROJECT_ENDPOINT`.
 
-`https://myresource.services.ai.azure.com/api/projects/myproject`
+[!INCLUDE [endpoint-string-portal](connection-string-deprecation.md.md)]
 
-Set this endpoint as an environment variable named `PROJECT_ENDPOINT`.
+[!INCLUDE [model-name-portal](model-name-portal.md)]
+
+Save the name of your model deployment name as an environment variable named `MODEL_DEPLOYMENT_NAME`. 
 
 ```python
 import os

articles/ai-foundry/agents/includes/quickstart-typescript.md

@@ -58,11 +58,13 @@ Use the following code to create and run an agent which uploads [a CSV file](htt
 
 [!INCLUDE [endpoint-string-portal](endpoint-string-portal.md)]
 
-For example, your endpoint looks something like:
+Set this endpoint as an environment variable named `PROJECT_ENDPOINT` in a `.env` file.
 
-`https://myresource.services.ai.azure.com/api/projects/myproject`
+[!INCLUDE [endpoint-string-portal](connection-string-deprecation.md.md)]
 
-Set this endpoint as an environment variable named `PROJECT_ENDPOINT` in a `.env` file.
+[!INCLUDE [model-name-portal](model-name-portal.md)]
+
+Save the name of your model deployment name as an environment variable named `MODEL_DEPLOYMENT_NAME`. 
 
 > [!IMPORTANT] 
 > * This quickstart code uses environment variables for sensitive configuration. Never commit your `.env` file to version control by making sure `.env` is listed in your `.gitignore` file.