Перейти до вмісту
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 і полів даних мовою інтерфейсу. text для access_limited, restricted_unverified і fx_rate_missing, а також 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