Merge pull request #6185 from aahill/july-fixes

note about connection strings

Author: JamesJBarnett

articles/ai-foundry/agents/how-to/use-your-own-resources.md

@@ -6,7 +6,7 @@ services: cognitive-services
 manager: nitinme
 ms.service: azure-ai-agent-service
 ms.topic: how-to
-ms.date: 06/18/2025
+ms.date: 07/23/2025
 author: aahill
 ms.author: aahi
 ms.reviewer: fosteramanda
@@ -19,7 +19,29 @@ Use this article if you want to set up your Foundry project with your own resour
 
 ## Limitations
 
-**Use Azure Cosmos DB for NoSQL to store threads**  
+There are some limitations you should be aware of when you plan to use existing resources with the Azure AI Foundry Agent Service.
+
+### If you are using a hub-based project or Azure OpenAI Assistants
+
+At this time, there is no direct upgrade path to migrate existing agents or their associated data assets such as files, threads, or vector stores from a hub-based project to an Azure AI Foundry project. There is also no upgrade path to convert existing Azure OpenAI Assistants into Foundry Agents, nor a way to automatically migrate Assistants' files, threads, or vector stores.
+
+You can reuse your existing model deployments and quota from Azure AI Services or Azure OpenAI resources within a Foundry project.
+
+### SDK usage with hub-based projects
+
+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 was 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 the connection string for your project located under **Connection string** in the overview of your project. 
+
+    :::image type="content" source="../../media/quickstarts/azure-ai-sdk/connection-string.png" alt-text="A screenshot showing the legacy connection string for a hub-based project.":::
+
+* Use one of the previous versions of the SDK and the associated sample code:
+    * [C#](https://github.com/Azure/azure-sdk-for-net/tree/feature/azure-ai-agents/sdk/ai/Azure.AI.Projects/samples): `1.0.0-beta.2` or earlier
+    * [Python](https://github.com/Azure/azure-sdk-for-python/tree/feature/azure-ai-projects-beta10/sdk/ai/azure-ai-projects/samples/agents): `1.0.0b10` or earlier
+
+### Azure Cosmos DB for NoSQL to store threads 
+
 - Your existing Azure Cosmos DB for NoSQL account used in a [standard setup](#choose-basic-or-standard-agent-setup) must have a total throughput limit of at least 3000 RU/s. Both provisioned throughput and serverless are supported.
 - Three containers will be provisioned in your existing Cosmos DB account, each requiring 1000 RU/s
 
@@ -70,7 +92,7 @@ Includes everything in the basic setup and fine-grained control over your data b
 
 ## Basic agent setup: Use an existing Azure OpenAI resource 
 
-Replace the parameter value for `existingAoaiResourceId` with the full arm resource ID of the Azure OpenAI resource you want to use.
+Replace the parameter value for `existingAoaiResourceId`in the [template](https://github.com/azure-ai-foundry/foundry-samples/tree/main/samples/microsoft/infrastructure-setup/42-basic-agent-setup-with-customization) with the full arm resource ID of the Azure OpenAI resource you want to use.
 
 1. To get the Azure OpenAI account resource ID, sign in to the Azure CLI and select the subscription with your AI Services account:
        

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

@@ -0,0 +1,11 @@
+---
+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 was previously used for hub-based projects. If you're using a hub-based project, you won't be able to use the current versions of the SDK and REST API. For more information, see [SDK usage with hub-based projects](../how-to/use-your-own-resources.md#sdk-usage-with-hub-based-projects).

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

@@ -46,13 +46,11 @@ Use the following code to create and run an agent. To run this code, you will ne
 
 `https://<AIFoundryResourceName>.services.ai.azure.com/api/projects/<ProjectName>`
 
-[!INCLUDE [endpoint-string-portal](endpoint-string-portal.md)]
-
-For example, your endpoint may look something like:
+[!INCLUDE [connection-string-deprecation](connection-string-deprecation.md)]
 
-`https://myresource.services.ai.azure.com/api/projects/myproject`
+[!INCLUDE [endpoint-string-portal](endpoint-string-portal.md)]
 
-Set this endpoint in an environment variable variable named `ProjectEndpoint`.
+Set this endpoint in an environment variable named `ProjectEndpoint`.
 
 [!INCLUDE [model-name-portal](model-name-portal.md)]
 

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

@@ -43,13 +43,15 @@ Use the following code to create and run an agent. To run this code, you will ne
 
 `https://<AIFoundryResourceName>.services.ai.azure.com/api/projects/<ProjectName>`
 
+[!INCLUDE [connection-string-deprecation](connection-string-deprecation.md)]
+
 [!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 [model-name-portal](model-name-portal.md)]
 
-Set this endpoint as an environment variable named `PROJECT_ENDPOINT`.
+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,11 @@ 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 [model-name-portal](model-name-portal.md)]
 
-Set this endpoint as an environment variable named `PROJECT_ENDPOINT` in a `.env` file.
+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.