Módulo 1: Fundamentos do MastraAula 4 de 172 minResumo aberto · Vídeo com cadastro grátis

Tools tipadas com createTool e o ciclo de vida do agente

Por Mauro Mequelussi · Curso gratuito Mastra sem mistério: agentes e workflows em TypeScript · Português (PT-BR)

Resposta direta · O que esta aula resolve

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.

Aula gratuita · Cadastro rápido

Crie sua conta grátis para assistir a esta videoaula em HD

O resumo técnico e os capítulos abaixo são abertos para consulta. Crie sua conta 100% gratuita em segundos para liberar todas as 17 videoaulas em HD, controle automático de progresso, Tutor IA e certificado gratuito verificável.

  • R$ 0 · Sem cartão de crédito
  • Tutor IA tira-dúvidas da aula
  • Certificado gratuito incluso

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 roteiro técnico da aula

4 capítulos minutados
  1. 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.

  2. 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.

  3. 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.

  4. 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.

Momentos de destaque na prática

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.

Notas de aula e guia de estudo

Conectar ferramentas externas é o passo definitivo para transformar um modelo de linguagem em um agente prático que não inventa dados. Nesta aula, você verá como definir contratos rígidos para ferramentas no Mastra usando schemas de entrada e saída, além de compreender o ciclo de vida completo de cada chamada. Esse entendimento garante que sua aplicação consulte dados reais com segurança e previsibilidade orçamentária.

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

  • 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.

Conceitos e ferramentas abordados nesta aula

Criação de ferramentas tipadasCiclo de vida do agenteValidação com schemasControle de tokens e iteraçõesProcessadores de entrada e saídaMastraTypeScriptZod

Perguntas frequentes sobre esta aula

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.