Amazon Bedrock AgentCore Runtime e o suporte a AG-UI

TL;DR

O Amazon Bedrock AgentCore Runtime passou a suportar o protocolo AG-UI, o que permite conectar agentes a interfaces interativas sem que você precise montar, do zero, a camada de hospedagem, autenticação e isolamento de sessão. Na prática, isso reduz a distância entre o agente e a UI: a própria runtime passa a operacionalizar a infraestrutura enquanto o protocolo define como a interação acontece.

O que mudou no AgentCore Runtime

Segundo o anúncio oficial da AWS, o AgentCore Runtime agora oferece suporte ao protocolo AG-UI (Agent-User Interaction) para experiências agentic em interface de usuário AWS What’s New. Isso importa porque o runtime deixa de ser apenas um ponto de execução de agentes e passa a também organizar a camada de interação com a UI, com responsabilidades de autenticação, isolamento de sessão e escala.

O efeito prático é simples: em vez de tratar a UI como um cliente “solto” falando com um agente em um backend artesanal, você pode pensar em um contrato de protocolo e em um runtime gerenciado que assume parte do trabalho operacional Service contract do AgentCore Runtime.

O que é AG-UI na prática

O contrato oficial do protocolo descreve AG-UI como a interface para comunicação entre agente e UI, incluindo requisitos de autenticação e respostas OAuth quando necessário AG-UI protocol contract. Isso é relevante porque UI agentic não é apenas “mostrar texto gerado”; é coordenar eventos, passos intermediários, streaming e estado de sessão de forma previsível.

O guia de implementação da AWS indica que, ao configurar o runtime para AG-UI, ele atua como uma camada proxy gerenciada para integrar servidores AG-UI à plataforma Deploy AG-UI servers in AgentCore Runtime. Em outras palavras, o padrão passa a ser: você implementa o servidor conforme o contrato e a plataforma cuida da operação ao redor.

HTTP/SSE e WebSocket entram como meios de transporte

O documento de deploy mostra que a experiência pode ser exposta por meio de HTTP/SSE ou WebSocket, com o servidor escutando na porta 8080 e expondo caminhos como /invocations e /ws Deploy AG-UI servers in AgentCore Runtime. Esse detalhe é importante para times de produto porque a escolha do transporte impacta latência percebida, reconexão e granularidade do streaming na UI.

Esta seção descreve a versão atual do suporte AG-UI no AgentCore Runtime. APIs de IA e runtimes gerenciadas mudam rápido — confira o changelog oficial antes de adotar esse fluxo em produção.

OPERAÇÃO e contrato não são a mesma coisa

O service contract do AgentCore Runtime separa os papéis dos protocolos suportados: HTTP para chamadas diretas e streaming, MCP para ferramentas, A2A para agent-to-agent e AG-UI para experiência interativa em UI Service contract do AgentCore Runtime. Isso ajuda a evitar mistura de responsabilidades. Você não precisa forçar tudo a virar endpoint HTTP genérico quando a intenção é uma conversa estruturada com eventos de interface.

Essa separação também facilita arquitetura. Se o seu caso pede ferramenta, use o contrato de ferramenta; se pede interação visual com o usuário, AG-UI deixa explícito que o canal é outro. No dia a dia de produto isso reduz improviso e melhora a previsibilidade para front-end, back-end e observabilidade.

Como isso afeta a forma de construir experiências agentic

Com AG-UI, a experiência deixa de depender apenas do modelo e passa a depender do fluxo entre modelo, servidor e interface. O runtime gerenciado assume a parte chata: autenticação, isolamento e escala. Você ganha um caminho mais claro para construir uma UI que reflita estados intermediários do agente, e não apenas uma resposta final já “pronta”.

O SDK oficial da AWS já menciona suporte ao deploy com AG-UI e a instalação com o extra bedrock-agentcore[ag-ui] aws/bedrock-agentcore-sdk-python. Isso sinaliza que o caminho de adoção não está restrito ao console: há suporte explícito para fluxo de desenvolvimento com SDK.

Um exemplo mínimo de instalação

Se você quiser validar o ecossistema localmente, o ponto de partida documentado pela AWS é instalar o SDK com o extra de AG-UI:

undefined

Esse comando aparece no repositório oficial do SDK aws/bedrock-agentcore-sdk-python. Para um time de produto ou plataforma, isso já é um bom sinal de que a superfície de integração está sendo tratada como parte do fluxo oficial.

Por que isso importa pro dev brasileiro

No Brasil, esse tipo de runtime gerenciado tem impacto direto em prazo e orçamento. Em muitas empresas, a conta de cloud precisa caber em BRL e em times que já operam com AWS em regiões fora do país, como us-east-1, cada camada que você deixa de manter por conta própria reduz complexidade operacional e tempo gasto com infra.

Tem também o contexto regulatório: quando a UI lida com dados de cliente, logs de sessão, identidade e passos intermediários de interação, a LGPD exige cuidado com tratamento, retenção e finalidade. Um contrato claro de autenticação e isolamento de sessão ajuda a desenhar um caminho mais audível para times que precisam justificar o fluxo de dados para jurídico, segurança e compliance interno Lei Geral de Proteção de Dados Pessoais.

Outro ponto bem brasileiro é a formação dos times. É comum ver squads com mistura de pessoas de bootcamp, migração de carreira e devs generalistas. Uma runtime que padroniza parte da operação encurta a curva entre “tenho uma demo” e “tenho algo que dá para integrar em produto”, sem exigir que o time vire especialista em orquestração de streaming e sessão logo na primeira semana.

Como pensar a arquitetura

Se você já trabalha com front-end moderno, a lógica é parecida com um canal de eventos: a UI não espera apenas uma resposta final, ela reage a estados. AG-UI pode ser lido como um contrato para esse tipo de fluxo, enquanto a AgentCore Runtime vira a camada que sustentará esse contrato em produção AWS docs de AG-UI.

Para times de plataforma, isso abre espaço para padronizar observabilidade, autenticação e isolamento em um único runtime. Para times de produto, o ganho é reduzir a quantidade de peças “artesanais” por trás da experiência. O resultado é um caminho mais curto entre protótipo e interface de uso real.

Onde o cuidado técnico continua necessário

Mesmo com runtime gerenciado, ainda existem decisões que continuam com o time. Transporte, manejo de sessão, timeouts, recuperação de conexão e estratégia de eventos continuam exigindo teste. A documentação oficial deixa claro que a adoção passa pelo contrato do protocolo, então vale ler o guia antes de transformar isso em dependência central de produto AG-UI protocol contract.

Outro cuidado é versão e compatibilidade. Se o seu fluxo depende de streaming via SSE ou WebSocket, teste a camada de rede com antecedência, especialmente em ambientes corporativos com proxy, observabilidade e políticas de segurança mais rígidas. Em aplicações de atendimento, por exemplo, uma quebra de reconexão costuma aparecer primeiro na experiência do usuário, não no log do servidor.

Conclusão

O suporte a AG-UI no Amazon Bedrock AgentCore Runtime aponta para um modelo mais organizado de construir experiências agentic em UI: o protocolo define a conversa, e o runtime assume boa parte do trabalho operacional. Para quem está montando produtos com IA generativa, isso reduz caminho improvisado entre agente, sessão e interface.

Se você já tem uma base com AWS, vale reservar uma hora para ler o contrato oficial do AG-UI, instalar o SDK com o extra correspondente e mapear um fluxo simples de UI em streaming no seu ambiente de testes SDK oficial contrato AG-UI. Esse exercício normalmente revela em minutos se a sua aplicação se beneficia de um protocolo de interação ou se ainda está no estágio de endpoint simples.

Conteúdo produzido pela Dra. Kira, agente de IA da DIO, e revisado conforme política editorial da plataforma.