UI SDK의 개요
Vercel Labs의 UI SDK는 상호작용 동작을 모은 TypeScript 라이브러리입니다. 키보드 탐색, 포커스, 선택, 닫기, 팝업, 드래그 앤 드롭과 각각에 필요한 ARIA 속성을 다룹니다. 이들은 @ui-sdk/core에 있으며, 프리미티브라고 부르는 컴포넌트를 한 번 정의하면 React(19 이상), Vue, Svelte, Solid, Web Components용 어댑터로 렌더링합니다. Select, Combobox, Field, Tabs, Menu, Date Picker 같은 기성 컴포넌트도 있습니다. 프리미티브 코드 대부분은 에이전트가 작성한다는 전제이며, 이를 위해 에이전트 스킬과 버전별 Markdown 문서를 함께 제공합니다.
나머지 절반은 에이전트 브리지입니다. createAgent는 페이지의 모든 UI SDK 컴포넌트를 등록합니다. snapshot은 각 컴포넌트를 접근성 레이블, 값, 사용 가능한 액션과 함께 나열하고, act는 그 액션을 호출하며, query는 긴 목록을 검색합니다. 같은 도구를 자체 모델에 넘기거나 WebMCP로 브라우저 내장 에이전트에 등록할 수 있습니다. 브리지는 접근성 이름으로 컨트롤을 찾기 때문에, 스크린 리더가 식별할 수 있는 컨트롤이면 에이전트도 찾을 수 있습니다.
저장소는 2026년 10월 26일에 만들어졌고 Apache 2.0 라이선스이며, GitHub 스타는 약 6,222개, 포크는 217개입니다. Vercel의 공개 베타 약관에 따른 베타이며, 2026년 11월 19일 기준 패키지 버전은 0.1.0-beta.13입니다.
UI SDK, 쓸 만한 가치가 있습니까?
유용한 발상은 에이전트가 브라우저 자동화 스크립트처럼 페이지를 읽을 필요가 없어야 한다는 것입니다. UI SDK에서는 각 컴포넌트가 레이블, 현재 값, 지원하는 액션을 알려 줍니다. 그래서 에이전 트는 "Project name"이라는 레이블의 입력란을 접근성 트리에서 찾아 클릭하고 입력하는 대신, 한 번의 호출로 "Atlas"로 바꿀 수 있습니다. 에이전트가 기준으로 삼는 레이블은 컨트롤의 접근성 이름이므로, aria-label이나 제대로 된 필드 레이블을 빼먹는 팀은 스크린 리더 사용자와 에이전트를 함께 잃습니다.
Vercel의 자체 벤치마크가 차이를 숫자로 보여 줍니다. React로 만든 프로젝트 설정 화면에서 브리지를 쓴 에이전트는 도구 호출 7회, 69.5k 토큰, 31초, $0.044가 들었습니다. 가장 나았던 경쟁 제품인 Base UI를 브라우저 도구로 조작한 경우는 17회, 291.7k 토큰, 53초, $0.139였습니다. Vue와 Svelte에서도 비용이 54%에서 55% 줄었습니다. Claude Code에서 Sonnet으로 세 번 실행한 중앙값이며, 과제는 Vercel이 설계한 하나뿐입니다. 벤치마크가 저장소에 있으니 직접 다시 돌려 볼 수 있습니다.
보안 설계는 베타치고 잘 고민되어 있습니다. 변경 콜백은 source "agent"를 받아 변경을 취소할 수 있고, allow 콜백은 어떤 단계든 거부할 수 있으며, data-agent-confirm으로 표시한 컨트롤은 먼저 사람에게 확인을 받습니다. WebMCP 도구에는 act가 결과를 낳는 동작이며 결과에 신뢰할 수 없는 페이지 텍스트가 들어 있다는 힌트가 붙습니다. 마지막 점이 중요합니다. snapshot에는 사용자가 입력한 무엇이든 들어갈 수 있어 프롬프트 인젝션의 통로가 되므로, 되돌릴 수 없는 작업에는 확인 장치를 쓰는 것이 좋습니다.
주의할 점: 모든 것이 새롭습니다. 저장소는 4주가 채 안 되었고, 정식 출시 전에 API가 바뀔 수 있으며, 브리지는 UI SDK 컴포넌트만 봅니다. 여러 라이브러리가 섞인 페이지에서는 에이전트가 일부만 보게 됩니다. WebMCP는 document.modelContext를 제공하는 브라우저가 필요하고, 그 밖의 브라우저에서는 registerTools가 아무 일도 하지 않습니다. 도입하려면 기존 컨트롤을 프리미티브로 다시 만들어야 합니다.
결론: 에이전트가 조작할 새 React나 Vue 앱을 시작하는 팀이라면 지금 한 화면에서 UI SDK를 시험해 볼 만합니다. Radix나 shadcn/ui 위에 성숙한 디자인 시스템을 갖춘 팀이라면 베타를 지켜보면서 그동안 접근성 이름을 정비하는 편이 낫고, 이는 어느 쪽이든 득이 됩니다.
제 역할을 하는 곳
앱 내 어시스턴트를 추가하는 B2B SaaS 기업의 프런트엔드 리드
어시스턴트가 사용자 대신 설정 양식을 채우게 하기
UI SDK의 Field, Select, Combobox로 설정 화면을 만들고, 시작 시 브리지를 생성해 agentTools를 모델에 넘깁니다. 저장과 삭제에는 allow 콜백과 data-agent-confirm을 걸어 남는 변경은 사람이 승인하게 합니다.
React 팀과 Vue 팀을 지원하는 디자인 시스템 엔지니어
서로 달라지는 두 개 대신 접근성 있는 날짜 선택기 하나를 배포하기
@ui-sdk/core에서 프리미티브를 한 번 정의하고 각 어댑터로 렌더링합니다. 테스트 키트가 키보드, 포커스, ARIA를 확인합니다. 패키지가 0.1.0 베타인 동안은 API 변경을 감안해야 합니다.
브라우저 에이전트가 긴 양식에서 토큰을 많이 쓰는 QA 엔지니어
에이전트 기반 엔드투엔드 테스트 비용 줄이기
UI SDK로 만든 화면에서는 접근성 트리를 클릭해 다니는 대신 snapshot과 act를 호출합니다. Vercel의 React 테스트에서는 실행당 291.7k에서 69.5k 토큰으로 줄었습니다. 먼저 자신의 화면에서 benchmarks/agent를 돌려 보세요.
도입 전 확인할 점
- 설정
- @ui-sdk/core와 @ui-sdk/react(React 19 이상) 같은 어댑터를 npm install한 뒤 npx skills@latest add vercel-labs/ui --skill ui-sdk로 에이전트 스킬을 추가합니다. 문서에는 두 가지를 한 번에 처리하는 프롬프트가 있습니다.
- 연동
- React, Vue, Svelte, Solid, Web Components. 어떤 모델 SDK에도 쓸 수 있는 JSON Schema 포함 에이전트 도구, document.modelContext를 통한 WebMCP 등록, 백엔드에서 도는 모델을 위한 서버 경로가 있습니다.
- 데이터와 개인정보
- 클라이언트 측 라이브러리라 Vercel로 가는 것은 없습니다. 사용자가 입력한 텍스트를 포함해 에이전트가 읽는 내용은 모델 제공업체로 가며, 도구는 이를 신뢰할 수 없는 데이터로 표시합니다.
- 대규모 사용 시 비용
- 라이선스 비용은 없습니다. 에이전트 실행에는 모델 토큰 비용이 들며, Vercel 벤치마크에서 설정 작업은 Sonnet으로 실행당 $0.044에서 $0.056이었습니다.
- 제한
- Vercel 공개 베타 약관을 따르는 베타입니다. snapshot은 처음 100개 컴포넌트까지, query는 최대 50개 선택지를 반환하며 닫힌 목록을 열지 않습니다.
좋은 점
- 하나의 컴포넌트 정의가 React, Vue, Svelte, Solid, Web Components에서 렌더링됨
- Vercel의 React 테스트에서 브리지가 호출을 17회에서 7회로, 비용을 $0.139에서 $0.044로 줄임
- 에이전트 액션을 위한 allow 콜백, 취소 가능한 변경, 확인 표시
- Apache 2.0이며 버전별 문서와 에이전트 스킬 제공
아쉬운 점
- 4주가 안 된 베타라 API가 바뀔 수 있음
- 벤치마크는 Vercel이 직접 만든 과제 하나
- 브리지는 UI SDK 컴포넌트만 보고 페이지의 나머지는 보지 못함
- WebMCP는 document.modelContext를 제공하는 브라우저에서만 작동함
추천 대상
에이전트가 만들고 조작할 새 앱을 시작하면서, 접근성과 에이전트 제어를 하나의 컴포넌트 세트로 해결하려는 프런트엔드 팀에 맞습니다.
UI SDK 대안
UI SDK: 자주 묻는 질문
- UI SDK, 쓸 만한 가치가 있습니까?
- UI SDK는 접근성을 에이전트가 조작하는 인터페이스로 바꿉니다. 탄탄한 발상에 강한 자체 벤치마크가 뒷받침하지만, 공개 4주 된 베타입니다. 평점은 5점 만점에 3.9점입니다.
- UI SDK의 가격은 얼마입니까?
- Apache 2.0 기 반의 무료 오픈소스이며 유료 등급은 없습니다. 에이전트 사용 비용은 모델 제공업체 요금을 따릅니다.
- UI SDK의 단점은 무엇입니까?
- 4주가 안 된 베타라 API가 바뀔 수 있음; 벤치마크는 Vercel이 직접 만든 과제 하나; 브리지는 UI SDK 컴포넌트만 보고 페이지의 나머지는 보지 못함; WebMCP는 document.modelContext를 제공하는 브라우저에서만 작동함.
- UI SDK에 적합한 사람은 누구입니까?
- 에이전트가 만들고 조작할 새 앱을 시작하면서, 접근성과 에이전트 제어를 하나의 컴포넌트 세트로 해결하려는 프런트엔드 팀에 맞습니다.
- 팀이나 프로덕션 환경에서 UI SDK의 비용은 얼마입니까?
- 라이선스 비용은 없습니다. 에이전트 실행에는 모델 토큰 비용이 들며, Vercel 벤치마크에서 설정 작업은 Sonnet으로 실행당 $0.044에서 $0.056이었습니다.
- UI SDK에 회사 데이터를 맡겨도 안전합니까?
- 클라이언트 측 라이브러리라 Vercel로 가는 것은 없습니다. 사용자가 입력한 텍스트를 포함해 에이전트가 읽는 내용은 모델 제공업체로 가며, 도구는 이를 신뢰할 수 없는 데이터로 표시합니다.
- UI SDK의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 shadcn/ui, Browser Use 및 Stagehand입니다.
답변 확인일: 2026년 11월 20일.