Skip to content
Open
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
8 changes: 5 additions & 3 deletions .github/agents/lab-generator.agent.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,9 @@ You are modeled after the TireForge Industries foundry-hackathon lab. You know:
├── requirements.txt # Python dependencies (always the same base set)
├── challenge-0-setup/
│ ├── README.md
│ └── deploy.sh # Provisions Azure resources + writes .env
│ ├── azure.yaml # azd project definition
│ ├── infra/main.bicep # Azure infrastructure
│ └── scripts/write-env.ps1 # Writes the scenario .env
├── challenge-1-build/
│ ├── README.md
│ ├── agents.py # Two agents with system prompts + tool
Expand Down Expand Up @@ -80,7 +82,7 @@ Follow the exact code patterns from the reference lab:

- `README.md`: Scenario intro, entity table with statuses, prerequisites, challenge table, architecture diagram
- `FACILITATOR_GUIDE.md`: Timing guide, reconvene talking points connecting challenges, common errors
- `deploy.sh`: Same Azure provisioning (AI Foundry project + model + App Insights)
- `azure.yaml` and `infra/main.bicep`: Azure provisioning (AI Foundry project + model + App Insights)
- `requirements.txt`: Same Python dependencies

## Agent Design Patterns
Expand Down Expand Up @@ -124,7 +126,7 @@ When generating a lab, produce all files in order:
3. Domain data JSON
4. `evaluation_dataset.json`
5. Each challenge folder's `README.md` + Python file
6. `deploy.sh`
6. `azure.yaml` and `infra/main.bicep`
7. `FACILITATOR_GUIDE.md` last (references all challenges)

Always confirm the use case with the user before generating. Ask if they want any specific twists (e.g., "one entity should have compound failures" or "include a seasonal pattern").
14 changes: 7 additions & 7 deletions CODE_OF_CONDUCT.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
# Microsoft Open Source Code of Conduct
# Código de Conduta de Código Aberto da Microsoft

This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
Este projeto adotou o [Código de Conduta de Código Aberto da Microsoft](https://opensource.microsoft.com/codeofconduct/).

Resources:
Recursos:

- [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
- [Microsoft Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/)
- Contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with questions or concerns
- Employees can reach out at [aka.ms/opensource/moderation-support](https://aka.ms/opensource/moderation-support)
- [Código de Conduta de Código Aberto da Microsoft](https://opensource.microsoft.com/codeofconduct/)
- [Perguntas frequentes sobre o Código de Conduta da Microsoft](https://opensource.microsoft.com/codeofconduct/faq/)
- Entre em contato com [opencode@microsoft.com](mailto:opencode@microsoft.com) em caso de dúvidas ou preocupações
- Funcionários podem entrar em contato pelo endereço [aka.ms/opensource/moderation-support](https://aka.ms/opensource/moderation-support)
108 changes: 55 additions & 53 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,81 +1,83 @@
<img width="990" height="150" alt="Microsoft Agent-a-thon_banner_WEB_990x150" src="https://github.com/user-attachments/assets/5f550061-077d-421c-bba2-4a5820e72fad" />

# Build and Scale AI Agents with Microsoft Foundry
## The Level 3: Architect learning path
# Frontier Week Hack
## Microsoft Foundry: Crie, escale, observa e proteja seus agentes de IA

Welcome to the hands-on lab experience where ideas turn into real, enterprise-ready solutions. This is the most advanced of the three agent-building learning paths. Where the Explorer path builds your first no-code agent and the Maker path automates work with low-code tools, this path is for developers, engineers, and architects who want complete control over models, orchestration, and operations.
Boas-vindas à experiência de laboratório prático onde ideias se transformam em soluções reais e prontas para empresas. Esta é a mais avançada das três trilhas de criação de agentes. Enquanto a trilha Explorer cria seu primeiro agente sem código e a trilha Maker automatiza tarefas com ferramentas low-code, esta trilha é voltada a desenvolvedores, engenheiros e arquitetos que desejam controle total sobre modelos, orquestração e operações.

In this lab, you’ll build, monitor, evaluate, and orchestrate AI agents using the Microsoft Foundry SDK. You’ll follow a guided, scenario-based experience designed to help you move from concept to a working, enterprise-ready multi-agent system.
Neste laboratório, você criará, monitorará, avaliará e orquestrará agentes de IA usando o SDK do Microsoft Foundry. Você seguirá uma experiência guiada e baseada em cenários, projetada para ajudar a transformar um conceito em um sistema multiagente funcional e pronto para empresas.

By the end, you won’t just understand how agents work — you’ll have built one you can trace, evaluate, and deploy.
Ao final, você não apenas entenderá como os agentes funcionam: terá criado um agente que pode rastrear, avaliar e implantar.

All challenge instructions are also available at [microsoft.github.io/FrontierWeekHack](https://microsoft.github.io/FrontierWeekHack/).
## O que você aprenderá

## What You'll Learn
Este laboratório orienta você por todo o ciclo de vida da criação de agentes de IA prontos para produção com o [Microsoft Foundry](https://learn.microsoft.com/azure/ai-foundry/):

This lab walks you through the full lifecycle of building production-ready AI agents with [Microsoft Foundry](https://learn.microsoft.com/azure/ai-foundry/):
- **Design de agentes** — Criar agentes especializados com prompts de sistema, ferramentas e dados específicos do domínio
- **Observabilidade** — Instrumentar agentes com rastreamento de GenAI baseado em OpenTelemetry por meio do Application Insights
- **Avaliação de qualidade** — Executar avaliações com LLM como juiz para medir sistematicamente a qualidade das saídas dos agentes
- **Orquestração multiagente** — Conectar agentes a fluxos de trabalho automatizados usando o SDK do Python e o portal do Foundry

- **Agent design** — Create purpose-built agents with system prompts, tools, and domain-specific data
- **Observability** — Instrument agents with OpenTelemetry-based GenAI tracing via Application Insights
- **Quality evaluation** — Run LLM-as-judge evaluations to systematically measure agent output quality
- **Multi-agent orchestration** — Wire agents into automated workflows using the Python SDK and the Foundry portal
Este é um **hackathon code-first**: você escreverá e executará Python ao longo de todo o percurso. No entanto, vários desafios também exigem interação com o **portal do Microsoft Foundry** para implantar modelos, explorar rastreamentos, revisar avaliações e criar fluxos de trabalho visualmente. Espere alternar regularmente entre seu IDE e o portal.

This is a **code-first hackathon** — you'll write and run Python throughout. However, several challenges also have you interact with the **Microsoft Foundry portal** to deploy models, explore traces, review evaluations, and build workflows visually. Expect to move between your IDE and the portal regularly.

## Escolha seu cenário

## Choose Your Scenario
Todas as trilhas ensinam os mesmos conceitos do Foundry — escolha aquela com a qual você mais se identifica:

All paths teach the same Foundry concepts — pick the one that resonates with you the most:

| Scenario | Description | Start Here |
| Cenário | Descrição | Comece aqui |
|----------|-------------|------------|
| 🏭 **Factory** | Detect machine anomalies and diagnose faults at TireForge Industries | [Factory Lab](./factory/README.md) |
| 📋 **Claims** | Triage incoming claims and recommend actions at ClaimSight Insurance | [Claims Lab](./claims/README.md) |
| 📞 **Call Center** | Classify call intents and advise resolutions at NovaTel Communications | [Call Center Lab](./callcenter/README.md) |
| 🏭 **Fábrica** | Detectar anomalias em máquinas e diagnosticar falhas na TireForge Industries | [Laboratório de fábrica](./factory/README.md) |
| 📋 **Sinistros** | Fazer a triagem de sinistros recebidos e recomendar ações na ClaimSight Insurance | [Laboratório de sinistros](./claims/README.md) |
| 📞 **Central de atendimento** | Classificar intenções de chamadas e orientar resoluções na NovaTel Communications | [Laboratório de central de atendimento](./callcenter/README.md) |

All scenarios follow the same 5-challenge structure:
Todos os cenários seguem a mesma estrutura de cinco desafios:

| # | Challenge | Duration | What You'll Learn |
| # | Desafio | Duração | O que você aprenderá |
|---|-----------|----------|-------------------|
| 0 | **Setup** | 20 min | Provision Microsoft Foundry, deploy a model, verify auth |
| 1 | **Build Agents** | 35 min | Create two agents with tools and system prompts |
| 2 | **Monitor** | 20 min | Enable GenAI tracing with Application Insights |
| 3 | **Evaluate** | 25 min | Run LLM-as-judge evaluations against test datasets |
| 4 | **Workflow** | 20 min | Orchestrate agents in a multi-step pipeline |
| 0 | **Configuração** | 20 min | Provisionar o Microsoft Foundry, implantar um modelo e verificar a autenticação |
| 1 | **Criar agentes** | 35 min | Criar dois agentes com ferramentas e prompts de sistema |
| 2 | **Monitorar** | 20 min | Habilitar o rastreamento de GenAI com o Application Insights |
| 3 | **Avaliar** | 25 min | Executar avaliações com LLM como juiz em conjuntos de dados de teste |
| 4 | **Workflow** | 20 min | Orquestrar agentes em um pipeline de várias etapas |

## Prerequisites
## Pré-requisitos

- **Azure subscription** with **Contributor** and **Foundry User** access
- A **GitHub account**
- **Python 3.10+** installed locally (pre-installed when using Codespaces)
- **Azure CLI** (`az`) installed (pre-installed when using Codespaces)
- **Assinatura do Azure** com acesso de **Colaborador** e **Usuário do Foundry**
- Uma **conta do GitHub**
- **Python 3.10 ou posterior** instalado localmente (pré-instalado ao usar Codespaces)
- **Azure CLI** (`az`) instalada (pré-instalada ao usar Codespaces)
- **Azure Developer CLI** (`azd`) instalada (pré-instalada ao usar Codespaces)

## Ready to Expand Your Knowledge?
## Implantar pelo diretório raiz

### 1. Put Your Skills to the Test at the Microsoft Agent-a-Thon!
You’ve built production-grade agents — now bring them to a live, hands-on build experience. The Microsoft Agent-a-Thon is where you apply everything from this path, get real-time support as you build, and compete for recognition and prizes. Register at [Microsoft Agent-a-Thon](https://www.microsoft.com/en-us/events/local-events/microsoft-agent-a-thon).
O projeto `azd` na raiz provisiona o cenário da central de atendimento. Depois de autenticar no Azure, execute:

### 2. Join the Tour!
```bash
az login
azd auth login
azd up
```

<img width="4400" height="687" alt="banner" src="agentichacks.jpg" />
O comando cria os recursos no grupo de recursos do ambiente `azd` e gera o arquivo `.env` na raiz do repositório. Para alterar o ambiente ou a assinatura, use `azd env set` antes de executar `azd up`.

Prefer to build alongside experts in the room? Spend a full day exploring advanced use cases, hands-on builds, and expert-led sessions designed to turn ideas into real business impact. Find the event nearest you on [EMEA Agentic AI Hacks - Microsoft Pulse](https://pulse.microsoft.com/en/build-ai-hacks-agentic-ai/).
## Pronto para ampliar seus conhecimentos?

### 3. Go deeper with the docs
### 1. Aprofunde-se com a documentação

- [What is Microsoft Foundry?](https://learn.microsoft.com/azure/foundry/what-is-foundry)
- [Foundry Agent Service overview](https://learn.microsoft.com/azure/foundry/agents/overview)
- [Trace your agents with Microsoft Foundry](https://learn.microsoft.com/azure/foundry/observability/how-to/trace-agent-setup)
- [Evaluate agentic workflows](https://learn.microsoft.com/azure/foundry/observability/how-to/evaluate-agent)
- [azure-ai-projects SDK Reference](https://learn.microsoft.com/python/api/azure-ai-projects/)
- [O que é o Microsoft Foundry?](https://learn.microsoft.com/azure/foundry/what-is-foundry)
- [Visão geral do Foundry Agent Service](https://learn.microsoft.com/azure/foundry/agents/overview)
- [Rastreie seus agentes com o Microsoft Foundry](https://learn.microsoft.com/azure/foundry/observability/how-to/trace-agent-setup)
- [Avalie fluxos de trabalho agentivos](https://learn.microsoft.com/azure/foundry/observability/how-to/evaluate-agent)
- [Referência do SDK azure-ai-projects](https://learn.microsoft.com/python/api/azure-ai-projects/)

### 4. Keep learning on Microsoft Learn
### 2. Continue aprendendo no Microsoft Learn

- [Develop an AI agent with Microsoft Foundry Agent Service](https://learn.microsoft.com/training/modules/develop-ai-agent-azure/) — 55 min module
- [Build agent-driven workflows using Microsoft Foundry](https://learn.microsoft.com/training/modules/build-agent-workflows-microsoft-foundry/) — 1 hr module
- [Analyze and debug your generative AI app with tracing](https://learn.microsoft.com/training/modules/tracing-generative-ai-app/) — 1 hr module
- [Evaluate generative AI performance in Microsoft Foundry portal](https://learn.microsoft.com/training/modules/evaluate-models-azure-ai-studio/) — 38 min module
- [Monitor your generative AI application](https://learn.microsoft.com/training/modules/monitor-generative-ai-app/) — 1 hr module
- [Develop generative AI apps in Azure](https://learn.microsoft.com/training/paths/develop-generative-ai-apps/) — learning path
- [Monitor AI workloads on Azure](https://learn.microsoft.com/training/paths/monitor-ai-workloads-on-azure/) — learning path
- [Operationalize AI responsibly with Azure AI Foundry](https://learn.microsoft.com/training/paths/operationalize-ai-responsibly/) — learning path
- [Desenvolva um agente de IA com o Foundry Agent Service](https://learn.microsoft.com/training/modules/develop-ai-agent-azure/) — módulo de 55 min
- [Crie fluxos de trabalho orientados por agentes usando o Microsoft Foundry](https://learn.microsoft.com/training/modules/build-agent-workflows-microsoft-foundry/) — módulo de 1 hora
- [Analise e depure seu aplicativo de IA generativa com rastreamento](https://learn.microsoft.com/training/modules/tracing-generative-ai-app/) — módulo de 1 hora
- [Avalie o desempenho de IA generativa no portal do Microsoft Foundry](https://learn.microsoft.com/training/modules/evaluate-models-azure-ai-studio/) — módulo de 38 min
- [Monitore seu aplicativo de IA generativa](https://learn.microsoft.com/training/modules/monitor-generative-ai-app/) — módulo de 1 hora
- [Desenvolva aplicativos de IA generativa no Azure](https://learn.microsoft.com/training/paths/develop-generative-ai-apps/) — trilha de aprendizagem
- [Monitore cargas de trabalho de IA no Azure](https://learn.microsoft.com/training/paths/monitor-ai-workloads-on-azure/) — trilha de aprendizagem
- [Operacionalize a IA com responsabilidade usando o Azure AI Foundry](https://learn.microsoft.com/training/paths/operationalize-ai-responsibly/) — trilha de aprendizagem
12 changes: 6 additions & 6 deletions SECURITY.md
Original file line number Diff line number Diff line change
@@ -1,14 +1,14 @@
<!-- BEGIN MICROSOFT SECURITY.MD V1.0.0 BLOCK -->

## Security
## Segurança

Microsoft takes the security of our software products and services seriously, which
includes all source code repositories in our GitHub organizations.
A Microsoft leva a segurança de seus produtos e serviços de software a sério, o que
inclui todos os repositórios de código-fonte em suas organizações do GitHub.

**Please do not report security vulnerabilities through public GitHub issues.**
**Não relate vulnerabilidades de segurança por meio de issues públicas do GitHub.**

For security reporting information, locations, contact information, and policies,
please review the latest guidance for Microsoft repositories at
Para obter informações sobre como relatar problemas de segurança, locais, contatos e políticas,
consulte as orientações mais recentes para repositórios da Microsoft em
[https://aka.ms/SECURITY.md](https://aka.ms/SECURITY.md).

<!-- END MICROSOFT SECURITY.MD BLOCK -->
32 changes: 16 additions & 16 deletions SUPPORT.md
Original file line number Diff line number Diff line change
@@ -1,25 +1,25 @@
# TODO: The maintainer of this repo has not yet edited this file
# TODO: O mantenedor deste repositório ainda não editou este arquivo

**REPO OWNER**: Do you want Customer Service & Support (CSS) support for this product/project?
**PROPRIETÁRIO DO REPOSITÓRIO**: Você deseja suporte do Atendimento e Suporte ao Cliente (CSS) para este produto/projeto?

- **No CSS support:** Fill out this template with information about how to file issues and get help.
- **Yes CSS support:** Fill out an intake form at [aka.ms/onboardsupport](https://aka.ms/onboardsupport). CSS will work with/help you to determine next steps.
- **Not sure?** Fill out an intake as though the answer were "Yes". CSS will help you decide.
- **Sem suporte do CSS:** Preencha este modelo com informações sobre como registrar issues e obter ajuda.
- **Com suporte do CSS:** Preencha um formulário de entrada em [aka.ms/onboardsupport](https://aka.ms/onboardsupport). O CSS trabalhará com você e ajudará a determinar os próximos passos.
- **Não tem certeza?** Preencha a entrada como se a resposta fosse "Sim". O CSS ajudará você a decidir.

*Then remove this first heading from this SUPPORT.MD file before publishing your repo.*
*Depois, remova este primeiro título do arquivo SUPPORT.MD antes de publicar seu repositório.*

# Support
# Suporte

## How to file issues and get help
## Como registrar issues e obter ajuda

This project uses GitHub Issues to track bugs and feature requests. Please search the existing
issues before filing new issues to avoid duplicates. For new issues, file your bug or
feature request as a new Issue.
Este projeto usa o GitHub Issues para acompanhar bugs e solicitações de recursos. Pesquise as
issues existentes antes de registrar novas issues para evitar duplicatas. Para novas issues, registre seu bug ou
solicitação de recurso como uma nova Issue.

For help and questions about using this project, please **REPO MAINTAINER: INSERT INSTRUCTIONS HERE
FOR HOW TO ENGAGE REPO OWNERS OR COMMUNITY FOR HELP. COULD BE A STACK OVERFLOW TAG OR OTHER
CHANNEL. WHERE WILL YOU HELP PEOPLE?**.
Para obter ajuda e tirar dúvidas sobre o uso deste projeto, **MANTENEDOR DO REPOSITÓRIO: INSIRA AQUI AS INSTRUÇÕES
SOBRE COMO INTERAGIR COM OS PROPRIETÁRIOS DO REPOSITÓRIO OU COM A COMUNIDADE PARA OBTER AJUDA. PODE SER UMA TAG DO STACK OVERFLOW OU OUTRO
CANAL. ONDE VOCÊ AJUDARÁ AS PESSOAS?**.

## Microsoft Support Policy
## Política de suporte da Microsoft

Support for this **PROJECT or PRODUCT** is limited to the resources listed above.
O suporte para este **PROJETO ou PRODUTO** está limitado aos recursos listados acima.
15 changes: 15 additions & 0 deletions azure.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
# yaml-language-server: $schema=https://raw.githubusercontent.com/Azure/azure-dev/main/schemas/v1.0/azure.yaml.json

name: callcenter

metadata:
template: callcenter-foundry@1.0

infra:
provider: bicep
path: infra

hooks:
postprovision:
shell: pwsh
run: ./scripts/write-env.ps1
Binary file removed banner.png
Binary file not shown.
1 change: 1 addition & 0 deletions callcenter/.gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
.azure
Loading