O que é AG-UI?
O AG-UI (Agent-User Interaction protocol) define como o backend de um agente conversa com o app que uma pessoa está usando. O app envia um único RunAgentInput (mensagens, as ferramentas que o front end oferece, estado compartilhado e contexto) para um endpoint HTTP, e o agente devolve em streaming eventos tipados: 31, em oito famílias que cobrem o ciclo de vida da execução, texto, chamadas de ferramentas, snapshots de estado e deltas JSON Patch, raciocínio, progresso, subagentes e dados personalizados. Os transportes são HTTP com Server-Sent Events ou um vínculo binário Protobuf.
Ele fica ao lado dos outros dois protocolos de agentes, em vez de competir com eles. O MCP liga um agente a ferramentas e dados, o A2A liga agentes entre si e o AG-UI liga um agente a um usuário; um agente muitas vezes fala os três, e o middleware do AG-UI pode ficar na frente de agentes MCP e A2A. Especificações de UI generativa como o A2UI do Google e o MCP Apps descrevem o que desenhar, e o AG-UI transporta esse conteúdo.
A versão 1.0 saiu em 17 de setembro de 2026 com uma especificação normativa e um JSON Schema, a partir do qual são gerados os SDKs oficiais de TypeScript, Python e .NET; os SDKs de Kotlin, Go, Java, Dart, Rust, Ruby, C++ e Swift vêm da comunidade. A CopilotKit criou o protocolo e o mantém de forma aberta sob MIT.
AG-UI vale a pena?
O AG-UI resolve a parte do trabalho com agentes que toda equipe reconstrói mal: levar texto em streaming, chamadas de ferramentas, estado compartilhado e pedidos de aprovação de um agente no backend até um navegador sem inventar um formato de eventos próprio para cada framework. Os números de adoção mostram que ele praticamente venceu essa disputa. O @ag-ui/core teve cerca de 7,6 milhões de downloads no npm na semana até 19 de novembro de 2026, e o pacote Python ag-ui-protocol cerca de 2,3 milhões; o repositório tem cerca de 20.800 estrelas no GitHub.
O motivo é o suporte dos frameworks. Microsoft Agent Framework, Google ADK, AWS Strands, Mastra, Pydantic AI, Agno, LlamaIndex e AG2 o trazem embutido; LangChain e CrewAI aparecem como parceiros; as integrações de Claude Agent SDK e OpenAI Agents ficam no repositório; e o Amazon Bedrock AgentCore documenta o AG-UI para o seu runtime. Trocar o framework de agentes por trás de um front end CopilotKit ou de terminal vira uma mudança de configuração, não uma reescrita.
A versão 1.0, de 17 de setembro de 2026, tirou o comportamento do cliente TypeScript e o levou para uma especificação escrita com regras MUST e SHOULD. As execuções agora informam um resultado (sucesso, interrupção ou cancelamento), o que transforma a aprovação humana em uma pausa e retomada limpas; os eventos THINKING viraram eventos REASONING com ida e volta criptografadas; e os resultados de ferramentas podem trazer imagens e documentos. Versões antigas e novas interoperam nos dois sentidos, então um agente 0.x continua funcionando com um cliente 1.0 e vice-versa.
O porém: o protocolo não tem autenticação nem autorização próprias. O guia de segurança do AG-UI da Microsoft diz isso diretamente, desaconselha expor um servidor AG-UI ao JavaScript do navegador ou a apps móveis e aponta a lista de mensagens e o estado como os principais caminhos de injeção de prompt, porque um cliente pode enviar as mensagens de sistema, ferramentas ou estado que quiser. IDs de thread não são credenciais. Na prática, você coloca na frente um backend confiável que monta as mensagens do protocolo e só repassa o texto do usuário. O ritmo de lançamentos também é rápido, com versões marcadas a cada poucos dias em novembro, e há 318 issues abertas.
Nossa opinião: se o seu agente precisa de uma interface de usuário de verdade, o AG-UI é a escolha sensata por padrão, como o MCP é para ferramentas; reserve um dia para o encanamento de segurança que a especificação deixa de propósito para você.
Onde ele se destaca
Uma engenheira de front end em uma empresa SaaS que está adicionando um assistente ao app
Mostrar respostas em streaming, o progresso das ferramentas e uma etapa de aprovar ou rejeitar ações arriscadas
Rode `npx create-ag-ui-app@latest`, escolha o framework do backend e a CopilotKit em Next.js e ligue os resultados de interrupção a um diálogo de confirmação. O protocolo é gratuito; o custo são as chamadas ao modelo e a hospedagem do agente.
Uma equipe de plataforma em um banco que roda agentes em dois frameworks
Manter um único front end de chat enquanto o backend passa de LangGraph para Microsoft Agent Framework
Os dois emitem eventos AG-UI, então o cliente continua igual. Coloque na frente um serviço backend-for-frontend que autentique os usuários, monte ele mesmo o RunAgentInput e repasse só o texto do usuário, como recomenda o guia de segurança da Microsoft.
Um desenvolvedor criando um bot interno de Slack sobre um agente que já existe
Reaproveitar o agente web no Slack e no Teams sem uma segunda integração
O SDK de canais da CopilotKit consome o mesmo fluxo AG-UI que o cliente web, então o código do agente não muda; só muda, em cada canal, a forma de exibir chamadas de ferramentas e estado.
Antes de decidir
- Configuração
- npm install @ag-ui/client ou pip install ag-ui-protocol; um agente mínimo em Python e um cliente em TypeScript têm cerca de 30 linhas cada, ou `npx create-ag-ui-app@latest` cria um app CopilotKit ligado a um framework (os modelos chamam a OpenAI).
- Integrações
- Microsoft Agent Framework, Google ADK, AWS Strands, Mastra, Pydantic AI, Agno, LlamaIndex, AG2, LangChain, CrewAI, Claude Agent SDK, OpenAI Agents, Spring AI e outros; clientes para React, Angular, Vue, React Native, Slack, Teams e terminais; middleware para MCP e A2A.
- Dados e privacidade
- Um protocolo, não um serviço: os eventos circulam só entre o seu app e o seu agente. Nenhuma autenticação é definida, então os endpoints precisam da sua própria autenticação e de um backend confiável na frente; licença MIT.
- Custo em escala
- Sem licença nem taxa de uso; o custo é a hospedagem do agente, os tokens do modelo e as conexões de streaming longas no seu balanceador de carga.
- Limites
- O SDK de Python precisa de 3.9+ e o cliente TypeScript de Node.js 20+; a 1.0 descarta eventos desconhecidos com um aviso e trata como fatais eventos conhecidos malformados, então versões de SDK incompatíveis aparecem como erros em tempo de execução.
O que é bom
- Embutido na maioria dos grandes frameworks de agentes, incluindo os da Microsoft, do Google e da AWS
- Especificação 1.0 congelada e JSON Schema com SDKs gerados para TypeScript, Python e .NET
- Resultados de interrupção transformam a aprovação humana em pausa e retomada limpas
- Estado compartilhado com deltas JSON Patch mantém app e agente sincronizados
- Demos ao vivo de cada integração no Dojo
O que não é
- Sem autenticação embutida; os endpoints não devem ficar expostos diretamente a navegadores
- Mensagens e estado são caminhos abertos de injeção de prompt a partir de um cliente não confiável
- SDKs de Kotlin, Go, Rust e outros são mantidos pela comunidade e não gerados a partir do esquema
- Ritmo de lançamentos rápido e 318 issues abertas
Ideal para
Equipes que colocam um agente feito com LangGraph, ADK, Mastra, CrewAI ou similares por trás de uma interface web, móvel ou de chat e querem um único formato de eventos para todos.
Alternativas ao AG-UI
AG-UI: perguntas frequentes
- AG-UI vale a pena?
- O AG-UI virou o formato padrão de comunicação entre backends de agentes e front ends, e a especificação 1.0 torna seguro construir sobre ele, desde que você forneça a autenticação que ele deixa de fora. Damos nota 4.3 de 5.
- Quanto custa AG-UI?
- Gratuito e de código aberto sob a licença MIT: protocolo, SDKs, integrações e o app de demonstração Dojo. Você paga a hospedagem do seu agente e as chamadas ao modelo.
- Quais são as desvantagens de AG-UI?
- Sem autenticação embutida; os endpoints não devem ficar expostos diretamente a navegadores; mensagens e estado são caminhos abertos de injeção de prompt a partir de um cliente não confiável; sDKs de Kotlin, Go, Rust e outros são mantidos pela comunidade e não gerados a partir do esquema; ritmo de lançamentos rápido e 318 issues abertas.
- Para quem AG-UI é indicado?
- Equipes que colocam um agente feito com LangGraph, ADK, Mastra, CrewAI ou similares por trás de uma interface web, móvel ou de chat e querem um único formato de eventos para todos.
- Quanto custa AG-UI para uma equipe ou em produção?
- Sem licença nem taxa de uso; o custo é a hospedagem do agente, os tokens do modelo e as conexões de streaming longas no seu balanceador de carga.
- AG-UI é seguro para dados da empresa?
- Um protocolo, não um serviço: os eventos circulam só entre o seu app e o seu agente. Nenhuma autenticação é definida, então os endpoints precisam da sua própria autenticação e de um backend confiável na frente; licença MIT.
- Quais são as melhores alternativas ao AG-UI?
- As alternativas mais próximas que analisamos são MCP Python SDK, Mastra, LangGraph e Google Agent Development Kit (ADK).
Respostas verificadas em 20 de nov. de 2026.