AG-UI 1.0 dá aos agentes de IA uma linguagem única para falar com o aplicativo: 31 tipos de eventos
Cada framework de agentes avisa o aplicativo à sua maneira que o agente está digitando, chamou uma ferramenta ou espera a confirmação de uma pessoa. O protocolo AG-UI 1.0 substitui essa camada caseira por um fluxo comum de eventos, como "começou a digitar" ou "chamou uma ferramenta". São 31 tipos, agrupados em oito famílias. Com isso, um mesmo agente funciona na web, no aplicativo móvel ou no Slack sem reescrever a interface.
Processado por IA de GitHub Trending AI; editado por Hamidun News
Imagine que você está integrando um agente de IA ao chat dentro do seu produto. O agente digita a resposta palavra por palavra, no meio dela chama uma ferramenta, por exemplo uma busca em banco de dados, e depois espera o usuário clicar em "Confirmar". Cada framework de agentes informa tudo isso ao aplicativo em seu próprio formato, e quem cuida do frontend precisa escrever uma camada de integração separada para cada backend.
O protocolo AG-UI (Agent-User Interaction Protocol, "protocolo de interação entre agente e usuário") elimina essa camada. Na versão 1.0, ele descreve 31 tipos de eventos: "o agente começou a digitar", "chamou uma ferramenta", "atualizou o estado" e assim por diante.
Qualquer interface (UI) sabe exibir esses eventos.
Como funciona
Entre o agente e o aplicativo corre um único fluxo bidirecional de eventos. O aplicativo inicia uma "execução" (run) e envia ao agente uma única mensagem: o histórico da conversa, a lista de ferramentas que o frontend sabe executar, o estado compartilhado e o contexto. Em resposta, o agente devolve um stream de eventos tipados. Para o cliente, não importa em que o agente foi escrito: basta entender os eventos.
Uma analogia do dia a dia são as legendas de um filme. O filme pode ter sido gravado com qualquer câmera, mas, se o formato das legendas é padronizado, qualquer player consegue exibi-las. Aqui, o papel do player cabe ao aplicativo web, ao cliente móvel, ao terminal ou ao Slack.
Esses 31 tipos de eventos estão divididos em oito famílias: ciclo de vida da execução, mensagens de texto, chamadas de ferramentas, estado, raciocínio, atividade, subagentes e eventos arbitrários. Apenas a primeira família é obrigatória. Um agente mínimo envia um par de eventos, e o restante é adicionado conforme o produto cresce.
Por esses eventos passam coisas que normalmente precisam ser feitas à mão:
- mensagens em streaming, com cancelamento e retomada;
- um repositório de estado compartilhado, lido e escrito tanto pelo agente quanto pelo aplicativo, sincronizado por snapshots e deltas em JSON Patch;
- ferramentas que o agente chama, mas que são executadas no aplicativo, com o resultado voltando ao agente;
- confirmação humana: o usuário aprova, edita ou rejeita a ação, e a execução seguinte continua a partir desse ponto;
- exibição do raciocínio, inclusive de raciocínios criptografados;
- delegação aninhada, em que cada evento é marcado com a execução do subagente que o gerou;
- imagens, áudio, vídeo e documentos na entrada do usuário e nos resultados das ferramentas.
O que o "1.0" significa para o desenvolvedor
O número 1.0 significa estabilidade. A especificação está congelada e descrita em JSON Schema, e os SDKs para TypeScript, Python e .NET são gerados diretamente a partir dela. Isso reduz o risco de cliente e servidor divergirem nos detalhes. A compatibilidade retroativa também é declarada nas duas direções: agentes da versão 0.x funcionam com clientes 1.0, e vice-versa. Quem já começou a integração não precisará reescrever nada.
O protocolo não está preso a um transporte: a especificação descreve um binding HTTP, e uma camada intermediária (middleware) pode injetar eventos de qualquer outra fonte. Todo agente AG-UI é um endpoint HTTP que recebe uma requisição e devolve eventos em stream. O repositório traz um exemplo de servidor e cliente com cerca de 30 linhas. Ele não exige chaves de API: o servidor é instalado com pip install ag-ui-protocol fastapi uvicorn, e o cliente com npm install @ag-ui/client tsx (requer Node.js 20+). Se você trocar o servidor por outro, não é preciso mexer no cliente.
Para começar rápido, há uma CLI: npx create-ag-ui-app@latest gera um frontend em Next.js ou um cliente de terminal para o framework de agentes escolhido. Os templates usam a OpenAI, portanto é preciso ter uma chave antes de executá-los.
Lugar entre outros protocolos e ressalvas
O AG-UI se posiciona como o terceiro elemento do conjunto de protocolos abertos para agentes. O MCP fornece ferramentas e contexto ao agente, o A2A permite que agentes conversem entre si, e o AG-UI conecta o agente ao usuário. Um mesmo agente pode usar os três ao mesmo tempo, e o AG-UI pode ficar na frente de agentes que falam MCP ou A2A. À parte ficam formatos como MCP Apps e Open-JSON-UI: eles descrevem qual interface o agente quer mostrar. Nesse esquema, o AG-UI é o canal pelo qual essas descrições e todo o resto chegam ao aplicativo.
Os autores afirmam que o protocolo foi adotado por Google, Microsoft, Amazon e Oracle e que está integrado à maioria dos frameworks de agentes. Entre as integrações citadas estão OpenAI Agents, watsonx, Spring AI e clientes para React, Angular, Vue e React Native. Esses dados vêm da descrição do próprio projeto, e o material não traz verificação independente da escala de adoção. Vale olhar as demos concretas no Dojo e checar até que ponto o framework de que você precisa é suportado sem gambiarras caseiras.
Conclusão prática: se você desenvolve um produto com várias interfaces ou quer trocar de framework de agentes sem reescrever o frontend, o AG-UI merece um teste em um protótipo pequeno. Ele dispensa o protocolo caseiro entre o agente e a UI, que normalmente acaba sendo mantido pela própria equipe.
- 21 de nov. de 2026OpenAI revisou os prompts para o GPT-6.2: menos perguntas, menos testes
- 21 de nov. de 2026CoreWeave deve US$ 47 bilhões por chips da Nvidia e perde US$ 709 milhões no trimestre
- 21 de nov. de 2026Apple prepara um agente de IA e dificulta o acesso de terceiros: a permissão agora tem 14 etapas, e não 4
- 21 de nov. de 2026Desenvolvedor dispensou o Pinecone: busca em 72 450 trechos de código em 50 ms
Perguntas frequentes sobre a notícia
Como funciona?
Entre o agente e o aplicativo corre um único fluxo bidirecional de eventos. O aplicativo inicia uma "execução" (run) e envia ao agente uma única mensagem: o histórico da conversa, a lista de ferramentas que o frontend sabe executar, o estado compartilhado e o contexto. Em resposta, o agente devolve um stream de eventos tipados. Para o cliente, não importa em que o agente foi escrito: basta entender os eventos. Uma analogia do dia a dia são as legendas de um filme.
O que o "1.0" significa para o desenvolvedor?
O número 1.0 significa estabilidade. A especificação está congelada e descrita em JSON Schema, e os SDKs para TypeScript, Python e .NET são gerados diretamente a partir dela. Isso reduz o risco de cliente e servidor divergirem nos detalhes. A compatibilidade retroativa também é declarada nas duas direções: agentes da versão 0.x funcionam com clientes 1.0, e vice-versa. Quem já começou a integração não precisará reescrever nada.
O que se sabe sobre Lugar entre outros protocolos e ressalvas?
O AG-UI se posiciona como o terceiro elemento do conjunto de protocolos abertos para agentes. O MCP fornece ferramentas e contexto ao agente, o A2A permite que agentes conversem entre si, e o AG-UI conecta o agente ao usuário. Um mesmo agente pode usar os três ao mesmo tempo, e o AG-UI pode ficar na frente de agentes que falam MCP ou A2A. À parte ficam formatos como MCP Apps e Open-JSON-UI: eles descrevem qual interface o agente quer mostrar.
Test Frontier LLMs & Autonomous Agents in One Workspace
Run Claude Opus 5.5, GPT-6, Gemini 3.1, and DeepSeek side-by-side in Nomad AI (nomadnet.ai) — unified model routing, deep research, and multimodal workflows under one subscription.
O essencial da IA — uma vez por semana
Sete histórias que realmente importaram, escolhidas a dedo. Sem ruído nem releases.
Pronto! Verifique seu e-mail para a confirmação.