Oggetti
AnswerResponse
La risposta dell’assistente (POST /v1/ask, POST /v1/chat senza streaming e l’evento done dello stream). Esistono varie forme: una risposta normale; “nessun documento” (empty: no_hits, senza provenance); un rifiuto su un argomento soggetto a restrizioni (empty: restricted con restricted); e un rifiuto per una regola di protezione (empty: guardrail con guardrail, dove il testo è il messaggio di rifiuto standard dell’organizzazione). Una risposta dalla cache ha cached: true e cache_hit (una ripetizione esatta o una risposta a una domanda simile). Una risposta basata solo su schede verificate (VERIFIED_ONLY) ha verified_only: true.
Campi
answerstringobbligatorioquestion_idintegerobbligatorioquerystringcollectionstringobbligatorioprovenancearray of NumberProvenanceemptystringValori ammessi:
no_hitsrestrictedguardrailno_data_for_periodbasisAnswerBasisverificationAnswerVerificationalt_periodsarray of AnswerAltPerioditems ≤ 6
drilldownarray of AnswerDrilldownitems ≤ 20
restrictedRestrictedInfoguardrailGuardrailVerdictverified_onlybooleancachedbooleancache_hitAnswerCacheHitout_of_scopeAnswerOutOfScopeattachmentsarray of Attachmentexport_errorstringtoolsstring | nullPerché sono stati usati strumenti per questa risposta:
request(richiesti esplicitamente);compare,compute,action(in base alla domanda);needs_calc(serve un calcolo sulle tabelle);summary(una panoramica di una raccolta o di documenti);mcp(l’organizzazione ha collegato server MCP esterni).Valori ammessi:
requestcomparecomputeactionneeds_calcsummarymcpnulltool_callsarray of ToolCallInfocalculationsarray of Calculationpending_actionsarray of PendingActionconversation_idstringSolo per
POST /v1/chatcon una conversazione.answer_idstringID dell’oggetto della risposta.
Usato da
- POST
/v1/askOttenere una risposta dell’assistente senza streaming - POST
/v1/chatTrasmettere in streaming una risposta dell’assistente (SSE)