Expected Duration: 30 minutes
Welcome to your very first challenge! Your goal in this challenge is to create the services and environment necessary to conduct this hackathon. You will deploy the required resources in Azure, create your development environment and all the assets necessary for the subsequent challenges. By completing this challenge, you will set up the foundation for the rest of the hackathon.
If something is not working correctly, please do let your coach know!
Before you start, please fork this repository to your GitHub account by clicking the Fork button in the upper right corner of the repository's main screen (or follow the documentation). This will allow you to make changes to the repository and save your progress.
GitHub Codespaces is a cloud-based development environment that allows you to code from anywhere. It provides a fully configured environment that can be launched directly from any GitHub repository, saving you from lengthy setup times. You can access Codespaces from your browser, Visual Studio Code, or the GitHub CLI, making it easy to work from virtually any device.
To open GitHub Codespaces, click on the button below:
Please select your forked repository from the dropdown and, if necessary, adjust other settings of GitHub Codespace.
Note
If GitHub Codespaces is not enabled in your organization, you can enable it by following the instructions here, or, if you cannot change your GitHub organization's settings, create a free personal GitHub account here. The Github Free Plan includes 120 core hours per month, equivalent to 60 hours on a 2-core machine, along with 15 GB of storage.
The first step on this hackathon will be to create the resources we will use throughout the day. You can deploy using either the one-click button or manual method below.
Before anything else, let's log in into the CLI with our account. Please paste the code underneath and follow the necessary instructions.
az login --use-device-codeOptional: Manual Resources Deployment via Azure Portal
Now, time to deploy our resources to Azure!
NOTE: Some parts of your deployment may fail if the resource provider Microsoft.AlertsManagement is not registered in your subscription. Follow the documentation to register it and the re-run the deployment.
Resource deployment can take up to 10 minutes, afterwards you'll be able to find all the Azure resources you need in your resource group.
Go to your Azure Portal and find your Resource Groupthat should by now contain 10 Azure resources.
After deploying resources, configure environment variables in the .env file. Ensure you're logged into Azure CLI, then run the get-keys script to automatically populate the required values.
Then run the get-keys script with your resource group name:
cd challenge-0 && ./get-keys.sh --resource-group YOUR_RESOURCE_GROUP_NAMEReplace YOUR_RESOURCE_GROUP_NAME with the actual name of the resource group created.
This script will:
- Connect to Azure and fetch the necessary keys
- Assign Azure AI Developer and Cognitive Services User roles to your user account (required for AI Foundry agent management)
- Populate the
.envfile with the required values in the root directory of the repository
Review the generated .env file to ensure all values are correct. The script creates this file from .env.sample with populated Azure resource values. If the file isn't created automatically, copy .env.sample to .env and populate values manually from the Azure Portal.
Caution
For convenience we will use key-based authentication and public network access to resources in the hack. In real world implementations you should consider stronger authentication mechanisms and additional network security.
By reaching this section you should have every resource and installed the requirements necessary to conduct the hackathon. In the next challenges, you will use these resources to start strongly your Azure AI Agents journey.
Now the real fun begins!