Neste artigo
O Google anunciou esta semana o preview da nova API de Agentes para o Genkit, seu framework open-source focado em aplicações de IA full-stack. Esta atualização introduz funcionalidades avançadas como detached turns e controle human-in-the-loop, expandindo o suporte oficial para as linguagens TypeScript e Go.
A nova interface chat() centraliza o histórico de mensagens, fluxos de ferramentas, streaming e persistência de estado. O objetivo é permitir que desenvolvedores criem fluxos complexos de agentes sem a necessidade de alternar entre diferentes primitivas do framework, mantendo a consistência tanto em ambientes locais quanto em endpoints HTTP.
Arquitetura e Gerenciamento de Estado
O Genkit estabelece uma distinção clara entre dados de estado e artefatos, algo que facilita a manutenção de aplicações complexas. O estado personalizado lida com a lógica de fluxo, enquanto artefatos representam saídas que usuários podem verificar ou versionar, como relatórios ou patches de código.
A persistência pode ser gerenciada pelo servidor ou pelo cliente. Em ambientes com restrições rigorosas de residência de dados, o gerenciamento pelo cliente é ideal, embora traga um aumento na carga de rede. Para implementações em produção, o suporte nativo ao Firestore garante escalabilidade e gerenciamento de sessões simplificado.
Recursos de Detached Turns
Os detached turns permitem que um cliente inicie uma tarefa e desconecte, enquanto o agente continua processando no servidor. É possível realizar o polling dos resultados posteriormente, eliminando a dependência de WebSockets ou filas de trabalho externas para tarefas de longa duração, como pesquisas complexas.
const chat = reportAgent.chat({ sessionId: 'report-123' });
const task = await chat.detach('Write the quarterly market report.');
for await (const snapshot of task.poll({ intervalMs: 1000 })) {
renderStatus(snapshot.status);
if (snapshot.status === 'completed') renderMessages(snapshot.state.messages);
}Interrupções com Human-in-the-Loop
O controle human-in-the-loop é garantido por meio de ferramentas interrompíveis com proteção contra falsificação. Quando uma ferramenta exige confirmação, o agente pausa a execução, aguarda a aprovação do usuário e valida o payload de retomada contra o histórico da sessão antes de prosseguir.
Impacto no Ecossistema de Desenvolvimento
A abordagem do Genkit se destaca no competitivo mercado de frameworks de IA, como como usar IA no dia a dia da programação. Ao oferecer uma estrutura full-stack, o Google facilita a integração de agentes em aplicações web utilizando SDKs tipados para TypeScript e Go.
Para a comunidade de desenvolvedores brasileiros, a adoção destas ferramentas pode acelerar a criação de fluxos de orquestração de agentes. Aprender a estruturar essas aplicações é fundamental para quem deseja atuar na área, conforme discutido em iniciando a carreira de programação começando no backend.
Perguntas Frequentes
O que são detached turns no Genkit?
São execuções de agentes que continuam rodando no servidor após o cliente desconectar, permitindo tarefas longas que podem ser monitoradas via polling.
Como o Genkit lida com o controle humano?
O framework usa ferramentas interrompíveis que pausam o fluxo até que uma aprovação explícita seja validada, garantindo segurança contra inputs maliciosos.
O Genkit suporta outros modelos de linguagem?
Sim, o framework é agnóstico ao modelo, com plugins oficiais para Gemini, Vertex AI, Anthropic e OpenAI, além de suporte a implementações locais como Ollama.