문제 해결
일반적인 오류와 트레이스를 읽어 라우팅 결정을 디버그하는 방법.
모든 모델이 하한선을 통과하지 못함
필터가 모든 후보를 제외했으므로 요청이 조용한 다운그레이드 대신 명시적으로 실패합니다(
no_candidates). cmp 한도나 하드 ["is", …]를 완화하고, /x/rank를 실행하여 어떤 규칙이 각 모델을 탈락시켰는지 확인하세요.알 수 없는 필드 또는 연산자
허가 단계에서 호스트가 제공하지 않는 필드 또는 인터프리터가 알지 못하는 연산자를 지명하는 항(term)을 거부합니다(
invalid_policy). GET /x/fields에서 실제 필드를 사용하세요. 예: price가 아닌 price_out.제공자 키 누락
선택된 모델의 제공자가 호스트에 구성되어 있지 않아 업스트림 호출 인증이 불가능합니다. 호스트에 제공자 키를 추가하세요. 추론은 항상 자신의 계정을 통해 실행됩니다.
제공자 타임아웃 또는 오류
선택된 모델에서 오류가 발생하거나 타임아웃이 발생했습니다. 라우터는 다음 통과 후보로 폴백하고 트레이스에 전환을 기록합니다. 모든 후보가 실패하면 요청 자체가 오류를 반환합니다.
["top_k", N, ["argmax"]]로 캐스케이드를 확장하세요.워크플로우가 제한 초과
워크플로우는 제한 내에서만 허가됩니다(
≤ 256 노드, 진입 차수 ≤ 32). 그 이상은 실행 전에 거부됩니다. 워크플로우를 분리하세요.드라이런 통과, 라이브 호출 실패
/x/rank와 /x/*/normalize는 항(term)을 허가하고 평가하지만 추론은 실행하지 않으므로, 라이브 실패는 제공자/런타임 문제(속도 제한, 타임아웃, 인증)이지 정책 오류가 아닙니다. 실패한 전환에 대해 트레이스의 결정 경로(decision path)를 읽으세요.