TAU-HOME.COM
LOADING

AG-UI: AI 에이전트를 웹·앱 프론트엔드와 실시간 연동하는 오픈 인터랙션 프로토콜

AI 에이전트를 사용자 인터페이스와 연결하는 오픈 이벤트 기반 프로토콜 AG-UI의 아키텍처, 16종 표준 이벤트 규격, 전송 계층 유연성 및 프레임워크 지원 현황을 살펴봅니다.

tau · 2026년 11월 16일

#AG-UI #AI-Agents #Frontend #CopilotKit #LangGraph

AG-UI: AI 에이전트를 웹·앱 프론트엔드와 실시간 연동하는 오픈 인터랙션 프로토콜

인공지능 에이전트 기술이 백엔드 오케스트레이션을 넘어 실제 사용자 애플리케이션으로 확장되면서, 에이전트의 내부 실행 흐름과 프론트엔드 화면을 유기적으로 이어주는 통신 규격이 주목받고 있습니다. 오픈소스 프로젝트 AG-UI(Agent-User Interaction Protocol)는 에이전트 백엔드와 사용자 화면 사이의 실시간 상호작용을 약 16종의 표준 이벤트로 추상화한 경량 오픈 프로토콜입니다.

AI 에이전트 프로토콜 스택(MCP, A2A, AG-UI)의 상호작용 및 역할 분담 아키텍처 다이어그램

이미지 출처: ag-ui-protocol / GitHub

2025년 5월 처음 공개된 이 프로젝트는 CopilotKit, LangChain, CrewAI 등 주요 에이전트 생태계의 실무 협업 경험을 바탕으로 발전해 왔습니다. 2026년 11월 13일 배포된 최신 릴리스에 이르기까지 마이크로소프트, 구글, 아마존웹서비스(AWS) 등 다양한 클라우드 에이전트 프레임워크 연동을 꾸준히 넓혀가고 있습니다.

에이전트 생태계 3대 축: MCP, A2A, 그리고 프론트엔드를 맡는 AG-UI

AI 에이전트 생태계가 정교해지면서 통신 프로토콜 역시 역할별로 세분화되는 추세입니다. 시스템 수준에서 에이전트가 외부 도구나 데이터베이스에 접근할 때는 모델 컨텍스트 프로토콜(MCP, Model Context Protocol)이 주로 쓰이고, 에이전트가 다른 자율 에이전트와 작업을 위임하며 통신할 때는 A2A(Agent-to-Agent) 규격이 담당합니다.

반면 AG-UI는 이 둘과 상호 보완적인 위치에서 '최종 사용자와 에이전트 사이의 접점'을 전담합니다. 에이전트가 내부적으로 어떤 추론 단계를 거치고 어떤 도구를 호출하는지 실시간으로 화면에 중계하고, 사용자의 선택이나 피드백을 다시 에이전트 실행 컨텍스트에 즉각 전달하는 프론트엔드 인터랙션 계층입니다.

  • MCP (Model Context Protocol): 에이전트에 데이터와 실행 도구 연결
  • A2A (Agent-to-Agent): 분산된 자율 에이전트 상호 간의 통신 및 협업
  • AG-UI (Agent-User Interaction): 에이전트와 최종 사용자 인터페이스(UI) 간의 실시간 상태 동기화

이 3단계 레이어 구조 안에서 AG-UI는 백엔드 에이전트 모델의 내부 구현 방식과 프론트엔드 UI 렌더링 프레임워크 사이의 강한 결합을 느슨하게 풀어주는 표준 접착제 역할을 수행합니다.

16종 표준 이벤트와 전송 계층을 아우르는 유연한 미들웨어 구조

AG-UI 아키텍처의 중심에는 약 16종의 표준 이벤트 타입 규격이 자리 잡고 있습니다. 에이전트 백엔드가 연산이나 외부 호출을 수행할 때 해당 이벤트 규격에 호환되는 이벤트를 발행(emit)하고, 간단한 표준 입력 인자만을 받아들이도록 설계되어 복잡한 커스텀 프로토콜 작성 부담을 덜어줍니다.

프로토콜의 기술적 차별점은 네트워크 전송 계층(Transport Layer)에 구애받지 않는다는 점입니다.

  • 다양한 전송 수단 지원: 단방향 실시간 스트리밍에 적합한 서버 전송 이벤트(SSE, Server-Sent Events)부터 양방향 저지연 통신을 위한 웹소켓(WebSocket), 비동기 이벤트 전달용 웹훅(Webhook)까지 폭넓게 수용합니다.
  • 느슨한 이벤트 포맷 매칭: 프로토콜 미들웨어 계층이 느슨한 포맷 매칭을 허용하여, 서로 다른 버전의 에이전트 백엔드와 프론트엔드 클라이언트가 연동될 때 발생할 수 있는 스키마 불일치 문제를 유연하게 완화합니다.
  • 참조 구현체 제공: 빠른 서비스 구축을 위해 기본 HTTP 참조 구현체와 기본 커넥터(Default Connector)를 저장소 차원에서 함께 배포합니다.

이를 통해 개발자는 스트리밍 방식의 실시간 채팅뿐 아니라, 에이전트의 내부 상태와 화면 폼(Form)이 함께 갱신되는 양방향 상태 동기화(Bi-directional state synchronization), 도구 실행 결과에 따라 컴포넌트가 동적으로 생성되는 생성형 UI(Generative UI), 인간 개입 루프(Human-in-the-loop) 등의 복잡한 상호작용 패턴을 표준화된 방식으로 조립할 수 있습니다.

프레임워크 지원 현황 및 프로젝트 시작 경로

AG-UI는 다수의 주요 에이전트 프레임워크 및 언어별 SDK와의 연동을 지원하고 있습니다. 공식 문서와 저장소에 명시된 생태계 지원 범위는 다음과 같습니다.

  • 파트너십 및 지원 프레임워크: LangChain(LangGraph), CrewAI와의 초기 파트너십을 시작으로 Microsoft Agent Framework, Google ADK, Google Antigravity, AWS Strands Agents, Mastra, Pydantic AI, Agno, LlamaIndex, AG2(구 AutoGen) 등을 지원합니다. 커뮤니티 차원에서는 Claude Agent SDK, Claude Managed Agents SDK, Langroid, Omnara, Cloudflare Agents 연동이 제공됩니다.
  • 다국어 SDK 생태계: 파이썬과 자바스크립트 외에도 Kotlin 등 다양한 언어 환경용 SDK를 순차적으로 구축하고 있습니다.
  • 진행 중인 연동(In Progress): OpenAI Agents SDK 및 AWS Bedrock Agents 등 일부 프레임워크 연동은 현재 개발 및 통합이 진행 중인 상태입니다.

신규 프로젝트를 시작하려는 개발자는 노드 패키지 실행 명령어로 손쉽게 보일러플레이트 앱을 생성할 수 있습니다.

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

프로젝트는 MIT 라이선스 하에 오픈소스로 공개되어 상업적·비상업적 용도로 자유롭게 활용할 수 있습니다. 다만 CopilotKit 파트너십을 주축으로 성장한 프로젝트 특성상, 일부 고급 UI 컴포넌트나 클라이언트 인터페이스를 고도화할 때는 연계 라이브러리 및 종속성 문서를 함께 검토하는 작업이 필요합니다.

출처

Impact-Site-Verification: 9b3ebd10-6c45-44cf-a014-5b8c19b7b285