本文へスキップ
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:ドシエ型の質問、または同じ種類のドキュメントの一覧。範囲内で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

    回答のテキスト内での部分の位置(UTF-16。JavaScriptの文字列と同じ):数値と月。

  • 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