AG-UI
CopilotKit · Programação
O AG-UI é um protocolo aberto e baseado em eventos da CopilotKit que conecta agentes de IA a apps frontend e transmite estado e ações do usuário em tempo real.
Sobre AG-UI
What Is AG-UI
O AG-UI é um protocolo, não um app que você instala. O nome completo é Agent User Interaction Protocol (protocolo de interação agente-usuário), e ele define uma linguagem comum que fica entre um agente backend e a interface usada por uma pessoa. Os dois lados trocam mensagens, estado e chamadas de ferramentas sem código de cola para cada combinação.
O problema que ele resolve é fácil de descrever. Agentes trabalham por muito tempo, decidem sozinhos e misturam texto, voz e chamadas de ferramentas numa mesma sessão. Endpoints clássicos de REST ou GraphQL partem do princípio de que entra um pedido e sai uma resposta organizada. Agentes interativos como Cursor ou Devin já trabalham ao lado de uma pessoa em tempo real, e esse estilo quebra o modelo antigo.
O limite principal está no escopo. O AG-UI cobre só a conexão entre agente e interface. Ele não diz nada sobre como os agentes chegam às ferramentas nem como conversam entre si, então você o combina com outras peças da pilha.
Getting Started
- Leia a documentação oficial em ag-ui.com e escolha um framework compatível, como LangChain, CrewAI ou uma conexão direta com um modelo.
- Registre o endpoint do seu agente como HttpAgent no runtime do frontend, para que o cliente saiba onde enviar a entrada e escutar eventos.
- Adicione as peças de UI que você precisa, como chat com streaming, estado compartilhado ou uma etapa de aprovação. Use as implementações de referência como ponto de partida.
- Rode as demos do AG-UI Dojo para ver cada recurso num app real e depois leve esses mesmos eventos para o seu produto.
Informações do produto
Uma visão rápida dos preços, das plataformas compatíveis e do desempenho de AG-UI.
Ideal para
Os usuários, tarefas e cenários em que esta ferramenta se encaixa melhor.
Usuários
- Desenvolvedores frontend
- Equipes full-stack e de plataforma
- Product managers técnicos
Tarefas
- Transmitir respostas do agente para um app web
- Sincronizar o estado entre agente e interface
- Adicionar aprovação humana
Cenários
- Um assistente de suporte que redige respostas
- Um companheiro de programação dentro de uma IDE ou ferramenta web
- Um agente de pesquisa ou de dados com várias etapas
Principais recursos
Streaming de eventos em tempo real
O AG-UI mantém um canal aberto entre o agente e a interface, então tokens, chamadas de ferramentas e status chegam conforme acontecem. As execuções aceitam cancelar e retomar, algo que importa quando um pedido dura minutos e não segundos. A conexão vai sobre HTTP e WebSockets padrão, então encaixa na pilha web que você já usa.
Estado compartilhado
O protocolo define um armazenamento tipado que tanto o agente quanto o app podem ler e atualizar. As mudanças voltam como diffs com tratamento de conflitos, então a interface reflete o trabalho do agente sem recarregamentos completos. Os modos de somente leitura e de leitura-escrita deixam você decidir quanto controle cada lado tem.
UI generativa
Os agentes devolvem componentes que o app renderiza, de widgets tipados estáveis a uma pequena árvore declarativa que o frontend valida antes de montar. Assim um agente molda o que o usuário vê, como um formulário ou um gráfico, em vez de só mandar texto. O app mantém sempre o controle final sobre o que aparece.
Controle humano no fluxo (human in the loop)
Você pode interromper uma execução para pausar, aprovar, editar, tentar de novo ou escalar uma etapa. O estado sobrevive à pausa, então o agente continua de onde parou quando a pessoa responde. É essa peça que torna os agentes úteis para qualquer coisa com consequências reais.
Integrações agnósticas de framework
O AG-UI nasceu do trabalho da CopilotKit com LangChain e CrewAI, e traz integrações para esses frameworks mais um caminho direto ao modelo. Qualquer backend que emita o fluxo de eventos certo pode se conectar, rode ele em Python, em JavaScript ou em outra linguagem. Ao lado do MCP e do A2A, o AG-UI é um dos protocolos agenticos que hoje definem como os sistemas de agentes se encaixam, e deixa você escrever a lógica de UI uma vez e apontá-la para agentes diferentes.
Prós e contras
Prós
- Abre uma única conexão padrão, então um frontend conversa com vários backends de agentes sem fiação sob medida.
- Foi pensado para a realidade dos agentes: execuções longas, trabalho em streaming e saída mista de texto e ferramentas.
- Oferece blocos claros para estado compartilhado, UI generativa e revisão humana, todos usáveis de forma separada.
- A documentação e as demos ao vivo do AG-UI Dojo tornam o modelo de eventos concreto rápido.
- Roda sobre HTTP e WebSockets, então encaixa na infraestrutura web que você já tem.
Contras
- Cobre só a camada agente-interface, então você ainda precisa de MCP ou A2A para ferramentas e trabalho entre agentes.
- Parte de um público de desenvolvedores; não há um caminho sem código para quem não programa.
- Adotá-lo implica aprender os tipos de eventos e os formatos de mensagem antes de publicar o primeiro recurso.
- Está muito ligado ao conjunto de ferramentas da CopilotKit, então equipes de fora encontram menos peças prontas.
Perguntas frequentes
O AG-UI padroniza como os agentes de IA se conectam a aplicações voltadas ao usuário. Ele transporta respostas em streaming, estado compartilhado, chamadas de ferramentas e etapas de aprovação entre um agente backend e um app frontend, para que os desenvolvedores não construam a própria fiação em cada framework.
Conteúdo relacionado
Explore ferramentas, skills e artigos relacionados a AG-UI.
Alternativas a AG-UI
Forefront
Forefront · ProgramaçãoO Forefront é uma plataforma web para construir com IA de código aberto. Você ajusta os principais modelos de linguagem de código aberto com seus próprios dados, avalia o desempenho deles e os roda por uma API ou os exporta para hospedar por conta própria. Desenvolvedores que querem a conveniência de uma plataforma fechada, mas fazem questão de ser donos dos modelos e dos dados, são o público-alvo aqui.
Startkit
StartKit.AI · ProgramaçãoStartkit é um boilerplate para criar produtos de SaaS com IA e wrappers de IA. Pense nele como um boilerplate para startups de IA com as partes chatas já conectadas: autenticação, pagamentos com Stripe e Lemon Squeezy, limites de uso, e-mail transacional e um kit inicial de API de IA que conversa com OpenAI, Anthropic, Groq ou Llama. Você clona o repositório, define seu preço e começa pela parte do produto que as pessoas realmente pagam. Ele é feito em Next.js sobre React e Tailwind, então boa parte do código boilerplate já parece familiar.
Testim
Tricentis · ProgramaçãoO Testim é uma plataforma de automação de testes com IA para criar e executar testes de ponta a ponta em aplicações web, mobile e Salesforce. Ele se apoia no aprendizado de máquina para manter os testes estáveis quando uma interface muda, então as equipes gastam menos tempo consertando seletores quebrados. Nada mal para uma ferramenta de testes automatizados que você pode começar a usar hoje. Você cria testes gravando ações no navegador e depois adiciona JavaScript quando precisa de mais controle. É uma escolha sólida para equipes de QA ocupadas.