본문으로 건너뛰기
Sursa Developers

객체

ChatEventError

스트림이 시작된 뒤의 오류. 스트림은 done 이벤트 없이 끝나며, 질문은 기록에 저장되지 않아요. 업데이트를 위해 서버 인스턴스가 멈추면(code = server_restart, retry: true) 답변은 취소된 것으로 표시되고 다시 생성되지 않으므로, 같은 요청을 그대로 다시 보낼 수 있어요.

필드

  • type"error"필수
  • codeChatErrorCode필수
  • messagestring필수
  • retryboolean

    true이면 서버 때문에 답변이 완료되지 않았다는 뜻이며(업데이트를 위해 인스턴스가 멈춤, code = server_restart), 요청을 그대로 반복할 수 있어요. 다른 코드에서는 없어요.

  • answer_idstring

    답변이 이미 생성되었다면 답변 객체의 ID.

  • detailsobject

    세부 정보. sources_inaccessible과 out_of_scope에서는 hidden(사용할 수 없는 출처의 수), can_request(answer_id 값과 함께 POST /v1/access-requests로 접근을 요청할 수 있음), reason(이벤트 필드와 같음)이 있고, out_of_scope에서는 collections(답변이 있는 CollectionRef 목록)도 있어요. assistant.unavailable에서 어시스턴트가 바쁠 때(사유 rate_limited)는 스트림 시작 전의 429 answers.engine_busy 오류처럼 재시도 전 대기 시간(초)인 retry_after 값이 있어요. details에는 오류의 이전 코드가 없어요.

    필드
    • hiddeninteger
    • can_requestboolean
    • reasonstring
    • collectionsarray of CollectionRef
    • retry_afterinteger
  • reasonstring

    화면 언어로 메시지를 보여 주기 위한 사유 코드(값이 늘어날 수 있는 자유 형식 문자열). 어시스턴트 오류 코드: timeout, rate_limited, upstream_unavailable, license_blocked, license_restricted, forbidden, canceled, internal, bad_request, conflict, not_found, too_large, unprocessable, not_implemented, server_restart. Sursa 코드: engine_unavailable(어시스턴트를 사용할 수 없음), engine_closed(어시스턴트의 스트림이 결과 없이 닫힘), sources_inaccessible, server_restart(업데이트를 위해 Sursa 인스턴스가 멈춤), sources_unavailable(삭제되었거나 보관된 출처 때문에 숨겨짐), out_of_scope(선택한 컬렉션 밖에만 출처가 있음), superseded(canceled와 함께: 같은 request_id 값으로 한 재시도가 답변을 대체함), awaiting_classification(문서가 아직 처리 중이라 숨겨짐: 접근 카테고리가 아직 정해지지 않았고, 분류가 끝나면 답변을 볼 수 있으며, 접근을 요청할 수 없으므로 can_request = false). 코드에 따라 메시지를 표시하세요. 알 수 없는 코드는 code 값에 따라 일반 메시지를 표시하세요. message 값은 번역이 없는 클라이언트를 위한 대체 텍스트일 뿐이며, 그 언어는 보장되지 않아요.

포함하는 객체

ChatEvent