ToolChoiceViolationError

ToolChoiceViolationError

이 오류는 generateText 응답이 강제된 도구 선택을 충족하지 못할 때 발생해요. toolChoice가 'required'로 설정됐는데 응답에 구조화된 도구 호출이 없거나, 특정하게 선택된 도구가 호출되지 않았을 때 throw돼요.

이 오류는 텍스트나 추론을 자동으로 실행 가능한 도구 호출로 해석하지 않아요. content를 검사해서 옵트인 복구를 구현할 수 있어요. 복구된 호출을 실행하기 전에 스키마 검증을 포함하세요.

출처: 문서

본문

속성 (Properties)

  • toolChoice: 응답이 충족하지 못한 유효한 도구 선택
  • finishReason: 모델이 응답 생성을 마친 이유
  • provider: 응답을 반환한 provider
  • modelId: 응답을 반환한 모델
  • content: 모델이 반환한 정규화된 콘텐츠
  • message: 오류 메시지

이 오류 확인하기 (Checking for this Error)

오류가 ToolChoiceViolationError 인스턴스인지 다음과 같이 확인할 수 있어요:

import { ToolChoiceViolationError } from 'ai';

if (ToolChoiceViolationError.isInstance(error)) {
  const serializedCall = error.content.find(part => part.type === 'text')?.text;

  // Parse and validate serializedCall before treating it as a tool call.
}

더 알아보기 (Learn more)