diff --git a/Instructions/Exercises/01-get-started-azure-openai.md b/Instructions/Exercises/01-get-started-azure-openai.md index 8b452bd3..bc4b1cac 100644 --- a/Instructions/Exercises/01-get-started-azure-openai.md +++ b/Instructions/Exercises/01-get-started-azure-openai.md @@ -116,4 +116,4 @@ In addition to generating natural language responses, you can use GPT models to ## Clean up -When you're done with your Azure OpenAI resource, remember to delete the deployment or the entire resource in the [Azure portal](https://portal.azure.com?azure-portal=true). +When you're done with your Azure OpenAI resource, remember to delete the deployment or the entire resource in the **Azure portal** at `https://portal.azure.com`. diff --git a/Instructions/Exercises/02-natural-language-azure-openai.md b/Instructions/Exercises/02-natural-language-azure-openai.md index b3498a6c..a891834e 100644 --- a/Instructions/Exercises/02-natural-language-azure-openai.md +++ b/Instructions/Exercises/02-natural-language-azure-openai.md @@ -13,7 +13,7 @@ This exercise will take approximately **30** minutes. If you don't already have one, provision an Azure OpenAI resource in your Azure subscription. -1. Sign into the [Azure portal](https://portal.azure.com) at `https://portal.azure.com`. +1. Sign into the **Azure portal** at `https://portal.azure.com`. 2. Create an **Azure OpenAI** resource with the following settings: - **Subscription**: *Select an Azure subscription that has been approved for access to the Azure OpenAI service* - **Resource group**: *Choose or create a resource group* @@ -59,7 +59,7 @@ You'll develop your Azure OpenAI app using Visual Studio Code. The code files fo Applications for both C# and Python have been provided, as well as a sample text file you'll use to test the summarization. Both apps feature the same functionality. First, you'll complete some key parts of the application to enable using your Azure OpenAI resource. 1. In Visual Studio Code, in the **Explorer** pane, browse to the **Labfiles/02-nlp-azure-openai** folder and expand the **CSharp** or **Python** folder depending on your language preference. Each folder contains the language-specific files for an app into which you're you're going to integrate Azure OpenAI functionality. -2. Right-click the **CSharp** or **Python** folder containing your code files and open an integrated terminal. Then install the Azure AI Vision SDK package by running the appropriate command for your language preference: +2. Right-click the **CSharp** or **Python** folder containing your code files and open an integrated terminal. Then install the Azure OpenAI SDK package by running the appropriate command for your language preference: **C#**: @@ -78,7 +78,9 @@ Applications for both C# and Python have been provided, as well as a sample text - **C#**: appsettings.json - **Python**: .env -4. Update the configuration values to include the **endpoint** and **key** from the Azure OpenAI resource you created (available on the **Keys and Endpoint** page for your Azure OpenAI resource in the Azure portal), as well as the name you specified for your model deployment (available in the **Deployments** page in Azure OpenAI Studio). +4. Update the configuration values to include: + - The **endpoint** and a **key** from the Azure OpenAI resource you created (available on the **Keys and Endpoint** page for your Azure OpenAI resource in the Azure portal) + - The **model name** you specified for your model deployment (available in the **Deployments** page in Azure OpenAI Studio). 5. Save the configuration file. ## Add code to use the Azure OpenAI service @@ -177,4 +179,4 @@ Increasing the temperature often causes the summary to vary, even when provided ## Clean up -When you're done with your Azure OpenAI resource, remember to delete the deployment or the entire resource in the [Azure portal](https://portal.azure.com). +When you're done with your Azure OpenAI resource, remember to delete the deployment or the entire resource in the **Azure portal** at `https://portal.azure.com`. diff --git a/Instructions/Exercises/03-prompt-engineering.md b/Instructions/Exercises/03-prompt-engineering.md index 47654e73..7382f9ca 100644 --- a/Instructions/Exercises/03-prompt-engineering.md +++ b/Instructions/Exercises/03-prompt-engineering.md @@ -13,7 +13,7 @@ This exercise will take approximately **25** minutes. If you don't already have one, provision an Azure OpenAI resource in your Azure subscription. -1. Sign into the [Azure portal](https://portal.azure.com) at `https://portal.azure.com`. +1. Sign into the **Azure portal** at `https://portal.azure.com`. 2. Create an **Azure OpenAI** resource with the following settings: - **Subscription**: *Select an Azure subscription that has been approved for access to the Azure OpenAI service* - **Resource group**: *Choose or create a resource group* @@ -45,7 +45,7 @@ Azure OpenAI provides a web-based portal named **Azure OpenAI Studio**, that you Let's start by exploring some prompt engineering techniques in the Chat playground. -1. In [Azure OpenAI Studio](https://oai.azure.com), in the **Playground** section, select the **Chat** page. The **Chat** playground page consists of three main sections: +1. In **Azure OpenAI Studio** at `https://oai.azure.com`, in the **Playground** section, select the **Chat** page. The **Chat** playground page consists of three main sections: - **Assistant setup** - used to set the context for the model's responses. - **Chat session** - used to submit chat messages and view responses. - **Configuration** - used to configure settings for the model deployment. @@ -173,7 +173,7 @@ Now let's explore the use of prompt engineering in an app that uses the Azure Op Applications for both C# and Python have been provided, as well as a sample text file you'll use to test the summarization. Both apps feature the same functionality. First, you'll complete some key parts of the application to enable using your Azure OpenAI resource. 1. In Visual Studio Code, in the **Explorer** pane, browse to the **Labfiles/03-prompt-engineering** folder and expand the **CSharp** or **Python** folder depending on your language preference. Each folder contains the language-specific files for an app into which you're you're going to integrate Azure OpenAI functionality. -2. Right-click the **CSharp** or **Python** folder containing your code files and open an integrated terminal. Then install the Azure AI Vision SDK package by running the appropriate command for your language preference: +2. Right-click the **CSharp** or **Python** folder containing your code files and open an integrated terminal. Then install the Azure OpenAI SDK package by running the appropriate command for your language preference: **C#**: @@ -192,7 +192,9 @@ Applications for both C# and Python have been provided, as well as a sample text - **C#**: appsettings.json - **Python**: .env -4. Update the configuration values to include the **endpoint** and **key** from the Azure OpenAI resource you created (available on the **Keys and Endpoint** page for your Azure OpenAI resource in the Azure portal), as well as the name you specified for your model deployment (available in the **Deployments** page in Azure OpenAI Studio). +4. Update the configuration values to include: + - The **endpoint** and a **key** from the Azure OpenAI resource you created (available on the **Keys and Endpoint** page for your Azure OpenAI resource in the Azure portal) + - The **model name** you specified for your model deployment (available in the **Deployments** page in Azure OpenAI Studio). 5. Save the configuration file. ## Add code to use the Azure OpenAI service @@ -304,4 +306,4 @@ Each prompt is displayed in the console as it sends for you to see how differenc ## Clean up -When you're done with your Azure OpenAI resource, remember to delete the deployment or the entire resource in the [Azure portal](https://portal.azure.com). +When you're done with your Azure OpenAI resource, remember to delete the deployment or the entire resource in the **Azure portal** at `https://portal.azure.com`. diff --git a/Instructions/Exercises/04-code-generation.md b/Instructions/Exercises/04-code-generation.md index 25be2a25..d8a85734 100644 --- a/Instructions/Exercises/04-code-generation.md +++ b/Instructions/Exercises/04-code-generation.md @@ -13,7 +13,7 @@ This exercise will take approximately **25** minutes. If you don't already have one, provision an Azure OpenAI resource in your Azure subscription. -1. Sign into the [Azure portal](https://portal.azure.com) at `https://portal.azure.com`. +1. Sign into the **Azure portal** at `https://portal.azure.com`. 2. Create an **Azure OpenAI** resource with the following settings: - **Subscription**: *Select an Azure subscription that has been approved for access to the Azure OpenAI service* - **Resource group**: *Choose or create a resource group* @@ -45,7 +45,7 @@ Azure OpenAI provides a web-based portal named **Azure OpenAI Studio**, that you Before using in your app, examine how Azure OpenAI can generate and explain code in the chat playground. -1. In [Azure OpenAI Studio](https://oai.azure.com), in the **Playground** section, select the **Chat** page. The **Chat** playground page consists of three main sections: +1. In the **Azure OpenAI Studio** at `https://oai.azure.com`, in the **Playground** section, select the **Chat** page. The **Chat** playground page consists of three main sections: - **Assistant setup** - used to set the context for the model's responses. - **Chat session** - used to submit chat messages and view responses. - **Configuration** - used to configure settings for the model deployment. @@ -117,7 +117,7 @@ Now let's explore how you could build a custom app that uses Azure OpenAI servic Applications for both C# and Python have been provided, as well as a sample text file you'll use to test the summarization. Both apps feature the same functionality. First, you'll complete some key parts of the application to enable using your Azure OpenAI resource. 1. In Visual Studio Code, in the **Explorer** pane, browse to the **Labfiles/04-code-generation** folder and expand the **CSharp** or **Python** folder depending on your language preference. Each folder contains the language-specific files for an app into which you're you're going to integrate Azure OpenAI functionality. -2. Right-click the **CSharp** or **Python** folder containing your code files and open an integrated terminal. Then install the Azure AI Vision SDK package by running the appropriate command for your language preference: +2. Right-click the **CSharp** or **Python** folder containing your code files and open an integrated terminal. Then install the Azure OpenAI SDK package by running the appropriate command for your language preference: **C#**: @@ -136,7 +136,9 @@ Applications for both C# and Python have been provided, as well as a sample text - **C#**: appsettings.json - **Python**: .env -4. Update the configuration values to include the **endpoint** and **key** from the Azure OpenAI resource you created (available on the **Keys and Endpoint** page for your Azure OpenAI resource in the Azure portal), as well as the name you specified for your model deployment (available in the **Deployments** page in Azure OpenAI Studio). +4. Update the configuration values to include: + - The **endpoint** and a **key** from the Azure OpenAI resource you created (available on the **Keys and Endpoint** page for your Azure OpenAI resource in the Azure portal) + - The **model name** you specified for your model deployment (available in the **Deployments** page in Azure OpenAI Studio). 5. Save the configuration file. ## Add code to use your Azure OpenAI service model @@ -261,4 +263,4 @@ Now that your app has been configured, run it to try generating code for each us ## Clean up -When you're done with your Azure OpenAI resource, remember to delete the deployment or the entire resource in the [Azure portal](https://portal.azure.com). +When you're done with your Azure OpenAI resource, remember to delete the deployment or the entire resource in the **Azure portal** at `https://portal.azure.com`. diff --git a/Instructions/Exercises/05-generate-images.md b/Instructions/Exercises/05-generate-images.md index 894149d6..1f1ae944 100644 --- a/Instructions/Exercises/05-generate-images.md +++ b/Instructions/Exercises/05-generate-images.md @@ -13,7 +13,7 @@ This exercise will take approximately **25** minutes. Before you can use Azure OpenAI models, you must provision an Azure OpenAI resource in your Azure subscription. -1. Sign into the [Azure portal](https://portal.azure.com) at `https://portal.azure.com`. +1. Sign into the **Azure portal** at `https://portal.azure.com`. 2. Create an **Azure OpenAI** resource with the following settings: - **Subscription**: *Select an Azure subscription that has been approved for access to the Azure OpenAI service, including DALL-E* - **Resource group**: *Choose or create a resource group* @@ -115,4 +115,4 @@ Now that you've reviewed the code, it's time to run it and generate some images. ## Clean up -When you're done with your Azure OpenAI resource, remember to delete the resource in the [Azure portal](https://portal.azure.com). +When you're done with your Azure OpenAI resource, remember to delete the resource in the **Azure portal** at `https://portal.azure.com`. diff --git a/Instructions/Exercises/06-use-own-data.md b/Instructions/Exercises/06-use-own-data.md index 4e83007c..a1037298 100644 --- a/Instructions/Exercises/06-use-own-data.md +++ b/Instructions/Exercises/06-use-own-data.md @@ -13,7 +13,7 @@ This exercise will take approximately **20** minutes. If you don't already have one, provision an Azure OpenAI resource in your Azure subscription. -1. Sign into the [Azure portal](https://portal.azure.com) at `https://portal.azure.com`. +1. Sign into the **Azure portal** at `https://portal.azure.com`. 2. Create an **Azure OpenAI** resource with the following settings: - **Subscription**: *Select an Azure subscription that has been approved for access to the Azure OpenAI service* - **Resource group**: *Choose or create a resource group* @@ -55,7 +55,7 @@ Azure OpenAI provides a web-based portal named **Azure OpenAI Studio**, that you Before connecting Azure OpenAI to your data, let's first observe how the base model responds to queries without any grounding data. -1. In [Azure OpenAI Studio](https://oai.azure.com), in the **Playground** section, select the **Chat** page. The **Chat** playground page consists of three main sections: +1. In **Azure OpenAI Studio** at `https://oai.azure.com`, in the **Playground** section, select the **Chat** page. The **Chat** playground page consists of three main sections: - **Assistant setup** - used to set the context for the model's responses. - **Chat session** - used to submit chat messages and view responses. - **Configuration** - used to configure settings for the model deployment. @@ -152,7 +152,7 @@ Now let's explore the use of your own data in an app that uses the Azure OpenAI Applications for both C# and Python have been provided, as well as a sample text file you'll use to test the summarization. Both apps feature the same functionality. First, you'll complete some key parts of the application to enable using your Azure OpenAI resource. 1. In Visual Studio Code, in the **Explorer** pane, browse to the **Labfiles/06-use-own-data** folder and expand the **CSharp** or **Python** folder depending on your language preference. Each folder contains the language-specific files for an app into which you're you're going to integrate Azure OpenAI functionality. -2. Right-click the **CSharp** or **Python** folder containing your code files and open an integrated terminal. Then install the Azure AI Vision SDK package by running the appropriate command for your language preference: +2. Right-click the **CSharp** or **Python** folder containing your code files and open an integrated terminal. Then install the Azure OpenAI SDK package by running the appropriate command for your language preference: **C#**: @@ -173,7 +173,7 @@ Applications for both C# and Python have been provided, as well as a sample text 4. Update the configuration values to include: - The **endpoint** and a **key** from the Azure OpenAI resource you created (available on the **Keys and Endpoint** page for your Azure OpenAI resource in the Azure portal) - - The name you specified for your model deployment (available in the **Deployments** page in Azure OpenAI Studio). + - The **model name** you specified for your model deployment (available in the **Deployments** page in Azure OpenAI Studio). - The endpoint for your search service (the **Url** value on the overview page for your search resource in the Azure portal). - A **key** for your search resource (available in the **Keys** page for your search resource in the Azure portal - you can use either of the admin keys) - The name of the search index (which should be `margiestravel`). @@ -218,4 +218,4 @@ Now that your app has been configured, run it to send your request to your model ## Clean up -When you're done with your Azure OpenAI resource, remember to delete the resource in the [Azure portal](https://portal.azure.com). Be sure to also include the storage account and search resource, as those can incur a relatively large cost. +When you're done with your Azure OpenAI resource, remember to delete the resource in the **Azure portal** at `https://portal.azure.com`. Be sure to also include the storage account and search resource, as those can incur a relatively large cost.