검증 리포트
링크, 최신성, 추론 구간, 소스 간 충돌 여부를 점검한 결과를 기록합니다.
공식 migration·limits·runtime 문서와 npm 버전, Gateway 모델 카탈로그를 대조했습니다.
| 검증 항목 | 반영 결과 |
|---|
| 보안·개발 MCP | 9~10월 Next.js advisory의 조건·수정 버전, 16.3+ 지침 관리, SDK MCP client 예제 대조 |
| Runtime | Node.js 24; Next.js 16.3+ Node-only routes/pages |
| SDK | ai 7.0.148; workflow 5.2.3; @ai-sdk/workflow 2.0.80 |
| API | isStepCount; instructions; telemetry integration; stateless streaming |
| Limits | 300s default; 800s / 1800s Beta distinction; 4.5 MB payload |
| Models | Gateway catalog: openai/gpt-6.1-sol; anthropic/claude-sonnet-5.5 |
제품·공식 문서·예제의 정적 대조입니다. 실제 운영 계정이나 Windows 장치, 유료 서비스에서 기능을 실행했다고 간주하지 않습니다.
AI SDK 7 migration · Workflow 5 changes · Functions limits · Node.js versions · Global Config rename.
아래는 이전 검증 당시 기록입니다.
이 리포트는 핸드북 본문이 어떤 기준으로 검증되었는지 기록합니다.
| 항목 | 값 |
|---|
| 확인일 | 2026-05-04 |
| 기준 타임존 | Asia/Seoul |
| 1차 소스 | AI SDK docs, Vercel docs, Vercel blog/changelog |
| 보조 소스 | 공개 X permalink |
| 항목 | 기준 |
|---|
| 링크 검증 | 공식 문서/블로그 링크가 유효한지 확인 |
| 최신성 검토 | 2026-05-04 기준 기능명/상태 점검 |
| 정합성 검토 | 장 간 주장 충돌 여부 점검 |
| 추론 구간 분리 | 공식 문서에 직접 없는 해석을 명시 |
| 항목 | 결과 | 메모 |
|---|
| AI SDK 관련 기능명 | 통과 | Introduction, Agents, Tools, MCP, Telemetry 기준 |
| AI Gateway 기능명 | 통과 | Overview, provider options, custom reporting, BYOK, ZDR 기준 |
| Workflow 용어 | 통과 | Workflow docs 기준 |
| Sandbox 명칭 | 통과 | Vercel Sandbox docs 기준 |
| Queues 기능명 | 통과 | Queues docs 기준 |
| X 보조 근거 | 제한적 사용 | 본문 핵심 근거로 승격하지 않음 |
| 대상 | 상태 | 확인 근거 | 확인 메모 |
|---|
| AI Gateway | 사용 가능 / GA 근거 존재 | AI Gateway docs, GA changelog | docs는 all plans, changelog는 GA 명시 |
| Workflow | GA | Workflows docs, GA blog | 2026-04-16 GA, "use workflow" / "use step" 기준 |
| Vercel Sandbox | GA / tags Beta | Sandbox docs, Sandbox GA, Custom tags | 실행 환경은 GA, custom tags는 Beta |
| AI SDK 6 | 현행 문서 기준 확인 | AI SDK docs, Structured Output | 구조화 출력은 generateText + Output.object() 기준 |
| Queues | Public Beta | Queues docs, Public beta changelog | @vercel/queue, trigger, retry/visibility timeout 기준 |
| 챕터 | 검증 결과 | 메모 |
|---|
| Ch7. Queues & 비동기 작업 | 통과 | Queues docs 기준, Workflow 조합 패턴은 공식 사례 기반 추론 |
| Ch8. 프롬프트 엔지니어링 | 통과 | AI SDK structured output, MCP prompts 기능 기준 |
| Ch9. RAG & 검색 증강 생성 | 통과 | AI SDK embeddings, tools 기능 기준, 운영 패턴은 업계 표준 기반 |
| Ch13. 배포 전략 & AI CI/CD | 통과 | Vercel deployments, preview, rollback docs 기준 |
| Ch20. 멀티 에이전트 아키텍처 | 통과 | AI SDK subagents docs 기준, 패턴 분류는 업계 표준 기반 추론 |
| 부록. 마이그레이션 가이드 | 통과 | AI SDK docs 기준, LangChain/LangGraph 매핑은 공식 API 기반 추론 |
| 영역 | 링크 |
|---|
| AI SDK | Introduction, Agents Overview, Subagents, Telemetry, Embeddings |
| AI Gateway | Overview, Models and Providers, Provider Options, Custom Reporting |
| Workflow | Workflows docs, Workflow SDK, Queues docs |
| Sandbox | Overview, SDK Reference, Custom tags |
| 배포 | Deployments, Preview Deployments, Instant Rollback |
| 운영/사례 | AI SDK 6 blog, Anyone can build agents, How AI Gateway runs on Fluid compute |
| 문장 유형 | 이유 |
|---|
| Gateway를 "운영 정책 중앙화"로 해석한 부분 | 문서 기능 설명을 운영 프레임으로 재구성 |
| Workflow와 Queue의 역할 분리 | 공식 기능 설명을 아키텍처 선택 기준으로 해석 |
| Sandbox를 prompt injection 이후 피해 반경 제한 장치로 강조한 부분 | 문서의 격리 기능을 보안 운영 관점으로 확장 |
| 평가를 운영 루프로 통합한 부분 | observability와 telemetry 기능을 실무 체계로 종합 |
| RAG 파이프라인을 Queues + AI SDK 조합으로 구성한 부분 | 개별 기능을 엔터프라이즈 파이프라인으로 조합 |
| 멀티 에이전트 패턴을 supervisor/pipeline/delegation으로 분류 | AI SDK subagents 기능을 업계 표준 패턴으로 매핑 |
| 마이그레이션 경로를 Gateway → SDK → Workflow 순서로 제시 | 제품 의존 관계를 기반으로 한 전환 순서 추론 |
| AI CI/CD를 eval → preview → canary → rollout으로 단계화 | Vercel 배포 기능을 AI 품질 관리 파이프라인으로 해석 |
| 비교 | 결과 |
|---|
| 공식 문서 vs 블로그 | 중대한 충돌 없음 |
| 공식 문서 vs 공개 X 신호 | X는 보조 수준으로만 반영 |
| 장 간 설명 | 중대한 모순 없음 |
| 기존 챕터 vs 신규 챕터 | 일관성 유지 |
- AI SDK major update 시 agent/tool/MCP 서술을 재검토합니다.
- Workflow/Queues 상태 변경 시 beta/GA 표현을 재확인합니다.
- AI Gateway의 provider, caching, budgets 표현은 docs 변경 시 재검토합니다.
- Sandbox와 security 관련 기능은 보안 문서 변경 시 다시 확인합니다.
- RAG 관련 기능(embeddings, structured output)은 AI SDK 변경 시 재검토합니다.
- 배포 관련 기능(preview, rollback)은 Vercel platform 변경 시 재확인합니다.