LangGraph: grafos de agentes em código

O que você vai aprender

1. Aula 1. Nós, arestas e estado: o fluxo visual vira um grafo em código

   45 min

   O que muda quando você sai do construtor e escreve o fluxo em LangGraph: estado tipado com redutores, nós como funções puras, arestas fixas, START e END, compilação e execução, em Python e em JavaScript.

   • Mapear cada bloco do construtor visual para o conceito equivalente em LangGraph (estado, nó, aresta).
   • Declarar um estado tipado em Python (TypedDict) e em JavaScript (StateSchema com zod), com um campo de lista que usa redutor.
   • Escrever nós como funções que recebem o estado e devolvem só o que mudou.
   • Montar, compilar e executar um grafo sequencial com START e END.

   Aula completa, exemplos e exercícios dentro da plataforma

2. Aula 2. Condições e ciclos: arestas condicionais, laços e o limite de recursão

   45 min

   Como o grafo escolhe o caminho com add_conditional_edges, como um nó pode voltar para trás formando um ciclo controlado, como proteger o ciclo com contador e recursion_limit, e como usar Command e Send para rotear e espalhar trabalho.

   • Escrever uma função de roteamento e ligá-la com add_conditional_edges, com e sem mapa de destinos.
   • Montar um ciclo (gerar, avaliar, gerar de novo) e limitá-lo com um contador no estado e com recursion_limit.
   • Usar Command para atualizar o estado e escolher o próximo nó dentro do próprio nó.
   • Reconhecer quando Send resolve um problema de espalhar trabalho (map-reduce) e quando um ciclo basta.

   Aula completa, exemplos e exercícios dentro da plataforma

3. Aula 3. Aprovação humana com interrupt: pausar o grafo e retomar com a decisão

   45 min

   Como o bloco de aprovação humana do construtor se escreve em LangGraph: interrupt dentro do nó, checkpointer obrigatório, thread_id por conversa, leitura do pedido pendente em __interrupt__ e retomada com Command(resume=...), em Python e JavaScript.

   • Explicar por que interrupt exige um checkpointer e um thread_id para funcionar.
   • Pausar um grafo com interrupt dentro de um nó e ler o pedido pendente no resultado do invoke.
   • Retomar a execução com Command(resume=...) e tratar os três desfechos (aprovar, editar, recusar) no grafo.
   • Escrever nós compatíveis com o reinício do nó na retomada, sem efeitos duplicados.

   Aula completa, exemplos e exercícios dentro da plataforma

4. Aula 4. Checkpoints, persistência e orquestração: o grafo que sobrevive, volta no tempo e se organiza

   50 min

   Checkpointers duráveis (SQLite e Postgres), threads e histórico de estados, retomar de um checkpoint antigo e criar uma bifurcação, políticas de retentativa e cache por nó, modos de streaming e os padrões de orquestração que combinam tudo.

   • Escolher o checkpointer certo para cada ambiente (memória, SQLite, Postgres) e explicar o que cada um guarda.
   • Inspecionar o histórico de checkpoints de um thread e retomar a execução a partir de um checkpoint anterior, com ou sem alterar o estado.
   • Configurar RetryPolicy e CachePolicy por nó e explicar quando cada uma vale a pena.
   • Mapear os padrões de orquestração (encadeamento, roteamento, paralelização, orquestrador-trabalhadores, avaliador-otimizador, agente) para os recursos do LangGraph.

   Aula completa, exemplos e exercícios dentro da plataforma

Termos que você vai dominar

• StateGraph
• Estado (state schema)
• Redutor (reducer)
• Nó (node)
• Aresta (edge)
• Compilar (compile)
• Aresta condicional (conditional edge)
• Função de roteamento
• Ciclo
• recursion_limit
• Command
• Send
• interrupt
• Checkpointer
• thread_id
• __interrupt__
• Command(resume=...)
• Reinício do nó
• Checkpoint
• Thread
• Viagem no tempo (time travel)
• RetryPolicy
• CachePolicy
• Modo de streaming