Объекты
AnswerResponse
Ответ ассистента (POST /v1/ask, POST /v1/chat без потоковой передачи и событие done потока). Есть несколько форм: обычный ответ; «нет документов» (empty: no_hits, без provenance); отказ по теме с ограниченным доступом (empty: restricted с restricted); и отказ ограничителя (empty: guardrail с guardrail, где текст — стандартное сообщение об отказе организации). У ответа из кеша есть cached: true и cache_hit (точный повтор или ответ на похожий вопрос). У ответа только по подтверждённым карточкам (VERIFIED_ONLY) есть verified_only: true.
Поля
answerstringобязательноquestion_idintegerобязательноquerystringcollectionstringобязательноprovenancearray of NumberProvenanceemptystringДопустимые значения:
no_hitsrestrictedguardrailno_data_for_periodbasisAnswerBasisverificationAnswerVerificationalt_periodsarray of AnswerAltPerioditems ≤ 6
drilldownarray of AnswerDrilldownitems ≤ 20
restrictedRestrictedInfoguardrailGuardrailVerdictverified_onlybooleancachedbooleancache_hitAnswerCacheHitout_of_scopeAnswerOutOfScopeattachmentsarray of Attachmentexport_errorstringtoolsstring | nullПочему для этого ответа использовались инструменты:
request(явно попросили);compare,compute,action(исходя из вопроса);needs_calc(нужен расчёт по таблицам);summary(обзор коллекции или документов);mcp(организация подключила внешние серверы MCP).Допустимые значения:
requestcomparecomputeactionneeds_calcsummarymcpnulltool_callsarray of ToolCallInfocalculationsarray of Calculationpending_actionsarray of PendingActionconversation_idstringТолько для
POST /v1/chatс беседой.answer_idstringID объекта ответа.
Используется в
- POST
/v1/askПолучить ответ ассистента без потоковой передачи - POST
/v1/chatПолучать ответ ассистента потоком (SSE)