الكائنات
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_idstringمعرّف كائن الإجابة.