본문으로 건너뛰기
Sursa Developers

객체

AnswerWarning

답변에 첨부된 경고. kind 값은 늘어날 수 있으므로 알 수 없는 종류는 일반 메시지로 표시하세요. 종류:
- chart_unavailable, chart_type_changed, chart_axis_categorical, tool_not_allowed, tool_failed, table_query_failed(답변의 표 조회가 실패함), truncated. 이 유형에는 reason 값이 없어요.

- answer_mismatch_data: 답변에서 어떤 달 옆에 있는 숫자가 그 달의 차트 데이터와 달라요(reason: period_value, period_missing, total_as_period, period_part). 또는 숫자가 답변 데이터에 없어요(reason: number_not_in_data). 또는 개요 답변이 문서 목록에 없고 출처 링크도 없는 문서를 언급해요(reason: document_not_in_list). 또는 숫자가 데이터에 있지만 다른 통화예요(reason: currency_mismatch, 필드 number, currency, currencies 포함). 필드: text, expected, spans.

- answer_source_ambiguous: 같은 기간에 대한 비슷한 표 여러 개에서 데이터가 나왔는데, 질문은 이 표들을 합치라고 하지 않았어요(text 값에 표 목록이 있어요).

- answer_no_data_basis: 월별 숫자가 있는 답변에 표 데이터가 없어서 숫자를 확인하지 못했어요.

- currency_missing: 데이터에 통화가 여러 개 있는데 금액 데이터에서 나온 숫자에 통화가 없어요(text, number, spans, currencies).

- mixed_currency_sum: 답변의 숫자가 서로 다른 통화로 된 값의 합과 같아요(text, number, spans, currencies).

- access_limited: 사용자의 접근 권한 때문에 일부 결과가 제외되어 답변이 불완전할 수 있어요(데이터 필드 없음).

- fx_rate_stale: 환산에 출처의 최신성 기준보다 오래된 환율을 썼어요(rate_date, currencies).

- fx_rate_missing: 답변의 금액이 환산되지 않았어요. reason 값은 no_rate_on_date(허용 오차 안에서 금액 행의 날짜에 맞는 환율이 없음. 허용 오차는 7일, 수동으로 업로드한 환율은 31일) 또는 no_rate(그 통화 쌍의 환율이 아예 없음)예요. currencies 값은 환율이 없는 통화 목록이에요. text 값은 통화 쌍과 날짜가 담긴 영어 대체 텍스트로, 예를 들면 “RUB → USD on 2026-03-04, 2026-03-05”이고, 쌍이 여러 개면 “; ”로 구분해요.

- restricted_unverified: 제한된 주제에 대한 질문이에요. 관련성 확인 없이는 발췌문을 보여 주지 않아요(데이터 필드 없음).

- enrichment_pending: 질문 범위에 아직 처리 중인 문서가 있어 그 문서의 필드와 재무 기록이 준비되지 않았어요. reason 값은 documents(금액에 대한 질문이거나 표에서 나온 답변이라 합계가 불완전할 수 있음) 또는 document(아직 처리 중이거나 처리하지 못한 특정 문서에 대한 질문)예요. pending 값은 처리 중인 문서 수이고, card_ids 값은 그중 사용자가 볼 수 있는 문서예요(최대 20개). failed 값은 처리하지 못한 문서 수이고, failed_card_ids 값은 그중 볼 수 있는 문서예요(최대 20개).

- partial_coverage: 관련 문서 모음(dossier) 질문 또는 한 유형의 문서 목록이에요. 범위에서 문서 found개를 찾았지만 답변에는 shown < found개만 있어서 답변이 불완전할 수 있어요.

- reconcile_unconfirmed: 대조 질문에 답변이 “일치해요”라고 했지만, 서로 다른 두 문서에서 그 금액을 찾지 못했어요(text 값은 답변 언어로 두 출처의 금액을 적은 메모예요).

클라이언트는 kind, reason, 데이터 필드를 바탕으로 화면 언어로 사용자에게 보여 줄 텍스트를 만들어요. access_limited, restricted_unverified, fx_rate_missing의 text 값과 expected 값은 답변 언어나 영어로 된 대체 텍스트예요.

필드

  • kindstring필수
  • reasonstring

    answer_mismatch_data: 사유 코드(period_value, period_missing, total_as_period, period_part, number_not_in_data, document_not_in_list, currency_mismatch). chart_axis_categorical: unparsed_periods. tool_failed, table_query_failed, truncated: reason 값 없음. currency_missing, mixed_currency_sum: 영어로 된 설명(대체 텍스트. 클라이언트는 currencies 값으로 문구를 만들어요). fx_rate_missing: no_rate_on_date(허용 오차 안에서 행의 날짜에 맞는 환율이 없음) 또는 no_rate(그 통화 쌍의 환율이 아예 없음).

  • requestedstring
  • typestring
  • toolstring

    tool_failed, tool_not_allowed: 도구의 이름.

  • textstring

    경고가 가리키는 답변 부분(answer_mismatch_data: 답변에 쓰인 그대로의 달과 숫자). access_limited, restricted_unverified, fx_rate_missing에서는 대체 텍스트(fx_rate_missing: 환율이 없는 통화 쌍과 날짜).

  • expectedstring

    데이터에 있는 값(answer_mismatch_data: 이 달의 값과 이 값의 달, 또는 합계 값).

  • spansarray of array of integer

    답변 텍스트 안에서 각 부분의 위치(JavaScript 문자열처럼 UTF-16 기준): 숫자와 달.

  • numberstring

    answer_mismatch_data: 답변에 쓰인 그대로의 숫자. period, other_period, values, rows 값과 함께 화면 언어로 경고 텍스트를 만드는 데이터예요.

  • periodstring

    answer_mismatch_data: 답변에 나온 달(YYYY-MM).

  • other_periodstring

    answer_mismatch_data: 값이 그 숫자와 같은 데이터의 달(YYYY-MM).

  • valuesarray of number (double)

    answer_mismatch_data: 그 달의 데이터 값 또는 합계.

  • rowsinteger

    answer_mismatch_data, period_part: 그 달의 합계에 더한 행 수.

  • currencystring

    answer_mismatch_data, currency_mismatch: 답변에서 말한 숫자의 통화(ISO 4217 코드).

  • currenciesarray of string

    데이터의 통화(ISO 4217 코드). currency_mismatch에서는 이 값이 데이터에 나타나는 통화, currency_missing과 mixed_currency_sum에서는 답변 데이터에 있는 금액 값의 통화, fx_rate_stale에서는 오래된 환율로 환산된 통화, fx_rate_missing에서는 환율이 없는 통화예요.

  • rate_datestring (date)

    fx_rate_stale: 오래된 환율의 날짜(YYYY-MM-DD).

  • pendinginteger

    enrichment_pending: 질문 범위에서 아직 처리 중인 문서 수.

  • card_idsarray of string

    enrichment_pending: 이 문서 중 사용자가 볼 수 있는 카드(최대 20개).

  • failedinteger

    enrichment_pending: 질문 범위에서 처리하지 못한 문서 수.

  • failed_card_idsarray of string

    enrichment_pending: 처리하지 못한 문서 중 사용자가 볼 수 있는 카드(최대 20개).

  • foundinteger

    partial_coverage: 질문 범위에서 찾은 해당 묶음의 문서 수.

  • showninteger

    partial_coverage: 찾은 문서 중 답변에 포함된 문서 수.

포함하는 객체

AnswerResponseChatEventDataFeedItemQuestionPayload