Vercel AI SDK 3.3

Vercel AI SDK 3.3이 출시되어 OpenTelemetry 기반 트레이싱, `useChat`의 멀티모달 파일 첨부, 구조화 객체 스트리밍을 위한 `useObject` 훅, 확장된 LLM 설정 옵션이 추가됐다. AWS Bedrock과 Chrome AI 프로바이더도 새로 지원된다.

핵심 포인트

OpenTelemetry 트레이싱(실험적): `experimental_telemetry` 옵션으로 SDK 함수 호출 계측, Datadog·Sentry·LangFuse 등 연동
`useChat`의 `experimental_attachments`: FileList 또는 URL 배열로 이미지·PDF 등 파일 첨부 메시지 전송
`useObject` 훅(실험적): `streamObject`와 연동해 구조화 JSON 객체를 클라이언트에 실시간 스트리밍 렌더링
JSON Schema 직접 지원: Zod 없이 `jsonSchema` 함수로 동적 도구·구조화 생성 스키마 정의 가능
`stopSequences` 옵션: `streamText`/`generateText`에 텍스트 종료 시퀀스 지정 가능
커스텀 헤더(`headers` 옵션): 트레이싱 정보 전달, 프로바이더 베타 기능 활성화 등에 활용

상세 정리

OTel 트레이싱: `@vercel/otel`로 설정, `functionId`와 `metadata`로 호출 위치·컨텍스트 기록
트레이싱 분석 도구: Datadog, Sentry, Axiom(Vercel 통합) 또는 LangFuse, Braintrust, LangSmith
FileList 첨부: `<input type="file">` 선택 파일을 `handleSubmit`의 `experimental_attachments`로 전달, SDK가 데이터 URL로 자동 변환
URL 첨부: `Attachment[]` 배열에 name·contentType·url 지정으로 외부 리소스 첨부
`useObject` 패턴: 서버의 `streamObject` + Zod 스키마 공유 + 클라이언트의 `useObject` 훅으로 실시간 부분 객체 렌더링
부분 객체 렌더링: `?.`와 `??`로 스트리밍 중 undefined 속성 안전하게 처리
JSON Schema: `jsonSchema({ ... }, { validate: fn })` 형태로 동적 도구 정의
AWS Bedrock 프로바이더: `@ai-sdk/amazon-bedrock` 패키지로 공식 지원 추가
Chrome AI(커뮤니티): 브라우저 내장 AI 모델 활용 가능

왜 읽나`useObject`로 AI 응답을 구조화된 형태로 실시간 스트리밍하는 패턴과 OTel 트레이싱 설정은 프로덕션 AI 앱의 UX와 관찰 가능성을 동시에 높이는 실용적인 구현 방법이다.

Vercel Blog 블로그

원문은 여기서 이어서 읽을 수 있어요

원문 읽기

읽음 (0)

·takedown 요청

Vercel AI SDK 3.3

이 글과 비슷한

DS와 MLE가 함께 일하는 법

AI와 개발하기: 숨은 결정을 드러내기

Grafana에서 자연어로 장애 원인을 분석하기: LLM 에이전트 기반 SRELens 개발기