Skip to content

Commit

Permalink
update
Browse files Browse the repository at this point in the history
  • Loading branch information
madiepev committed Aug 24, 2023
1 parent 08750d9 commit c33e9a2
Show file tree
Hide file tree
Showing 2 changed files with 25 additions and 55 deletions.
48 changes: 18 additions & 30 deletions Instructions/01-foundation-model.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,43 +15,31 @@ You'll need an [Azure subscription](https://azure.microsoft.com/free?azure-porta

## Provision an Azure Machine Learning workspace

An Azure Machine Learning *workspace* provides a central place for managing all resources and assets you need to train and manage your models. You can interact with the Azure Machine Learning workspace through the studio, Python SDK, and Azure CLI.
An Azure Machine Learning *workspace* provides a central place for managing all resources and assets you need to train and manage your models.

You'll use the Azure CLI to provision the workspace and necessary data assets, and you'll use the studio to explore the model catalog.
You'll provision the workspace through the Azure Portal, from which you can then launch the Azure Machine Learning studio. You'll use the studio to explore the foundation models in the model catalog.

### Create the workspace and upload the dataset
### Create the workspace

To create the Azure Machine Learning workspace, and upload the dataset to the workspace, you'll use the Azure CLI. All necessary commands are grouped in a Shell script for you to execute.
To create the Azure Machine Learning workspace, you'll use the Azure Portal.

1. In a browser, open the Azure portal at `https://portal.azure.com/`, signing in with your Microsoft account.
1. Select the \[>_] (*Cloud Shell*) button at the top of the page to the right of the search box. This opens a Cloud Shell pane at the bottom of the portal.
1. Select **Bash** if asked. The first time you open the cloud shell, you will be asked to choose the type of shell you want to use (*Bash* or *PowerShell*).
1. Check that the correct subscription is specified and select **Create storage** if you are asked to create storage for your cloud shell. Wait for the storage to be created.
1. In the terminal, enter the following commands to clone this repo:

```azurecli
rm -r gen-ai-labs -f
git clone https://github.com/MicrosoftLearning/advanced-gen-ai.git gen-ai-labs
```
> Use `SHIFT + INSERT` to paste your copied code into the Cloud Shell.
1. After the repo has been cloned, enter the following commands to change to the folder for this lab and run the **setup.sh** script it contains:
```azurecli
cd gen-ai-labs/Labs/setup-script
./setup.sh
```
> Ignore any (error) messages that say that the extensions were not installed.
1. Wait for the script to complete - this typically takes around 5-10 minutes.
1. Sign into the `https://portal.azure.com/`.
2. Create a new **Azure Machine Learning** resource with the following settings:
- **Subscription**: *Your Azure subscription*
- **Resource group**: `rg-genai-lab`
- **Workspace name**: `mlw-genai-lab`
- **Region**: *Select the geographical region closest to you*
- **Storage account**: *Note the default new storage account that will be created for your workspace*
- **Key vault**: *Note the default new key vault that will be created for your workspace*
- **Application insights**: *Note the default new application insights resource that will be created for your workspace*
- **Container registry**: None (*one will be created automatically the first time you deploy a model to a container*)
3. Wait for the workspace and its associated resources to be created - this typically takes around 5 minutes.

### Explore the model catalog

*Azure Machine Learning studio* is a web-based portal through which you can access the Azure Machine Learning workspace. You can use the Azure Machine Learning studio to manage all assets and resources within your workspace. To explore the foundation models, you can navigate to the model catalog in the studio.

1. In the Azure portal, navigate to the Azure Machine Learning workspace that starts with **rg-genai-...**.
1. In the Azure portal, navigate to the Azure Machine Learning workspace that starts with **rg-genai-lab**.
1. Select the Azure Machine Learning workspace, and in its **Overview** page, select **Launch studio**. Another tab will open in your browser to open the Azure Machine Learning studio.
1. Navigate to the **Model catalog**, using the menu on the left.

Expand All @@ -63,8 +51,8 @@ If you don't know which model best fits your needs yet, you can use the filter p

There are two main filters you're likely to use when searching for a foundation model:

- Inference tasks: Filters models on tasks they can do when directly deploying the foundation model. Inference refers to the use of a deployed model.
- Finetune tasks: Filters models on tasks they can do when fine-tuning foundation models with your own data.
- **Inference tasks**: Filters models on tasks they can do when directly deploying the foundation model. Inference refers to the use of a deployed model.
- **Finetune tasks**: Filters models on tasks they can do when fine-tuning foundation models with your own data.

> **Note**:
> Some models have different inference and finetune tasks. For example, `bert-base-cased` can be used as is for fill mask tasks, and can be fine-tuned for text classification.
Expand Down
32 changes: 7 additions & 25 deletions readme.md
Original file line number Diff line number Diff line change
@@ -1,35 +1,17 @@
# INF99X: Sample Course
## Hands-on exercises for foundation models

- **[Download Latest Student Handbook and AllFiles Content](../../releases/latest)**
- **Are you a MCT?** - Have a look at our [GitHub User Guide for MCTs](https://microsoftlearning.github.io/MCT-User-Guide/)
- **Need to manually build the lab instructions?** - Instructions are available in the [MicrosoftLearning/Docker-Build](https://github.com/MicrosoftLearning/Docker-Build) repository
This repository contains the hands-on lab exercises for the Microsoft Learning Paths exploring foundation models with Azure Machine Learning. The Learning Paths consists of self-paced modules on Microsoft Learn. The labs are designed to accompany the learning materials and enable you to practice using the technologies described them.

You can view the instructions for the lab exercises at [https://microsoftlearning.github.io/advanced-gen-ai/](https://microsoftlearning.github.io/advanced-gen-ai/).

## What are we doing?

- To support this course, we will need to make frequent updates to the course content to keep it current with the Azure services used in the course. We are publishing the lab instructions and lab files on GitHub to allow for open contributions between the course authors and MCTs to keep the content current with changes in the Azure platform.

- We hope that this brings a sense of collaboration to the labs like we've never had before - when Azure changes and you find it first during a live delivery, go ahead and make an enhancement right in the lab source. Help your fellow MCTs.

## How should I use these files relative to the released MOC files?

- The instructor handbook and PowerPoints are still going to be your primary source for teaching the course content.

- These files on GitHub are designed to be used in conjunction with the student handbook, but are in GitHub as a central repository so MCTs and course authors can have a shared source for the latest lab files.

- It will be recommended that for every delivery, trainers check GitHub for any changes that may have been made to support the latest Azure services, and get the latest files for their delivery.

## What about changes to the student handbook?

- We will review the student handbook on a quarterly basis and update through the normal MOC release channels as needed.
- We hope that this brings a sense of collaboration to the labs like we've never had before - when Azure changes and you find it first during a live delivery, go ahead and make an enhancement right in the lab source.

## How do I contribute?

- Any MCT can submit a pull request to the code or content in the GitHub repro, Microsoft and the course author will triage and include content and lab code changes as needed.

- You can submit bugs, changes, improvement and ideas. Find a new Azure feature before we have? Submit a new demo!

## Notes

### Classroom Materials
- Anyone can submit a pull request to the code or content in the GitHub repro, Microsoft and the course author will triage and include content and lab code changes as needed.

It is strongly recommended that MCTs and Partners access these materials and in turn, provide them separately to students. Pointing students directly to GitHub to access Lab steps as part of an ongoing class will require them to access yet another UI as part of the course, contributing to a confusing experience for the student. An explanation to the student regarding why they are receiving separate Lab instructions can highlight the nature of an always-changing cloud-based interface and platform. Microsoft Learning support for accessing files on GitHub and support for navigation of the GitHub site is limited to MCTs teaching this course only.
- You can submit bugs, changes, improvement and ideas. Find a new Azure feature before we have? Submit a new demo!

0 comments on commit c33e9a2

Please sign in to comment.