오늘 우리는 v0의 앱 구축 에이전트(app-building agent)에 대한 새로운 방식인 프로그래밍 방식의 헤드리스(headless) 액세스를 소개합니다. 프롬프트(prompt)를 보내면 앱을 생성하고, 개발 서버(dev server)를 시작하며, 여러분의 자체 UI에 임베드(embed)할 수 있는 미리보기 URL을 제공합니다.v0 APIv0Vercel Sandbox

각 채팅은 하나의 앱을 위한 격리된 워크스페이스(workspace)이며, 여기서 v0는 파일을 읽고, 편집하고, 실행할 수 있습니다. 후속 메시지는 현재 상태에서 계속 이어집니다. v0는 샌드박스(sandbox)에서 실행되는 코드를 검증하므로, 앱의 오류를 실시간으로 포착하고 수정할 수 있습니다.

새로운 API는 현재 퍼블릭 베타(public beta)로 제공됩니다.

프롬프트로부터 채팅을 생성하고, 작업 내용을 스트리밍(stream)하며, 라이브 미리보기를 렌더링(render)하는 모든 과정을 여러분의 자체 인터페이스에서 수행할 수 있습니다. 먼저, v0 SDK를 설치하세요.

그런 다음, 채팅을 생성합니다. 프롬프트를 보내면 v0가 앱을 생성합니다.

동일한 채팅에 후속 메시지를 보내 계속해서 빌드하세요. 각 메시지는 현재 상태에서 이어집니다.

그 다음 앱을 임베드(embed)하세요.

프롬프트가 입력되면 실행 중인 앱이 출력됩니다. v0는 그 이면에서 샌드박스, 개발 서버 및 미리보기를 운영합니다. 준비가 되면 단 한 번의 API 호출로 Vercel에 배포하세요. v0가 전체 파이프라인(pipeline)을 관리합니다.

새로운 API를 사용하면 여러분의 제품이나 파이프라인 내부에서 v0의 앱 빌더를 실행할 수 있습니다. 이는 다음과 같은 유스케이스(use cases)를 가능하게 합니다:

아래에서는 이 워크플로(workflow)의 이면에 있는 API 프리미티브(primitives)를 자세히 설명합니다.

각 채팅은 하나의 앱 상태를 보유하며, 하나의 리포지토리(repo) 또는 Vercel 프로젝트는 여러 채팅을 가질 수 있습니다. 각 채팅의 ID를 저장하고 해당 ID를 사용하여 후속 메시지를 보내세요. 채팅 메타데이터(metadata)를 사용하면 고객, 워크스페이스, 앱 또는 제품에서 이미 사용 중인 모든 키를 기준으로 채팅을 그룹화할 수 있습니다.

.messages에 대해 더 알아보세요.

여러분의 인터페이스는 요청을 보낸 시점과 업데이트된 미리보기가 보이는 시점 사이에 발생하는 일을 보여주어야 합니다.

모든 메시지에는 순서가 지정된 parts가 포함됩니다: 텍스트(text), 생각(thinking), 파일 읽기 및 편집(file reads and edits), 검색(searches), bash 명령(bash commands), 도구 호출(tool calls) 및 에이전트 작업(agent actions). 동일한 객체로 한 줄 상태 표시, 변경된 파일 보기 또는 전체 트레이스(trace)를 구동할 수 있습니다.

사용량(Usage)은 채팅 및 메시지 응답과 함께 반환되므로, 작업이 완료되었을 때 해당 작업량을 계산할 수 있습니다.

채팅 생성 및 메시지는 동기(synchronous), 비동기(asynchronous), 스트리밍(streaming) 응답을 지원합니다. 호출자가 완료된 응답을 필요로 하는 경우에는 동기(sync) 방식을 사용하세요. 작업을 큐(queue)에 넣고 나중에 v0의 응답을 webhook을 통해 업데이트를 받거나 폴링(poll)하려면 비동기(async) 방식을 사용하세요. v0의 작업이 진행되는 동안 실시간으로 렌더링하려면 요청을 스트림(stream)으로 처리하세요.

또한 리포지토리(repository), ZIP 아카이브 또는 파일 세트를 통해 채팅을 생성할 수도 있습니다.

각 채팅에는 수명이 짧은 프리뷰 토큰(preview token)이 부여됩니다. 서버 라우트(server route)에서 이 토큰을 가져와 브라우저 요청을 해당 토큰을 통해 프록시(proxy)하면, v0 API 키가 브라우저에 노출되지 않습니다. 프리뷰가 준비되면 트래픽이 해당 프리뷰로 전달되며, 샌드박스(Sandbox)가 구동되는 동안에는 요청이 로딩 라우트로 폴백(fallback)됩니다. iframe을 프록시 라우트로 지정하고 프리뷰 세부 정보가 만료될 때까지 캐싱하세요.

자세한 내용은 문서에서 확인하세요. Accessing Previews

채팅에 특정 MCP 서버를 켜거나 기본값을 사용하세요.

디자인 시스템을 스킬(skill)로 저장합니다. 요청에 이를 포함하여 컴포넌트(components), 토큰(tokens), 설정(setup) 및 스타터 앱(starter app)을 로드할 수 있습니다. Design Systems 2.0

팀 또는 사용자 메모리, , 또는 연결된 리포지토리로부터 요청당 최대 3개까지 전달할 수 있으며, 에이전트가 팀의 스킬을 스스로 가져오도록 할 수도 있습니다. skills.sh

에이전트를 구축 중이라면 v0를 도구(tool)로 제공하세요. 작업이 텍스트 답변이나 코드 대신 실제 앱을 필요로 할 때, 에이전트는 v0를 호출하여 채팅을 생성하거나 계속하고, 질문이나 승인 사항을 해결하며, 실행 중인 프리뷰 또는 배포(deployment)를 받아옵니다. v0는 샌드박스 내부의 코드와 런타임(runtime)을 처리하며, 에이전트는 워크플로(workflow)와 최종 응답에 대한 제어권을 유지합니다.

연결하는 방법에는 세 가지가 있습니다:

MCP를 지원하는 IDE, 데스크톱 어시스턴트 또는 에이전트 런타임에 v0 MCP 서버를 연결하세요.

첫 번째 연결 방식은 OAuth 흐름 (flow)을 시작합니다. MCP 서버는 채팅 생성, 채팅 목록 조회, 채팅 상세 정보 가져오기, 메시지 목록 조회 및 전송, 대기 중인 작업 해결, 그리고 프리뷰 URL (preview URLs) 가져오기를 위한 도구 (tools)를 노출합니다.

AI SDK로 구축된 TypeScript 에이전트의 경우, @v0-sdk/ai-tools를 사용하여 v0의 API 작업을 에이전트 자체 루프 내의 도구로 노출할 수 있습니다.

에이전트가 채팅을 생성하거나 계속할 시점을 결정합니다. 사용자의 AI SDK 실행 환경이 오케스트레이션 (orchestration)과 최종 응답에 대한 제어권을 유지합니다.

에이전트의 경우, OpenAPI 연결 파일을 추가하세요. eve는 허용된 작업을 도구로 변환하고, 실행 시점에 모델 컨텍스트 (model context) 외부에서 API 키를 부착합니다.

채팅을 위한 Vercel 프로젝트를 생성한 다음, Vercel API를 통해 환경 변수 (environment variables), 통합 (integrations) 및 설정을 관리하세요. 귀하의 앱에는 엔터프라이즈급 보안 및 관찰 가능성 (observability) 도구가 기본적으로 포함되어 있습니다.

배포할 준비가 되면 채팅을 Vercel에 배포하세요.

이전 버전의 v0 API에서 생성된 채팅은 새 버전에서 실행되지 않으므로, 이를 앞으로 가져와야 합니다. 유지하고 싶은 버전을 선택하여 ZIP 파일로 다운로드한 다음, 해당 ZIP 파일로부터 새 채팅을 생성하세요. 추적 가능성 (traceability)이 필요한 경우 이전 식별자 (identifiers)를 새 채팅의 메타데이터 (metadata)에 저장하세요.

마이그레이션 가이드 (migration guide)가 전체 매핑을 다룹니다. 주요 변경 사항은 다음과 같습니다:

v0 설정에서 API 키를 생성하고 SDK를 설치하세요.

또는, 전체 앱의 스캐폴딩 (scaffold)을 수행하세요.

문서 (documentation)와 마이그레이션 가이드 (migration guide)를 읽어보세요.

더 읽어보기 (Read more)

작동 원리 (How it works)

이를 통해 가능해지는 것 (What this unlocks)

채팅으로 시작하기 (Start with a chat)

트레이스 스트리밍 (Stream the trace)

동기, 비동기 또는 스트리밍 선택 (Choose sync, async, or streaming)

기존 코드에서 작업하기 (Work from existing code)

개발 서버 프리뷰 렌더링 (Render the dev server preview)

자체 도구 및 디자인 시스템 활용 (Bring your own tools and design systems)

에이전트에서 v0 사용하기 (Use v0 from agents)

Vercel 프로젝트 연결 (Connect a Vercel project)

채팅 마이그레이션 (Migrate your chats)

시작하기 (Get started)

• 사용자가 앱을 설명하면 제품 내부에서 작동하는 앱을 돌려받습니다.화이트 라벨 앱 빌더 (A white-labeled app builder):

• 스크립트, CI 작업 또는 웹훅(webhook)에서 v0를 트리거하여 새로운 앱을 생성하거나 기존 앱을 업데이트합니다.자동화된 앱 변경 (Automated app changes):

• 에이전트(agent)가 코드 스니펫(code snippet) 대신 작동하는 앱을 전달합니다.에이전트를 위한 빌드 도구 (A build tool for your agents):

• 새로운 요청에 사용하세요. https://api.v0.dev/v2

• 채팅(chat)은 현재 앱 상태를 유지하며, 메시지(message)는 그 이력을 보유합니다.

• 버전 워크플로우(version workflows)를 채팅 파일 워크플로우(chat file workflows)로 대체하고, v0 프로젝트 조직(Project organization)을 채팅 메타데이터(chat metadata)로 대체합니다.

• 프로젝트 작업을 위해 Vercel API와 함께 사용하세요. vercelProjectId

• 최종 텍스트뿐만 아니라 메시지 parts를 렌더링합니다.

MCP

AI SDK

eve