Skip to content

1. Pre-Requisites

You must have a GitHub account to get started. Take a minute to sign up for a free account if you don't currently have one. Then check your workshop tab below for additional details.

1. What You Will Need

  1. Your own laptop.
    • Any laptop capable of running a modern browser (and GitHub Codespaces) will do.
    • We recommend having recent version of the Edge, Chrome or Safari browser installed.
    • Make sure your laptop is fully-charged (or connected to power) for the duration of lab.
  2. A GitHub Account.
    • This is needed for creating a copy of the sample, and for launching GitHub Codespaces.
    • We recommend using a personal (vs. enterprise) GitHub account for convenience.
    • If you don't have a GitHub account, sign up for a free one now. (takes just a few mins)
  3. An Azure Subscription.
    • This is needed for provisioning the Azure infrastructure for your AI project.
    • If you don't have an Azure account, signup for a free one now. (takes just a few mins)
2. What You Should Know (expand to view)
  1. (recommended) Familiarity with Visual Studio Code
    1. The workshop is run completely in GitHub Codespaces, a virtualized Linux machine in the cloud. We do not run any code in your local laptop.
    2. The default editor used in GitHub Codespaces is Visual Studio Code (in browser). The VS Code development environment is pre-configured with required extensions.
    3. If you are familiar with Dev Containers and want to use Docker Desktop (on device), or want to connect to GitHub Codespaces from your local VS Code, feel free to do so.
  2. (preferred) Familiarity with the bash shell.
    1. We use bash in the VS Code terminal to run post-provisioning scripts if needed.
    2. We also use it to run Azure CLI and Azure Developer CLI commands during setup.
  3. (preferred) Familiarity with Python and Jupyter Notebooks.
    1. We'll create and run Python code scripts from the command-line in some steps.
    2. We'll select the Python kernel and run pre-existing Jupyter Notebooks in some steps.
3. What You Will Take Away (expand to view)

On completing this workshop, you will have:

  1. A personal copy of the Contoso Chat repository in your GitHub profile. This contains all the materials you need to reproduce the workshop on your own later (e.g., as a Self-Guided session).
  2. Hands-on understanding of the Azure AI Foundry platform and relevant developer tools (e.g., Azure Developer CLI, Prompty, Fast API) to streamline end-to-end development workflows for your own AI apps.

ARE YOU CURRENTLY IN THE LAB SESSION? Jump to Provision & Setup! to get started!

The instructor-guided labs are setup with everything you need to get started. To get the most from this session, you should have some familiarity with Python, Jupyter Notebooks and Visual Studio Code. If you revisit the workshop later at home, use the Self-Guided version instead.

ARE YOU CURRENTLY IN THE LAB SESSION? Jump to Provision & Setup! to get started!

The instructor-guided labs are setup with everything you need to get started. To get the most from this session, you should have some familiarity with Python, Jupyter Notebooks and Visual Studio Code. If you revisit the workshop later at home, use the Self-Guided version instead.