[New Hack] Agentic AI Apps - Student & Coach Guide

.devcontainer/xxx-AgenticAIApps/devcontainer.json

@@ -0,0 +1,28 @@
+{
+    "name" : "xxx-AgenticAIApps",
+    "image": "mcr.microsoft.com/devcontainers/python:3.11",
+    "workspaceFolder": "/workspace/xxx-AgenticAIApps/Student/Resources",
+	"workspaceMount": "source=${localWorkspaceFolder},target=/workspace,type=bind,consistency=cached",
+    "hostRequirements": {
+      "cpus": 2
+    },
+    "waitFor": "onCreateCommand",
+    "updateContentCommand": "python3 -m pip install -r requirements.txt",
+    "postCreateCommand": "",
+    "features": {
+        "ghcr.io/devcontainers/features/azure-cli:1": {
+          "installBicep": true
+        }
+      },
+    "customizations": {
+      "codespaces": {
+        "openFiles": []
+      },
+      "vscode": {
+        "extensions": [
+          "ms-toolsai.jupyter",
+          "ms-python.python"
+        ]
+      }
+    }
+  }

xxx-AgenticAIApps/Coach/README.md

@@ -0,0 +1,113 @@
+# What The Hack - AgenticAIApps - Coach Guide
+
+## Introduction
+
+Welcome to the coach's guide for **AgenticAIApps**, a modern **Azure Agentic AI Hack** designed to help participants build, test, and scale intelligent multi-agent systems.  
+Here you will find links to specific guidance for coaches for each of the challenges.
+
+This hack includes an optional [lecture presentation](Lectures.pptx) that features short presentations to introduce key topics associated with each challenge. It is recommended that the host present each short presentation before attendees kick off that challenge.
+
+**NOTE:** If you are a Hackathon participant, this is the answer guide. Don't cheat yourself by looking at these during the hack! Go learn something. :)
+
+## Learning Objectives
+
+This project is designed to teach participants how to build agentic applications using Azure’s AI ecosystem.  
+Participants will orchestrate intelligent agents using Semantic Kernel, implement secure communication protocols, and deploy multi-agent workflows with live metric integration via Azure Monitor. By the end, participants will be equipped to design, deploy, and manage scalable, secure, and collaborative AI agents in real-world scenarios.
+
+Participants will learn to:
+
+- Provision and configure a Linux VM in Azure with read/write permissions  
+- Deploy and test **Anomaly Detector**, **Resource Optimizer**, and **Alert Manager** agents  
+- Orchestrate multi-agent collaboration for real-time decision-making  
+- Build and visualize logs locally and in Azure (via Streamlit or Power BI)  
+- Spike VM resources to test agent detection and resilience  
+- Integrate Azure tools (Monitor, Storage, and AI Foundry) for advanced observability  
+
+---
+
+## Coach's Guides
+
+- **Challenge 00:** [Azure AI Foundry Onboarding & Environment Prep](./Solution-00.md)  
+  *Set up your Azure environment and validate permissions.*
+
+- **Challenge 01:** [Semantic Kernel Setup & Configuration](./Solution-01.md)  
+  *Deploy a Linux VM with contributor permissions and enable SSH access.*
+
+- **Challenge 02:** [Build the Anomaly Detector Agent (Real Azure Metrics)](./Solution-02.md)  
+  *Set up your environment with Python, Bash, and Azure SDKs, and create your first monitoring agent.*
+
+- **Challenge 03:** [Build the Resource Optimizer Agent (Real Azure Integration)](./Solution-03.md)  
+  *Implement automated resource adjustments based on detected anomalies.*
+
+- **Challenge 04:** [Build the Alert Manager Agent (Live Azure Integration)](./Solution-04.md)  
+  *Design a communication layer to notify or log alerts from your system.*
+
+- **Challenge 05:** [Orchestrate Agent-to-Agent Communication](./Solution-05.md)  
+  *Build an orchestrator to coordinate communication between agents.*
+
+- **Challenge 06:** [Enable Agent-to-Agent Communication (A2A)](./Solution-06.md)  
+  *Enable agents to share context, pass messages, and coordinate actions dynamically.*
+
+- **Challenge 07:** [Build the Anomaly & Resolution Tracker](./Solution-07.md)  
+  *Log and visualize all anomaly and resolution events in real time.*
+
+- **Challenge 08:** [Spike VM Resources & Test Agent Detection](./Solution-08.md)  
+  *Simulate CPU and memory spikes to validate your agentic system.*
+
+---
+
+## Coach Prerequisites
+
+Before hosting, coaches should ensure they can perform the following:
+
+- **Active Azure Subscription**  
+- **Python 3.7 or higher** *(Python 3.13 preferred)*  
+- **Pip** (Python package installer)  
+- **GitHub account** with access to the AgenticAIApps repository and **Codespaces**  
+- **VS Code** with Python and Azure extensions  
+- **Azure CLI** installed and authenticated  
+- Basic familiarity with **Linux, SSH, and Bash scripting**  
+- (Optional) Azure Monitor, Streamlit, and Power BI for visualization  
+
+Always review the [What The Hack Hosting Guide](https://aka.ms/wthhost) for event-specific instructions.
+
+### Student Resources
+
+Coaches should download and package the `/Student/Resources` folder into a `Resources.zip` file and provide it to students at the start of the hack.
+
+**NOTE:** Students should **not** have access to the repository before or during the hack. 
+
+---
+
+## Azure Requirements
+
+Students require access to an Azure subscription capable of creating and consuming resources used in the challenges.  
+This includes:
+
+- VM creation and scaling  
+- Storage access (for logs)  
+- Permissions to deploy agents and monitoring solutions  
+
+---
+
+## Learning Resources
+
+- [Microsoft Agent Framework – Python User Guide](https://learn.microsoft.com/en-us/agent-framework/user-guide/agents/agent-types/?pivots=programming-language-python)  
+- [Connect to a VM using SSH (Azure Docs)](https://learn.microsoft.com/en-us/azure/virtual-machines/linux/mac-create-ssh-keys)  
+- [Introduction to Bash and Linux CLI](https://ubuntu.com/tutorials/command-line-for-beginners)  
+- [Azure AI Foundry Overview](https://learn.microsoft.com/en-us/azure/ai-foundry/)  
+
+---
+
+## Repository Contents
+
+- `./Coach` – Coach's guide and related files  
+- `./Coach/Solutions` – Completed solution files for each challenge  
+- `./Student` – Student challenge guide  
+- `./Student/Resources` – Resource files, sample code, and scripts for students  
+
+---
+
+## Contributors
+
+- **Esvin Ruiz**  

xxx-AgenticAIApps/Coach/Solution-00.md

@@ -0,0 +1,117 @@
+# Challenge 00 - Azure AI Foundry Onboarding & Environment Prep - Coach's Guide
+
+**[Home](./README.md)** - [Next Solution >](./Solution-01.md)
+
+## Notes & Guidance
+
+This guide walks you through setting up your development environment and Azure subscription for working with Azure AI Foundry. It is designed to help coaches and participants prepare their cloud-based workspace for the challenges ahead.
+
+### Prerequisites
+
+- Python (Version 3.7 or higher, Python 3.13 preferred)
+- Pip (package installer for Python)
+- Active Azure Subscription
+- Azure Developer CLI
+
+Reference documentation:
+- [Azure AI Foundry Overview](https://learn.microsoft.com/en-us/azure/azure-ai-foundry/overview)
+
+---
+
+### Create Azure AI Foundry Resource in Azure Account
+
+- Log in to your Azure portal
+- Create a new Azure AI Foundry resource
+- Note down your resource endpoint URL (you'll need this later)
+
+---
+
+### Set Up GitHub Codespaces
+
+GitHub Codespaces provides a cloud-hosted development environment that eliminates the need for local setup.
+
+- Navigate to the project repository:  
+  [Agentic AI Apps GitHub Repository](https://github.com/WhatTheHack/tree/xxx-AgenticAIApps)
+- Click the green **Code** button and select **Codespaces > Create codespace on main**
+- Wait for the environment to initialize. It will automatically install dependencies and configure your workspace.
+- Use the integrated terminal to run commands and interact with Azure resources.
+- Authenticate your Codespace CLI session with Azure by running:
+
+  ```bash
+  az login
+  ```
+
+  - This will open a browser window to complete the login process
+  - Once authenticated, your Codespace CLI will be connected to your Azure subscription
+
+---
+
+### Install Required Packages
+
+Once your Codespace is ready, open the terminal and run:
+
+```bash
+pip install azure-ai-projects azure-identity
+```
+
+Verify installation:
+
+```bash
+pip list
+```
+
+---
+
+### Create a Virtual Machine with Permissions
+
+To support later stages of the project, you'll need a Linux-based virtual machine with read/write permissions.
+
+- Open the Azure Portal and navigate to **Virtual Machines**
+- Click **Create > Virtual Machine**
+- Use the following configuration:
+  - **Resource Group:** Same as your Azure AI Foundry project
+  - **Virtual Machine Name:** `agentic-vm-test`
+  - **Region:** West US 2
+  - **Availability Zone:** Zone 1
+  - **Image:** Ubuntu 22.04 LTS
+  - **Size:** Standard B2pts v2 (2 vCPUs, 1 GiB memory)
+  - **Authentication Type:** SSH public key
+  - **Inbound Ports:** Allow SSH (port 22)
+- Click **Next: Disks** and accept the default settings
+- Click **Next: Networking** and ensure the VM is assigned a public IP
+- Click **Next: Management**, then enable **System Assigned Managed Identity**
+- After deployment, go to **Access Control (IAM)** for the VM and assign the **Contributor** role
+
+> ⚠️ This VM is intended for testing purposes only. Do not use it for production workloads.
+
+---
+
+### Repository Usage Notes
+
+The [Agentic AI Apps GitHub Repository](https://github.com/WhatTheHack/tree/xxx-AgenticAIApps) contains all the source code and configuration files needed for this challenge.
+
+- **Codespaces Ready:** Preconfigured for GitHub Codespaces—launch and start coding immediately
+- **Project Structure:** Each challenge is organized into its own folder. Start with `Challenge-01`
+- **Auto-Setup:** Dependencies install automatically when the Codespace launches
+- **Customization:** Modify `.devcontainer` files to adjust the environment
+- **Sync with Azure:** Use the terminal to authenticate and interact with Foundry resources
+
+---
+
+## Next Steps: 
+Your Azure AI Foundry development environment is now fully configured.  
+You’ve installed the required SDKs, authenticated with Azure, and confirmed that your workspace can register and run agents.
+
+Tip: Keep your `.env` and Foundry configuration handy — you’ll reuse them throughout every subsequent challenge.
+
+---
+
+Proceed to **[Challenge 001 – Semantic Kernel Setup & Configuration](./Solution-01.md)** to:
+- Integrate **Semantic Kernel** for planning and reasoning.  
+- Explore how prompts, skills, and plugins form the cognitive layer of your agents.  
+- Learn how agents interpret natural language requests and turn them into structured actions.  
+- Prepare the foundation for multi-agent collaboration in future challenges.
+
+---
+
+All sections marked with `🔹 STUDENT MISSING SECTION` are **what students were expected to implement themselves** in the student guide. Coaches can reference these for solution verification.