Merge pull request #1561 from sdgilley/sdg-main-update-tutorial

Update SDK tutorial

Author: v-dirichards

articles/ai-studio/includes/create-env-file-tutorial.md

@@ -23,6 +23,8 @@ CHAT_MODEL="gpt-4o-mini"
 EVALUATION_MODEL="gpt-4o-mini"
 ```
 
+If you changed the name of the models you deployed, or you want to try different models, update those names in this `.env` file.
+
 Find your connection string in the Azure AI Studio project you created in the [AI Studio playground quickstart](../quickstarts/get-started-playground.md).  Open the project, then find the connection string on the **Overview** page.  Copy the connection string and paste it into the `.env` file.
 
 :::image type="content" source="../media/quickstarts/azure-ai-sdk/connection-string.png" alt-text="Screenshot shows the overview page of a project and the location of the connection string.":::

articles/ai-studio/tutorials/copilot-sdk-create-resources.md

@@ -1,5 +1,5 @@
 ---
-title: "Part 1: Set up project and development environment to build a a custom knowledge retrieval (RAG) app"
+title: "Part 1: Set up project and development environment to build a custom knowledge retrieval (RAG) app"
 titleSuffix: Azure AI Studio
 description:  Build a custom chat app using the Azure AI Foundry SDK. Part 1 of a 3-part tutorial series, which shows how to create the resources you'll need for parts 2 and 3.
 manager: scottpolly
@@ -44,8 +44,31 @@ To create a project in [Azure AI Studio](https://ai.azure.com), follow these ste
 1. Go to the **Home** page of [Azure AI Studio](https://ai.azure.com).
 1. Select **+ Create project**.
 1. Enter a name for the project.  Keep all the other settings as default.
+1. Projects are created in hubs.  For this tutorial, create a new hub. If you see **Create a new hub** select it and specify a name.  Then select **Next**. (If you don't see **Create new hub**, it's because a new one is being created for you.) 
+1. Select **Customize** to specify properties of the hub.
+1. Use any values you want, except for **Region**.  We recommend you use either **East US2** or **Sweden Central** for the region for this tutorial series.
+1. Select **Next**.
 1. Select **Create project**.
 
+## Deploy models
+
+You need two models to build a RAG-based chat app: an Azure OpenAI chat model (`gpt-4o-mini`) and an Azure OpenAI embedding model (`text-embedding-ada-002`). Deploy these models in your Azure AI Studio project, using this set of steps for each model.
+
+These steps deploy a model to a real-time endpoint from the AI Studio [model catalog](../how-to/model-catalog-overview.md):
+
+1. On the left navigation pane, select **Model catalog**.
+1. Select the **gpt-4o-mini** model from the list of models. You can use the search bar to find it. 
+
+    :::image type="content" source="../media/tutorials/chat/select-model.png" alt-text="Screenshot of the model selection page." lightbox="../media/tutorials/chat/select-model.png":::
+
+1. On the model details page, select **Deploy**.
+
+    :::image type="content" source="../media/tutorials/chat/deploy-model.png" alt-text="Screenshot of the model details page with a button to deploy the model." lightbox="../media/tutorials/chat/deploy-model.png":::
+
+1. Leave the default **Deployment name**. select **Deploy**.  Or, if the model isn't available in your region, a different region is selected for you and connected to your project.  In this case, select **Connect and deploy**.
+
+After you deploy the **gpt-4o-mini**, repeat the steps to deploy the **text-embedding-ada-002** model.
+
 ## Create an Azure AI Search service
 
 The goal with this application is to ground the model responses in your custom data. The search index is used to retrieve relevant documents based on the user's question.
@@ -80,10 +103,13 @@ In the Azure AI Studio, check for an Azure AI Search connected resource.
 1. Otherwise, select **New connection** and then **Azure AI Search**.
 1. Find your Azure AI Search service in the options and select **Add connection**.
 1. Use **API key** for **Authentication**.
+
+    > [!NOTE]
+    > You can instead use **Microsoft Entra ID** for **Authentication**. If you do this, you must also configure access control for the Azure AI Search service. Assign yourself the **Search Index Data Contributor** and **Search Service Contributor** roles. If you don't know how to do this, or don't have the necessary permissions, use the **API key** for **Authentication**.
+
 1. Select **Add connection**.  
 
-> [!NOTE]
-> You can instead use **Microsoft Entra ID** for **Authentication**. If you do this, you must also configure access control for the Azure AI Search service. Assign yourself the **Cognitive Services OpenAI User** role. If you don't know how to do this, or don't have the necessary permissions, use the **API key** for **Authentication**.
+
 
 ## <a name="installs"></a> Install the Azure CLI and sign in 
 
@@ -113,25 +139,6 @@ Create a folder for your work. Create a file called **config.py** in this folder
 
 :::code language="python" source="~/azureai-samples-nov2024/scenarios/rag/custom-rag-app/config.py":::
 
-## Deploy models
-
-You need two models to build a RAG-based chat app: an Azure OpenAI chat model (`gpt-4o-mini`) and an Azure OpenAI embedding model (`text-embedding-ada-002`). Deploy these models in your Azure AI Studio project, using this set of steps for each model.
-
-These steps deploy a model to a real-time endpoint from the AI Studio [model catalog](../how-to/model-catalog-overview.md):
-
-1. Sign in to [Azure AI Studio](https://ai.azure.com).
-1. Studio remembers where you were last, so you should now see the project you created at the beginning of this tutorial. If you instead see a list of projects, select the one you created for this tutorial.
-1. Select the **gpt-4o-mini** model from the list of models. You can use the search bar to find it. 
-
-    :::image type="content" source="../media/tutorials/chat/select-model.png" alt-text="Screenshot of the model selection page." lightbox="../media/tutorials/chat/select-model.png":::
-
-1. On the model details page, select **Deploy**.
-
-    :::image type="content" source="../media/tutorials/chat/deploy-model.png" alt-text="Screenshot of the model details page with a button to deploy the model." lightbox="../media/tutorials/chat/deploy-model.png":::
-
-1. Leave the default **Deployment name**. Select **Connect and deploy**.
-
-After you deploy the **gpt-4o-mini**, repeat the steps to deploy the **text-embedding-ada-002** model.
 
 ## Configure environment variables
 

articles/ai-studio/tutorials/copilot-sdk-evaluate.md

@@ -17,9 +17,9 @@ author: sdgilley
 In this tutorial, you use the Azure AI SDK (and other libraries) to  evaluate and deploy the chat app you built in [Part 2 of the tutorial series](copilot-sdk-build-rag.md). In this part three, you learn how to:
 
 > [!div class="checklist"]
-> - Evaluate the quality of chat app responses
-> - Deploy the chat app to Azure
-> - Verify the deployment
+> - Create an evaluation dataset
+> - Evaluate the chat app with Azure AI evaluators
+
 
 This tutorial is part three of a three-part tutorial.
 
@@ -72,7 +72,6 @@ The script also logs the evaluation results to the cloud project so that you can
 
     :::code language="python" source="~/azureai-samples-nov2024/scenarios/rag/custom-rag-app/evaluate.py" id="run_evaluation":::
 
-
 ### Configure the evaluation model 
 
 Since the evaluation script calls the model many times, you might want to increase the number of tokens per minute for the evaluation model.  
@@ -96,7 +95,7 @@ In Part 1 of this tutorial series, you created an **.env** file that specifies t
 1. Install the required package:
 
     ```bash
-    pip install azure_ai-evaluation[remote]
+    pip install azure_ai-evaluation[prompts]
     ```
 
 1. Now run the evaluation script:

articles/ai-studio/tutorials/deploy-chat-web-app.md

@@ -8,7 +8,7 @@ ms.custom:
   - ignite-2023
   - build-2024
 ms.topic: tutorial
-ms.date: 10/28/2024
+ms.date: 11/14/2024
 ms.reviewer: tgokal
 ms.author: sgilley
 author: sdgilley