O Google anunciou no dia 24 de maio uma camada de middleware para o Genkit, seu framework open-source para apps de IA e agentes. A novidade adiciona pontos de intercepcao programaveis em torno de chamadas de modelo, execucao de ferramentas e loops de geracao. Para times que ja rodam Genkit em producao, e a peca que faltava para colocar retries, fallback, aprovacao humana e logging sem reescrever a logica da aplicacao.

O que muda na arquitetura do Genkit

O Genkit, na pratica, e um framework para integrar IA em apps web e mobile existentes. Toda chamada generate() ja roda em loop: o modelo gera, executa tools, processa o resultado e itera ate concluir. O que faltava era um lugar limpo para injetar comportamentos transversais — retry, log, autorizacao, fallback.

O middleware preenche esse buraco. Os hooks atuam em tres niveis: na geracao como um todo, em cada chamada de modelo, e em cada execucao de tool. O modelo mental e parecido com middleware de framework web — uma cadeia onde cada camada decide se passa adiante, retorna cedo, ou modifica a chamada.

Os componentes prontos que ja vem na caixa

O Google publicou um conjunto inicial de middlewares pre-construidos:

• Retry com exponential backoff — para lidar com erros transitorios de provedor de modelo.
• Fallback automatico — quando a API do modelo principal falha, a chamada cai para um alternativo definido.
• Approval gates — para chamadas sensiveis de tool, exigem aprovacao explicita antes de executar.
• Filesystem access control — limita o que tools podem ler ou escrever no disco.
• Sistema de “skills” — injeta dinamicamente instrucoes a partir de arquivos locais no contexto do agente.

Os componentes sao composaveis: da para empilhar retries, filtros, aprovacoes e logging em ordem definida de execucao.

Genkit vs ADK: onde cada um se encaixa

A pergunta inevitavel — qual e a diferenca entre Genkit e o Agent Development Kit (ADK) do Google — apareceu logo no anuncio. Michael Doyle, engenheiro de software no Google, respondeu no X: se voce ja tem um app (web, mobile) e quer adicionar funcionalidades agenticas, use Genkit. Se voce esta construindo um sistema multi-agente standalone, complexo, rodando em infraestrutura dedicada como a Agent Platform do GCP, use ADK.

E uma divisao deliberada de territorio. Genkit e a porta de entrada de IA na camada de aplicacao. ADK e a fundacao para sistemas agenticos heavy-orquestrados.

Linguagens suportadas e ferramentas

O Genkit suporta TypeScript, Go e Dart. Python esta no roadmap, mas o Google nao detalhou data. A integracao com a Genkit Developer UI permite inspecionar comportamento do middleware, tracear fluxo de execucao e debugar interacoes em runtime — util quando uma cadeia de middleware esta interferindo em algo que voce nao esperava.

O contexto: runtime guards estao virando padrao

O movimento se encaixa em uma tendencia mais ampla no tooling de IA. Em vez de confiar so em prompt e fine-tuning, frameworks estao adicionando camadas programaveis que governam o comportamento do modelo durante a execucao. Approval gates, fallback de modelo e injecao de skills sao primitivas que cada vez mais aparecem como necessidade de producao, nao como add-on de quem ja sofreu na pratica.

O que vale testar primeiro

O middleware ja esta disponivel no release mais recente do Genkit. Para quem ja tem um app com Genkit, vale comecar plugando o middleware de retry e o de logging — sao os de menor risco e maior retorno. Depois, em fluxo onde tool executa acao com efeito colateral, experimentar o approval gate antes de soltar agente sem revisao em producao.

Reportado originalmente por Google Developers Blog em 2026-05-24.