AG-UI는 AI 에이전트를 웹·모바일·슬랙 화면에 하나의 이벤트 스트림으로 연결하는 오픈 프로토콜입니다 | DAKER 커뮤니티

AG-UI(Agent-User Interaction Protocol)는 AI 에이전트와 사용자가 보는 앱 화면 사이의 통신 방식을 하나로 맞춘 오픈 프로토콜입니다. 에이전트가 타입이 정해진 이벤트를 흘려보내면 웹, 모바일, 터미널, 슬랙 같은 어떤 클라이언트든 같은 방식으로 받아 그립니다. 2026년 11월 17일 GitHub 트렌딩(Daily) 1위에 올랐고, 같은 날 11:41 KST에 확인한 스타 수는 19,153개, 트렌딩 페이지 기준 하루 새 스타는 791개입니다.

노트북, 스마트폰, 태블릿에 같은 대화 화면이 떠 있는 책상 사진과 AG-UI 공식 워드마크

무엇인가

AG-UI 저장소 README는 이 프로젝트를 AI 에이전트가 사용자용 애플리케이션에 연결되는 방식을 표준화하는 가볍고 이벤트 기반인 개방형 프로토콜이라고 소개합니다. 앱은 대화 내용, 프런트엔드가 제공하는 도구, 공유 상태, 맥락을 담은 RunAgentInput 하나를 보내고, 에이전트는 타입이 있는 이벤트 스트림으로 답합니다.

AG-UI 1.0 명세는 이벤트를 8개 계열, 31개 타입으로 정의합니다. 실행 시작·종료, 텍스트 메시지, 도구 호출, 상태(스냅숏과 JSON Patch 변경분), 추론, 진행 활동, 서브에이전트, 사용자 정의 이벤트가 그 계열입니다. 이 중 필수는 실행 수명 주기 이벤트뿐이라, 최소한의 에이전트는 몇 가지 이벤트만 내보내고 필요할 때 늘려 가면 됩니다. 전송 방식은 HTTP+SSE와 바이너리 HTTP+Protobuf 바인딩을 명세에 담았습니다.

왜 지금 뜨나

README가 꼽는 가장 큰 변화는 AG-UI 1.0 출시입니다. 명세가 JSON Schema로 고정됐고, TypeScript·Python·.NET SDK가 그 스키마에서 생성됩니다. 0.x 에이전트와 1.0 클라이언트가 양방향으로 호환된다는 점도 함께 밝혔습니다.

에이전트는 요청-응답 모델에 맞지 않습니다. 토큰을 흘려보내고, 답하는 도중 도구를 부르고, 상태를 바꾸고, 사람 확인을 기다리고, 서브에이전트를 띄웁니다.

README는 이런 동작을 프레임워크마다 따로 연결하던 일을 양방향 이벤트 스트림 하나로 바꾸는 것이 AG-UI의 목적이라고 설명합니다. 역할 구분도 분명합니다. MCP는 에이전트에 도구와 맥락을, A2A는 에이전트끼리의 협업을, AG-UI는 에이전트와 사용자 사이를 맡는 세 프로토콜 구조입니다. README에 따르면 Google, Microsoft, Amazon, Oracle이 채택했고 LangChain, CrewAI, Mastra, Google ADK, Microsoft Agent Framework, Pydantic AI, Claude Agent SDK 등과 연동되며, 각 연동은 AG-UI Dojo에서 데모로 볼 수 있습니다.

어떻게 써 보나

새 앱을 바로 만들고 싶다면 README의 빠른 시작처럼 CLI로 프런트엔드(CopilotKit 기반 Next.js 또는 터미널 클라이언트)와 원하는 에이전트 프레임워크를 연결한 템플릿을 만들 수 있습니다. 생성된 템플릿은 OpenAI를 호출하므로 실행 전에 OPENAI_API_KEY 환경 변수를 설정해야 합니다.

npx create-ag-ui-app@latest

프로토콜을 직접 다뤄 보고 싶다면 README의 30줄 예제가 좋습니다. Python 3.9 이상에서 FastAPI 서버가 RUN_STARTED, TEXT_MESSAGE_START·CONTENT·END, RUN_FINISHED 이벤트를 차례로 스트리밍하고, Node.js 20 이상의 TypeScript 클라이언트가 HttpAgent로 받아 출력합니다. 이 예제는 API 키 없이 돌아갑니다.

먼저 에이전트 서버(Python)를 띄웁니다.

pip install ag-ui-protocol fastapi uvicorn
uvicorn server:app --port 8000

새 터미널의 새 폴더에서 클라이언트(TypeScript)를 실행합니다.

npm init -y && npm pkg set type=module
npm install @ag-ui/client tsx
npx tsx client.ts

README에 따르면 서버를 지원되는 다른 프레임워크로 바꿔도 클라이언트 코드는 그대로입니다.

어디에 쓰면 좋나

AG-UI가 웹·모바일·슬랙·터미널 앱과 LangChain·CrewAI·Mastra·Google ADK 등 에이전트를 잇는 구조를 보여 주는 AG-UI 저장소 공식 개요 도식

여러분은 에이전트를 화면에 붙일 때 스트리밍과 도구 호출 표시를 어떻게 처리하고 계신가요? AG-UI 같은 표준 프로토콜을 쓸지, 직접 만든 연결을 유지할지 댓글로 의견을 들려주세요.

출처