업데이트 내역
이 핸드북의 변경 이력과 반영 근거를 기록합니다.
2026-10-23
-
Next.js 9~10월 보안 권고를 반영하고 과거 16.2.3을 현재 보안 최소 버전으로 제시하던 표현을 교체했습니다. AGENTS.md 자동 생성 경계를 16.3+로 정정하고 MCP 연결 예제를 client·도구 허용 목록·수명 관리 방식으로 바꿨습니다.
-
AI SDK 7·Workflow 5와 Node.js 24/Fluid Compute 운영 기준을 반영했습니다.
-
AI SDK의 loop helper·instructions·telemetry·stream helper와 관측 bootstrap 예제를 갱신했습니다.
-
임의의 10초 Workflow 전환 규칙을 제거하고 durable state 요구로 실행 경로를 고르게 했습니다.
-
함수 기본·최대 시간과 Beta 확장, payload·번들 한도와 과금 축을 구분했습니다.
-
Global Config 명칭·SDK와 migration 단계, 한·영판의 검증 근거를 갱신했습니다.
AI SDK 7 migration · Workflow 5 changes · Functions limits · Global Config rename.
2026-05-04 — Vercel 공식 자료 현행화
| 변경 | 내용 | 근거 |
|---|---|---|
| Ch2 AI SDK 런타임 정정 | 구조화 출력 예제를 generateText + Output.object() 기준으로 수정하고 Gateway 모델 문자열을 plain provider/model 형태로 정리 | AI SDK Structured Output |
| Ch3 AI Gateway 확장 | provider routing(order, only), automatic caching, custom reporting의 user/tags 운영 기준 반영 | AI Gateway Provider Options, Custom Reporting |
| Ch4/Ch15~20 Workflow 예제 정정 | 구 Workflow 컨텍스트 예제를 WDK의 "use workflow", "use step", defineHook 패턴으로 교체 | Workflows Docs, Workflow SDK |
| Ch5 Sandbox 확장 | Sandbox.create, runCommand, network policy, custom tags 기준으로 실행 격리 예제를 수정 | Vercel Sandbox, Sandbox custom tags |
| Ch7 Queues 정정 | 구 큐 인스턴스 예제와 dead-letter 중심 설명을 @vercel/queue의 send, handleCallback, trigger, retry/visibility timeout/expired message 기준으로 교체 | Queues SDK, Queues public beta |
| Ch11 보안 기준선 갱신 | Next.js 16.2.3 이상을 16.2 계열 운영 기준으로 제시하고 CVE-2026-23869를 반영 | Next.js Advisory GHSA-q4gf-8mx6-v5v3 |
| 레퍼런스·검증 리포트 갱신 | 조사 기준일을 2026-05-04로 변경하고 Workflows GA, Sandbox GA/tags Beta, Queues Public Beta 상태를 반영 | 공식 docs/changelog 재확인 |
2026-03-26 — Next.js 16.2, CVE 대응, 에코시스템 업데이트
| 변경 | 내용 | 근거 |
|---|---|---|
| Ch1 플랫폼 아키텍처 확장 | Next.js 16.2.0/16.2.1 주요 기능 반영 (~400% dev 시작, Strict Route Types, 에이전트 DevTools, MCP, SRI), CDN as Universal Proxy 추가 | Next.js 16.2 Blog |
| Ch2 AI SDK 런타임 확장 | AI SDK 6 기반 agent, MCP, typed generation 추적 안내 | AI SDK docs, Chat SDK changelog |
| Ch3 AI Gateway 확장 | MiniMax M2.7 모델 추가 및 신규 모델 도입 체크리스트 | AI Gateway Models and Providers |
| Ch6 MCP 데이터 계층 확장 | next-devtools-mcp (DevTools를 MCP 서버로 노출) 반영 | Next.js 16.2 release |
| Ch11 보안·거버넌스 확장 | 2026년 3월 Next.js security advisory 항목(CVE-2026-27977~27980) 추적 | Next.js Security Advisories |
| Ch13 배포 전략 확장 | Vercel CLI v50.37.1 AI 에이전트 플러그인 자동 설치, AGENTS.md/CLAUDE.md 프롬프트 반영 | Vercel CLI changelog |
| Ch17 코딩 오케스트레이션 확장 | AGENTS.md 기본 생성, 에이전트 DevTools(next-browser), next-devtools-mcp 활용 패턴 추가 | Next.js 16.2 release |
| 레퍼런스 확장 | Security 영역 추가, Next.js 16.2/AI SDK 6 블로그 추가 | 근거 추적 |
| 기준선 갱신 | 기준일을 2026-03-11에서 2026-03-26으로 변경 | 콘텐츠 최신화 |
2026-03-11 — 완전판 확장
| 변경 | 내용 | 근거 |
|---|---|---|
| 구조 재편 | 6파트 20챕터 + 부록 4개로 확장, 레거시 허브 페이지 제거 | 실전 운영 완전판 목표 |
| Ch7 신규 | Queues & 비동기 작업 관리 추가 | Queues Docs |
| Ch8 신규 | 프롬프트 엔지니어링 & 가드레일 추가 | AI SDK Structured Output |
| Ch9 신규 | RAG & 검색 증강 생성 추가 | AI SDK Embeddings |
| Ch13 신규 | 배포 전략 & AI CI/CD 추가 | Vercel Deployments |
| Ch20 신규 | 멀티 에이전트 아키텍처 추가 | AI SDK Subagents |
| 부록 신규 | 마이그레이션 가이드 추가 (LangChain/LangGraph/커스텀) | AI SDK Docs |
| 파트 재구성 | 프롬프트 & 품질 파트 신설, 오케스트레이션 패턴 파트 분리 | 주제별 탐색 용이성 개선 |
| 플랫폼 운영식 확장 | Async Plane(Queues) 추가 | Queues의 독립 계층 역할 반영 |
| 검증 리포트 확장 | 신규 6챕터 검증 결과, 추론 문장 유형 추가 | 내부 정합성 검토 |
2026-03-10 — 초판
| 변경 | 내용 | 근거 |
|---|---|---|
| 초판 작성 | Vercel 엔터프라이즈 AI 플랫폼 핸드북 신규 추가 | AI SDK docs, Vercel docs, Vercel blog |
| AI SDK 반영 | AI SDK 6 기준의 agent, tool, MCP, telemetry 구조 반영 | AI SDK 6, AI SDK Docs |
| Workflow 반영 | 장기 실행, 승인, 이벤트 재개 중심 구조 반영 | Workflow Docs |
| AI Gateway 반영 | Gateway 제어면, BYOK, ZDR, provider policy 반영 | AI Gateway Docs |
| Sandbox 반영 | 격리 실행 계층과 피해 반경 제한 설계 반영 | Vercel Sandbox Docs |