# Tools tipadas com createTool e o ciclo de vida do agente > **Resposta Direta:** A Aula 4 de 17 ("Tools tipadas com createTool e o ciclo de vida do agente"), 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: o agente Theo recebe ferramentas tipadas com contratos explícitos de entrada e saída. Você vai descobrir como funciona a assinatura de execução na versão 1 do Mastra e quais são as quatro fases do ciclo de vida que impedem alucinações e controlam o gasto de tokens. ## 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 4 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/tools-tipadas-com-createtool-e-o-ciclo-de-vida-do-agente ## O que você vai aprender - Como criar ferramentas com contratos explícitos de entrada e saída - A assinatura correta da função de execução no Mastra v1 - As quatro fases do ciclo de vida de um agente: Preparação, Iteração, Passo do Modelo e Finalização - Como processadores de entrada e saída gerenciam memória e reduzem o consumo de tokens - Como limitar encadeamentos sucessivos de ferramentas para evitar loops infinitos ## Pontos-chave da Aula - Objetos soltos sem schema falham em silêncio; use sempre contratos definidos. - A função de execução recebe primeiro os dados validados e depois o contexto da requisição. - A fase de Preparação filtra dados sensíveis antes de gastar tokens no modelo. - O controle de iterações evita execuções desnecessárias e estouro de custos. ## Capítulos e Tópicos da Videoaula - **[00:00] Contratos explícitos para criação de ferramentas** — Entenda por que criar ferramentas com schemas tipados evita falhas silenciosas e alucinações do modelo. - **[00:31] Assinatura de execução e visão geral do ciclo** — Veja a assinatura padrão de execução no Mastra v1 e conheça as quatro fases essenciais do agente. - **[01:02] Preparação, iteração e finalização do agente** — Aprenda como funcionam a preparação, os limites de passos em ferramentas e a auditoria de respostas. - **[01:27] Resultados com dados reais e próximos passos** — Veja o agente consultando lotes reais e entenda o que vem a seguir sobre engenharia de contexto. ## Destaques Práticos - **[00:00] Como estruturar ferramentas com contrato explícito**: Descubra por que nunca passar objetos soltos para o agente e como estruturar a função de execução. - **[00:31] As quatro fases do ciclo de vida de um agente**: Entenda o que acontece por baixo dos panos a cada volta do loop de execução no Mastra. ## Conceitos e Tecnologias Abordados - **Tópicos:** Criação de ferramentas tipadas, Ciclo de vida do agente, Validação com schemas, Controle de tokens e iterações, Processadores de entrada e saída - **Ferramentas e Entidades:** Mastra, TypeScript, Zod ## Documentação e Referências Oficiais - [Documentação oficial sobre uso e criação de tools no Mastra](https://mastra.ai/docs/agents/using-tools) - [Guia detalhado do ciclo de vida de execução de agentes](https://mastra.ai/docs/guides/agent-lifecycle) - [Guia de guardrails e processamento de entrada e saída](https://mastra.ai/docs/agents/guardrails) ## Perguntas Frequentes (FAQ) ### O que é ensinado na Aula 4 (Tools tipadas com createTool e o ciclo de vida do agente) 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 criar ferramentas com contratos explícitos de entrada e saída; A assinatura correta da função de execução no Mastra v1; As quatro fases do ciclo de vida de um agente: Preparação, Iteração, Passo do Modelo e Finalização; Como processadores de entrada e saída gerenciam memória e reduzem o consumo de tokens. ### Como assistir ao vídeo completo da aula "Tools tipadas com createTool e o ciclo de vida do agente" 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 "Tools tipadas com createTool e o ciclo de vida do agente"? A aula cobre diretamente os seguintes tópicos técnicos aplicados em produção: Criação de ferramentas tipadas, Ciclo de vida do agente, Validação com schemas, Controle de tokens e iterações, Processadores de entrada e saída. ### 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%2Ftools-tipadas-com-createtool-e-o-ciclo-de-vida-do-agente 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 3: Criando o primeiro agente com Mastra Studio, Model Router e Zod](https://www.escoladeaplicativos.com.br/cursos/mastra-sem-misterio/criando-o-primeiro-agente-com-mastra-studio-model-router-e-zod) - **Próxima aula:** [Aula 5: Engenharia de contexto e RequestContext no Mastra](https://www.escoladeaplicativos.com.br/cursos/mastra-sem-misterio/engenharia-de-contexto-e-requestcontext-no-mastra)