← Voltar pro acervo
Decoded · 15 mai 2026 · ep.8 / agent layer

Genkit Middleware
Kit PT-BR · pattern web de 30 anos absorvido

A Google anunciou em maio/2026 Genkit Middleware — composable hooks que interceptam generation calls + tool execution loop. O nome diz tudo: middleware, o mesmo conceito do Express, Rack, Connect, há 30 anos no mundo web. Agora com 3 níveis de granularidade pra refletir o loop agentic: Generate, Model, Tool. Este kit cobre o conceito, código em TS + Go + Dart, os 5 middlewares oficiais prontos, padrão de composição, anti-patterns e glossário.

Decifrado a partir de developers.googleblog.com/announcing-genkit-middleware · 15.05.2026.

Arquivos · 7 docs

O que tem aqui dentro

comece pelo README
◆
README.md
Índice + 3 trilhas de leitura
O mapa do kit. 3 trilhas conforme seu ponto de partida — nunca usou middleware em agente, conhece Express e quer ver paralelo agentic, ou quer implementar essa semana em produção.
→
01
01-genkit-middleware-explicado.md
O que é + por que importa
Contexto histórico (Connect, Express, Rack, WSGI), 3 diferenças na camada agentic, por que importa pra quem opera agente em produção, onde encaixa na série Agent Layer (Ep.06 → 07 → 08).
→
02
02-os-3-hooks-decifrados.md
Generate, Model, Tool em detalhe
Cada hook: quando dispara, pra que usar, quando NÃO usar, exemplo conceitual em código, decisão "qual nível pro meu caso", erros comuns por nível, composição entre níveis.
→
03
03-codigo-completo-content-filter.md
Custom middleware · TS + Go + Dart
ContentFilter completo em 3 linguagens, workaround Python via decorator, padrão de composição left-to-right, stack padrão recomendada pra produção, validação obrigatória com test unitário.
→
04
04-5-middlewares-prontos.md
Retry · Fallback · Approval · Skills · FS
Os 5 middlewares oficiais que cobrem 80% dos casos de produção. Cada um com config, hook usado, exemplo, quando NÃO usar. Tabela cruzada problema → middleware. Stack padrão de produção.
→
05
05-anti-patterns-middleware.md
7 anti-patterns + fix de cada
Retry no hook errado, ContentFilter no Generate, Approval cobrindo read-only, Skills injetando demais, Filesystem sem denylist, ordem errada, logging em todos os 3 níveis. Sintoma + causa + fix de uma linha.
→
06
06-glossario.md
Glossário PT-BR · 30+ termos
Allowed roots, backoff exponencial, composable hooks, custom middleware, fallback, filesystem middleware, hardening, hook, HITL, intercept, loop agentic, middleware, next, outermost/innermost, retry, skills, tool-loop, WithUse, WrapModel — e mais 14 termos relacionados.
→