Objectes
AnswerResponse
Resposta de l’assistent (POST /v1/ask, POST /v1/chat sense transmissió en temps real i l’esdeveniment done del flux). Hi ha diverses formes: una resposta normal; «cap document» (empty: no_hits, sense provenance); una negativa sobre un tema restringit (empty: restricted amb restricted); i una negativa per una regla de protecció (empty: guardrail amb guardrail, on el text és el missatge de negativa estàndard de l’organització). Una resposta de la memòria cau té cached: true i cache_hit (una repetició exacta o una resposta a una pregunta semblant). Una resposta basada només en entrades verificades (VERIFIED_ONLY) té verified_only: true.
Camps
answerstringobligatoriquestion_idintegerobligatoriquerystringcollectionstringobligatoriprovenancearray of NumberProvenanceemptystringValors permesos:
no_hitsrestrictedguardrailno_data_for_periodbasisAnswerBasisverificationAnswerVerificationalt_periodsarray of AnswerAltPerioditems ≤ 6
drilldownarray of AnswerDrilldownitems ≤ 20
restrictedRestrictedInfoguardrailGuardrailVerdictverified_onlybooleancachedbooleancache_hitAnswerCacheHitout_of_scopeAnswerOutOfScopeattachmentsarray of Attachmentexport_errorstringtoolsstring | nullPer què s’han fet servir eines per a aquesta resposta:
request(s’ha demanat explícitament);compare,compute,action(segons la pregunta);needs_calc(cal un càlcul sobre taules);summary(una visió general d’una col·lecció o de documents);mcp(l’organització ha connectat servidors MCP externs).Valors permesos:
requestcomparecomputeactionneeds_calcsummarymcpnulltool_callsarray of ToolCallInfocalculationsarray of Calculationpending_actionsarray of PendingActionconversation_idstringNomés per a
POST /v1/chatamb una conversa.answer_idstringID de l’objecte de la resposta.
S’usa a
- POST
/v1/askObtenir una resposta de l’assistent sense transmissió en temps real - POST
/v1/chatTransmetre en temps real una resposta de l’assistent (SSE)