Intensivo Grátis 21–22/11Intensivo gratuito de 2 dias em Vibecoding (21–22/11 às 16:00 MSK) · Turma 3 começa 23/11Inscrever-se grátis →Turma 3 (23/11)
IndústriaCódigo / SDK · Pronto p/ usoGitHub Trending AI→ original

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
AG-UI 1.0 dá aos agentes de IA uma linguagem única para falar com o aplicativo: 31 tipos de eventos
Fonte: GitHub Trending AI. Colagem: Hamidun News.
Ouvir artigo
Ficha técnica e números-chave
ParâmetroDados
Fonte originalGitHub Trending AI ↗
Editor-chefe
A versão 1.0 está congeladaagentes 0.x funcionam com clientes 1.0 e vice-versa
Dado-chave #2Os SDKs para TypeScript, Python e .NET são gerados a partir do JSON Schema
Dado-chave #3Entre os apoiadores declarados estão Google, Microsoft, Amazon e Oracle

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.

História

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.

ZK
Zhemal Khamidun — CPO da Alpina Digital, gerente de produto do AlpinaGPT. Cria produtos de IA desde 2019. O Hamidun News é um projeto pessoal que virou um agregador em produção com mais de 6.000 leitores.
✦ Unified AI Workspace · Nomad

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.

Try Nomad AI →Launch Nomad Agent
O que você acha?
Carregando comentários…