AG-UI
CopilotKit · 코딩
AG-UI는 CopilotKit이 공개한 이벤트 기반 프로토콜이자 에이전트용 프로토콜이다. AI 에이전트 프런트엔드를 연결해 상태와 사용자 동작을 실시간으로 양방향 전송한다.
AG-UI 소개
What Is AG-UI
AG-UI는 프로토콜이지 설치하는 앱이 아니다. 정식 이름은 Agent User Interaction Protocol(에이전트와 사용자 상호작용 프로토콜)이며, 백엔드 에이전트와 사람이 쓰는 화면 사이에 공통 언어를 놓는다. 양쪽은 메시지, 상태, 도구 호출을 주고받고, 조합마다 연결 코드를 다시 짤 필요가 없다.
해결하는 문제는 설명하기 쉽다. 에이전트는 오래 돌아가고 스스로 판단하며, 한 세션 안에서 텍스트와 음성과 도구 호출을 섞는다. 기존 REST나 GraphQL 엔드포인트는 요청이 들어가고 정돈된 응답이 나온다는 전제로 만들어졌다. Cursor나 Devin 같은 대화형 에이전트는 이미 사람 옆에서 실시간으로 일한다. 이 방식이 옛 모델을 깨뜨린다.
가장 큰 한계는 범위에 있다. AG-UI가 다루는 것은 에이전트와 화면 연결 계층뿐이다. 에이전트가 도구에 닿는 방식이나 에이전트끼리 대화하는 방법은 건드리지 않는다. 그래서 스택의 다른 부품과 함께 쓴다.
Getting Started
- ag-ui.com의 공식 문서를 훑고 LangChain, CrewAI, 모델 직접 연결처럼 지원되는 프레임워크를 고른다.
- 프런트엔드 런타임에서 에이전트 엔드포인트를 HttpAgent로 등록한다. 그러면 클라이언트가 입력을 보낼 곳과 이벤트를 들을 곳을 알게 된다.
- 스트리밍 채팅, 공유 상태, 승인 단계처럼 필요한 UI 부품을 붙인다. 공식 참조 구현을 출발점으로 삼으면 된다.
- AG-UI Dojo의 데모를 돌려 각 기능이 실제 앱에서 어떻게 동작하는지 보고, 같은 이벤트를 자기 제품에 옮긴다.
제품 정보
AG-UI의 요금, 지원 플랫폼, 성능을 한눈에 확인해 보세요.
추천 대상
이 도구가 가장 잘 맞는 사용자, 작업, 상황입니다.
사용자
- 프런트엔드 개발자
- 풀스택과 플랫폼 팀
- 기술 제품 관리자
작업
- 에이전트 응답을 웹 앱으로 흘려보내기
- 에이전트와 화면의 상태 동기화
- 사람의 승인 끼워 넣기
활용 상황
- 답변 초안을 쓰는 지원 도우미
- IDE나 웹 도구에 붙는 코딩 동료
- 여러 단계를 거치는 리서치나 데이터 에이전트
주요 기능
실시간 이벤트 스트리밍(에이전트 스트리밍)
AG-UI는 에이전트와 화면 사이에 열린 통로를 유지한다. 토큰, 도구 호출, 상태 갱신이 생기는 즉시 도착한다. 실행은 취소와 재개를 지원하고, 요청이 몇 초가 아니라 몇 분 걸릴 때 이 점이 중요해진다. 연결은 표준 HTTP와 WebSocket을 타므로 이미 돌리는 웹 구성에 그대로 얹힌다.
공유 상태
프로토콜은 타입이 있는 저장소를 정의하고, 에이전트와 앱이 모두 읽고 고칠 수 있다. 변화는 차이 형태로 돌아오고 충돌도 처리된다. 화면은 전체를 다시 불러오지 않고 에이전트의 작업을 비춘다. 읽기 전용과 읽기·쓰기 모드로 어느 쪽이 얼마나 통제할지 정한다.
생성형 UI
에이전트는 앱이 그리는 부품을 돌려준다. 안정된 타입 위젯부터 프런트엔드가 검증한 뒤 올리는 작은 선언형 트리까지 있다. 글자만 보내는 대신 폼이나 차트처럼 사용자가 보는 것을 에이전트가 빚는다. 무엇을 보여줄지의 마지막 결정은 앱이 쥔다.
사람이 개입하는 제어(human in the loop)
실행을 끊어 단계를 멈추고, 승인하고, 고치고, 다시 시도하고, 위로 넘길 수 있다. 상태는 멈춤을 넘어 살아남아, 사람이 답하면 에이전트가 멈춘 곳에서 이어간다. 실제 결과가 따르는 일에 에이전트를 쓸 만하게 만드는 부품이 바로 이것이다.
프레임워크에 얽매이지 않는 통합
AG-UI는 CopilotKit이 LangChain, CrewAI와 협업한 작업에서 나왔고, 그 프레임워크용 통합과 모델 직접 연결 경로를 갖췄다. 올바른 이벤트 흐름을 내보내는 백엔드라면 Python이든 JavaScript든 다른 언어든 붙는다. MCP, A2A와 나란히 AG-UI는 오늘날 에이전트 계열 프로토콜 가운데 하나로 에이전트 시스템이 맞물리는 방식을 정한다. UI 로직은 한 번 쓰고 다른 에이전트에 겨눌 수 있다.
장단점
장점
- 표준 연결을 하나 열어, 프런트엔드가 맞춤 배선 없이 여러 에이전트 백엔드와 대화한다.
- 에이전트의 현실에 맞춰져 있다. 긴 실행, 스트리밍 작업, 텍스트와 도구가 섞인 출력을 전제로 한다.
- 공유 상태, 생성형 UI, 사람의 확인에 뚜렷한 부품이 있고 따로따로 쓸 수도 있다.
- 공식 문서와 AG-UI Dojo의 살아 있는 데모 덕에 이벤트 모델이 금방 구체화된다.
- HTTP와 WebSocket 위에 올라가 기존 웹 인프라에 들어맞는다.
단점
- 에이전트와 화면 계층만 감싼다. 도구와 에이전트 사이 작업에는 여전히 MCP나 A2A가 필요하다.
- 개발자를 전제로 한다. 코드를 쓰지 않는 사람을 위한 길은 없다.
- 도입하려면 첫 기능을 내보내기 전에 이벤트 종류와 메시지 형식을 익혀야 한다.
- CopilotKit의 도구 묶음에 크게 기대는 편이라, 바깥 팀은 바로 쓸 부품이 적다.
자주 묻는 질문
AG-UI는 AI 에이전트를 사용자 대상 앱에 연결하는 방법을 표준화한다. 스트리밍 응답, 공유 상태, 도구 호출, 승인 단계를 백엔드 에이전트와 프런트엔드 앱 사이에서 나른다. 개발자는 프레임워크마다 자체 배선을 만들지 않아도 된다.
관련 콘텐츠
AG-UI와 관련된 도구, 스킬, 아티클을 살펴보세요.
AG-UI 대안
Udon
Udon · 코딩 · 생산성Udon은 Apple Silicon Mac을 Mac 홈서버로 바꾸는 소프트웨어다. 브라우저에서 컨테이너와 파일 공유를 관리하고, 원하면 AI 시스템 관리자까지 붙일 수 있다.
offstage
offstage cloud · 코딩 · 생산성offstage는 AI 에이전트와 CI 작업에 진짜 Mac을 넘긴다. Apple Silicon 위의 새 macOS 27 계정을 API로 다루고 초 단위로 과금한다.
BotBus
Chengdu Tuyang Tusen Technology Co., Ltd. · 코딩 · 생산성BotBus는 AI 코딩 에이전트 원격 제어 앱이다. 스마트폰과 워치에서 명령을 승인하고, 작업을 시작하고, 결과를 확인한다.