<img src="https://github.com/user-attachments/assets/ebc0dd08-8732-4519-9b6c-452ce54d8058" alt="ag-ui Logo" width="22"/> AG-UI: 에이전트-사용자 상호작용 프로토콜
AG-UI는 AI 에이전트가 사용자 인터페이스(user-facing applications)에 연결되는 방식을 표준화하는 개방형, 경량의 이벤트 기반 프로토콜입니다.
단순성과 유연성을 위해 구축되었으며, AI 에이전트, 실시간 사용자 컨텍스트, 그리고 사용자 인터페이스 간의 원활한 통합을 가능하게 합니다.
<div align="center">
<a href="https://trendshift.io/repositories/27961?utm_source=trendshift-badge&utm_medium=badge&utm_campaign=badge-trendshift-27961" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/trendshift/repositories/27961/daily" alt="ag-ui-protocol%2Fag-ui | Trendshift" width="250" height="55"/></a>
</div>
<br>
Version
MIT
Discord
<a href="https://discord.gg/Jd3FzfdJa8" target="_blank"> Discord에서 참여하기 → </a> <a href="https://ag-ui.com/" target="_blank"> 문서 보기 → </a> <a href="https://dojo.ag-ui.com/" target="_blank"> AG-UI Dojo로 이동하기 → </a> <a href="https://x.com/CopilotKit" target="_blank"> 팔로우하기 → </a>
<img width="1600" height="680" alt="1600x680" src="https://github.com/user-attachments/assets/00ec7366-713e-443f-a8f0-8db52ad28ef4" />
🚀 시작하기 (Getting Started)
몇 초 만에 새로운 AG-UI 애플리케이션을 생성하세요:
npx create-ag-ui-app my-agent-app
유용한 링크:
AG-UI란 무엇인가?
AG-UI는 에이전트와 인간의 상호작용을 위한 개방적이고 가벼우며 이벤트 기반의 프로토콜로, 단순성과 유연성을 위해 설계되었습니다:
- 에이전트 실행 중, 에이전트 백엔드는 AG-UI의 약 16가지 표준 이벤트 유형 중 하나와 호환되는 이벤트를 방출합니다.
- 에이전트 백엔드는 인수로 몇 가지 간단한 AG-UI 호환 입력을 수신할 수 있습니다.
AG-UI는 다양한 환경에서 호환성을 보장하는 유연한 미들웨어 계층을 포함합니다:
- 모든 이벤트 전송 방식(SSE, WebSockets, 웹훅 등)과 작동합니다.
- 느슨한 이벤트 형식 매칭(loose event format matching)을 허용하여 광범위한 에이전트 및 앱 상호 운용성을 가능하게 합니다.
또한 팀이 빠르게 시작할 수 있도록 **참조 HTTP 구현(reference HTTP implementation)**과 **기본 커넥터(default connector)**를 함께 제공합니다.
사양에 대해 더 알아보기 →
왜 AG-UI인가요?
AG-UI는 실제 요구 사항과 인앱(in-app) 에이전트 상호작용 구축 경험을 바탕으로 개발되었습니다.
AG-UI는 에이전트 프로토콜 스택에서 어디에 위치하나요?
AG-UI는 다른 2가지 주요 에이전트 프로토콜을 보완합니다.
- MCP는 에이전트에게 도구를 제공합니다.
- A2A는 에이전트가 다른 에이전트와 통신할 수 있게 합니다.
- AG-UI는 에이전트를 사용자 대면 애플리케이션으로 가져옵니다.
<div align="center">
<img width="2048" height="1182" alt="The Agent Protocol Stack" src="https://github.com/user-attachments/assets/41138f71-50be-4812-98aa-20e0ad595716" />
</div>
🚀 기능 (Features)
- 💬 스트리밍을 이용한 실시간 에이전트 채팅
- 🔄 양방향 상태 동기화(Bi-directional state synchronization)
- 🧩 생성형 UI 및 구조화된 메시지
- 🧠 실시간 컨텍스트 강화(Real-time context enrichment)
- 🛠️ 프론트엔드 도구 통합 (Frontend tool integration)
- 🧑💻 인간 개입 루프 협업 (Human-in-the-loop collaboration)
🛠 지원되는 통합 (Supported Integrations)
AG-UI는 CopilotKit이 LangChain 및 CrewAI와 초기 **파트너십(partnership)**을 맺으면서 탄생했으며, 매우 인기 있는 에이전트-사용자 상호작용 인프라를 더 넓은 에이전트 생태계로 가져왔습니다.
1st party = AG‑UI가 내장되어 있고 가이드를 제공하는 플랫폼입니다.
프레임워크 (Frameworks)
| 프레임워크 | 상태 | AG-UI 리소스 |
|---|
| Built-in Agent | ✅ 지원됨 | ➡️ Docs |
🤝 파트너십 (Partnerships)
🧩 퍼스트 파티 (1st Party)
에이전트 상호작용 프로토콜 (Agent Interaction Protocols)
| 프로토콜 | 상태 | AG-UI 리소스 | 통합 (Integrations) |
|---|
| A2A | ✅ 지원됨 | ➡️ Docs | 파트너십 (Partnership) |
인프라스트럭처 / 배포 (Infrastructure / Deployment)
규격 (표준) (Specification (standard))
생성형 UI (Generative UI)
SDK (소프트웨어 개발 키트)
클라이언트 (Clients)
예시 (Examples)
헬로 월드 앱 (Hello World App)
영상:
AG-UI 도조 (빌딩 블록 뷰어) (The AG-UI Dojo (Building-Blocks Viewer))
AG-UI 도조는 간단하고 집중된 예시들(각각 코드 50~200줄)을 통해 AG-UI의 핵심 빌딩 블록을 시연합니다.
도조 및 모든 프레임워크 통합에 대한 소스 코드는 [여기]에서 확인할 수 있습니다.
🙋🏽♂️ AG-UI 기여하기 (Contributing to AG-UI)
기여 가이드는 Contributing guide를 확인하세요.
로드맵 (Roadmap)
무엇이 구축되고 있는지, 그리고 어디에 참여할 수 있는지 확인하려면 AG-UI 로드맵을 확인하세요.
📄 라이선스 (License)
AG-UI는 오픈 소스 소프트웨어이며, MIT로 라이선스가 부여되었습니다.
