AG-UI
에이전트를 사용자 화면에 붙이는 이벤트 기반 규약
npx create-ag-ui-app my-agent-app에이전트가 사용자용 애플리케이션과 연결되는 방식을 표준화한 가볍고 이벤트 기반인 규약입니다. 에이전트가 실행되는 동안 열여섯 가지 표준 이벤트 유형 중 하나에 맞는 이벤트를 내보내고, 몇 가지 정해진 입력을 인자로 받습니다. 전송 방식을 가리지 않아서 서버 전송 이벤트든 웹소켓이든 웹훅이든 붙고, 이벤트 형식 대조가 느슨해서 다양한 조합에서 통합니다. 실시간 대화 스트리밍과 양방향 상태 동기화, 생성형 UI, 사람이 개입하는 협업이 규약 안에 들어 있습니다. MCP 가 도구를, A2A 가 에이전트 간 대화를 맡는다면 이쪽은 화면을 맡는 자리입니다.
판단
이럴 때 씁니다
- 에이전트를 사용자 화면에 붙여야 할 때
- 실행 중 상태를 화면과 양방향으로 맞춰야 할 때
- 여러 프레임워크의 에이전트를 같은 화면 규약으로 다룰 때
이럴 땐 쓰지 마세요
- 화면 없이 배치 작업만 한다면 필요 없습니다
- 규약 판이 0.1.x 대라 이벤트가 늘어날 수 있습니다
- 직접 만든 스트리밍 구조가 이미 있으면 이전 비용이 듭니다
차별점
- 에이전트와 화면 사이만 다루는 좁고 명확한 규약입니다.
- 전송 방식을 가리지 않는 중간 계층을 제공합니다.
- 실시간 대화와 상태 동기화, 생성형 UI, 사람 개입이 규약 안에 있습니다.
- 참조 구현과 기본 연결기가 함께 나와 시작이 빠릅니다.
워크플로
- 01초기화 명령으로 예제 애플리케이션을 만듭니다.
- 02에이전트 쪽에서 표준 이벤트를 내보내게 맞춥니다.
- 03전송 방식을 고릅니다.
- 04화면에서 상태 동기화와 도구 호출을 연결합니다.
- 05사람이 개입하는 지점을 배치합니다.
주요 명령
| 명령 | 설명 |
|---|---|
npx create-ag-ui-app my-agent-app | 예제 애플리케이션을 만듭니다. |
pip install ag-ui-protocol | 파이썬 쪽 규약 패키지를 설치합니다. |
함정
설치 전에 확인하세요
- 이벤트 형식 대조가 느슨하도록 설계돼 있습니다. 호환은 넓어지지만 잘못된 이벤트가 조용히 넘어갈 수 있습니다.
- 판 번호가 0.1.x 대입니다. 표준 이벤트 유형이 늘어날 수 있으므로 판을 고정하는 편이 안전합니다.
- 규약이지만 참조 구현과 기본 연결기가 함께 제공됩니다. 어디까지가 규약이고 어디부터가 구현인지 구분해야 합니다.
- 배포 태그가 날짜 형식이고 패키지 판과 다릅니다. 어느 쪽을 말하는지 확인해야 합니다.
비교
MCP 는 에이전트가 도구를 부르는 층이고 A2A 는 에이전트끼리 대화하는 층입니다. 이쪽은 에이전트와 사람이 만나는 층을 맡습니다. 세 규약이 경쟁이 아니라 층이 다르기 때문에 함께 쓰는 구성이 자연스럽습니다.
최근 변경
패키지가 0.1.22 로 배포됐습니다. 이 판에 대한 변경 기록 항목이 비어 있다고 배포 노트가 직접 밝히고 있습니다.