AG-UI: AI 에이전트와 웹 화면을 이어 주는 이벤트 프로토콜

AG-UI(Agent-User Interaction Protocol)는 AI 에이전트 백엔드와 사용자가 보는 웹·앱 화면 사이에 오가는 메시지를 표준 이벤트로 정해 둔 오픈 프로토콜이에요. 에이전트를 LangChain으로 만들든 Google ADK나 Claude Agent SDK로 만들든, 같은 이벤트 형식만 지키면 같은 프론트엔드에 붙일 수 있게 하는 것이 목표예요. 라이선스는 MIT이고, 오늘 GitHub 일간 트렌딩 2위였어요.

무엇을 해 주나요

README가 설명하는 동작 방식은 단순해요. 에이전트 백엔드는 AG-UI가 정한 약 16가지 표준 이벤트 중 하나에 맞는 이벤트를 내보내고, 몇 가지 간단한 AG-UI 형식의 입력을 받아요. 프론트엔드는 이 이벤트만 해석하면 돼요. 중간에 미들웨어 층이 있어서 이벤트 형식이 조금 달라도 맞춰 줄 수 있다고 해요.

  • 실시간 채팅 스트리밍: 에이전트가 답을 만드는 동안 글자와 도구 호출을 이벤트로 흘려보내요.
  • 양방향 상태 동기화: 에이전트가 가진 상태와 화면의 상태를 서로 맞춰요. 예를 들어 에이전트가 표의 값을 바꾸면 화면에도 반영되는 식이에요.
  • 생성형 UI와 구조화 메시지: 텍스트 대신 화면 구성 요소를 보내 그리게 해요. MCP Apps 같은 생성형 UI 규격과도 연동돼요.
  • 프론트엔드 도구: 브라우저 쪽 기능을 에이전트가 부를 수 있는 도구로 등록해요.
  • 사람 개입(human-in-the-loop): 실행 중간에 사용자 승인이나 입력을 받아 이어 가요.
  • 전송 방식 무관: SSE, WebSocket, 웹훅 어느 것이든 쓸 수 있고, 기준이 되는 HTTP 구현과 기본 연결기가 들어 있어요.

설치와 사용

README는 새 앱을 만드는 명령 하나를 안내해요.

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

저장소에 .node-version 파일이 있어 Node.js 기반이지만, 필요한 정확한 버전은 확인되지 않았어요. README에 기본 사용 코드 예시는 없고, ‘Dojo’ 예제들이 50~200줄 정도라고만 소개해요.

연동 대상은 넓어요. README 표 기준으로 LangChain, CrewAI와는 파트너 연동이고, Microsoft Agent Framework, Google ADK, AWS Strands Agents, Mastra, Pydantic AI, Agno, LlamaIndex, AG2는 1차 지원이에요. Claude Agent SDK, Cloudflare Agents 등은 커뮤니티 연동이고, A2A 프로토콜과 Amazon Bedrock AgentCore도 목록에 있어요. SDK는 TypeScript 외에 Kotlin, Go, Dart, Java, Rust, Ruby, C++, .NET이 있고, 클라이언트 쪽으로는 CopilotKit, React Native, Slack·Teams 같은 채팅 플랫폼이 적혀 있어요.

누구에게 쓸모 있나요

에이전트 기능을 제품 화면에 넣으려는 프론트엔드 개발자, 그리고 백엔드 프레임워크를 바꿀 가능성이 있는 팀에 맞아요. 화면 코드는 AG-UI 이벤트에만 맞춰 두면, 백엔드를 LangGraph에서 다른 프레임워크로 바꿔도 프론트엔드를 덜 고칠 수 있어요.

쓰기 전에 알아 둘 점

  • 아직 진행 중인 연동: AWS Bedrock Agents, OpenAI Agents SDK는 작업 중이고, Nim, Flowise, Langflow SDK도 진행 중이라고 적혀 있어요.
  • 호환성이 자주 바뀌어요. 최근 사흘 동안 나온 릴리스 세 건에 모두 호환성을 깨는 변경이 들어 있었어요. 11월 13일 릴리스부터 @ag-ui/client 관련 피어 의존성이 1.0.0 이상이어야 하고, 11월 12일 릴리스의 ag-ui-claude-sdk 0.2.4는 텍스트·도구 호출 이벤트에 threadId, runId를 더 이상 싣지 않아요. 11월 10일 @ag-ui/a2ui-middleware 0.0.15에서는 UI 동작이 서명된 모델 기록에서 사용자 입력으로 나타나도록 바뀌었어요. 패키지 버전을 고정하고 변경 기록을 확인하며 올리는 편이 안전해요.
  • 성능 수치, 한계, 텔레메트리에 관한 설명은 README에 없어요.

저장소 상태

  • 별 18.2k, 포크 1.9k (GitHub 표시값)
  • 열린 이슈 315개, 풀 리퀘스트 279개 — 참여가 활발한 만큼 쌓인 것도 많아요.
  • 언어: TypeScript (트렌딩 페이지의 주 언어 표시)
  • 라이선스: MIT
  • 마지막 커밋: 2026년 11월 15일 (Go SDK의 이벤트 디코딩, 토큰 사용량 기록 등을 고친 병합 4건)
  • 최신 릴리스: release/2026-11-13 (11월 13일). 패키지별로 날짜 이름의 릴리스를 자주 내요.
  • 최상위 폴더: spec, sdks, integrations, middlewares, apps, docs, skills 등. README가 말하는 규격·SDK·연동·미들웨어 구성이 실제로 나뉘어 있어요.

확인 범위

  • GitHub 웹 페이지로 확인(API 미사용). 확인한 날짜: 2026년 11월 16일.
  • 읽은 페이지: 저장소 첫 화면과 README, 릴리스 페이지, 커밋 페이지 (이슈 수는 첫 화면 표시값)
  • 읽지 못했거나 하지 않은 것: 코드와 spec 문서 분석, 이벤트 16종의 개별 정의, 설치·실행

출처: ag-ui-protocol/ag-ui, 릴리스, 커밋 기록

Similar Posts