Merge pull request #5175 from sdgilley/sdg-patches

Help identify project types

Author: JamesJBarnett

articles/ai-foundry/includes/find-endpoint.md

@@ -0,0 +1,17 @@
+---
+title: Include file
+description: Include file
+author: sgilley
+ms.author: sgilley
+ms.service: azure-ai-foundry
+ms.topic: include
+ms.date: 05/13/2025
+ms.custom: include file
+---
+
+Copy the **Azure AI Foundry project endpoint** in the **Overview** section of your project. You'll use it in a moment.
+
+:::image type="content" source="../media/how-to/projects/fdp-project-overview.png" alt-text="Screenshot shows the project overview for a Foundry project.":::
+
+> [!TIP]
+> If you don't see the **Azure AI Foundry project endpoint**, you're using a [!INCLUDE [hub-project-name](hub-project-name.md)]. (See [Types of projects](../what-is-azure-ai-foundry.md#project-types)). Switch to a [!INCLUDE [fdp-project-name](fdp-project-name.md)], or use the preceding steps to create one.

articles/ai-foundry/includes/get-started-fdp.md

@@ -45,7 +45,7 @@ The Azure AI Foundry SDK is available in multiple languages, including Python, J
 
 You now have both a project and a model available for your agent.
 
-### Set up your environment  
+## Set up your environment  
 
 # [Azure AI Foundry portal](#tab/azure-ai-foundry)
 
@@ -60,22 +60,24 @@ No installation is necessary to use the Azure AI Foundry portal.
     pip install openai azure-ai-projects azure-identity
     ```
 
+1. [!INCLUDE [find-endpoint](find-endpoint.md)]
 1. Make sure to sign in using the CLI `az login` (or `az login --use-device-code`) command to authenticate before running your Python scripts.
 
-> [!TIP]
+> [!NOTE]
 > All the code in this article is at [GitHub Quickstart](https://github.com/azure-ai-foundry/foundry-samples/tree/main/samples/microsoft/python/mslearn-resources/quickstart).
 
 # [Java (preview)](#tab/java)
 
 1. [Install Java and Azure CLI](../how-to/develop/install-cli-sdk.md?pivots=programming-language-java).
+1. [!INCLUDE [find-endpoint](find-endpoint.md)]
 1. Set these environment variables to use in your scripts:
 
     :::code language="plaintext" source="~/foundry-samples-main/samples/microsoft/java/mslearn-resources/quickstart/.env.template":::
 
 1. Make sure to sign in using the CLI `az login` (or `az login --use-device-code`) command to authenticate before running your Java scripts.
 1. Download [POM.XML](https://github.com/azure-ai-foundry/foundry-samples/blob/main/samples/microsoft/java/mslearn-resources/quickstart/pom.xml) to your Java IDE.
 
-> [!TIP]
+> [!NOTE]
 > All the code in this article is at [GitHub Quickstart](https://github.com/azure-ai-foundry/foundry-samples/blob/main/samples/microsoft/java/mslearn-resources/quickstart).
 
 # [JavaScript (preview)](#tab/javascript)
@@ -84,12 +86,13 @@ No installation is necessary to use the Azure AI Foundry portal.
 1. Make sure to sign in using the CLI `az login` (or `az login --use-device-code`) command to authenticate before running your JavaScript scripts.
 1. Download [package.json](https://github.com/azure-ai-foundry/foundry-samples/blob/main/samples/microsoft/javascript/mslearn-resources/quickstart/package.json).
 1. Install packages with `npm install`
+1. [!INCLUDE [find-endpoint](find-endpoint.md)]
 1. Set these environment variables to use in your scripts:
 
     :::code language="plaintext" source="~/foundry-samples-main/samples/microsoft/javascript/mslearn-resources/quickstart/.env.template":::
 
 
-> [!TIP]
+> [!NOTE]
 > All the code in this article is at [GitHub Quickstart](https://github.com/azure-ai-foundry/foundry-samples/tree/main/samples/microsoft/javascript/mslearn-resources/quickstart).
 
 # [C#](#tab/csharp)
@@ -99,13 +102,15 @@ No installation is necessary to use the Azure AI Foundry portal.
 
     [!INCLUDE [install-csharp-packages](install-csharp-packages.md)]
 
+1. [!INCLUDE [find-endpoint](find-endpoint.md)]
+
 1. Set these environment variables to use in your scripts:
 
     :::code language="plaintext" source="~/foundry-samples-main/samples/microsoft/csharp/mslearn-resources/quickstart/Samples/.env.example":::
 
 1. Make sure to sign in using the CLI `az login` (or `az login --use-device-code`) command to authenticate before running your C# scripts.
 
-> [!TIP]
+> [!NOTE]
 > All the code in this article is at [GitHub Quickstart](https://github.com/azure-ai-foundry/foundry-samples/tree/main/samples/microsoft/csharp/mslearn-resources/quickstart).
 
 # [REST API](#tab/rest)
@@ -120,7 +125,7 @@ No installation is necessary to use the Azure AI Foundry portal.
     
 1. Save the results as the environment variable `AZURE_AI_AUTH_TOKEN`.  
 
-> [!TIP]
+> [!NOTE]
 > All the code in this article is at [GitHub Quickstart](https://github.com/azure-ai-foundry/foundry-samples/tree/main/samples/microsoft/REST/mslearn-resources/quickstart).
 
 
@@ -140,6 +145,8 @@ After the preceding steps, you're now in the agents playground.
 
 # [Python](#tab/python)
 
+Substitute your endpoint for the `endpoint` in this code:
+
 :::code language="python" source="~/foundry-samples-main/samples/microsoft/python/mslearn-resources/quickstart/quickstart.py" id="create_and_run_agent":::
 
 # [Java (preview)](#tab/java)
@@ -183,6 +190,8 @@ Now let's add a file search tool that enables us to do knowledge retrieval.
 
 # [Python](#tab/python)
 
+Substitute your endpoint for the `endpoint` in this code:
+
 :::code language="python" source="~/foundry-samples-main/samples/microsoft/python/mslearn-resources/quickstart/quickstart.py" id="create_filesearch_agent":::
 
 # [Java (preview)](#tab/java)
@@ -219,7 +228,7 @@ Chat completions are the basic building block of AI applications. Using chat com
 
 # [Python](#tab/python)
 
-Substitute your value for the endpoint in this code:
+Substitute your endpoint for the `endpoint` in this code:
 
 :::code language="python" source="~/foundry-samples-main/samples/microsoft/python/mslearn-resources/quickstart/quickstart.py" id="chat_completion":::
 

articles/ai-foundry/includes/uses-fdp-only.md

@@ -11,4 +11,4 @@ ms.custom: include
 ---
 
 > [!NOTE]
-> You must use a **[!INCLUDE [fdp](fdp-project-name.md)]** for this feature. A **[!INCLUDE [hub](hub-project-name.md)]** isn't supported. For more information, see [Types of projects](../what-is-azure-ai-foundry.md#project-types).
+> You must use a **[!INCLUDE [fdp](fdp-project-name.md)]** for this feature. A **[!INCLUDE [hub](hub-project-name.md)]** isn't supported. See [How do I know which type of project I have?](../what-is-azure-ai-foundry.md#how-do-i-know) and [Create a Foundry project](../how-to/create-projects.md?pivots="fdp-project").

articles/ai-foundry/includes/uses-hub-only.md

@@ -11,4 +11,4 @@ ms.custom: include
 ---
 
 > [!NOTE]
-> You must use a **[!INCLUDE [hub](hub-project-name.md)]** for this feature. A **[!INCLUDE [fdp](fdp-project-name.md)]** isn't supported. For more information, see [Types of projects](../what-is-azure-ai-foundry.md#project-types).
+> You must use a **[!INCLUDE [hub](hub-project-name.md)]** for this feature. A **[!INCLUDE [fdp](fdp-project-name.md)]** isn't supported. See [How do I know which type of project I have?](../what-is-azure-ai-foundry.md#how-do-i-know) and [Create a hub based project](../how-to/create-projects.md?pivots="hub-project").

articles/ai-foundry/media/how-to/projects/all-resources.png

@@ -60,6 +60,34 @@ This table summarizes features available in the two project types:
 | Managed compute  |  | ✅ |
 | Required Azure dependencies | - | Azure Storage account, Azure Key Vault |
 
+### <a name="how-do-i-know"></a> How do I know which type of project I have?
+
+Here are some of the ways to identify your project type:
+
+* From the **breadcrumb navigation** section
+
+    * A [!INCLUDE [fdp-project-name](includes/fdp-project-name.md)] displays **(AI Foundry)** on the second line
+    * A [!INCLUDE [hub-project-name](includes/hub-project-name.md)] displays **(Hub)** on the second line
+
+    :::image type="content" source="media/how-to/projects/breadcrumb.png" alt-text="Screenshot shows both a Foundry and hub based project in the breadcrumb navigation.":::
+
+* From the **All resources** page
+
+    * A [!INCLUDE [fdp-project-name](includes/fdp-project-name.md)] displays **(AI Foundry)** as the parent resource
+    * A [!INCLUDE [hub-project-name](includes/hub-project-name.md)] displays **(Hub)** as the parent resource
+
+    :::image type="content" source="media/how-to/projects/all-resources.png" alt-text="Screenshot shows both a Foundry and hub based project in the All Resources page.":::
+
+<!-- * From the **Overview** section of the project
+
+    * If it's a [!INCLUDE [fdp-project-name](includes/fdp-project-name.md)], you see an **Azure AI Foundry endpoint**
+
+        :::image type="content" source="media/how-to/projects/fdp-project-overview.png" alt-text="Screenshot shows a Foundry project overview page." lightbox="media/how-to/projects/fdp-project-overview.png":::
+
+    * If it's a [!INCLUDE [hub-project-name](includes/hub-project-name.md)], you see a **Project connection string**
+
+        :::image type="content" source="media/how-to/projects/hub-project-overview.png" alt-text="Screenshot shows a hub based project overview page." lightbox="media/how-to/projects/hub-project-overview.png"::: -->
+
 ## Navigate in the Azure AI Foundry portal
 
 In the Azure AI Foundry portal, you can navigate among all your resources using the breadcrumbs at the top of the page. The breadcrumbs show recent resources, along with a link to all resources. 
@@ -77,7 +105,7 @@ If you're an admin, or leading a development team, and need to manage the team's
 
 The left pane of the Azure AI Foundry portal is your main navigation tool. Customize this area to show the parts of the portal you want to use.
 
-Pin or unpin items into the left pane. When you pin an item, it appears in the left pane. When you unpin an item, it disappears from the left pane. 
+Pin or unpin items into the left pane. When you unpin an item, it is hidden from the left pane but can be found again in the **...More** menu.
 
 * Select **... More** at the bottom of the pane to see items to pin and unpin.
 * Customize each project separately. The left pane is not shared across projects.