`experimental_getBatchResults()`
experimental_getBatchResults()
경고: 배치 지원은 실험적이며 API가 patch 릴리스에서 바뀔 수 있어요.
비동기 배치의 요청들에 대한 종료 결과의 async iterable을 반환해요. 배치 수명주기에 대한 전체 가이드는 Batch를 참고하세요.
import { anthropic } from '@ai-sdk/anthropic';
import { experimental_getBatchResults as getBatchResults } from 'ai';
for await (const item of getBatchResults({ provider: anthropic, batch })) {
if (item.status === 'succeeded') {
console.log(item.id, item.text);
} else {
console.error(item.id, item.error);
}
}
출처: 문서
본문
Import
import { experimental_getBatchResults } from "ai"
API 시그니처 (API Signature)
파라미터 (Parameters)
| 이름 | 타입 | 선택 | 설명 |
|---|---|---|---|
provider |
Experimental_BatchProvider |
선택 | 배치 접근에 사용한 provider. 기본값은 전역 provider, 또는 전역 provider가 없으면 AI Gateway. |
batch |
Experimental_BatchReference |
experimental_startBatch가 반환한 직렬화 가능한 참조. |
|
tools |
ToolSet |
선택 | 배치의 요청에 제공된 클라이언트 정의 도구. 반환된 도구 호출을 검증·정규화하는 데 사용되고, execute 함수는 절대 호출되지 않아요. |
providerOptions |
ProviderOptions |
선택 | 결과 조회용 추가 provider별 옵션. |
maxRetries |
number |
선택 | 결과 조회의 최대 재시도 횟수. 0으로 설정하면 재시도 비활성화. 기본값: 2. |
abortSignal |
AbortSignal |
선택 | 결과 조회를 취소하는 선택적 abort 신호. |
timeout |
number | { totalMs?: number } |
선택 | 결과 조회에 허용되는 최대 시간. |
headers |
Record<string, string | undefined> |
선택 | 요청용 추가 HTTP 헤더. |
반환 (Returns)
succeeded, failed, cancelled 또는 expired 요청 결과의 AsyncIterableStream<Experimental_BatchItemResult>를 반환해요. 스트림을 async iterable이나 ReadableStream로 소비할 수 있어요.
성공 항목은 id, status: 'succeeded', text, 정규화된 content(텍스트, 추론, 소스, 파일, 도구 호출, 도구 결과 포함), finishReason, usage, 선택 응답·provider 메타데이터를 담아요. text는 텍스트 파트의 연결이며 결과에 텍스트 파트가 없으면 빈 문자열일 수 있어요.
실패·취소·만료 항목은 요청 id, 종료 상태, 선택 오류 세부 정보를 담아요.