[Hack Update] 066-AI fundamentals 0126 #1073

perktime · 2026-01-21T15:06:21Z

This pull request updates documentation and environment configuration to consistently use "Microsoft Foundry" instead of "Azure AI Foundry" across all student and coach materials. It also introduces a new development container configuration for improved setup consistency. The most important changes are grouped below:

Dev Environment Setup

Added a new .devcontainer.json file to define a standardized development container with pre-installed Azure CLI, Node.js, Python, and recommended VS Code extensions for a smoother onboarding experience.

Documentation Updates: Foundry Naming and Instructions

Refactored all references from "Azure AI Foundry" to "Microsoft Foundry" in student and coach guides, including setup steps, resource deployment instructions, and troubleshooting sections, ensuring consistent terminology throughout the hackathon materials. [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11] [12] [13] [14]

Student Guide Enhancements

Updated step-by-step instructions for resource creation and configuration to reflect the new Microsoft Foundry workflow, including automated and manual deployment processes, resource naming conventions, and credential retrieval. [1] [2] [3]

Resource Credential and Environment File Clarifications

Clarified instructions for populating the .env file, specifying where to find credentials in the Microsoft Foundry and Azure Portal, and updated language to avoid confusion regarding file renaming and resource verification. [1] [2] [3]

Troubleshooting and Known Bugs

Updated troubleshooting steps to reference Microsoft Foundry for model deployment adjustments and kernel restarts in VS Code, providing clearer guidance for common issues encountered during the hackathon. [1] [2]

Let me know if you'd like a walkthrough of any specific section or further details on the new dev container setup!

- Add generic .devcontainer/devcontainer.json at repo root - Updated Challenge-00-lab.md with working Dev Containers button - Root devcontainer uses universal image for broad compatibility - Allows users to start with generic container, then reopen specific folders in their specialized containers

- Updated URL to include ref=TestCodespaceButton parameter - Ensures testing uses the branch with the root devcontainer - Users can now test the full dev container workflow

…ve elements ✨ Key Enhancements: - 🎨 Changed Jekyll theme from midnight to modern cayman theme - 💅 Comprehensive custom CSS with modern styling and animations - 📊 Interactive elements: progress bars, alerts, status badges - 📁 Collapsible sections for better content organization - 📈 Mermaid diagram support for visual workflows - 🌙 Dark mode support and responsive design - 📱 Mobile-optimized experience - ♿ Improved accessibility features 🚀 Challenge-00 Improvements: - Added technology badges and progress indicators - Enhanced navigation with visual hierarchy - Interactive validation checklists - Collapsible help sections - Modern card-based layout 📝 Template Creation: - Created enhanced challenge template for consistency - Includes all new visual elements and best practices

- Created demonstration page showing all enhanced visual elements - Includes examples of alerts, badges, progress bars, cards, buttons - Shows Mermaid diagrams, collapsible sections, and enhanced tables - Provides reference for content creators using the new styling - Documents the complete visual enhancement system

✨ Theme Changes: - 🎨 Switched from dark Cayman to bright, clean Minima theme - 🌈 Redesigned entire color palette with bright, friendly colors - ☀️ Light background with colorful gradients throughout - 🎯 Maintained all interactive elements with brighter styling 🎨 Visual Improvements: - 💙 Bright blue primary colors instead of dark themes - 🌸 Colorful gradients in alerts, cards, and buttons - 🌅 Light backgrounds with subtle gradients - 🔆 Enhanced contrast for better readability - 🎨 Colorful progress bars with rainbow gradients - ✨ Bright, cheerful badge designs 🎯 Enhanced Elements: - 📊 Redesigned all components for brightness - 🎪 More colorful and engaging visual elements - 📱 Maintained mobile responsiveness - ♿ Kept accessibility features with better contrast

…re AD token provider, enhance error handling, and improve environment setup. Add Bicep module for Foundry project deployment with role assignments and diagnostic settings.

…s; clarify resource creation process and troubleshooting steps for students.

…e challenge documents for consistency and clarity.

…can be used prior to getting the PR approved in the main repo

…the introduction and use case sections.

…y deployment error details on failure.

…es for AI Services and Storage Account.

…cess to codespaces

…ss to codespaces

…cess with devcontainer configuration

Removed reference to 'Hub' in project verification steps.

…despaces changes instead)

…atTheHack into ai-fundamentals-0126

Changed Codespace link

…es and environment setup. Add easy.txt for quick fixes.

…ecessary configurations.

…the repository.

…streamline HTML elements and remove unnecessary includes.

…d streamline content for clarity.

…nused configuration.

…resources and update API versions - Updated `deploy.sh` to derive deployment name from template filename and corrected environment variable for project endpoint. - Removed parameters and modules related to Application Insights and Container Registry from `main.bicep`. - Updated AI Services resource to use the latest API version and added project management properties. - Deleted unused modules for Application Insights, Container Registry, Foundry Project, and Hub. - Added new notebook for building a Research Assistant Agent using the Microsoft Agent Framework.

…irements

…-06-AgenticAI notebook

…t Foundry portal in CH-06-AgenticAI notebook

…A-RAG_for_structured_data notebook

…e clarity, and update success criteria

…-03 notebooks to improve clarity and maintainability.

jrzyshr · 2026-01-29T21:28:59Z

066-OpenAIFundamentals/Student/Resources/infra/deploy.sh

  [template]="main.bicep"
  [parameters]="main.bicepparam"
-  [resourceGroupName]="rg-ai-foundry-secure"
+  [resourceGroupName]="rg-microsoft-foundry-secure"


wondering if we should name the RG after the hack? "rg-wth-ai-fundamentals"? (Also, why does it say "secure" in the RG name?!

Done. Now rg-openai-fundamentals for the default

jrzyshr · 2026-01-29T21:34:28Z

066-OpenAIFundamentals/Student/Resources/notebooks/CH-01-PromptEngineering.ipynb

        }
      },
-      "outputs": [],
+      "outputs": [


should this be populated? I thought all the outputs should be blank? Perhaps this ended up committed after you were testing inline?

Was fixed earlier

jrzyshr · 2026-01-29T21:34:57Z

066-OpenAIFundamentals/Student/Resources/notebooks/CH-01-PromptEngineering.ipynb

    {
      "cell_type": "code",
-      "execution_count": null,
+      "execution_count": 15,


why are all of these nulls changed to numbers like 15, 16, 17, etc?

jrzyshr · 2026-01-29T21:45:29Z

066-OpenAIFundamentals/Student/Challenge-00.md

  - [GitHub Codespaces](#setup-github-codespace)
  - [Local Workstation](#setup-local-workstation)
- [Deploy Azure AI Foundry Resources](#deploy-azure-ai-foundry-resources)
+- [Deploy Microsoft Foundry Resources](#deploy-azure-ai-foundry-resources)


Suggested change

- [Deploy Microsoft Foundry Resources](#deploy-azure-ai-foundry-resources)

- [Deploy Microsoft Foundry Resources](#deploy-microsoft-foundry-resources)

the nav link needs to match the new header

jrzyshr · 2026-01-29T21:53:48Z

066-OpenAIFundamentals/Student/Challenge-02-Old.md

Let's delete this file since we're not using it anymore.

I can see copilot updated this file anyway.

jrzyshr · 2026-01-29T21:57:21Z

066-OpenAIFundamentals/Student/Challenge-05.md


-**NOTE:** Previously, each of the Content Safety services were hosted in their own portals. As of July 2024, they have been integrated into Azure AI Foundry. While searching for documentation of these services, you may find references to their original stand-alone portals. You should access these services via Azure AI Foundry for this hack.
-
-### Access Content Safety Service - TEMPORARY STEP


Are we confident that these "temporary steps" are no longer needed?

Yes. The deployment script does this now

…undamentals

…cumentation

perktime and others added 30 commits September 19, 2025 11:00

Add badges for Codespaces and Dev Containers

36a0b65

Fix formatting of GitHub Codespaces badge section

dafb3f1

Create devcontainer.json

7f44ea8

Update Dev Containers button to use TestCodespaceButton branch

19bb6ab

- Updated URL to include ref=TestCodespaceButton parameter - Ensures testing uses the branch with the root devcontainer - Users can now test the full dev container workflow

Enhance root devcontainer with Python feature and postCreateCommand

9409b20

Update dev containers URL for testing

71dacec

Add generic root devcontainer for testing Dev Containers button

6d2f98d

Add devcontainer.json at root level for Dev Containers detection

e7cfa89

Try cloneInContainer command with folder parameter

037565e

Add root level devcontainer.json for testing

5ce0874

Test simple cloneInVolume with branch parameter

9f1fd6d

Try openInContainer command

8b6d85e

Simplify Dev Container URL for master branch

89b6980

Fix merge conflict in root devcontainer.json

d89f1be

Enhanced markdown styling with emojis, better formatting, and custom CSS

12ec55f

Merge branch 'microsoft:master' into master

3c59112

Refactor Azure OpenAI integration across notebooks; update to use Azu…

510e0df

…re AD token provider, enhance error handling, and improve environment setup. Add Bicep module for Foundry project deployment with role assignments and diagnostic settings.

Update references from AI Foundry to Microsoft Foundry in coach guide…

6f630de

…s; clarify resource creation process and troubleshooting steps for students.

Update references from AI Foundry to Microsoft Foundry across multipl…

80a5e1a

…e challenge documents for consistency and clarity.

temporary change to WTH OpenAI Fundamentals Codespace Repo URL so it …

83bbdad

…can be used prior to getting the PR approved in the main repo

Update notebook for Challenge 04-A: Enhance clarity and structure in …

ee4fb63

…the introduction and use case sections.

Enhance error handling in Bicep template deployment; fetch and displa…

1f5b97d

…y deployment error details on failure.

Remove unused parameters and sensitive output keys from Bicep templat…

fe5c5df

…es for AI Services and Storage Account.

Update link to WTH OpenAI Fundamentals Codespace Repo for improved ac…

d3dd937

…cess to codespaces

Update link to WTH OpenAI Fundamentals Codespace Repo for direct acce…

f2586fc

…ss to codespaces

Update link to WTH OpenAI Fundamentals Codespace Repo for improved ac…

af14747

…cess with devcontainer configuration

perktime added 6 commits January 20, 2026 16:06

Fix formatting issue in known bugs section

406ebd3

Update project verification instructions

cd192b0

Removed reference to 'Hub' in project verification steps.

Reverted changes back to match what's in WTH master (will be using co…

4a842cb

…despaces changes instead)

Merge branch 'ai-fundamentals-0126' of https://github.com/perktime/Wh…

157e6c1

…atTheHack into ai-fundamentals-0126

Update notes on .env file handling

19fbd88

Update Challenge-00.md

7fc5943

Changed Codespace link

perktime requested a review from a team as a code owner January 21, 2026 15:06

Refactor Azure OpenAI integration across notebooks; update dependenci…

6be2ed5

…es and environment setup. Add easy.txt for quick fixes.

jrzyshr changed the title ~~[Hack Update] AI fundamentals 0126~~ [Hack Update] 066-AI fundamentals 0126 Jan 21, 2026

perktime added 9 commits January 21, 2026 16:06

Update theme in _config.yml to jekyll-theme-midnight and clean up unn…

0e49a81

…ecessary configurations.

Remove .devcontainer.json and VISUAL-SHOWCASE.md files to streamline …

a65b027

…the repository.

Refactor default.html layout for improved structure and readability; …

376be40

…streamline HTML elements and remove unnecessary includes.

Remove custom.css file to streamline styles and eliminate unused CSS

2ce2cc3

Refactor Challenge 00 lab documentation; remove unnecessary badges an…

feb1a98

…d streamline content for clarity.

Remove devcontainer.json to streamline the repository and eliminate u…

9168081

…nused configuration.

Update note in CH-06-AgenticAI notebook for clarity on .env file requ…

22f3fb3

…irements

Add optional section for exploring the Microsoft Foundry portal in CH…

abdec08

…-06-AgenticAI notebook

jrzyshr self-assigned this Jan 23, 2026

jrzyshr and others added 8 commits January 23, 2026 14:36

Fix typo in Challenge-00.md regarding constraints

347b70b

Add 'Gally' to the wordlist

7d454b8

Fix formatting and punctuation in instructions for using the Microsof…

9c464fd

…t Foundry portal in CH-06-AgenticAI notebook

Remove output logs from code cell and reset execution count in CH-04-…

37b967a

…A-RAG_for_structured_data notebook

Refactor Challenge 06 documentation: reorganize prerequisites, enhanc…

02de28d

…e clarity, and update success criteria

Update section numbering in CH-06-AgenticAI notebook for consistency

897ed58

Fix formatting in Challenge-02.md

f761e0d

Refactor notebook execution counts and clear outputs for CH-01 and CH…

5b6131f

…-03 notebooks to improve clarity and maintainability.

jrzyshr requested changes Jan 29, 2026

View reviewed changes

perktime added 2 commits January 30, 2026 08:52

Update resource group name and location in deploy script for OpenAI f…

c46d848

…undamentals

Fix link reference for Microsoft Foundry Resources in Challenge 00 do…

b8994e4

…cumentation

	- [Deploy Microsoft Foundry Resources](#deploy-azure-ai-foundry-resources)
	- [Deploy Microsoft Foundry Resources](#deploy-microsoft-foundry-resources)


		NOTE: Previously, each of the Content Safety services were hosted in their own portals. As of July 2024, they have been integrated into Azure AI Foundry. While searching for documentation of these services, you may find references to their original stand-alone portals. You should access these services via Azure AI Foundry for this hack.

		### Access Content Safety Service - TEMPORARY STEP

[Hack Update] 066-AI fundamentals 0126 #1073

Are you sure you want to change the base?

[Hack Update] 066-AI fundamentals 0126 #1073

Uh oh!

Conversation

perktime commented Jan 21, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants