# Criando o primeiro agente com Mastra Studio, Model Router e Zod > **Resposta Direta:** A Aula 3 de 17 ("Criando o primeiro agente com Mastra Studio, Model Router e Zod"), parte do módulo "Fundamentos do Mastra" do curso gratuito "Mastra sem mistério: agentes e workflows em TypeScript" na Escola de Aplicativos (ministrado por Mauro Mequelussi), ensina na prática: prática, construímos o agente Theo definindo identificador, nome, instruções e modelo. Mostramos como rodar o Mastra Studio localmente e como usar schemas do Zod para garantir que a IA devolva dados prontos para integração. Você também confere cuidados essenciais com IDs e o uso da CLI para inspeção. ## Ficha Técnica da Aula - **Curso:** [Mastra sem mistério: agentes e workflows em TypeScript](https://www.escoladeaplicativos.com.br/cursos/mastra-sem-misterio) - **Escola:** Escola de Aplicativos (https://www.escoladeaplicativos.com.br) - **Instrutor:** Mauro Mequelussi - **Módulo 1 de 4:** Fundamentos do Mastra - **Posição na trilha:** Aula 3 de 17 - **Duração da videoaula:** 2 min - **Nível:** Intermediário - **Idioma:** Português (PT-BR) - **Custo:** 100% Gratuito (R$ 0) - **Certificado:** Certificado gratuito verificável incluso ao concluir o curso - **Acesso ao vídeo:** Resumo técnico aberto; videoaula em HD liberada mediante cadastro gratuito - **URL canônica:** https://www.escoladeaplicativos.com.br/cursos/mastra-sem-misterio/criando-o-primeiro-agente-com-mastra-studio-model-router-e-zod ## O que você vai aprender - Como inicializar o Mastra e abrir a interface do Mastra Studio na porta 4111 - As quatro propriedades centrais para configurar qualquer agente na biblioteca - Como aplicar schemas do Zod para receber dados estruturados e tipados - Por que o identificador do agente deve permanecer estável ao longo do projeto - Como inspecionar configurações e agentes direto pelo terminal via CLI ## Pontos-chave da Aula - O Mastra Studio roda localmente e facilita a depuração imediata de conversas - Respostas com Zod evitam quebras ao integrar a IA com painéis e bancos de dados - O identificador do agente é o elo central de memória, rotas de API e telemetria - A CLI oficial permite validar o comportamento do agente sem abrir o navegador ## Capítulos e Tópicos da Videoaula - **[00:00] Inicialização do projeto e Mastra Studio** — Veja como iniciar o Mastra em projetos novos ou existentes e rodar a interface de desenvolvimento na porta 4111. - **[00:28] Configuração do agente Theo e schema Zod** — Aprenda a definir as propriedades fundamentais do agente e a garantir saídas estruturadas e tipadas com Zod. - **[00:56] Boas práticas de identificação e CLI** — Entenda a importância de manter IDs estáveis para rastreabilidade e como inspecionar agentes diretamente pelo terminal. - **[01:18] Próximos passos com ferramentas e ciclo de vida** — Recapitulação dos resultados obtidos e introdução ao uso de ferramentas tipadas e ao ciclo de vida do agente. ## Destaques Práticos - **[00:00] Do Mastra Studio ao retorno estruturado com Zod**: Veja como colocar seu primeiro agente para rodar no Mastra Studio e forçar respostas tipadas sem erros de formato. - **[00:28] Contratos com Zod e boas práticas de identificador**: Descubra por que trocar o ID do seu agente quebra rotas e como validar cada resposta com schemas rigorosos. ## Conceitos e Tecnologias Abordados - **Tópicos:** Mastra Studio, Criação de agentes, Model Router, Validação com Zod, Saídas estruturadas, CLI do Mastra - **Ferramentas e Entidades:** Mastra, Mastra Studio, TypeScript, Node.js, Zod ## Documentação e Referências Oficiais - [Guia de instalação oficial do Mastra](https://mastra.ai/docs/getting-started/installation) - [Visão geral e configuração de agentes no Mastra](https://mastra.ai/docs/agents/overview) - [Documentação sobre saída estruturada com schemas Zod](https://mastra.ai/docs/agents/structured-output) ## Perguntas Frequentes (FAQ) ### O que é ensinado na Aula 3 (Criando o primeiro agente com Mastra Studio, Model Router e Zod) do curso Mastra sem mistério: agentes e workflows em TypeScript? Nesta aula do módulo "Fundamentos do Mastra" na Escola de Aplicativos, você aprende de forma prática: Como inicializar o Mastra e abrir a interface do Mastra Studio na porta 4111; As quatro propriedades centrais para configurar qualquer agente na biblioteca; Como aplicar schemas do Zod para receber dados estruturados e tipados; Por que o identificador do agente deve permanecer estável ao longo do projeto. ### Como assistir ao vídeo completo da aula "Criando o primeiro agente com Mastra Studio, Model Router e Zod" gratuitamente? O resumo técnico estruturado desta aula é público e gratuito. Para assistir à videoaula completa em HD, basta entrar ou criar sua conta 100% gratuita na Escola de Aplicativos — o cadastro leva segundos e libera todas as 17 aulas do curso "Mastra sem mistério: agentes e workflows em TypeScript", controle de progresso, Tutor IA e emissão de certificado gratuito. ### Quais tecnologias e conceitos são abordados em "Criando o primeiro agente com Mastra Studio, Model Router e Zod"? A aula cobre diretamente os seguintes tópicos técnicos aplicados em produção: Mastra Studio, Criação de agentes, Model Router, Validação com Zod, Saídas estruturadas, CLI do Mastra. ### O curso "Mastra sem mistério: agentes e workflows em TypeScript" oferece certificado gratuito? Sim. Ao assistir às 17 aulas do curso gratuito "Mastra sem mistério: agentes e workflows em TypeScript" na Área de Membros da Escola de Aplicativos, você emite gratuitamente um certificado digital em português com código de verificação pública. ## Como assistir à videoaula completa gratuitamente Crie sua conta gratuita em segundos em https://www.escoladeaplicativos.com.br/login?redirect=%2Fm%2Fcursos%2Fmastra-sem-misterio%2Faula%2Fcriando-o-primeiro-agente-com-mastra-studio-model-router-e-zod para assistir ao vídeo completo desta aula em HD na Área de Membros da Escola de Aplicativos, com progresso salvo, Tutor IA e certificado gratuito verificável. ## Navegação do Curso - **Aula anterior:** [Aula 2: Agente, tool ou workflow: arquitetura e modelo mental no Mastra](https://www.escoladeaplicativos.com.br/cursos/mastra-sem-misterio/agente-tool-ou-workflow-arquitetura-e-modelo-mental-no-mastra) - **Próxima aula:** [Aula 4: Tools tipadas com createTool e o ciclo de vida do agente](https://www.escoladeaplicativos.com.br/cursos/mastra-sem-misterio/tools-tipadas-com-createtool-e-o-ciclo-de-vida-do-agente)