Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
36 changes: 0 additions & 36 deletions .github/ISSUE_TEMPLATE/project-submission.md

This file was deleted.

24 changes: 24 additions & 0 deletions .github/ISSUE_TEMPLATE/quest-feedback.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
---
name: Quest or content feedback
about: Report a problem or suggest an improvement to a Quest or the learning site
title: "[Quest feedback] "
labels: documentation
assignees: ''
---

## Quest or page

Which Quest, page, or section is this feedback about?

## What happened?

Describe the problem, unclear instruction, or suggested improvement.

## What did you expect?

Explain what you expected to find or what would make the content more useful.

## Additional context

Include relevant links, screenshots, environment details, or error messages.
Do not include credentials, access tokens, or other secrets.
2 changes: 1 addition & 1 deletion .github/workflows/deploy.yml
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ jobs:

- uses: actions/setup-python@v6
with:
python-version: "3.x"
python-version: "3.12"
cache: pip

- run: pip install -r requirements.txt
Expand Down
40 changes: 10 additions & 30 deletions 01-Local-AI-Development/README.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
![Foundry Local](./assets/foundry-local-logo.png)

**Click the image below to watch the recording.**
**Optional companion recording:** click the image below for a guided walkthrough.

[![Reactor Livestream](./assets/poster-quest1.png)](https://www.youtube.com/live/GHH50rDlLn0?si=-i3hPYq1o6H271_z)
[![Watch the Quest 1 companion recording](./assets/quest-1-companion-recording.png)](https://www.youtube.com/live/GHH50rDlLn0?si=-i3hPYq1o6H271_z)

## Overview

Expand All @@ -15,26 +15,10 @@ With Foundry Local, you gain:
- **Cost Efficiency**: No cloud compute costs incurred.
- **Offline Access**: AI capabilities even without internet connectivity.

> [!NOTE]
>
> **Hackathon Award Category: Offline-Ready AI Award**
>
> This quest mapped to our Offline-Ready AI Award category, which recognized the best performing AI solutions with standout offline capabilities (local inference).
>
> Winning solutions featured apps that:
>
> - Processed sensitive data entirely on-device.
> - Used Foundry Local for reasoning and cloud storage services for optional sync or analytics.
>
> Winners demonstrated:
>
> - **Privacy** (no sensitive data leaving the device).
> - **Latency** optimization using local inference.
>
> Checkout some Foundry Local + JavaScript projects: -
>
> 1. [Interview Doctor](https://github.com/leestott/interview-doctor-js) - AI-powered interview preparation assistant that runs **100% offline** on your local machine
> 1. [Gas Field Support Agent](https://github.com/leestott/local-rag) - A fully offline, on-device Retrieval-Augmented Generation (RAG) support agent for gas field inspection and maintenance engineers.
Here are two Foundry Local and JavaScript projects you can explore:

1. [Interview Doctor](https://github.com/leestott/interview-doctor-js) - An AI-powered interview preparation assistant that runs entirely on your local machine.
2. [Gas Field Support Agent](https://github.com/leestott/local-rag) - An offline, on-device RAG support agent for gas-field inspection and maintenance engineers.

First step, **installation instructions** for your OS:

Expand Down Expand Up @@ -196,21 +180,17 @@ Once configured, GitHub Copilot Chat will use your local Foundry model for all r
| **Qwen models** | Multilingual code generation |
| **GPT models** | Advanced capabilities and broad compatibility |

> [!NOTE]
>
> For the Offline-Ready AI Award, using GitHub Copilot with Foundry Local demonstrates a powerful offline development workflow. Highlight this capability in your submission!

### 3. Software Development Kits (SDKs)

Foundry Local provides SDKs to programmatically send requests to the local management service. Since the endpoint is dynamically allocated each time the service starts, the SDK handles endpoint discovery and management for you (control plane).

#### Step 1: Initialize New Project

Create a parent folder for your Build-a-thon projects and navigate into it:
Create a parent folder for your JavaScript AI projects and navigate into it:

```bash
mkdir buildathon
cd buildathon
mkdir javascript-ai-quests
cd javascript-ai-quests
```

Create a new folder for this quest, navigate into it and initialize a Node.js project:
Expand Down Expand Up @@ -394,7 +374,7 @@ Example UI:

## Stay connected

Have a question, project, or insight to share? Join the [Build-a-thon Discord channel](https://aka.ms/JSAIonDiscord)
Have a question, project, or insight to share? Join the [JavaScript AI community on Discord](https://aka.ms/JSAIonDiscord).

## AI Note

Expand Down
Binary file removed 01-Local-AI-Development/assets/poster-quest1.png
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
12 changes: 5 additions & 7 deletions 02-E2E-Model-Development-on-Foundry/README.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
![Foundry Local](./assets/foundry-logo.png)

**Click the image below to watch the recording.**
**Optional companion recording:** click the image below for a guided walkthrough.

[![Reactor Livestream](./assets/poster-quest2.png)](https://www.youtube.com/live/8ded7UAdPTA?si=UwncP4b4tIs1dwLS)
[![Watch the Quest 2 companion recording](./assets/quest-2-companion-recording.png)](https://www.youtube.com/live/8ded7UAdPTA?si=UwncP4b4tIs1dwLS)

# Building AI Agents E2E On Microsoft Foundry

Expand Down Expand Up @@ -59,9 +59,7 @@ To complete the quest, you will need:
>
> The **Foundry SDK is under active development**.
>
> If you encounter any blockers, unclear steps, or have suggestions to improve the developer experience, please open an issue using the [provided issue template](https://github.com/microsoft/microsoft-foundry-e2e-js/issues/new/choose) - *Bug report/ Build-a-thon Feedback*. Make sure to **apply the label** that matches the step you were on when the issue occurred.
>
> ![Buildathon issue with labels](./assets/buildathon-feedback.png)
> If you encounter a blocker or unclear instruction in the linked sample, open an issue in the [Microsoft Foundry end-to-end JavaScript repository](https://github.com/microsoft/microsoft-foundry-e2e-js/issues/new/choose). Include the task you were completing and enough environment detail to reproduce the problem.

The repoistory is setup with a `devcontainer.json` that installs all the required depdencencies and gives you access to a free tier of GitHub Copilot.

Expand Down Expand Up @@ -90,9 +88,9 @@ This quest has a lot of steps to complete, many of which cannot be completed in
**Explore the rest at your own pace later**. Create a fork of the repo, then launch a new Codespaces instance on that fork and work through the steps in order. Try customizing the data to suit a different scenario. Or change the code to try a different evaluator or attack strategy for red-teaming. Use your fork as a sandbox for building a deeper understanding of these capabilities with hands-on experiments.


### Return to the Build-a-thon
### Continue learning

Once you have completed this quest and get an intuitive sense for end-to-end development with Microsoft Foundry, return to the main Build-a-thon repository to continue with the next quests.
When you have an intuitive sense of end-to-end development with Microsoft Foundry, return to the [Quest directory](https://github.com/Azure-Samples/JavaScript-AI-Buildathon#the-learning-path) to choose what to explore next.

## AI Note

Expand Down
Binary file not shown.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
10 changes: 5 additions & 5 deletions 03-Run-Serverless-RAG-Support-System/README.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
![Serverless RAG](./assets/favicon.png)

**Click the image below to watch the recording.**
**Optional companion recording:** click the image below for a guided walkthrough.

[![Reactor Livestream](./assets/poster-quest3.png)](https://www.youtube.com/live/hfx7F7lObdg?si=vEtg3dt411oHcvJG)
[![Watch the Quest 3 companion recording](./assets/quest-3-companion-recording.png)](https://www.youtube.com/live/hfx7F7lObdg?si=vEtg3dt411oHcvJG)

## Overview

Expand Down Expand Up @@ -85,13 +85,13 @@ There are 6 tours to walk you through the entire RAG implementation flow. We rec
- Tour 5: Response Generation (7 steps)
- Tour 6: Streaming & Chat History (8 steps)

### Return to the Build-a-thon
### Continue learning

Once you have completed the CodeTour and explored the RAG implementation, return to the main Build-a-thon repository to continue with the next quests.
Once you have completed the CodeTour and explored the RAG implementation, return to the [Quest directory](https://github.com/Azure-Samples/JavaScript-AI-Buildathon#the-learning-path) to choose what to explore next.

## Stay connected

Have a question, project, or insight to share? Join the [Build-a-thon Discord channel](https://aka.ms/JSAIonDiscord)
Have a question, project, or insight to share? Join the [JavaScript AI community on Discord](https://aka.ms/JSAIonDiscord).

## AI Note

Expand Down
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
26 changes: 4 additions & 22 deletions 04-Build-Agents-with-AIToolKit/README.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
![AI Toolkit](./assets/aitk.png)

**Click the image below to watch the recording.**
**Optional companion recording:** click the image below for a guided walkthrough.

[![Reactor Livestream](./assets/poster-quest4.png)](https://www.youtube.com/live/k0q5-VIGtWQ?si=yXLiyalxU6wELpxW)
[![Watch the Quest 4 companion recording](./assets/quest-4-companion-recording.png)](https://www.youtube.com/live/k0q5-VIGtWQ?si=yXLiyalxU6wELpxW)

## Overview

Expand All @@ -20,24 +20,6 @@ The **AI Toolkit** is a powerful VS Code extension that streamlines generative A
- **Evaluation**: Measure agent performance with built-in metrics
- **Code Export**: Export agent code for integration into applications

> [!NOTE]
>
> **Hackathon Award Category: Agent Architecture Award**
>
> This quest mapped to our special award category that recognized the best AI agents with innovative and well-architected designs.
>
> Winning submissions featured:
>
> - Agents that solved complex problems with multiple steps of reasoning
> - Agents that integrated with custom MCP servers to access specialized tools or data
> - Agents with sophisticated evaluation techniques that pushed performance boundaries
>
> Winners demonstrated:
>
> - Innovative agent design patterns
> - Leverage of MCP servers for specialized tool integration
> - Evaluation methods that validated agent performance

### Install the AI Toolkit Extension

1. Open VS Code
Expand Down Expand Up @@ -416,7 +398,7 @@ Include clear instructions on:
3. How to open the UI: Open chat.html in browser
4. How to test: Send a message and verify agent responds

Make it simple, hackathon-ready, and immediately usable!
Make it simple, easy to extend, and immediately usable!
```

Sample UI Output:
Expand Down Expand Up @@ -444,7 +426,7 @@ This gives you a complete and ready chat application for your AI agent! 🚀

## Stay connected

Have a question, project, or insight to share? Join the [Build-a-thon Discord channel](https://aka.ms/JSAIonDiscord)
Have a question, project, or insight to share? Join the [JavaScript AI community on Discord](https://aka.ms/JSAIonDiscord).

## AI Note

Expand Down
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
18 changes: 6 additions & 12 deletions 05-Run-Burger-Ordering-Agent-System/README.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
![Burger Ordering Agent Logo](./assets/burger-logo.png)

**Click the image below to watch the livestream/recording.**
**Optional companion recording:** click the image below for a guided walkthrough.

[![Reactor Livestream](./assets/poster-quest5.png)](https://www.youtube.com/live/kBVsqJbM7Vc?si=hmIEfla6KOB9MsYW)
[![Watch the Quest 5 companion recording](./assets/quest-5-companion-recording.png)](https://www.youtube.com/live/kBVsqJbM7Vc?si=hmIEfla6KOB9MsYW)

## Overview

Expand All @@ -12,13 +12,7 @@ In this quest, you will set up and run a **complete end-to-end Burger Ordering A

> [!NOTE]
>
> **Hackathon Award Category: Agentic System Architecture Award**
>
> This quest mapped to our special award category recognizing agentic designs that are **useful, reliable, and secure**.
>
> The quest demonstrated foundational patterns: **MCP tool integration** enabling agents to interact with external systems (useful), **structured agent workflows** with proper error handling ensuring consistent behavior (reliable), and **API-based architectures** allowing for controlled access and validation (secure).
>
> Winners leveraged these patterns to build production-ready agent systems that users could trust.
> This quest highlights three foundations of an agent system: **MCP tool integration** for interaction with external systems, **structured agent workflows** with error handling for consistent behavior, and **API-based architecture** for controlled access and validation.

## Steps to Complete the Quest

Expand Down Expand Up @@ -83,13 +77,13 @@ There are 6 tours to walk you through the entire agent implementation flow. We r
> [!WARNING]
> Trouble viewing the CodeTour? Try setting `comments.maxHeightExceeded` to `false`

### Return to the Build-a-thon
### Continue learning

Once you have completed the CodeTour and explored the Agent implementation, return to the main Build-a-thon repository to continue with the next step.
Once you have completed the CodeTour and explored the agent implementation, return to the [Quest directory](https://github.com/Azure-Samples/JavaScript-AI-Buildathon#the-learning-path) to choose what to explore next.

## Stay connected

Have a question, project, or insight to share? Join the [Build-a-thon Discord channel](https://aka.ms/JSAIonDiscord)
Have a question, project, or insight to share? Join the [JavaScript AI community on Discord](https://aka.ms/JSAIonDiscord).

## AI Note

Expand Down
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading