Chuyển tới nội dung
Sursa Developers

Đối tượng

AnswerWarning

Cảnh báo gắn với một câu trả lời. kind có thể mở rộng: hãy hiển thị loại không xác định bằng một thông báo chung. Các loại:
- chart_unavailable, chart_type_changed, chart_axis_categorical, tool_not_allowed, tool_failed, table_query_failed (một truy vấn bảng của câu trả lời bị lỗi), truncated. Các loại này không có reason.

- answer_mismatch_data: một con số trong câu trả lời đứng cạnh một tháng khác với dữ liệu biểu đồ của tháng đó (reason: period_value, period_missing, total_as_period, period_part); hoặc con số không có trong dữ liệu của câu trả lời (reason: number_not_in_data); hoặc câu trả lời tổng quan nêu tên một tài liệu không có trong danh sách tài liệu và không có liên kết nguồn (reason: document_not_in_list); hoặc con số có trong dữ liệu nhưng ở tiền tệ khác (reason: currency_mismatch, với các trường number, currency, currencies). Trường: text, expected, spans.

- answer_source_ambiguous: dữ liệu đến từ nhiều bảng tương tự cho cùng một kỳ, và câu hỏi không yêu cầu kết hợp chúng (text liệt kê các bảng).

- answer_no_data_basis: câu trả lời có số liệu theo tháng nhưng không có dữ liệu bảng, nên các con số chưa được kiểm tra.

- currency_missing: một con số từ dữ liệu tiền tệ không có đơn vị tiền tệ, dù dữ liệu có nhiều tiền tệ (text, number, spans, currencies).

- mixed_currency_sum: một con số trong câu trả lời bằng tổng các giá trị ở các tiền tệ khác nhau (text, number, spans, currencies).

- access_limited: một số kết quả bị loại do quyền truy cập của người dùng, nên câu trả lời có thể chưa đầy đủ (không có trường dữ liệu).

- fx_rate_stale: việc quy đổi đã dùng tỷ giá cũ hơn ngưỡng độ mới của nguồn cung cấp tỷ giá (rate_date, currencies).

- fx_rate_missing: một số tiền trong câu trả lời chưa được quy đổi. reason là no_rate_on_date (không có tỷ giá cho ngày của dòng chứa số tiền trong phạm vi dung sai: 7 ngày, hoặc 31 ngày với tỷ giá tải lên thủ công) hoặc no_rate (hoàn toàn không có tỷ giá cho cặp tiền). currencies liệt kê các tiền tệ không có tỷ giá. text là văn bản dự phòng bằng tiếng Anh kèm các cặp tiền và ngày, ví dụ “RUB → USD on 2026-03-04, 2026-03-05”, nhiều cặp được phân tách bằng “; ”.

- restricted_unverified: câu hỏi về chủ đề bị hạn chế. Đoạn trích không được hiển thị nếu chưa kiểm tra mức độ liên quan (không có trường dữ liệu).

- enrichment_pending: phạm vi câu hỏi có tài liệu vẫn đang được xử lý, nên các trường và bản ghi tài chính của chúng chưa sẵn sàng. reason là documents (câu hỏi về số tiền hoặc câu trả lời từ bảng, nên tổng có thể chưa đầy đủ) hoặc document (câu hỏi về một tài liệu cụ thể đang được xử lý hoặc không thể xử lý). pending là số tài liệu đang được xử lý, còn card_ids là những tài liệu người dùng nhìn thấy (tối đa 20). failed là số tài liệu không thể xử lý, còn failed_card_ids là những tài liệu nhìn thấy được (tối đa 20).

- partial_coverage: câu hỏi tổng hợp hồ sơ hoặc danh sách tài liệu cùng một loại. Tìm thấy found tài liệu trong phạm vi, và chỉ shown < found tài liệu có trong câu trả lời, nên câu trả lời có thể chưa đầy đủ.

- reconcile_unconfirmed: câu trả lời nói “khớp” cho câu hỏi đối chiếu, nhưng số tiền không được tìm thấy trong hai tài liệu khác nhau (text là ghi chú kèm số tiền của cả hai nguồn bằng ngôn ngữ của câu trả lời).

Client tạo văn bản cho người dùng từ kind, reason và các trường dữ liệu bằng ngôn ngữ giao diện. text của access_limited, restricted_unverified và fx_rate_missing, cùng với expected, là văn bản dự phòng bằng ngôn ngữ của câu trả lời hoặc bằng tiếng Anh.

Trường

  • kindstringbắt buộc
  • reasonstring

    answer_mismatch_data: mã lý do (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: không có reason. currency_missing, mixed_currency_sum: lời giải thích bằng tiếng Anh (dự phòng; client tạo câu từ currencies). fx_rate_missing: no_rate_on_date (không có tỷ giá cho ngày của dòng trong phạm vi dung sai) hoặc no_rate (hoàn toàn không có tỷ giá cho cặp tiền).

  • requestedstring
  • typestring
  • toolstring

    tool_failed, tool_not_allowed: tên công cụ.

  • textstring

    Phần của câu trả lời mà cảnh báo nhắc tới (answer_mismatch_data: tháng và con số như được viết trong câu trả lời). Với access_limited, restricted_unverified và fx_rate_missing, là văn bản dự phòng (fx_rate_missing: các cặp tiền và ngày không có tỷ giá).

  • expectedstring

    Dữ liệu nói gì (answer_mismatch_data: giá trị của tháng này và tháng của giá trị này, hoặc giá trị của tổng).

  • spansarray of array of integer

    Vị trí của các phần trong nội dung câu trả lời (UTF-16, như trong chuỗi JavaScript): con số và tháng.

  • numberstring

    answer_mismatch_data: con số như được viết trong câu trả lời. Cùng với period, other_period, values và rows, đây là dữ liệu cho văn bản cảnh báo bằng ngôn ngữ giao diện.

  • periodstring

    answer_mismatch_data: tháng từ câu trả lời (YYYY-MM).

  • other_periodstring

    answer_mismatch_data: tháng của dữ liệu có giá trị bằng con số (YYYY-MM).

  • valuesarray of number (double)

    answer_mismatch_data: các giá trị dữ liệu của tháng, hoặc tổng.

  • rowsinteger

    answer_mismatch_data, period_part: số dòng được cộng vào tổng của tháng.

  • currencystring

    answer_mismatch_data, currency_mismatch: tiền tệ của con số như được nêu trong câu trả lời (mã ISO 4217).

  • currenciesarray of string

    Tiền tệ của dữ liệu (mã ISO 4217). Với currency_mismatch, là các tiền tệ mà giá trị này xuất hiện trong dữ liệu; với currency_missing và mixed_currency_sum, là tiền tệ của các giá trị tiền trong dữ liệu của câu trả lời; với fx_rate_stale, là các tiền tệ được quy đổi theo tỷ giá đã cũ; với fx_rate_missing, là các tiền tệ không có tỷ giá.

  • rate_datestring (date)

    fx_rate_stale: ngày của tỷ giá đã cũ (YYYY-MM-DD).

  • pendinginteger

    enrichment_pending: số tài liệu trong phạm vi câu hỏi vẫn đang được xử lý.

  • card_idsarray of string

    enrichment_pending: các thẻ của những tài liệu này mà người dùng nhìn thấy (tối đa 20).

  • failedinteger

    enrichment_pending: số tài liệu trong phạm vi câu hỏi không thể xử lý.

  • failed_card_idsarray of string

    enrichment_pending: các thẻ của những tài liệu không thể xử lý mà người dùng nhìn thấy (tối đa 20).

  • foundinteger

    partial_coverage: số tài liệu của tập được tìm thấy trong phạm vi câu hỏi.

  • showninteger

    partial_coverage: số tài liệu đã tìm thấy có trong câu trả lời.

Thuộc

AnswerResponseChatEventDataFeedItemQuestionPayload