Merge pull request #5183 from MicrosoftDocs/main

learn-build-service-prod[bot] · web-flow · commit 4a21f90f1923 · 2025-05-24T05:21:57.000Z
Merged by Learn.Build PR Management system
diff --git a/articles/ai-foundry/how-to/deploy-models-managed.md b/articles/ai-foundry/how-to/deploy-models-managed.md
@@ -22,6 +22,14 @@ Deployment of a large language model (LLM) makes it available for use in a websi
 
 In this article, you learn how to deploy models using the Azure Machine Learning SDK. The article also covers how to perform inference on the deployed model.
 
+## Prerequisites
+
+- An Azure subscription with a valid payment method. Free or trial Azure subscriptions won't work. If you don't have an Azure subscription, create a [paid Azure account](https://azure.microsoft.com/pricing/purchase-options/pay-as-you-go) to begin.
+
+- If you don't have one, [create a [!INCLUDE [hub-project-name](../includes/hub-project-name.md)]](create-projects.md?pivots=hub-project).
+
+- Marketplace purchases enabled for your Azure subscription. Learn more [here](/azure/cost-management-billing/manage/enable-marketplace-purchases).
+
 ## Get the model ID
 
 You can deploy managed compute models using the Azure Machine Learning SDK, but first, let's browse the model catalog and get the model ID you need for deployment.
diff --git a/articles/ai-foundry/how-to/deploy-models-serverless-availability.md b/articles/ai-foundry/how-to/deploy-models-serverless-availability.md
@@ -28,9 +28,6 @@ Certain models in the model catalog can be deployed as a standard deployment. Th
 
 Standard billing is available only to users whose Azure subscription belongs to a billing account in a country/region where the model provider has made the offer available (see "offer availability region" in the table in the next section). If the offer is available in the relevant region, the user then must have a Hub/Project in the Azure region where the model is available for deployment or fine-tuning, as applicable (see "Hub/Project Region" columns in the following tables).
 
-> [!NOTE]
-> If you plan to access your deployed models in Azure Machine Learning Studio, you must use a **[!INCLUDE [hub](../includes/hub-project-name.md)]**, rather than a **[!INCLUDE [fdp](../includes/fdp-project-name.md)]**. For more information, see [Project types](../what-is-azure-ai-foundry.md#project-types).
-
 
 [!INCLUDE [region-availability-maas](../includes/region-availability-maas.md)]
 
diff --git a/articles/ai-foundry/how-to/deploy-models-serverless-connect.md b/articles/ai-foundry/how-to/deploy-models-serverless-connect.md
@@ -35,7 +35,7 @@ The need to consume a standard deployments endpoint in a different project or hu
 
 - An [Azure AI Foundry hub](create-azure-ai-resource.md), if you're using a **[!INCLUDE [hub](../includes/hub-project-name.md)]**. A **[!INCLUDE [fdp](../includes/fdp-project-name.md)]** does not use a hub. For more information, see [Project types](../what-is-azure-ai-foundry.md#project-types).
 
-- An [Azure AI Foundry project](create-projects.md).
+- If you don't have one, [create a [!INCLUDE [hub](../includes/hub-project-name.md)]](create-projects.md?pivots=hub-project).
 
 - A model [deployed to a standard deployments](deploy-models-serverless.md). This article assumes that you previously deployed the **Meta-Llama-3-8B-Instruct** model. To learn how to deploy this model as a standard deployment, see [Deploy models as standard deployments](deploy-models-serverless.md).
 
diff --git a/articles/ai-foundry/how-to/deploy-models-serverless.md b/articles/ai-foundry/how-to/deploy-models-serverless.md
@@ -27,7 +27,7 @@ This article uses a Meta Llama model deployment for illustration. However, you c
 
 - An Azure subscription with a valid payment method. Free or trial Azure subscriptions won't work. If you don't have an Azure subscription, create a [paid Azure account](https://azure.microsoft.com/pricing/purchase-options/pay-as-you-go) to begin.
 
-- An [Azure AI Foundry project](create-projects.md).
+- If you don't have one, [create a [!INCLUDE [hub](../includes/hub-project-name.md)]](create-projects.md?pivots=hub-project).
 
 - Ensure that the **Deploy models to Azure AI model inference service** feature is turned off in the Azure AI Foundry portal. When this feature is on, standard deployments are not available for deployment when using the portal.
 
diff --git a/articles/ai-foundry/how-to/deploy-nvidia-inference-microservice.md b/articles/ai-foundry/how-to/deploy-nvidia-inference-microservice.md
@@ -25,7 +25,7 @@ NVIDIA inference microservices are containers built by NVIDIA for optimized pret
 
 - An Azure subscription with a valid payment method. Free or trial Azure subscriptions won't work. If you don't have an Azure subscription, create a [paid Azure account](https://azure.microsoft.com/pricing/purchase-options/pay-as-you-go) to begin.
 
-- An [Azure AI Foundry project](create-projects.md).
+- If you don't have one, [create a [!INCLUDE [hub](../includes/hub-project-name.md)]](create-projects.md?pivots=hub-project).
 
 - Marketplace purchases enabled for your Azure subscription. Learn more [here](/azure/cost-management-billing/manage/enable-marketplace-purchases).
 
diff --git a/articles/ai-foundry/how-to/healthcare-ai/deploy-cxrreportgen.md b/articles/ai-foundry/how-to/healthcare-ai/deploy-cxrreportgen.md
@@ -37,7 +37,7 @@ The CXRReportGen model combines a radiology-specific image encoder with a large
 
 - An Azure subscription with a valid payment method. Free or trial Azure subscriptions won't work. If you don't have an Azure subscription, create a [paid Azure account](https://azure.microsoft.com/pricing/purchase-options/pay-as-you-go) to begin.
 
-- An [Azure AI Foundry project](../create-projects.md).
+- If you don't have one, [create a [!INCLUDE [hub](../../includes/hub-project-name.md)]](../create-projects.md?pivots=hub-project).
 
 - Azure role-based access controls (Azure RBAC) are used to grant access to operations in Azure AI Foundry portal. To perform the steps in this article, your user account must be assigned the __Azure AI Developer role__ on the resource group. For more information on permissions, see [Role-based access control in Azure AI Foundry portal](../../concepts/rbac-ai-foundry.md).
 
diff --git a/articles/ai-foundry/how-to/healthcare-ai/deploy-medimageinsight.md b/articles/ai-foundry/how-to/healthcare-ai/deploy-medimageinsight.md
@@ -35,7 +35,8 @@ An embedding model is capable of serving as the basis of many different solution
 
 - An Azure subscription with a valid payment method. Free or trial Azure subscriptions won't work. If you don't have an Azure subscription, create a [paid Azure account](https://azure.microsoft.com/pricing/purchase-options/pay-as-you-go) to begin.
 
-- An [Azure AI Foundry project](../create-projects.md).
+- If you don't have one, [create a [!INCLUDE [hub](../../includes/hub-project-name.md)]](../create-projects.md?pivots=hub-project).
+
 
 - Azure role-based access controls (Azure RBAC) are used to grant access to operations in Azure AI Foundry portal. To perform the steps in this article, your user account must be assigned the __Azure AI Developer role__ on the resource group. For more information on permissions, see [Role-based access control in Azure AI Foundry portal](../../concepts/rbac-ai-foundry.md).
 
diff --git a/articles/ai-foundry/how-to/healthcare-ai/deploy-medimageparse.md b/articles/ai-foundry/how-to/healthcare-ai/deploy-medimageparse.md
@@ -47,7 +47,7 @@ Similar to the MedImageParse model, MedImageParse 3D uses a combination of a tex
 
 - An Azure subscription with a valid payment method. Free or trial Azure subscriptions won't work. If you don't have an Azure subscription, create a [paid Azure account](https://azure.microsoft.com/pricing/purchase-options/pay-as-you-go) to begin.
 
-- An [Azure AI Foundry project](../create-projects.md).
+- If you don't have one, [create a [!INCLUDE [hub](../../includes/hub-project-name.md)]](../create-projects.md?pivots=hub-project).
 
 - Azure role-based access controls (Azure RBAC) are used to grant access to operations in Azure AI Foundry portal. To perform the steps in this article, your user account must be assigned the __Azure AI Developer role__ on the resource group. For more information on permissions, see [Role-based access control in Azure AI Foundry portal](../../concepts/rbac-ai-foundry.md).
 
diff --git a/articles/ai-foundry/includes/find-endpoint.md b/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.
diff --git a/articles/ai-foundry/includes/get-started-fdp.md b/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":::
 
diff --git a/articles/ai-foundry/includes/region-availability-maas.md b/articles/ai-foundry/includes/region-availability-maas.md
@@ -10,6 +10,8 @@ ms.date: 03/24/2024
 ms.custom: include, references_regions
 ---
 
+[!INCLUDE [uses-hub-only](uses-hub-only.md)]
+
 ### AI21 models
 
 | Model  |Offer Availability Region  | Hub/Project Region for Deployment  | Hub/Project Region for Fine tuning  |
diff --git a/articles/ai-foundry/includes/uses-fdp-only.md b/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").
diff --git a/articles/ai-foundry/includes/uses-hub-only.md b/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").
diff --git a/articles/ai-foundry/media/how-to/projects/all-resources.png b/articles/ai-foundry/media/how-to/projects/all-resources.png
diff --git a/articles/ai-foundry/media/how-to/projects/breadcrumb.png b/articles/ai-foundry/media/how-to/projects/breadcrumb.png
diff --git a/articles/ai-foundry/media/how-to/projects/fdp-project-overview.png b/articles/ai-foundry/media/how-to/projects/fdp-project-overview.png
diff --git a/articles/ai-foundry/media/how-to/projects/hub-project-overview.png b/articles/ai-foundry/media/how-to/projects/hub-project-overview.png
diff --git a/articles/ai-foundry/model-inference/overview.md b/articles/ai-foundry/model-inference/overview.md
@@ -35,6 +35,7 @@ You can get access to the key model providers in the industry. Explore the follo
 - [Microsoft](concepts/models.md#microsoft)
 - [Mistral AI](concepts/models.md#mistral-ai)
 - [NTT Data](concepts/models.md#ntt-data)
+- [xAI](concepts/models.md#xai)
 
 To see details for each model including language, types, and capabilities, see [Models](concepts/models.md) article.
 
diff --git a/articles/ai-foundry/toc.yml b/articles/ai-foundry/toc.yml
@@ -72,10 +72,8 @@ items:
           href: how-to/develop/semantic-kernel.md
   - name: Deploy Azure OpenAI in Foundry Models
     items:
-    - name: Azure OpenAI in Azure AI Foundry portal
-      href: azure-openai-in-azure-ai-foundry.md
     - name: Use Azure OpenAI in Azure AI Foundry portal
-      href: ai-services/how-to/connect-azure-openai.md
+      href: ai-services/how-to/connect-azure-openai.md?context=/azure/ai-foundry/context/context
     - name: Supported Azure OpenAI models
       href: ../ai-services/openai/concepts/models.md?context=/azure/ai-foundry/context/context
     - name: Azure OpenAI deployment types
diff --git a/articles/ai-foundry/what-is-azure-ai-foundry.md b/articles/ai-foundry/what-is-azure-ai-foundry.md
@@ -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.
diff --git a/articles/machine-learning/concept-endpoint-serverless-availability.md b/articles/machine-learning/concept-endpoint-serverless-availability.md
@@ -27,7 +27,6 @@ Certain models in the model catalog can be deployed as a standard deployment. Th
 
 Standard deployment is available only to users whose Azure subscription belongs to a billing account in a country/region where the model provider has made the offer available (see "offer availability region" in the table in the next section). If the offer is available in the relevant region, the user then must have a Hub/Project in the Azure region where the model is available for deployment or fine-tuning, as applicable (see "Hub/Project Region" columns in the following tables).
 
-[!INCLUDE [uses-hub-only](../ai-foundry/includes/uses-hub-only.md)]
 
 [!INCLUDE [region-availability-maas](../ai-foundry/includes/region-availability-maas.md)]
 
