diff --git a/docs/workshop/LAB-MANUAL-IGNITE.md b/docs/workshop/LAB-MANUAL-IGNITE.md deleted file mode 100644 index 0da2acd6..00000000 --- a/docs/workshop/LAB-MANUAL-IGNITE.md +++ /dev/null @@ -1,51 +0,0 @@ -## Azure Credentials: - -# CREDENTIALS - -++Username = "@lab.CloudPortalCredential(User1).Username" -Password = "@lab.CloudPortalCredential(User1).Password" -AzureEnvName = "AITOUR@lab.LabInstance.Id" -Subscription = "@lab.CloudSubscription.Id"++ - - -**If you are viewing this from the Skillable lab page** the above are your unique azure credentials. - -> **Note**: You will be asked to copy the above block in the lab later so keep this information readily available. - -**If you are viewing this from Github:** The above are not your credentials. They are placeholders. Your actual credentials can be seen on the Skillable lab page. - -*** - -### Welcome to Microsoft Ignite Lab400: Build a multi-agent AI assistant with Azure OpenA! - -In this session, you will learn how to build the app, **Contoso Creative Writer**. This app will assist the marketing team at Contoso Outdoors in creating trendy, well-researched articles to promote the company’s products. - -### Pre-Requisites - -To participate in this workshop, you will need: - -1. Your own laptop. - * It need only be capable of running a browser and GitHub Codespaces, so almost any laptop will do. - * A recent version of Edge, Chrome or Safari is recommended. -2. A GitHub Account. - * If you don't have one, you can [signup for a free account](https://github.com/signup) now. - * After this workshop is complete, you will have a fork of the "contoso-creative-writer" repository in your GitHub account, which includes all the materials you will need to reproduce this workshop at home. - - -### To begin this lab follow these steps: - -1. Confirm that you can see your **Azure Credentials** at the top of the page. - * You will use these to login to Azure Developer CLI (AZD) and Azure CLI (AZ) later. - -2. Click on this link [https://aka.ms/contoso-creative-writer-codespace](https://aka.ms/contoso-creative-writer-codespace). This will take you to a page where you can open a Codespace for Contoso Creative Writer. - * If you are not logged into Github already you will need to login using **your own** GitHub account credentials. - -3. Click the green **<> Create codespace** button at the bottom of the page. - * This will open a pre-built Codespace on main. - -4. Once your Codespace is ready: - * In the file explorer look for the **docs** folder and in it open the **workshop** folder. - * Open the **LAB-SETUP.ipynb** file. - * Follow the instructions to get going! - -Have fun building!🎉 diff --git a/docs/workshop/LAB-MANUAL.md b/docs/workshop/LAB-MANUAL.md index c5d2fd53..dccceb9d 100644 --- a/docs/workshop/LAB-MANUAL.md +++ b/docs/workshop/LAB-MANUAL.md @@ -2,15 +2,10 @@ # CREDENTIALS -```` -Username = "@lab.CloudPortalCredential(User1).Username" - +++Username = "@lab.CloudPortalCredential(User1).Username" Password = "@lab.CloudPortalCredential(User1).Password" - AzureEnvName = "AITOUR@lab.LabInstance.Id" - -Subscription = "@lab.CloudSubscription.Id" -```` +Subscription = "@lab.CloudSubscription.Id"++ **If you are viewing this from the Skillable lab page** the above are your unique azure credentials. @@ -21,7 +16,7 @@ Subscription = "@lab.CloudSubscription.Id" *** -### Welcome to the AI Tour and workshop WRK551! +### Welcome to this Microsoft workshop! In this session, you will learn how to build the app, **Contoso Creative Writer**. This app will assist the marketing team at Contoso Outdoors in creating trendy, well-researched articles to promote the company’s products. @@ -35,32 +30,22 @@ To participate in this workshop, you will need: 2. A GitHub Account. * If you don't have one, you can [signup for a free account](https://github.com/signup) now. * After this workshop is complete, you will have a fork of the "contoso-creative-writer" repository in your GitHub account, which includes all the materials you will need to reproduce this workshop at home. -3. Familiarity with Visual Studio Code. - * We will run all code in GitHub Codespaces, a virtualized Linux machine, instead of your local laptop. We won't be running anything on your laptop directly. - * VS Code Online will be our development environment in GitHub Codespaces. - * If you are familiar with running Codespaces within VS Code Desktop on your laptop, feel free to do so. -4. (preferred) Familiarity with the *bash* shell. - * We'll be using *bash* to run commands in the VS Code terminal. + ### To begin this lab follow these steps: 1. Confirm that you can see your **Azure Credentials** at the top of the page. * You will use these to login to Azure Developer CLI (AZD) and Azure CLI (AZ) later. -2. Click on this link [https://aka.ms/aitour/wrk551](https://aka.ms/aitour/wrk551). This will take you to the project Github repository. +2. Click on this link [https://aka.ms/contoso-creative-writer-codespace](https://aka.ms/contoso-creative-writer-codespace). This will take you to a page where you can open a Codespace for Contoso Creative Writer. * If you are not logged into Github already you will need to login using **your own** GitHub account credentials. -3. Click the green **<> Code** button in the top-right part of the page. - * Click the Codespaces tab - * Then click **Create codespace on main** +3. Click the green **<> Create codespace** button at the bottom of the page. * This will open a pre-built Codespace on main. - > **🚧 IMPORTANT**: Do not open the GitHub Codespace on a fork of the repository, this would prevent you from using the prebuilt Codespace container image. Don't worry, you'll have the possibility to fork the repository later. - 4. Once your Codespace is ready: * In the file explorer look for the **docs** folder and in it open the **workshop** folder. - * Open the **WORKSHOP-README.md** file. (There are other Readme files in the folder,specifically open the workshop one.) + * Open the **LAB-SETUP.ipynb** file. * Follow the instructions to get going! - * When following the steps to login to AZD and AZ in Part 1 of this file, use the [azure credentials](#azure-credentials) at the top of the Skillable manual to login. Have fun building!🎉 diff --git a/docs/workshop/LAB-SETUP.ipynb b/docs/workshop/LAB-SETUP.ipynb index 327bea97..6597c050 100644 --- a/docs/workshop/LAB-SETUP.ipynb +++ b/docs/workshop/LAB-SETUP.ipynb @@ -8,6 +8,8 @@ "\n", "✨This is a Jupyter Notebook that allows you to run Python code interactively 🐍✨\n", "\n", + "🚨**Double click on the notebook tab** above to keep the notebook open! \n", + "\n", "1. Click the **Select Kernel** button on the top right of the notebook.\n", "2. Choose **Python environments** and select **Python 3.11**.\n", "\n", @@ -107,7 +109,7 @@ "source": [ "2. Sign in to Azure Developer CLI. \n", "\n", - " > **🚧 IMPORTANT**: Use the following `username` and `password` when prompted to sign in with an email and password." + " > **🚨 IMPORTANT**: Use the following `username` and `password` when prompted to sign in with an email and password." ] }, { @@ -133,9 +135,11 @@ "cell_type": "markdown", "metadata": {}, "source": [ - "3. Next we will get the environment variables for your resource group.\n", + "### c. Get environment variables (You will need to use the terminal for step 1!)\n", + " \n", + "1. Next we will get the environment variables for your resource group.\n", "\n", - " > **🚧 IMPORTANT**: You will need to run the output of the next cell **in the terminal!**\n", + " > **🚨 IMPORTANT: You will need to run the output of the next cell in the terminal!**\n", " > \n", " > - Run the cell below and then copy the output and paste it in the terminal and press enter\n", " > - Select `Y` when asked if you'd like to create the environment \n", diff --git a/docs/workshop/workshop-1-intro.ipynb b/docs/workshop/workshop-1-intro.ipynb index 9d538581..c46c96a2 100644 --- a/docs/workshop/workshop-1-intro.ipynb +++ b/docs/workshop/workshop-1-intro.ipynb @@ -6,6 +6,8 @@ "source": [ "✨This is a Jupyter Notebook that allows you to run Python code interactively 🐍✨\n", "\n", + "🚨**Double click on the notebook tab** above to keep the notebook open! \n", + "\n", "**If you have not already:**\n", "1. Click the **Select Kernel** button on the top right of the notebook.\n", "2. Choose **Python environments** and select **Python 3.11**.\n", diff --git a/docs/workshop/workshop-2-tracing.ipynb b/docs/workshop/workshop-2-tracing.ipynb index a9895385..87c6e6fb 100644 --- a/docs/workshop/workshop-2-tracing.ipynb +++ b/docs/workshop/workshop-2-tracing.ipynb @@ -6,6 +6,8 @@ "source": [ "## 2. Utilizing Prompty tracing for debugging and observability\n", "\n", + "🚨**Double click on the notebook tab** above to keep the notebook open! \n", + "\n", "When running Applications driven by LLMs, sometimes things don't go as expected! \n", "
It's important to have a way to debug your LLM workflow so you can see where things are working. \n", "
Tracing helps you visualize the execution of your prompts and clearly see what inputs are being passed to the LLM. \n", diff --git a/docs/workshop/workshop-3-build.ipynb b/docs/workshop/workshop-3-build.ipynb index f0acbdb6..4b818a00 100644 --- a/docs/workshop/workshop-3-build.ipynb +++ b/docs/workshop/workshop-3-build.ipynb @@ -6,6 +6,8 @@ "source": [ "## 3. Building and running Contoso Creative Writer \n", "\n", + "🚨**Double click on the notebook tab** above to keep the notebook open! \n", + "\n", "We will now build and run Contoso Creativer Writer a multi-agent application! \n", "\n", "
\n", diff --git a/docs/workshop/workshop-4-ci-cd.ipynb b/docs/workshop/workshop-4-ci-cd.ipynb index b350aa80..a107a940 100644 --- a/docs/workshop/workshop-4-ci-cd.ipynb +++ b/docs/workshop/workshop-4-ci-cd.ipynb @@ -6,6 +6,8 @@ "source": [ "## 4. Setting up automated evaluations and deployment with Github Actions \n", "\n", + "🚨**Double click on the notebook tab** above to keep the notebook open! \n", + "\n", "Contoso Creative Writer is set up to run a CI/CD pipeline, which stands for Continuous Integration and Continuous Deployment. \n", "\n", "In this sample code the CI/CD pipeline includes the following: \n",