SDK TypeScript para criar aplicativos agent-native com UI generativa, estado compartilhado e fluxos com human-in-the-loop em React, Angular, Vue e apps de chat.
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
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
Toolkit de Generative UI independente de framework, baseado no OpenUI Lang, uma linguagem compacta de streaming que permite a LLMs gerar interfaces renderizáveis usando sua própria biblioteca de componentes.
Plataforma de colegas de trabalho com IA auto-hospedada, na qual cada agente tem seu próprio navegador, arquivos e ferramentas, e toda ação é controlada por políticas e registrada.
Uma interface de chat open source em que as respostas da IA podem ser interativas, com explicações, comparações, gráficos e ferramentas funcionais criadas com CopilotKit e AG-UI.
Framework TypeScript para criar agentes de IA com memória, ferramentas, MCP, RAG, voz e workflows, além do console VoltOps para observabilidade.
Framework TypeScript para criar servidores MCP, MCP Apps com visualizações em React e clientes, com Inspector e CLI integrados.