이번 소식
Cloudflare가 2026년 10월 21일 Agents SDK의 createAI를 발표했습니다. AI 모델을 애플리케이션에 연결하는 기존 workers-ai-provider와 ai-gateway-provider의 역할을 통합합니다. 두 기존 패키지는 새 기능 추가가 멈추고 사용 중단 권고(deprecated) 대상으로 표시됐습니다. 즉시 작동이 중단된다는 공지는 아닙니다.
달라진 점
AI SDK와 Pi AI에 각각 제공되는 createAI는 Workers AI 모델, AI Gateway의 모델 목록과 동적 경로를 같은 방식으로 선택할 수 있게 합니다. 동적 경로는 Gateway에서 정한 규칙에 따라 모델을 고르는 연결 방식입니다. 모델 공급사의 패키지로 만든 모델 객체도 사용할 수 있습니다.
캐시와 기록, 재시도 등의 Gateway 옵션과 함께, 첫 모델이 출력을 내기 전에 실패하면 다른 모델을 차례로 시도하는 대체 호출을 지원합니다. 응답 도중 연결이 끊겼을 때 이어 받는 기능은 AI 바인딩을 통해 호출한 Gateway 목록 모델이나 동적 경로에 한정됩니다.
어떤 점이 달라지나요?
Cloudflare 모델과 다른 공급사의 모델을 함께 쓰는 개발자는 연결 설정을 createAI 중심으로 정리할 수 있습니다. Worker 내부에서는 AI 서비스 연결 설정인 바인딩을 사용하고, Worker 밖이나 다른 계정의 Gateway에는 계정 ID와 API 토큰으로 연결합니다. 이는 모델을 무료로 쓰거나 기존 코드가 자동으로 이전된다는 뜻은 아닙니다.
사용 전 확인할 점
공식 모델 제공자 문서는 현재 베타이며 작은 버전 업데이트에서도 API가 바뀔 수 있다고 안내합니다. AI SDK용 제공자는 AI SDK v7을 기준으로 설명합니다. AI Search는 별도의 ai-search-provider를 사용해야 합니다. 기존 패키지는 편한 시점에 이전하도록 안내하며, 이번 발표에서 강제 이전 기한은 확인되지 않았습니다.
발표일은 공식 변경 기록의 2026년 10월 21일입니다. 정확한 발표 시각과 시간대는 이번 확인에서 확인하지 못했습니다.
새 글 받아보기
RSS 리더에서 BlogFlow의 새 글을 확인할 수 있습니다.