Skip to content

Commit

Permalink
Update workshop instructions to replace Azure AI Studio references wi…
Browse files Browse the repository at this point in the history
…th Azure AI Foundry and enhance clarity with updated images.
  • Loading branch information
BethanyJep authored Nov 19, 2024
1 parent 06c778c commit e95bf3f
Show file tree
Hide file tree
Showing 25 changed files with 21 additions and 21 deletions.
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ This repository is for the AI Tour workshop: Interacting with Large Language Mod

## Session Description

This workshop is designed to give you a hands-on introduction to the core concepts and best practices for interacting with OpenAI models in AAzure AI Foundry portal. If you have been provided with a Skillable Environment, you'll be using the VM and pre-provisioned Azure resources provided to you to complete the lab. If you are running this workshop on your own, you will need to have an Azure subscription and provision the resources yourself by deploying the resources to Azure.
This workshop is designed to give you a hands-on introduction to the core concepts and best practices for interacting with OpenAI models in Azure AI Foundry portal. If you have been provided with a Skillable Environment, you'll be using the VM and pre-provisioned Azure resources provided to you to complete the lab. If you are running this workshop on your own, you will need to have an Azure subscription and provision the resources yourself by deploying the resources to Azure.

[![Deploy to Azure](https://aka.ms/deploytoazurebutton)](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2Fmicrosoft%2Faitour-interact-with-llms%2Fmain%2Flab%2FWorkshop%20Instructions%2Fassets%2FAITour24_WKR540_Template.json)

Expand Down
20 changes: 10 additions & 10 deletions lab/Skillable Workshop Instructions/01_Set_up.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ In this workshop we will be working on Azure AI Foundry portal, focusing especia

1. On the Desktop, click on **Microsoft Edge** browser. Navigate to the second browser tab which will be showing the Azure AI Foundry portal homepage as shown in the following image.

![Homepage of Azure AI Foundry](./Images/aistudio-homepage.jpeg)
![Homepage of Azure AI Foundry](./Images/aifoundry-homepage.jpeg)

## Navigating Azure AI Foundry portal

Expand All @@ -32,7 +32,7 @@ In this workshop we will be working on Azure AI Foundry portal, focusing especia

## Project

![project overview tab](./Images/aistudio-project-overview.jpeg)
![project overview tab](./Images/aifoundry-project-overview.jpeg)

### Project Overview

Expand All @@ -46,10 +46,10 @@ On this page, we can see an overview of our Azure AI Foundry portal Project. Thi

You will notice the navigation bar has updated with new tabs, which represent functionalities tied to our project.

![project navigation bar](./Images/aistudio-project-navigation.jpeg)
![project navigation bar](./Images/aifoundry-project-navigation.jpeg)

We have two new sections:
1. The first section includes _Playgrounds_ to interact with the models, _Overview_ which provides a general overview of your project, _Model Catalog_ which showcases the available models inside Azure AI Studio, and _AI Services_ where you can see a list of Azure AI Services available along with demos, use cases and more.
1. The first section includes _Playgrounds_ to interact with the models, _Overview_ which provides a general overview of your project, _Model Catalog_ which showcases the available models inside Azure AI Foundry, and _AI Services_ where you can see a list of Azure AI Services available along with demos, use cases and more.
1. **Build and Customize**: This includes useful opportunities to expand your project's reach, such as _working in Code_ by running a cloud compute, access to [_Prompt Flow_](https://learn.microsoft.com/en-us/azure/ai-studio/how-to/prompt-flow), and the ability to carry _Fine Tuning_ on your deployments.
1. **Assess and Improve:** this includes development of _Evaluations_ for your models, _tracing_ to debug your flows and _content filters_ to add guardrails to prompt inputs and completion outputs.
1. **My assets**: Here you can add additional elements to the project, with resources such as _Data_, _Indexes_, _models and endpoints_ and _Web apps_ to be used as part of your work.
Expand All @@ -68,13 +68,13 @@ We will be doing most of our work in these Playgrounds, but namely in the follow
1. **Real-time audio playground**
1. **Assistants playground**

![Image of Azure AI Foundry Playgrounds](./Images/aistudio-playgrounds.jpeg)
![Image of Azure AI Foundry Playgrounds](./Images/aifoundry-playgrounds.jpeg)

### Chat Playground

Within the playground section, navigate to the **Chat playground** and select **Try the Chat Playground.** This feature allows you to engage with and test various AI models in a conversational format.

![Image of Azure AI Foundry Playground Chat Mode](./Images/aistudio-chat-playground.jpeg)
![Image of Azure AI Foundry Playground Chat Mode](./Images/aifoundry-chat-playground.jpeg)

1. **Deployment**: This section allows us to change between our deployed models.
1. **System Message Box**: Here is where we enter instructions for the model, previous to the user interaction.
Expand All @@ -87,7 +87,7 @@ Within the playground section, navigate to the **Chat playground** and select **

Navigate back to Playgrounds, select the **Image playground** and click **Try the Image Playground.** This option allows you to work with image generation

![Image of Azure AI Foundry Playground Images Mode](./Images/aistudio-image-playground.jpeg)
![Image of Azure AI Foundry Playground Images Mode](./Images/aifoundry-image-playground.jpeg)

1. **Deployments**: In this drop-down we are able to choose the model to prompt for image generation. These models, just like the chat ones, come from our deployments.
1. **Prompt Box**: Similar to the chat playground's box, this is where the models get their input from the user. In the case of images, descriptions of what we want to generate.
Expand All @@ -97,7 +97,7 @@ Navigate back to Playgrounds, select the **Image playground** and click **Try th

Navigate back to Playgrounds, then select the **Real-time audio playground** and click **Try the Real-time audio Playground.** This feature allows you to engage with and test various AI models in an audio conversational format.

![Image of Azure AI Foundry Playground Real time audio mode](./Images/aistudio-real-time-audio.jpeg)
![Image of Azure AI Foundry Playground Real time audio mode](./Images/aifoundry-real-time-audio.jpeg)

1. **Deployment**: This section allows us to change between our deployed models.
1. **Server turn detection**: Determines if the server should utilize voice activity detection (VAD) to identify when a user has finished speaking.
Expand All @@ -111,7 +111,7 @@ Navigate back to Playgrounds, then select the **Real-time audio playground** and

In the Navigation bar, select **Assistants**. This feature provides you with the tools to build, test, and customize AI-driven assistants.

![Image of Azure AI Foundry Playground assistants Mode](./Images/aistudio-assistant-plaground.jpeg)
![Image of Azure AI Foundry Playground assistants Mode](./Images/aifoundry-assistant-plaground.jpeg)

Once you _create your first assistant_ you will see the UI components as follows:
1. **Assistant id and name**: Here you can give your assistant a name.
Expand All @@ -126,7 +126,7 @@ Once you _create your first assistant_ you will see the UI components as follows

## Ready to start

That covers the necessary setup and basics of Azure AI Studio. We will now move forward to begin interacting with the models.
That covers the necessary setup and basics of Azure AI Foundry portal . We will now move forward to begin interacting with the models.

- Navigate to the **playgrounds** select the **Chat playground** and click **Try the Chat Playground.**
- In the _instructions tab_, Click Next to proceed to Part 1: Text Generation
Expand Down
6 changes: 3 additions & 3 deletions lab/Skillable Workshop Instructions/02_Text_Generation.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ Welcome to Part 1 of this workshop, where we'll be interacting with gpt-4o-mini

Let's start with a few prompts and observe the response using the chat playground. To use the chat playground, follow the following steps:

![image showing the chat interface](./Images/aistudio-chat-basicprompting.jpeg)
![image showing the chat interface](./Images/aifoundry-chat-basicprompting.jpeg)

1. Navigate to the playgrounds section, on the left-hand navigation bar, and click **Try the Chat Playground.**
2. In the Chat playground, find the text box labeled _"Type user query here."_
Expand Down Expand Up @@ -39,7 +39,7 @@ Note that the model is providing a copy for the *SweetScoops Delight* website, e
You can control your model parameters as follows:

![image showing parameters tab](./Images/aistudio-chat-parameters.jpeg)
![image showing parameters tab](./Images/aifoundry-chat-parameters.jpeg)

1. In the Chat interface, navigate to the **Parameters** section.
2. Once in the Parameters section, adjust the setting controls. You can change the number of past messages included which the model will consider as context. Once set, the changes will be applied automatically.
Expand Down Expand Up @@ -125,7 +125,7 @@ Take a step-by-step approach in your response: Start by thinking about the theme
> [!TIP]
> What is the **system message**? The system message is used to communicate instructions or provide context to the model at the beginning of a conversation. It is displayed in a different format compared to user messages, helping the model understand its role in the conversation. The system message typically guides the model's behavior, sets the tone, or specifies desired output from the model. By utilizing the system message effectively, users can steer the model towards generating more accurate and relevant responses.
![image showing system message tab](./Images/aistudio-chat-instructions.jpeg)
![image showing system message tab](./Images/aifoundry-chat-instructions.jpeg)

Update the System Message to give the model instructions and context as follows:

Expand Down
4 changes: 2 additions & 2 deletions lab/Skillable Workshop Instructions/03_Image_Generation.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ Welcome to part 2 of this workshop, where we will interact with a text-to-image

To create your first image, follow the following steps:

![image showing image generation](./Images/aistudio-image-generation.jpeg)
![image showing image generation](./Images/aifoundry-image-generation.jpeg)

1. Navigate to the **playgrounds**, on the left-hand navigation bar, and select **Try the Image Playground**
2. In the Images playground, find and click on the drop-down menu labeled **Deployments**. From the drop-down list, select **dall-e-3**.
Expand Down Expand Up @@ -124,7 +124,7 @@ Beyond its aesthetic appeal, the 3D Animated Office Space Design is designed wit

2. Once you get the response, click on the three dots at the top of the response and click on **Copy response to clipboard**.

![Image of copying option](./Images/ai-studio-copy-response.png)
![Image of copying option](./Images/ai-foundry-copy-response.png)

3. Navigate back to the **Images playground** to generate an image from the prompt response.

Expand Down
10 changes: 5 additions & 5 deletions lab/Skillable Workshop Instructions/05_AI_Assistants.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ Lastly, we can **Run** the Assistant. This means activating an Assistant to begi

1. Navigate back to _Playgrounds_ and click on the **try assistants playground** button. Here you will see the different components of the Playground. Click **+ create an assistant** to get started.

![Assistants Playground](./Images/aistudio-create-new-assistant.jpeg)
![Assistants Playground](./Images/aifoundry-create-new-assistant.jpeg)

2. In the **Deployments** section, ensure you select **gpt-4o-mini** model.

Expand All @@ -56,17 +56,17 @@ Lastly, we can **Run** the Assistant. This means activating an Assistant to begi
If a question is not related to sales or you cannot answer the question, you **must** respond: "Please contact IT for more assistance". If the user asks for help or says 'help', provide a list of sample questions that you can answer.
```
![Assistants Playground](./Images/aistudio-assistant-update-details.jpeg)
![Assistants Playground](./Images/aifoundry-assistant-update-details.jpeg)
>[!NOTE]
>How many prompt engineering techniques from the previous sections are you able to identify in this prompt? For clues, check Part 2 of the workshop.
4. Click on the **Tools** tab, and click to enable **Code Interpreter** then click **Add files**.
![assistant attach new file](Images/aistudio-tools-codeinterpreter.jpeg)
![assistant attach new file](Images/aifoundry-tools-codeinterpreter.jpeg)
6. On the pop up window, click on **select local files** and select the `Contoso_Sales_Revenue.csv` file on your Desktop.
![assistants code interpreter](Images/aistudio-codeinterpreter-upload-file.jpeg)
![assistants code interpreter](Images/aifoundry-codeinterpreter-upload-file.jpeg)
>[!NOTE]
> If you cannot find the file on your desktop, you can download it from [here](assets/Contoso_Sales_Revenue.csv).
Expand Down Expand Up @@ -98,6 +98,6 @@ You will notice that we get a series of sample questions that we can test. Test
The assistant should provide you with a graph showcasing a trending product by carrying out an analysis of the sales revenue data overtime.
Congratulations! You have now completed the last part of the workshop and have learnt what Azure OpenAI Assistants are, how they work and how to create one using Azure AI Foundry.
Congratulations! You have now completed the last part of the workshop and have learnt what Azure OpenAI Assistants are, how they work and how to create one using Azure AI Foundry portal.
Click **Next** to advance to the Summary section of the workshop.

0 comments on commit e95bf3f

Please sign in to comment.