# Agente, tool ou workflow: arquitetura e modelo mental no Mastra

> **Resposta Direta:** A Aula 2 de 17 ("Agente, tool ou workflow: arquitetura e modelo mental no Mastra"), 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 aluno aprende a organizar a arquitetura de aplicações com inteligência artificial para evitar respostas imprevisíveis. Veja como o Mastra separa raciocínio dinâmico, ferramentas determinísticas e workflows em uma instância unificada. Você também confere a configuração correta do TypeScript e a troca simplificada de modelos de IA.

## 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 2 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/agente-tool-ou-workflow-arquitetura-e-modelo-mental-no-mastra

## O que você vai aprender

- Por que separar regras de negócio e fluxos críticos de prompts abertos
- As responsabilidades de um agente, de uma tool e de um workflow determinístico
- Como funciona a instância central do Mastra e o Mastra Studio
- Como trocar de provedor de LLM usando o roteador integrado
- A configuração indispensável de TypeScript para módulos modernos

## Pontos-chave da Aula

- Prompts não devem orquestrar regras financeiras ou passos críticos sozinhos.
- Agentes cuidam de interpretação aberta; workflows controlam passos determinísticos.
- A instância Mastra centraliza telemetria, rotas de servidor e persistência.
- A troca de provedores de modelo é feita via string simples (ex.: openai/gpt-4o).
- O TypeScript precisa de módulo moderno e resolução por empacotador para rodar o Mastra sem erros.

## Capítulos e Tópicos da Videoaula

- **[00:00] O risco de colocar regras de negócio em prompts soltos** — Entenda por que delegar fluxos críticos e regras financeiras diretamente a um único prompt aberto leva a falhas no sistema.
- **[00:27] A divisão de papéis: agente, ferramenta e workflow** — Descubra como o Mastra separa raciocínio aberto, funções atômicas e fluxos determinísticos dentro de uma instância central.
- **[01:00] Roteamento simples de modelos de IA** — Veja como alternar entre provedores como OpenAI e Anthropic usando apenas uma string sem reescrever seu código.
- **[01:31] Configuração moderna do TypeScript para o Mastra** — Aprenda a configurar o compilador TypeScript com módulos modernos para garantir a compatibilidade dos pacotes do framework.

## Destaques Práticos

- **[00:00] Agente, ferramenta ou workflow? O papel de cada peça**: Pare de quebrar seus apps colocando regras de negócio em prompts gigantes e aprenda o papel de cada componente.
- **[01:00] Troca rápida de LLMs e setup essencial do TypeScript**: Descubra como trocar de modelo de IA com uma linha e evite o erro mais comum ao iniciar com Mastra.

## Conceitos e Tecnologias Abordados

- **Tópicos:** Arquitetura de agentes de IA, Diferença entre tools e workflows, Instância central do Mastra, Roteador de provedores de LLM, Configuração do TypeScript moderno, Mastra Studio
- **Ferramentas e Entidades:** Mastra, TypeScript, OpenAI, Anthropic, Mastra Studio

## Documentação e Referências Oficiais

- [Documentação oficial do Mastra](https://mastra.ai/docs)
- [Guia de instalação e requisitos do Mastra](https://mastra.ai/docs/getting-started/installation)
- [Visão geral sobre agentes no Mastra](https://mastra.ai/docs/agents/overview)
- [Visão geral sobre workflows no Mastra](https://mastra.ai/docs/workflows/overview)

## Perguntas Frequentes (FAQ)

### O que é ensinado na Aula 2 (Agente, tool ou workflow: arquitetura e modelo mental no Mastra) 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: Por que separar regras de negócio e fluxos críticos de prompts abertos; As responsabilidades de um agente, de uma tool e de um workflow determinístico; Como funciona a instância central do Mastra e o Mastra Studio; Como trocar de provedor de LLM usando o roteador integrado.

### Como assistir ao vídeo completo da aula "Agente, tool ou workflow: arquitetura e modelo mental no Mastra" 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 "Agente, tool ou workflow: arquitetura e modelo mental no Mastra"?

A aula cobre diretamente os seguintes tópicos técnicos aplicados em produção: Arquitetura de agentes de IA, Diferença entre tools e workflows, Instância central do Mastra, Roteador de provedores de LLM, Configuração do TypeScript moderno, Mastra Studio.

### 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%2Fagente-tool-ou-workflow-arquitetura-e-modelo-mental-no-mastra 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 1: Introdução: de prompts soltos a agentes de IA em produção](https://www.escoladeaplicativos.com.br/cursos/mastra-sem-misterio/introducao-de-prompts-soltos-a-agentes-de-ia-em-producao)
- **Próxima aula:** [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)
