Repolode
ag-ui-protocol

ag-ui-protocol/ag-ui

Um protocolo aberto baseado em eventos que padroniza a conexão entre agentes de IA e aplicações frontend voltadas aos usuários.

Estrelas
16,716
Forks
1,728
Issues abertas
495
Último commit
há 9 horas

O que é?

AG-UI, abreviação de Agent-User Interaction Protocol, define um formato leve de eventos emitidos pelos backends de agentes de IA durante a execução. Assim, as aplicações frontend podem exibir as respostas dos agentes e interagir com elas de forma consistente. Os agentes aceitam um pequeno conjunto de entradas compatíveis com AG-UI, e o protocolo é independente do transporte, podendo funcionar por SSE, WebSockets, webhooks ou outros canais.

O projeto se posiciona ao lado do MCP, que fornece ferramentas aos agentes, e do A2A, que permite que agentes se comuniquem entre si: o AG-UI cuida da conexão entre agentes e a interface do usuário. Ele oferece suporte a chat com streaming em tempo real, sincronização bidirecional de estado, UI generativa, chamadas de ferramentas do frontend e interações com participação humana. O projeto inclui uma implementação HTTP de referência e um conector padrão.

O repositório lista integrações com vários frameworks de agentes, incluindo LangChain, CrewAI, Google ADK, Pydantic AI, LlamaIndex e Mastra, além de SDKs de cliente em várias linguagens e um pacote principal em TypeScript. Uma CLI, npx create-ag-ui-app, cria a estrutura inicial de uma nova aplicação.

Recursos principais

  • 01Transmite as respostas dos agentes aos frontends em tempo real por meio de tipos de evento padronizados
  • 02Sincroniza o estado de forma bidirecional entre os agentes e a interface do usuário
  • 03Oferece suporte a UI generativa e mensagens estruturadas
  • 04Permite que os agentes chamem ferramentas do frontend e solicitem a participação de uma pessoa
  • 05Funciona com qualquer transporte, como SSE ou WebSockets

Casos de uso

  • Adicionar uma interface de chat com respostas em streaming a um backend de agente existente
  • Permitir que um agente leia e atualize o estado da aplicação exibido em uma interface web ou mobile
  • Criar fluxos de aprovação com participação humana, nos quais os usuários confirmam as ações dos agentes
  • Conectar agentes desenvolvidos com LangChain, CrewAI ou Pydantic AI a um protocolo frontend compartilhado

Início rápido

  1. 1

    Crie um novo aplicativo AG-UI com o script create

    npx create-ag-ui-app my-agent-app

Antes de usar

  • O protocolo ainda está evoluindo, e algumas integrações com frameworks estão marcadas como em andamento.
  • Para usá-lo bem, geralmente é preciso conectá-lo a um backend de agente, então ele não é uma ferramenta independente.

Tópicos

Perguntas frequentes

O que é ag-ui?
Um protocolo aberto baseado em eventos que padroniza a conexão entre agentes de IA e aplicações frontend voltadas aos usuários. AG-UI, abreviação de Agent-User Interaction Protocol, define um formato leve de eventos emitidos pelos backends de agentes de IA durante a execução. Assim, as aplicações frontend podem exibir as respostas dos agentes e interagir com elas de forma consistente. Os agentes aceitam um pequeno conjunto de entradas compatíveis com AG-UI, e o protocolo é independente do transporte, podendo funcionar por SSE, WebSockets, webhooks ou outros canais.
ag-ui é gratuito? Qual é a licença?
ag-ui é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
ag-ui ainda é mantido?
Manutenção ativa. O último commit de ag-ui foi em 20 de out. de 2026.
Para que posso usar ag-ui?
Adicionar uma interface de chat com respostas em streaming a um backend de agente existente Permitir que um agente leia e atualize o estado da aplicação exibido em uma interface web ou mobile Criar fluxos de aprovação com participação humana, nos quais os usuários confirmam as ações dos agentes Conectar agentes desenvolvidos com LangChain, CrewAI ou Pydantic AI a um protocolo frontend compartilhado
Como instalar ag-ui?
Crie um novo aplicativo AG-UI com o script create: npx create-ag-ui-app my-agent-app
Onde consigo ag-ui?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/ag-ui-protocol/ag-ui

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados