본문으로 건너뛰기
ReviewRamble

주간 브리프

AI 리뷰를 받은편지함으로.

  • 도구, 모델, MCP 서버, 저장소의 새 리뷰(결론부터)
  • 변경이 있을 때 다시 확인한 가격과 평점
  • 새로 발행된 분석 글

모델, 에이전트, MCP 서버, 그리고 정말 시간을 들일 만한 도구.

일주일에 한 통입니다. 각 브리프의 링크로 구독을 해지할 수 있습니다. 이메일 사용 방식

AG-UI

에이전트의 텍스트, 도구 호출, 상태, 승인을 프런트엔드로 스트리밍하는 CopilotKit의 공개 이벤트 프로토콜이며, 이제 1.0 사양이 고정되었습니다.

리뷰어: ReviewRamble editors · 업데이트

GitHub에서 보기 오픈 소스

이 페이지 공유:XLinkedInFacebookRedditWhatsApp이메일

평점

4.3/5

AG-UI는 에이전트 백엔드와 프런트엔드 사이의 기본 통신 형식이 되었고 1.0 사양 덕분에 안심하고 기반으로 삼을 수 있지만, 빠져 있는 인증은 직접 갖춰야 합니다.

AG-UI의 개요

AG-UI(Agent-User Interaction protocol)는 에이전트 백엔드가 사람이 쓰는 앱과 어떻게 통신할지를 정의합니다. 앱은 HTTP 엔드포인트로 RunAgentInput 하나(메시지, 프런트엔드가 제공하는 도구, 공유 상태, 컨텍스트)를 보내고, 에이전트는 타입이 정해진 이벤트를 스트리밍으로 돌려줍니다. 이벤트는 여덟 개 계열에 31종이 있으며 실행 수명 주기, 텍스트, 도구 호출, 상태 스냅숏과 JSON Patch 변경분, 추론, 진행 상황, 하위 에이전트, 사용자 정의 데이터를 다룹니다. 전송 방식은 Server-Sent Events를 쓰는 HTTP 또는 바이너리 Protobuf 바인딩입니다.

다른 두 에이전트 프로토콜과 경쟁하기보다 나란히 쓰입니다. MCP는 에이전트를 도구와 데이터에, A2A는 에이전트끼리, AG-UI는 에이전트를 사용자에게 연결합니다. 에이전트 하나가 세 가지를 모두 쓰는 경우가 많고, AG-UI 미들웨어는 MCP와 A2A 에이전트 앞단에 둘 수 있습니다. Google의 A2UI나 MCP Apps 같은 생성형 UI 사양은 무엇을 그릴지 기술하고, AG-UI는 그 내용을 실어 나릅니다.

버전 1.0은 2026년 9월 17일 규범적 사양과 JSON Schema를 갖추고 나왔으며, 공식 TypeScript, Python, .NET SDK는 이 스키마에서 생성됩니다. Kotlin, Go, Java, Dart, Rust, Ruby, C++, Swift SDK는 커뮤니티가 만듭니다. CopilotKit이 프로토콜을 만들었고 MIT 라이선스로 공개 개발하며 관리합니다.

AG-UI, 쓸 만한 가치가 있습니까?

AG-UI는 모든 팀이 서툴게 다시 만드는 에이전트 작업의 한 부분을 해결합니다. 백엔드 에이전트에서 스트리밍 텍스트, 도구 호출, 공유 상태, 승인 요청을 브라우저까지 전달하면서 프레임워크마다 별도의 이벤트 형식을 만들지 않아도 됩니다. 채택 수치를 보면 이 논쟁은 사실상 끝났습니다. @ag-ui/core는 2026년 11월 19일까지 한 주 동안 npm에서 약 760만 회, Python 패키지 ag-ui-protocol은 약 230만 회 다운로드되었고, 저장소는 GitHub 스타 약 20,800개를 보유하고 있습니다.

이유는 프레임워크 지원입니다. Microsoft Agent Framework, Google ADK, AWS Strands, Mastra, Pydantic AI, Agno, LlamaIndex, AG2가 기본으로 지원하고, LangChain과 CrewAI는 파트너로 올라 있으며, Claude Agent SDK와 OpenAI Agents 통합은 저장소 안에 있고, Amazon Bedrock AgentCore는 자사 런타임용으로 AG-UI를 문서화했습니다. CopilotKit이나 터미널 프런트엔드 뒤의 에이전트 프레임워크를 바꾸는 일이 재작성이 아니라 설정 변경이 됩니다.

2026년 9월 17일의 1.0 릴리스는 동작 정의를 TypeScript 클라이언트에서 MUST와 SHOULD 규칙을 갖춘 문서화된 사양으로 옮겼습니다. 이제 실행은 결과(성공, 중단, 취소)를 알리므로 사람의 승인을 깔끔한 일시 정지와 재개로 처리할 수 있습니다. THINKING 이벤트는 암호화된 왕복을 지원하는 REASONING 이벤트가 되었고, 도구 결과에 이미지와 문서를 담을 수 있습니다. 이전 버전과 새 버전은 양방향으로 호환되므로 0.x 에이전트는 1.0 클라이언트에서 계속 작동하며 그 반대도 마찬가지입니다.

주의할 점: 이 프로토콜에는 자체 인증이나 권한 부여가 없습니다. Microsoft의 AG-UI 보안 가이드는 이를 분명히 밝히고, AG-UI 서버를 브라우저 JavaScript나 모바일 앱에 직접 노출하지 말라고 권하며, 클라이언트가 원하는 시스템 메시지, 도구, 상태를 보낼 수 있기 때문에 메시지 목록과 상태가 프롬프트 인젝션의 주요 경로라고 지적합니다. 스레드 ID는 자격 증명이 아닙니다. 실제로는 프로토콜 메시지를 직접 만들고 사용자의 텍스트만 통과시키는 신뢰할 수 있는 백엔드를 앞에 둡니다. 릴리스 주기도 빨라 11월에는 며칠마다 태그 릴리스가 나왔고, 열린 이슈는 318개입니다.

결론: 에이전트에 제대로 된 사용자 인터페이스가 필요하다면, 도구에서 MCP가 그렇듯 AG-UI가 합리적인 기본 선택입니다. 사양이 의도적으로 사용자에게 맡긴 보안 작업에 하루 정도는 잡아 두십시오.

제 역할을 하는 곳

  • 앱 안에 어시스턴트를 추가하는 SaaS 회사의 프런트엔드 엔지니어

    스트리밍 답변, 도구 진행 상황, 위험한 작업에 대한 승인 또는 거부 단계를 보여 주기

    `npx create-ag-ui-app@latest`를 실행해 백엔드 프레임워크와 Next.js 기반 CopilotKit을 고른 뒤, 중단 결과를 확인 대화상자에 연결합니다. 프로토콜은 무료이고, 비용은 모델 호출과 에이전트 호스팅입니다.

  • 두 프레임워크에서 에이전트를 운영하는 은행의 플랫폼 팀

    백엔드를 LangGraph에서 Microsoft Agent Framework로 옮기는 동안 채팅 프런트엔드를 하나로 유지

    둘 다 AG-UI 이벤트를 내보내므로 클라이언트는 그대로입니다. Microsoft 보안 가이드가 권하는 대로 사용자를 인증하고 RunAgentInput을 직접 만들며 사용자 텍스트만 전달하는 backend-for-frontend 서비스를 앞에 둡니다.

  • 기존 에이전트로 사내 Slack 봇을 만드는 개발자

    두 번째 통합 없이 웹 에이전트를 Slack과 Teams에서 재사용

    CopilotKit의 채널 SDK는 웹 클라이언트와 같은 AG-UI 스트림을 받으므로 에이전트 코드는 바뀌지 않고, 채널마다 도구 호출과 상태를 보여 주는 방식만 달라집니다.

도입 전 확인할 점

설정
npm install @ag-ui/client 또는 pip install ag-ui-protocol을 실행합니다. 최소한의 Python 에이전트와 TypeScript 클라이언트는 각각 약 30줄이며, `npx create-ag-ui-app@latest`는 프레임워크와 연결된 CopilotKit 앱을 만들어 줍니다(템플릿은 OpenAI를 호출합니다).
연동
Microsoft Agent Framework, Google ADK, AWS Strands, Mastra, Pydantic AI, Agno, LlamaIndex, AG2, LangChain, CrewAI, Claude Agent SDK, OpenAI Agents, Spring AI 등. React, Angular, Vue, React Native, Slack, Teams, 터미널용 클라이언트와 MCP 및 A2A 미들웨어가 있습니다.
데이터와 개인정보
서비스가 아니라 프로토콜이므로 이벤트는 내 앱과 내 에이전트 사이에서만 오갑니다. 인증이 정의되어 있지 않으므로 엔드포인트에는 자체 인증과 앞단의 신뢰할 수 있는 백엔드가 필요합니다. 라이선스는 MIT입니다.
대규모 사용 시 비용
라이선스나 사용료는 없습니다. 비용은 에이전트 호스팅, 모델 토큰, 로드 밸런서에서 유지되는 장시간 스트리밍 연결입니다.
제한
Python SDK는 3.9+, TypeScript 클라이언트는 Node.js 20+가 필요합니다. 1.0은 알 수 없는 이벤트를 경고와 함께 버리고 형식이 잘못된 알려진 이벤트를 치명적 오류로 처리하므로, SDK 버전이 맞지 않으면 실행 중 오류로 드러납니다.

좋은 점

  • Microsoft, Google, AWS를 포함한 주요 에이전트 프레임워크 대부분에 기본 탑재
  • 고정된 1.0 사양과 JSON Schema로 TypeScript, Python, .NET SDK를 생성
  • 중단 결과 덕분에 사람의 승인을 깔끔한 일시 정지와 재개로 처리
  • JSON Patch 변경분을 쓰는 공유 상태로 앱과 에이전트를 동기화
  • Dojo에서 모든 통합의 라이브 데모 제공

아쉬운 점

  • 기본 인증이 없어 엔드포인트를 브라우저에 직접 노출하면 안 됨
  • 신뢰할 수 없는 클라이언트에게 메시지와 상태가 프롬프트 인젝션 경로로 열려 있음
  • Kotlin, Go, Rust 등의 SDK는 커뮤니티가 관리하며 스키마에서 생성되지 않음
  • 빠른 릴리스 주기와 열린 이슈 318개

추천 대상

LangGraph, ADK, Mastra, CrewAI 등으로 만든 에이전트를 웹, 모바일, 채팅 인터페이스 뒤에 두고 모두에 하나의 이벤트 형식을 쓰고 싶은 팀에 맞습니다.

AG-UI 대안

AG-UI: 자주 묻는 질문

AG-UI, 쓸 만한 가치가 있습니까?
AG-UI는 에이전트 백엔드와 프런트엔드 사이의 기본 통신 형식이 되었고 1.0 사양 덕분에 안심하고 기반으로 삼을 수 있지만, 빠져 있는 인증은 직접 갖춰야 합니다. 평점은 5점 만점에 4.3점입니다.
AG-UI의 가격은 얼마입니까?
MIT 라이선스의 무료 오픈소스로 프로토콜, SDK, 통합, 데모 앱 Dojo가 포함됩니다. 비용은 에이전트 호스팅과 모델 호출에 듭니다.
AG-UI의 단점은 무엇입니까?
기본 인증이 없어 엔드포인트를 브라우저에 직접 노출하면 안 됨; 신뢰할 수 없는 클라이언트에게 메시지와 상태가 프롬프트 인젝션 경로로 열려 있음; Kotlin, Go, Rust 등의 SDK는 커뮤니티가 관리하며 스키마에서 생성되지 않음; 빠른 릴리스 주기와 열린 이슈 318개.
AG-UI에 적합한 사람은 누구입니까?
LangGraph, ADK, Mastra, CrewAI 등으로 만든 에이전트를 웹, 모바일, 채팅 인터페이스 뒤에 두고 모두에 하나의 이벤트 형식을 쓰고 싶은 팀에 맞습니다.
팀이나 프로덕션 환경에서 AG-UI의 비용은 얼마입니까?
라이선스나 사용료는 없습니다. 비용은 에이전트 호스팅, 모델 토큰, 로드 밸런서에서 유지되는 장시간 스트리밍 연결입니다.
AG-UI에 회사 데이터를 맡겨도 안전합니까?
서비스가 아니라 프로토콜이므로 이벤트는 내 앱과 내 에이전트 사이에서만 오갑니다. 인증이 정의되어 있지 않으므로 엔드포인트에는 자체 인증과 앞단의 신뢰할 수 있는 백엔드가 필요합니다. 라이선스는 MIT입니다.
AG-UI의 가장 좋은 대안은 무엇입니까?
저희가 리뷰한 것 중 가장 가까운 대안은 MCP Python SDK, Mastra, LangGraph 및 Google Agent Development Kit (ADK)입니다.

답변 확인일: 2026년 11월 20일.

AG-UI 개발사입니까? 이 평점을 사이트에 표시하십시오ReviewRamble 평점: AG-UI, 5점 만점에 4.3점