AZD For Beginners: A Structured Learning Journey

Traduções Automatizadas (Sempre Atualizadas)

Prefere clonar localmente?

Este repositório inclui mais de 50 traduções de idiomas, o que aumenta significativamente o tamanho do download. Para clonar sem as traduções, use sparse checkout:

Bash / macOS / Linux:
git clone --filter=blob:none --sparse https://github.com/microsoft/AZD-for-beginners.git
cd AZD-for-beginners
git sparse-checkout set --no-cone '/*' '!translations' '!translated_images'
CMD (Windows):
git clone --filter=blob:none --sparse https://github.com/microsoft/AZD-for-beginners.git
cd AZD-for-beginners
git sparse-checkout set --no-cone "/*" "!translations" "!translated_images"
Isso fornece tudo o que você precisa para completar o curso com um download muito mais rápido.

🆕 Novidades do azd Hoje

O Azure Developer CLI evoluiu além de aplicativos web e APIs tradicionais. Hoje, azd é a ferramenta única para implantar qualquer aplicação no Azure — incluindo aplicações com IA e agentes inteligentes.

O que isso significa para você:

Agentes de IA agora são cargas de trabalho de primeira classe no azd. Você pode inicializar, implantar e gerenciar projetos de agentes de IA usando o mesmo fluxo azd init → azd up que você já conhece.
Integração com Microsoft Foundry traz implantação de modelos, hospedagem de agentes e configuração de serviços de IA diretamente para o ecossistema de templates do azd.
O fluxo principal não mudou. Seja implantando um aplicativo de tarefas, um microsserviço ou uma solução de IA multi-agente, os comandos são os mesmos.

Se você já usou azd antes, o suporte a IA é uma extensão natural — não uma ferramenta separada ou uma trilha avançada. Se você está começando agora, aprenderá um fluxo que funciona para tudo.

🚀 O que é o Azure Developer CLI (azd)?

Azure Developer CLI (azd) é uma ferramenta de linha de comando voltada para desenvolvedores que simplifica a implantação de aplicações no Azure. Em vez de criar e conectar manualmente dezenas de recursos do Azure, você pode implantar aplicações inteiras com um único comando.

A mágica do `azd up`

# Este único comando faz tudo:
# ✅ Cria todos os recursos do Azure
# ✅ Configura rede e segurança
# ✅ Constrói o código da sua aplicação
# ✅ Implanta no Azure
# ✅ Fornece uma URL funcional
azd up

É isso! Sem cliques no Azure Portal, sem templates ARM complexos para aprender primeiro, sem configuração manual — apenas aplicações funcionando no Azure.

❓ Azure Developer CLI vs Azure CLI: Qual é a diferença?

Esta é a pergunta mais comum entre iniciantes. Aqui está a resposta simples:

Recurso	Azure CLI (`az`)	Azure Developer CLI (`azd`)
Objetivo	Gerenciar recursos individuais do Azure	Implantar aplicações completas
Mentalidade	Focado em infraestrutura	Focado em aplicações
Exemplo	`az webapp create --name myapp...`	`azd up`
Curva de Aprendizado	Precisa conhecer serviços do Azure	Só precisa conhecer seu app
Melhor Para	DevOps, Infraestrutura	Desenvolvedores, Prototipagem

Analogia simples

Azure CLI é como ter todas as ferramentas para construir uma casa — martelos, serras, pregos. Você pode construir qualquer coisa, mas precisa conhecer construção.
Azure Developer CLI é como contratar um empreiteiro — você descreve o que quer, e eles cuidam da construção.

Quando usar cada um

Cenário	Use Isto
"Quero implantar meu web app rapidamente"	`azd up`
"Preciso criar apenas uma conta de armazenamento"	`az storage account create`
"Estou construindo uma aplicação completa de IA"	`azd init --template azure-search-openai-demo`
"Preciso depurar um recurso específico do Azure"	`az resource show`
"Quero uma implantação pronta para produção em minutos"	`azd up --environment production`

Eles funcionam juntos!

AZD usa Azure CLI por baixo dos panos. Você pode usar ambos:

# Faça o deploy do seu app com AZD
azd up

# Então ajuste recursos específicos com Azure CLI
az webapp config set --name myapp --always-on true

🌟 Encontre Templates no Awesome AZD

Não comece do zero! Awesome AZD é a coleção comunitária de templates prontos para implantar:

Recurso	Descrição
🔗 Galeria Awesome AZD	Navegue por 200+ templates com deploy em um clique
🔗 Enviar um Modelo	Contribua com seu próprio template para a comunidade
🔗 Repositório no GitHub	Dê estrela e explore a origem

Modelos de IA Populares do Awesome AZD

# Chat RAG com Modelos Microsoft Foundry + Pesquisa de IA
azd init --template azure-search-openai-demo

# Aplicativo Rápido de Chat com IA
azd init --template openai-chat-app-quickstart

# Agentes de IA com Agentes Foundry
azd init --template get-started-with-ai-agents

🎯 Começando em 3 passos

Antes de começar, certifique-se de que sua máquina está pronta para o template que você deseja implantar:

Windows:

.\validate-setup.ps1

macOS / Linux:

bash ./validate-setup.sh

Se alguma verificação necessária falhar, corrija isso primeiro e então continue com o início rápido.

Passo 1: Instalar o AZD (2 minutos)

Windows:

winget install microsoft.azd

macOS:

brew tap azure/azd && brew install azd

Linux:

curl -fsSL https://aka.ms/install-azd.sh | bash

Passo 2: Autenticar no AZD

# Opcional se você planeja usar comandos do Azure CLI diretamente neste curso
az login

# Requerido para fluxos de trabalho AZD
azd auth login

Se você não tem certeza de qual precisa, siga o fluxo completo de configuração em Installation & Setup.

Passo 3: Implantar seu primeiro app

# Inicializar a partir de um modelo
azd init --template todo-nodejs-mongo

# Implantar no Azure (cria tudo!)
azd up

🎉 É isso! Seu app agora está no ar no Azure.

Limpeza (Não esqueça!)

# Remove all resources when done experimenting
azd down --force --purge

📚 Como usar este curso

Este curso foi projetado para aprendizado progressivo — comece onde se sente confortável e avance:

Sua experiência	Comece aqui
Novo no Azure	Capítulo 1: Fundação
Conhece Azure, novo no AZD	Capítulo 1: Fundação
Quer implantar apps de IA	Capítulo 2: Desenvolvimento com foco em IA
Quer prática mão-na-massa	🎓 Workshop Interativo - laboratório guiado de 3-4 horas
Precisa de padrões para produção	Capítulo 8: Produção & Padrões Empresariais

Configuração Rápida

Faça um fork deste repositório:
Clone-o: git clone https://github.com/YOUR-USERNAME/azd-for-beginners.git
Peça ajuda: Comunidade Azure no Discord

Prefere clonar localmente?

Este repositório inclui mais de 50 traduções de idiomas, o que aumenta significativamente o tamanho do download. Para clonar sem as traduções, use sparse checkout:
git clone --filter=blob:none --sparse https://github.com/microsoft/AZD-for-beginners.git
cd AZD-for-beginners
git sparse-checkout set --no-cone '/*' '!translations' '!translated_images'
Isso fornece tudo o que você precisa para completar o curso com um download muito mais rápido.

Visão Geral do Curso

Domine o Azure Developer CLI (azd) por meio de capítulos estruturados projetados para aprendizado progressivo. Foco especial na implantação de aplicações de IA com integração ao Microsoft Foundry.

Por que este curso é essencial para desenvolvedores modernos

Com base em insights da comunidade Microsoft Foundry no Discord, 45% dos desenvolvedores querem usar AZD para cargas de trabalho de IA, mas encontram desafios com:

Arquiteturas complexas de IA com múltiplos serviços
Boas práticas para implantação de IA em produção
Integração e configuração de serviços de IA do Azure
Otimização de custos para cargas de trabalho de IA
Solução de problemas específicos de implantação de IA

Objetivos de Aprendizagem

Ao completar este curso estruturado, você irá:

Dominar os fundamentos do AZD: conceitos centrais, instalação e configuração
Implantar aplicações de IA: usar AZD com serviços do Microsoft Foundry
Implementar Infraestrutura como Código: gerenciar recursos do Azure com templates Bicep
Solucionar problemas de implantação: resolver problemas comuns e depurar falhas
Otimizar para produção: segurança, escalabilidade, monitoramento e gestão de custos
Construir soluções multi-agente: implantar arquiteturas complexas de IA

Antes de começar: Contas, Acesso e Premissas

Antes de iniciar o Capítulo 1, certifique-se de que você tem o seguinte em ordem. Os passos de instalação mais adiante neste guia assumem que esses pontos básicos já estão resolvidos.

Uma assinatura do Azure: Você pode usar uma assinatura existente do trabalho ou da sua conta pessoal, ou criar uma free trial para começar.
Permissão para criar recursos do Azure: Para a maioria dos exercícios, você deve ter pelo menos acesso Contributor na assinatura ou no grupo de recursos alvo. Alguns capítulos também podem assumir que você pode criar grupos de recursos, identidades gerenciadas e atribuições RBAC.
Uma conta do GitHub: Isso é útil para fazer fork do repositório, acompanhar suas próprias alterações e usar o GitHub Codespaces para o workshop.
Pré-requisitos de tempo de execução dos templates: Alguns templates exigem ferramentas locais como Node.js, Python, Java ou Docker. Execute o validador de configuração antes de começar para identificar ferramentas ausentes cedo.
Familiaridade básica com terminal: Você não precisa ser um especialista, mas deve estar confortável executando comandos como git clone, azd auth login e azd up.

Trabalhando em uma assinatura empresarial? Se seu ambiente Azure for gerenciado por um administrador, confirme com antecedência que você pode implantar recursos na assinatura ou no grupo de recursos que planeja usar. Caso contrário, solicite uma assinatura sandbox ou acesso Contributor antes de começar.

Novo no Azure? Comece com sua própria avaliação do Azure ou assinatura pay-as-you-go em https://aka.ms/azurefreetrial para que você possa completar os exercícios de ponta a ponta sem aguardar aprovações em nível de locatário.

🗺️ Mapa do Curso: Navegação Rápida por Capítulo

Cada capítulo tem um README dedicado com objetivos de aprendizagem, guias rápidos e exercícios:

Capítulo	Tópico	Aulas	Duração	Complexidade
Capítulo 1: Fundamentos	Introdução	Noções básicas do AZD \| Instalação \| Primeiro Projeto	30-45 min	⭐
Capítulo 2: Desenvolvimento com IA	Aplicativos com foco em IA	Integração com Microsoft Foundry \| Agentes de IA \| Implantação de Modelos \| Workshop	1-2 horas	⭐⭐
Capítulo 3: Configuração	Autenticação & Segurança	Configuração \| Autenticação e Segurança	45-60 min	⭐⭐
Capítulo 4: Infraestrutura	IaC & Implantação	Guia de Implantação \| Provisionamento	1-1.5 horas	⭐⭐⭐
Capítulo 5: Multi-Agente	Soluções com Agentes de IA	Cenário de Varejo \| Padrões de Coordenação	2-3 horas	⭐⭐⭐⭐
Capítulo 6: Pré-Implantação	Planejamento & Validação	Verificações Pré-voo \| Planejamento de Capacidade \| Seleção de SKU \| Application Insights	1 hr	⭐⭐
Capítulo 7: Solução de Problemas	Depuração & Correção	Problemas Comuns \| Depuração \| Problemas de IA	1-1.5 horas	⭐⭐
Capítulo 8: Produção	Padrões Corporativos	Práticas de Produção	2-3 horas	⭐⭐⭐⭐
🎓 Workshop	Laboratório Prático	Introdução \| Seleção \| Validação \| Desconstrução \| Configuração \| Personalização \| Desmontagem \| Encerramento	3-4 horas	⭐⭐

Duração total do curso: ~10-14 horas | Evolução de Habilidades: Iniciante → Pronto para Produção

📚 Capítulos de Aprendizagem

Selecione sua trilha de aprendizado com base no nível de experiência e objetivos

🚀 Capítulo 1: Fundamentos & Início Rápido

Pré-requisitos: assinatura do Azure, conhecimento básico de linha de comando
Duração: 30-45 minutos
Complexidade: ⭐

O que você vai aprender

Entender os fundamentos do Azure Developer CLI
Instalar o AZD na sua plataforma
Sua primeira implantação bem-sucedida

Recursos de Aprendizagem

🎯 Comece Aqui: O que é o Azure Developer CLI?
📖 Teoria: Noções básicas do AZD - Conceitos centrais e terminologia
⚙️ Configuração: Instalação & Configuração - Guias específicos por plataforma
🛠️ Mão na Massa: Seu Primeiro Projeto - Tutorial passo a passo
📋 Referência Rápida: Folha de Comandos

Exercícios Práticos

# Verificação rápida da instalação
azd version

# Implante sua primeira aplicação
azd init --template todo-nodejs-mongo
azd up

💡 Resultado do Capítulo: Implantar com sucesso uma aplicação web simples no Azure usando AZD

✅ Validação de Sucesso:

# Após concluir o Capítulo 1, você deverá ser capaz de:
azd version              # Mostra a versão instalada
azd init --template todo-nodejs-mongo  # Inicializa o projeto
azd up                  # Implanta no Azure
azd show                # Exibe a URL do aplicativo em execução
# O aplicativo abre no navegador e funciona
azd down --force --purge  # Limpa os recursos

📊 Investimento de Tempo: 30-45 minutos
📈 Nível de Habilidade Após: Capaz de implantar aplicações básicas de forma independente 📈 Nível de Habilidade Após: Capaz de implantar aplicações básicas de forma independente

🤖 Capítulo 2: Desenvolvimento com IA (Recomendado para Desenvolvedores de IA)

Pré-requisitos: Capítulo 1 concluído
Duração: 1-2 horas
Complexidade: ⭐⭐

O que você vai aprender

Integração Microsoft Foundry com AZD
Implantação de aplicações com IA
Entendimento das configurações de serviços de IA

Recursos de Aprendizagem

🎯 Comece Aqui: Integração com Microsoft Foundry
🤖 Agentes de IA: Guia de Agentes de IA - Implante agentes inteligentes com AZD
📖 Padrões: Implantação de Modelos de IA - Implantar e gerenciar modelos de IA
🛠️ Workshop: Laboratório de IA - Prepare suas soluções de IA para AZD
🎥 Guia Interativo: Materiais do Workshop - Aprendizado baseado no navegador com MkDocs * DevContainer Environment
📋 Templates: Microsoft Foundry Templates
📝 Exemplos: Exemplos de Implantação do AZD

Exercícios Práticos

# Implante sua primeira aplicação de IA
azd init --template azure-search-openai-demo
azd up

# Experimente modelos adicionais de IA
azd init --template openai-chat-app-quickstart
azd init --template agent-openai-python-prompty

💡 Resultado do Capítulo: Implantar e configurar uma aplicação de chat com IA e capacidades de RAG

✅ Validação de Sucesso:

# Após o Capítulo 2, você deverá ser capaz de:
azd init --template azure-search-openai-demo
azd up
# Testar a interface de chat com IA
# Fazer perguntas e obter respostas geradas por IA com fontes
# Verificar se a integração de pesquisa funciona
azd monitor  # Verificar se o Application Insights exibe telemetria
azd down --force --purge

📊 Investimento de Tempo: 1-2 horas
📈 Nível de Habilidade Após: Capaz de implantar e configurar aplicações de IA prontas para produção
💰 Consciência de Custos: Entenda custos de desenvolvimento de $80-150/mês, custos de produção de $300-3500/mês

💰 Considerações de Custos para Implantações de IA

Ambiente de Desenvolvimento (Estimado US$80-150/mês):

Modelos Microsoft Foundry (Pagamento por uso - Pay-as-you-go): US$0-50/mês (baseado no uso de tokens)
AI Search (nível Básico): US$75/mês
Container Apps (Consumo): US$0-20/mês
Armazenamento (Padrão): US$1-5/mês

Ambiente de Produção (Estimado US$300-3.500+/mês):

Modelos Microsoft Foundry (PTU para desempenho consistente): US$3.000+/mês OU Pay-as-go com alto volume
AI Search (nível Standard): US$250/mês
Container Apps (Dedicado): US$50-100/mês
Application Insights: US$5-50/mês
Armazenamento (Premium): US$10-50/mês

💡 Dicas de Otimização de Custos:

Use Free Tier dos Modelos Microsoft Foundry para aprendizado (Azure OpenAI 50.000 tokens/mês incluídos)
Execute azd down para desalocar recursos quando não estiver desenvolvendo ativamente
Comece com cobrança baseada em consumo, faça upgrade para PTU apenas para produção
Use azd provision --preview para estimar custos antes da implantação
Habilite auto-scaling: pague apenas pelo uso real

Monitoramento de Custos:

# Verificar os custos mensais estimados
azd provision --preview

# Monitorar os custos reais no Portal do Azure
az consumption budget list --resource-group <your-rg>

⚙️ Capítulo 3: Configuração & Autenticação

Pré-requisitos: Capítulo 1 concluído
Duração: 45-60 minutos
Complexidade: ⭐⭐

O que você vai aprender

Configuração e gerenciamento de ambientes
Boas práticas de autenticação e segurança
Nomeação e organização de recursos

Recursos de Aprendizagem

📖 Configuração: Guia de Configuração - Configuração de ambiente
🔐 Segurança: Padrões de autenticação e identidade gerenciada - Padrões de autenticação
📝 Exemplos: Exemplo de Aplicação com Banco de Dados - Exemplos AZD com banco de dados

Exercícios Práticos

Configurar múltiplos ambientes (dev, staging, prod)
Configurar autenticação com identidade gerenciada
Implementar configurações específicas por ambiente

💡 Resultado do Capítulo: Gerenciar múltiplos ambientes com autenticação e segurança apropriadas

🏗️ Capítulo 4: Infraestrutura como Código & Implantação

Pré-requisitos: Capítulos 1-3 concluídos
Duração: 1-1.5 horas
Complexidade: ⭐⭐⭐

O que você vai aprender

Padrões avançados de implantação
Infraestrutura como Código com Bicep
Estratégias de provisionamento de recursos

Recursos de Aprendizagem

📖 Implantação: Guia de Implantação - Fluxos de trabalho completos
🏗️ Provisionamento: Provisionamento de Recursos - Gerenciamento de recursos Azure
📝 Exemplos: Exemplo de Container App - Implantações conteinerizadas

Exercícios Práticos

Criar templates Bicep personalizados
Implantar aplicações multi-serviço
Implementar estratégias de implantação blue-green

💡 Resultado do Capítulo: Implantar aplicações multi-serviço complexas usando templates de infraestrutura personalizados

🎯 Capítulo 5: Soluções Multi-Agente de IA (Avançado)

Pré-requisitos: Capítulos 1-2 concluídos
Duração: 2-3 horas
Complexidade: ⭐⭐⭐⭐

O que você vai aprender

Padrões de arquitetura multi-agente
Orquestração e coordenação de agentes
Implantações de IA prontas para produção

Recursos de Aprendizagem

🤖 Projeto em Destaque: Solução Multi-Agente para Varejo - Implementação completa
🛠️ Pacote de Templates ARM: Pacote de Template ARM - Implantação com um clique
📖 Arquitetura: Padrões de coordenação multi-agente - Padrões

Exercícios Práticos

# Implantar a solução completa de varejo com múltiplos agentes
cd examples/retail-multiagent-arm-template
./deploy.sh

# Explorar configurações dos agentes
az deployment group show --resource-group <rg-name> --name <deployment-name>

💡 Resultado do Capítulo: Implantar e gerenciar uma solução multi-agente de IA pronta para produção com agentes de Cliente e Inventário

🔍 Capítulo 6: Validação & Planejamento Pré-Implantação

Pré-requisitos: Capítulo 4 concluído
Duração: 1 hora
Complexidade: ⭐⭐

O que você vai aprender

Planejamento de capacidade e validação de recursos
Estratégias de seleção de SKU
Verificações pré-implantação e automação

Recursos de Aprendizado

📊 Planejamento: Capacity Planning - Validação de recursos
💰 Seleção: SKU Selection - Escolhas custo-efetivas
✅ Validação: Pre-flight Checks - Scripts automatizados

Exercícios Práticos

Execute scripts de validação de capacidade
Otimize seleções de SKU para custo
Implemente verificações automatizadas pré-implantação

💡 Resultado do Capítulo: Validar e otimizar implantações antes da execução

🚨 Capítulo 7: Solução de Problemas e Depuração

Pré-requisitos: Qualquer capítulo de implantação concluído
Duração: 1-1,5 horas
Complexidade: ⭐⭐

O que você vai aprender

Abordagens sistemáticas de depuração
Problemas comuns e soluções
Solução de problemas específica para IA

Recursos de Aprendizado

🔧 Problemas Comuns: Common Issues - FAQ e soluções
🕵️ Depuração: Debugging Guide - Estratégias passo a passo
🤖 Problemas de IA: AI-Specific Troubleshooting - Problemas de serviços de IA

Exercícios Práticos

Diagnosticar falhas de implantação
Resolver problemas de autenticação
Depurar conectividade de serviços de IA

💡 Resultado do Capítulo: Diagnosticar e resolver de forma independente problemas comuns de implantação

🏢 Capítulo 8: Padrões de Produção e Empresariais

Pré-requisitos: Capítulos 1-4 concluídos
Duração: 2-3 horas
Complexidade: ⭐⭐⭐⭐

O que você vai aprender

Estratégias de implantação em produção
Padrões de segurança empresariais
Monitoramento e otimização de custos

Recursos de Aprendizado

🏭 Produção: Production AI Best Practices - Padrões empresariais
📝 Exemplos: Microservices Example - Arquiteturas complexas
📊 Monitoramento: Application Insights integration - Monitoramento

Exercícios Práticos

Implementar padrões de segurança empresariais
Configurar monitoramento abrangente
Implantar em produção com governança adequada

💡 Resultado do Capítulo: Implantar aplicações prontas para empresas com todas as capacidades de produção

🎓 Visão Geral do Workshop: Experiência de Aprendizagem Prática

⚠️ STATUS DO WORKSHOP: Em Desenvolvimento Ativo
Os materiais do workshop estão atualmente em desenvolvimento e refinamento. Os módulos principais estão funcionais, mas algumas seções avançadas estão incompletas. Estamos trabalhando ativamente para concluir todo o conteúdo. Acompanhe o progresso →

Materiais Interativos do Workshop

Aprendizagem prática abrangente com ferramentas baseadas no navegador e exercícios guiados

Nossos materiais do workshop fornecem uma experiência de aprendizado estruturada e interativa que complementa o currículo baseado em capítulos acima. O workshop foi projetado tanto para aprendizado autodirigido quanto para sessões conduzidas por instrutor.

🛠️ Recursos do Workshop

Interface baseada em navegador: Workshop completo com MkDocs, com busca, função de copiar e recursos de tema
Integração com GitHub Codespaces: Configuração do ambiente de desenvolvimento com um clique
Caminho de Aprendizagem Estruturado: Exercícios guiados em 8 módulos (3-4 horas no total)
Metodologia Progressiva: Introdução → Seleção → Validação → Desconstrução → Configuração → Personalização → Encerramento → Conclusão
Ambiente DevContainer Interativo: Ferramentas e dependências pré-configuradas

📚 Estrutura dos Módulos do Workshop

O workshop segue uma metodologia progressiva de 8 módulos que o leva da descoberta ao domínio da implantação:

Módulo	Tópico	O que você fará	Duração
0. Introduction	Workshop Overview	Understand learning objectives, prerequisites, and workshop structure	15 min
1. Selection	Template Discovery	Explore AZD templates and select the right AI template for your scenario	20 min
2. Validation	Deploy & Verify	Deploy the template with `azd up` and validate infrastructure works	30 min
3. Deconstruction	Understand Structure	Use GitHub Copilot to explore template architecture, Bicep files, and code organization	30 min
4. Configuration	azure.yaml Deep Dive	Master `azure.yaml` configuration, lifecycle hooks, and environment variables	30 min
5. Customization	Make It Yours	Enable AI Search, tracing, evaluation, and customize for your scenario	45 min
6. Teardown	Clean Up	Safely deprovision resources with `azd down --purge`	15 min
7. Wrap-up	Next Steps	Review accomplishments, key concepts, and continue your learning journey	15 min

Workshop Flow:

Introduction → Selection → Validation → Deconstruction → Configuration → Customization → Teardown → Wrap-up
     ↓            ↓           ↓              ↓               ↓              ↓            ↓           ↓
  Overview    Find the     Deploy &      Explore        Master         Customize     Clean up    Review &
             right        verify        code &        azure.yaml      for your      resources   next steps
             template                   structure                     scenario

🚀 Iniciando o Workshop

# Opção 1: GitHub Codespaces (Recomendado)
# Clique em "Code" → "Create codespace on main" no repositório

# Opção 2: Desenvolvimento local
git clone https://github.com/microsoft/azd-for-beginners.git
cd azd-for-beginners/workshop
# Siga as instruções de configuração em workshop/README.md

🎯 Resultados de Aprendizagem do Workshop

Ao completar o workshop, os participantes irão:

Implantar Aplicações de IA em Produção: Usar AZD com serviços Microsoft Foundry
Dominar Arquiteturas Multi-Agentes: Implementar soluções coordenadas de agentes de IA
Implementar Melhores Práticas de Segurança: Configurar autenticação e controle de acesso
Otimizar para Escala: Projetar implantações com custo-benefício e alto desempenho
Solução de Problemas em Implantações: Resolver problemas comuns de forma independente

📖 Recursos do Workshop

🎥 Guia Interativo: Workshop Materials - Ambiente de aprendizagem baseado no navegador
📋 Instruções Módulo a Módulo:
- 0. Introduction - Visão geral do workshop e objetivos
- 1. Selection - Encontrar e selecionar templates de IA
- 2. Validation - Implantar e verificar templates
- 3. Deconstruction - Explorar a arquitetura do template
- 4. Configuration - Dominar azure.yaml
- 5. Customization - Customizar para seu cenário
- 6. Teardown - Limpar recursos
- 7. Wrap-up - Revisão e próximos passos
🛠️ Laboratório do Workshop de IA: AI Workshop Lab - Exercícios focados em IA
💡 Início Rápido: Workshop Setup Guide - Configuração do ambiente

Perfeito para: Treinamento corporativo, cursos universitários, aprendizado autodirigido e bootcamps de desenvolvedores.

📖 Mergulho Profundo: Capacidades do AZD

Além do básico, o AZD fornece recursos poderosos para implantações em produção:

Implantações baseadas em templates - Use templates pré-construídos para padrões comuns de aplicação
Infraestrutura como Código - Gerencie recursos do Azure usando Bicep ou Terraform
Fluxos de trabalho integrados - Provisionar, implantar e monitorar aplicações de forma contínua
Focado no desenvolvedor - Otimizado para produtividade e experiência do desenvolvedor

AZD + Microsoft Foundry: Perfeito para Implantações de IA

Por que o AZD para Soluções de IA? O AZD resolve os principais desafios que desenvolvedores de IA enfrentam:

Templates Prontos para IA - Templates pré-configurados para Microsoft Foundry Models, Cognitive Services e cargas de trabalho de ML
Implantações de IA Seguras - Padrões de segurança embutidos para serviços de IA, chaves de API e endpoints de modelo
Padrões de IA para Produção - Melhores práticas para implantações de aplicações de IA escaláveis e custo-efetivas
Fluxos de Trabalho de IA de Ponta a Ponta - Do desenvolvimento do modelo à implantação em produção com monitoramento adequado
Otimização de Custos - Alocação inteligente de recursos e estratégias de escalonamento para cargas de trabalho de IA
Integração com Microsoft Foundry - Conexão fluida com o catálogo de modelos e endpoints do Microsoft Foundry

🎯 Biblioteca de Templates e Exemplos

Em Destaque: Templates Microsoft Foundry

Comece aqui se você estiver implantando aplicações de IA!

Nota: Esses templates demonstram vários padrões de IA. Alguns são Azure Samples externos, outros são implementações locais.

Template	Capítulo	Complexidade	Serviços	Tipo
Get started with AI chat	Capítulo 2	⭐⭐	AzureOpenAI + Azure AI Model Inference API + Azure AI Search + Azure Container Apps + Application Insights	Externo
Get started with AI agents	Capítulo 2	⭐⭐	Foundry Agents + AzureOpenAI + Azure AI Search + Azure Container Apps + Application Insights	Externo
Azure Search + OpenAI Demo	Capítulo 2	⭐⭐	AzureOpenAI + Azure AI Search + App Service + Storage	Externo
OpenAI Chat App Quickstart	Capítulo 2	⭐	AzureOpenAI + Container Apps + Application Insights	Externo
Agent OpenAI Python Prompty	Capítulo 5	⭐⭐⭐	AzureOpenAI + Azure Functions + Prompty	Externo
Contoso Chat RAG	Capítulo 8	⭐⭐⭐⭐	AzureOpenAI + AI Search + Cosmos DB + Container Apps	Externo
Retail Multi-Agent Solution	Capítulo 5	⭐⭐⭐⭐	AzureOpenAI + AI Search + Storage + Container Apps + Cosmos DB	Local

Em Destaque: Cenários de Aprendizagem Completos

Templates prontos para produção mapeados para os capítulos de aprendizado

Template	Capítulo de Aprendizagem	Complexidade	Aprendizado Principal
openai-chat-app-quickstart	Capítulo 2	⭐	Padrões básicos de implantação de IA
azure-search-openai-demo	Capítulo 2	⭐⭐	Implementação RAG com Azure AI Search
ai-document-processing	Capítulo 4	⭐⭐	Integração com Document Intelligence
agent-openai-python-prompty	Capítulo 5	⭐⭐⭐	Framework de agentes e chamadas de função
contoso-chat	Capítulo 8	⭐⭐⭐	Orquestração de IA corporativa
retail-multi-agent-solution	Capítulo 5	⭐⭐⭐⭐	Arquitetura multi-agente com agentes de Cliente e Inventário

Aprendizado por Tipo de Exemplo

📌 Exemplos Locais vs. Externos:
Exemplos Locais (neste repositório) = Prontos para uso imediato
Exemplos Externos (Azure Samples) = Clone dos repositórios vinculados

Exemplos Locais (Prontos para Uso)

Retail Multi-Agent Solution - Implementação completa pronta para produção com templates ARM
- Arquitetura multi-agente (agentes Cliente + Inventário)
- Monitoramento e avaliação abrangentes
- Implantação com um clique via template ARM

Exemplos Locais - Aplicações em Container (Capítulos 2-5)

Exemplos abrangentes de implantação em container neste repositório:

Container App Examples - Guia completo para implantações conteinerizadas
- Simple Flask API - API REST básica com scale-to-zero
- Microservices Architecture - Implantação multi-serviço pronta para produção
- Quick Start, Production, and Advanced deployment patterns
- Monitoramento, segurança e orientação de otimização de custos

Exemplos Externos - Aplicações Simples (Capítulos 1-2)

Clone esses repositórios Azure Samples para começar:

Simple Web App - Node.js + MongoDB - Padrões básicos de implantação
Static Website - React SPA - Implantação de conteúdo estático
Container App - Python Flask - Implantação de API REST

Exemplos Externos - Integração com Banco de Dados (Capítulos 3-4)

Aplicativo de Banco de Dados - C# + SQL - Padrões de conectividade com banco de dados
Functions + Cosmos DB - Fluxo de trabalho de dados sem servidor

Exemplos Externos - Padrões Avançados (Capítulos 4-8)

Java Microservices - Arquiteturas multi-serviço
Container Apps Jobs - Processamento em segundo plano
Enterprise ML Pipeline - Padrões de ML prontos para produção

Coleções de Templates Externas

Galeria Oficial de Templates AZD - Coleção selecionada de templates oficiais e da comunidade
Templates do Azure Developer CLI - Documentação de templates do Microsoft Learn
Diretório de Exemplos - Exemplos de aprendizado local com explicações detalhadas

📚 Recursos de Aprendizado e Referências

Referências Rápidas

Resumo de Comandos - Comandos essenciais do azd organizados por capítulo
Glossário - Terminologia do Azure e do azd
FAQ - Perguntas comuns organizadas por capítulo de aprendizado
Guia de Estudo - Exercícios práticos abrangentes

Workshops Práticos

Laboratório de Workshop de IA - Torne suas soluções de IA implantáveis com AZD (2-3 horas)
Workshop Interativo - Exercícios guiados em 8 módulos com MkDocs e GitHub Codespaces
- Segue: Introdução → Seleção → Validação → Desconstrução → Configuração → Personalização → Encerramento → Finalização

Recursos de Aprendizado Externos

Habilidades de Agente de IA para Seu Editor

Microsoft Azure Skills on skills.sh - 37 habilidades de agente abertas para Azure AI, Foundry, implantação, diagnóstico, otimização de custos e mais. Instale-as no GitHub Copilot, Cursor, Claude Code, ou em qualquer agente compatível:
```
npx skills add microsoft/github-copilot-for-azure
```

🔧 Guia Rápido de Solução de Problemas

Problemas comuns enfrentados por iniciantes e soluções imediatas:

❌ "azd: command not found"

# Instale o AZD primeiro
# Windows (PowerShell):
winget install microsoft.azd

# macOS:
brew tap azure/azd && brew install azd

# Linux:
curl -fsSL https://aka.ms/install-azd.sh | bash

# Verifique a instalação
azd version

❌ "No subscription found" or "Subscription not set"

# Listar assinaturas disponíveis
az account list --output table

# Definir assinatura padrão
az account set --subscription "<subscription-id-or-name>"

# Definir para o ambiente AZD
azd env set AZURE_SUBSCRIPTION_ID "<subscription-id>"

# Verificar
az account show

❌ "InsufficientQuota" or "Quota exceeded"

# Tente uma região do Azure diferente
azd env set AZURE_LOCATION "westus2"
azd up

# Ou use SKUs menores em desenvolvimento
# Edite infra/main.parameters.json:
{
  "sku": "B1"  // Instead of "P1V2"
}

❌ "azd up" fails halfway through

# Opção 1: Limpar e tentar novamente
azd down --force --purge
azd up

# Opção 2: Apenas corrigir a infraestrutura
azd provision

# Opção 3: Verificar status detalhado
azd show

# Opção 4: Verificar logs no Azure Monitor
azd monitor --logs

❌ "Authentication failed" or "Token expired"

# Reautenticar para o AZD
azd auth logout
azd auth login

# Opcional: atualizar também o Azure CLI se você estiver executando comandos az
az logout
az login

# Verificar autenticação
az account show

❌ "Resource already exists" or conflitos de nomenclatura

# AZD gera nomes únicos, mas se houver conflito:
azd down --force --purge

# Então tente novamente com um ambiente novo
azd env new dev-v2
azd up

❌ Implantação do template demorando demais

Tempos de espera normais:

Aplicativo web simples: 5-10 minutos
Aplicativo com banco de dados: 10-15 minutos
Aplicações de IA: 15-25 minutos (o provisionamento do OpenAI é lento)

# Verificar o progresso
azd show

# Se ficar travado por mais de 30 minutos, verifique o Portal do Azure:
azd monitor --overview
# Procure por implantações com falha

❌ "Permission denied" or "Forbidden"

# Verifique sua função no Azure
az role assignment list --assignee $(az account show --query user.name -o tsv)

# Você precisa, no mínimo, da função "Contributor"
# Peça ao administrador do Azure para conceder:
# - Contributor (para recursos)
# - User Access Administrator (para atribuições de função)

❌ Can't find deployed application URL

# Mostrar todos os endpoints de serviço
azd show

# Ou abra o Portal do Azure
azd monitor

# Verificar serviço específico
azd env get-values
# Procure por variáveis *_URL

📚 Recursos completos de Solução de Problemas

Guia de Problemas Comuns: Soluções Detalhadas
Problemas Específicos de IA: Solução de Problemas de IA
Guia de Depuração: Depuração passo a passo
Obtenha Ajuda: Azure Discord #azure-developer-cli

🎓 Conclusão do Curso e Certificação

Acompanhamento de Progresso

Acompanhe seu progresso de aprendizado em cada capítulo:

Capítulo 1: Fundamentos e Início Rápido ✅
Capítulo 2: Desenvolvimento com Foco em IA ✅
Capítulo 3: Configuração e Autenticação ✅
Capítulo 4: Infraestrutura como Código e Implantação ✅
Capítulo 5: Soluções de IA Multiagente ✅
Capítulo 6: Validação e Planejamento Pré-Implantação ✅
Capítulo 7: Solução de Problemas e Depuração ✅
Capítulo 8: Padrões de Produção e Corporativos ✅

Verificação de Aprendizado

Após completar cada capítulo, verifique seu conhecimento por meio de:

Exercício Prático: Complete a implantação prática do capítulo
Verificação de Conhecimento: Revise a seção de FAQ do seu capítulo
Discussão na Comunidade: Compartilhe sua experiência no Azure Discord
Próximo Capítulo: Avance para o próximo nível de complexidade

Benefícios da Conclusão do Curso

Ao concluir todos os capítulos, você terá:

Experiência em Produção: Implantou aplicações reais de IA no Azure
Habilidades Profissionais: Capacidades de implantação prontas para o ambiente corporativo
Reconhecimento na Comunidade: Membro ativo da comunidade de desenvolvedores Azure
Avanço na Carreira: Especialização em AZD e implantação de IA muito requisitada

🤝 Comunidade e Suporte

Obtenha Ajuda e Suporte

Problemas Técnicos: Reporte bugs e solicite recursos
Dúvidas de Aprendizado: Comunidade Microsoft Azure no Discord e
Ajuda Específica de IA: Junte-se ao
Documentação: Documentação oficial do Azure Developer CLI

Insights da Comunidade do Microsoft Foundry Discord

Resultados recentes da enquete do canal #Azure:

45% dos desenvolvedores querem usar AZD para cargas de trabalho de IA
Principais desafios: Implantações multi-serviço, gerenciamento de credenciais, prontidão para produção
Mais solicitados: Templates específicos para IA, guias de solução de problemas, melhores práticas

Junte-se à nossa comunidade para:

Compartilhar suas experiências com AZD + IA e obter ajuda
Acessar prévias antecipadas de novos templates de IA
Contribuir com melhores práticas de implantação de IA
Influenciar o desenvolvimento futuro de recursos de IA + AZD

Contribuindo para o Curso

Acolhemos contribuições! Por favor, leia nosso Guia de Contribuição para detalhes sobre:

Melhorias de Conteúdo: Aprimore capítulos e exemplos existentes
Novos Exemplos: Adicione cenários do mundo real e templates
Tradução: Ajude a manter o suporte multilíngue
Relatos de Bugs: Melhore a precisão e a clareza
Padrões da Comunidade: Siga nossas diretrizes comunitárias inclusivas

📄 Informações do Curso

Licença

Este projeto está licenciado sob a Licença MIT - veja o arquivo LICENSE para detalhes.

Recursos de Aprendizado Relacionados da Microsoft

Nossa equipe produz outros cursos de aprendizado abrangentes:

LangChain

Azure / Edge / MCP / Agentes

Série de IA Generativa

Aprendizado Fundamental

Série Copilot

🗺️ Navegação do Curso

🚀 Pronto para começar a aprender?

Iniciantes: Comece por Capítulo 1: Fundamentos & Início Rápido
Desenvolvedores de IA: Vá para Capítulo 2: Desenvolvimento com Foco em IA
Desenvolvedores Experientes: Comece por Capítulo 3: Configuração e Autenticação

Próximos Passos: Iniciar Capítulo 1 - Noções Básicas do AZD →

Isenção de responsabilidade: Este documento foi traduzido usando o serviço de tradução por IA Co-op Translator. Embora nos esforcemos pela precisão, esteja ciente de que traduções automatizadas podem conter erros ou imprecisões. O documento original em seu idioma nativo deve ser considerado a fonte autoritativa. Para informações críticas, recomenda-se tradução humana profissional. Não nos responsabilizamos por quaisquer mal-entendidos ou interpretações incorretas decorrentes do uso desta tradução.

FilesExpand file tree

README.md

Latest commit

History

README.md

File metadata and controls

AZD For Beginners: A Structured Learning Journey

Traduções Automatizadas (Sempre Atualizadas)

🆕 Novidades do azd Hoje

🚀 O que é o Azure Developer CLI (azd)?

A mágica do azd up

❓ Azure Developer CLI vs Azure CLI: Qual é a diferença?

Analogia simples

Quando usar cada um

Eles funcionam juntos!

🌟 Encontre Templates no Awesome AZD

Modelos de IA Populares do Awesome AZD

🎯 Começando em 3 passos

Passo 1: Instalar o AZD (2 minutos)

Passo 2: Autenticar no AZD

Passo 3: Implantar seu primeiro app

Limpeza (Não esqueça!)

📚 Como usar este curso

Configuração Rápida

Visão Geral do Curso

Por que este curso é essencial para desenvolvedores modernos

Objetivos de Aprendizagem

Antes de começar: Contas, Acesso e Premissas

🗺️ Mapa do Curso: Navegação Rápida por Capítulo

📚 Capítulos de Aprendizagem

🚀 Capítulo 1: Fundamentos & Início Rápido

O que você vai aprender

Recursos de Aprendizagem

Exercícios Práticos

🤖 Capítulo 2: Desenvolvimento com IA (Recomendado para Desenvolvedores de IA)

O que você vai aprender

Recursos de Aprendizagem

Exercícios Práticos

💰 Considerações de Custos para Implantações de IA

⚙️ Capítulo 3: Configuração & Autenticação

O que você vai aprender

Recursos de Aprendizagem

Exercícios Práticos

🏗️ Capítulo 4: Infraestrutura como Código & Implantação

O que você vai aprender

Recursos de Aprendizagem

Exercícios Práticos

🎯 Capítulo 5: Soluções Multi-Agente de IA (Avançado)

O que você vai aprender

Recursos de Aprendizagem

Exercícios Práticos

🔍 Capítulo 6: Validação & Planejamento Pré-Implantação

O que você vai aprender

Recursos de Aprendizado

Exercícios Práticos

🚨 Capítulo 7: Solução de Problemas e Depuração

O que você vai aprender

Recursos de Aprendizado

Exercícios Práticos

🏢 Capítulo 8: Padrões de Produção e Empresariais

O que você vai aprender

Recursos de Aprendizado

Exercícios Práticos

🎓 Visão Geral do Workshop: Experiência de Aprendizagem Prática

Materiais Interativos do Workshop

🛠️ Recursos do Workshop

📚 Estrutura dos Módulos do Workshop

🚀 Iniciando o Workshop

🎯 Resultados de Aprendizagem do Workshop

📖 Recursos do Workshop

📖 Mergulho Profundo: Capacidades do AZD

AZD + Microsoft Foundry: Perfeito para Implantações de IA

🎯 Biblioteca de Templates e Exemplos

Em Destaque: Templates Microsoft Foundry

Em Destaque: Cenários de Aprendizagem Completos

Aprendizado por Tipo de Exemplo

Exemplos Locais (Prontos para Uso)

Exemplos Locais - Aplicações em Container (Capítulos 2-5)

Exemplos Externos - Aplicações Simples (Capítulos 1-2)

Exemplos Externos - Integração com Banco de Dados (Capítulos 3-4)

A mágica do `azd up`