تفضيلات الخصوصية

الوظائف الضرورية

مطلوبة للأمان ووظائف الموقع الأساسية.

مفعّلة دائمًا

تحليلات الاستخدام الاختيارية

هل تسمح بتحليلات استخدام PostHog؟ يمكنك تغيير اختيارك في أي وقت من التذييل.

السماح أيضاً بتسجيل الجلسات لإعادة عرضها على هذا الموقع العام

تُظهر إعادة عرض الجلسات الصفحات العامة والتفاعلات، مع إخفاء المدخلات والمحتوى الخاص. إعادة عرض الجلسات في التطبيق خيار مستقل.

يتطلب التحليلات؛ إعادة تشغيل الموقع متوقفة افتراضيًا.

كيف نستخدم البيانات

السماح بالتحليلات يتيح لـ PostHog مشاركة ملف تعريف ارتباط مجهول الهوية بين هذا الموقع وتطبيقنا، مع استخدام تخزين المتصفح المحلي في كل موقع. بموافقتك، يمكن ربط زيارة جرى التحقّق منها في علامة التبويب نفسها بحسابك الجديد بعد تأكيد التسجيل.

تُظهر إعادة عرض الجلسات الصفحات العامة والتفاعلات، مع إخفاء المدخلات والمحتوى الخاص. إعادة عرض الجلسات في التطبيق خيار مستقل.

إعادة عرض جلسات الموقع معطّلة افتراضياً. أزل تحديدها واحفظ لإيقاف التسجيلات الجديدة؛ لا يغيّر هذا الاختيار إعدادات الحساب.

إشعار الخصوصية وقياس Cloudflare التجميعي المستقل.

لا تفعّل تحليلات المتصفح تحليلات الحساب.

SosoAPI
ابدأ مجانًا
AR
EN繁中繁體中文（台灣）简体中文日本語한국어DeutschFrançaisEspañolPortuguês (Brasil)العربيةעבריתNederlandsहिन्दीBahasa IndonesiaNorsk bokmålSvenskaMagyar
ابدأ مجانًا

يُحمّل البحث عند استخدامه فقط. تصفّح جميع الفئات أدناه.

أداة MCP

طلب تحليل بحث موثق بالمراجع

sosoapi_research_assistant_request

طلب تحليل محدود موثق بالمراجع مع processing_intent صريح؛ قد لا يكون متاحًا. لا تعيد عملية التغيير نفسها التوليد مطلقًا. يتطلب agent:research.

اقرأ بصيغة Markdown

الملفات التعريفية ووسائل النقل

الملفات التعريفية: full · وسائل النقل: stdio, http

اختر core أو full للأدوات التي يراها عميلك؛ لا يغيّر ذلك أذوناته. يحتاج رفع الملفات المحلية stdio ولا يتاح بـ HTTP. اضبط SOSOAPI_OUTPUT_SCHEMAS=1 لمخططات المخرجات بالاكتشاف. النتائج منظّمة بهذا الإعداد أوبدونه.

الأذونات والآثار الجانبية

تساعد الشروح العملاء على وصف الأداة. يظل كل استدعاء يفحص مصادقة المستخدم ودوره ووصوله إلى المورد وتفويض الإمكانات.

{
  "readOnlyHint": false,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": true
}
  • /research-api/assistant/request: agent:research · تشغيل مجال مقبول أو عدم توفر صريح؛ لا يحتوي على إجابة إلا تشغيل مكتمل ومصرح به

حقول الإدخال

تعني «مطلوب» داخل الكائن الأب والفرع المختار. الحقل الابن المطلوب لا يجعل الأب الاختياري مطلوباً. نُسخت القواعد وأسماء الحقول أدناه من العقد.

حقول الإدخال
الحقل / الفرعالنوع / مطلوبالقيود
$objectمطلوب في العنصر الأب
  • additionalProperties: false
workspace_idstringمطلوب في العنصر الأب
  • format: "uuid"
mutation_idstringمطلوب في العنصر الأب
  • format: "uuid"
conversation_idstringمطلوب في العنصر الأب
  • format: "uuid"
expected_revisionintegerمطلوب في العنصر الأب
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
parent_message_idstring | nullمطلوب في العنصر الأب—
parent_message_idanyOf 1stringمطلوب في العنصر الأب
  • format: "uuid"
parent_message_idanyOf 2nullمطلوب في العنصر الأب—
questionstringمطلوب في العنصر الأب
  • minLength: 1
  • maxLength: 2000
request_kindstringمطلوب في العنصر الأب
  • enum: ["question","overview","themes","audiences","sentiment","query_suggestions"]
processing_intentstringمطلوب في العنصر الأب
  • enum: ["google_gemini_selected_context"]
مخطط JSON Schema الكامل
{
  "type": "object",
  "properties": {
    "workspace_id": {
      "type": "string",
      "format": "uuid"
    },
    "mutation_id": {
      "type": "string",
      "format": "uuid"
    },
    "conversation_id": {
      "type": "string",
      "format": "uuid"
    },
    "expected_revision": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "parent_message_id": {
      "anyOf": [
        {
          "type": "string",
          "format": "uuid"
        },
        {
          "type": "null"
        }
      ]
    },
    "question": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000
    },
    "request_kind": {
      "type": "string",
      "enum": [
        "question",
        "overview",
        "themes",
        "audiences",
        "sentiment",
        "query_suggestions"
      ]
    },
    "processing_intent": {
      "type": "string",
      "enum": [
        "google_gemini_selected_context"
      ]
    }
  },
  "required": [
    "workspace_id",
    "mutation_id",
    "conversation_id",
    "expected_revision",
    "parent_message_id",
    "question",
    "request_kind",
    "processing_intent"
  ],
  "additionalProperties": false
}

مخرجات منظّمة

يصف المخطط structuredContent في نتيجة أداة ناجحة. تشمل استجابة MCP أيضاً content وقد تضبط isError عند الفشل. للنشر، اقرأ النتيجة النهائية بدلاً من اعتبار القبول أوالنص تأكيداً. تشرح عملية API المرتبطة الأذونات وقواعد المحاولة.

تعني «مطلوب» داخل الكائن الأب والفرع المختار. الحقل الابن المطلوب لا يجعل الأب الاختياري مطلوباً. نُسخت القواعد وأسماء الحقول أدناه من العقد.

مخرجات منظّمة
الحقل / الفرعالنوع / مطلوبالقيود
$objectمطلوب في العنصر الأب
  • additionalProperties: false
runobjectمطلوب في العنصر الأب
  • additionalProperties: false
run.idstringمطلوب في العنصر الأب
  • format: "uuid"
run.workspace_idstringمطلوب في العنصر الأب
  • format: "uuid"
run.conversation_idstringمطلوب في العنصر الأب
  • format: "uuid"
run.conversation_revisionintegerمطلوب في العنصر الأب
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
run.generationintegerمطلوب في العنصر الأب
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
run.request_kindstringمطلوب في العنصر الأب
  • enum: ["question","overview","themes","audiences","sentiment","query_suggestions"]
run.statusstringمطلوب في العنصر الأب
  • enum: ["queued","processing","completed","failed","cancelled","expired","unavailable"]
run.failure_codestring | nullمطلوب في العنصر الأب—
run.failure_codeanyOf 1stringمطلوب في العنصر الأب
  • enum: ["not_configured","budget_exhausted","access_changed","source_unavailable","context_changed","input_too_large","provider_unavailable","generation_unconfirmed","invalid_output","cancelled","expired","conversation_full"]
run.failure_codeanyOf 2nullمطلوب في العنصر الأب—
run.created_atstringمطلوب في العنصر الأب
  • format: "date-time"
  • pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
run.expires_atstringمطلوب في العنصر الأب
  • format: "date-time"
  • pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
run.processorstringمطلوب في العنصر الأب
  • const: "Google Gemini"
run.model_idstring | nullمطلوب في العنصر الأب—
run.model_idanyOf 1stringمطلوب في العنصر الأب
  • maxLength: 128
run.model_idanyOf 2nullمطلوب في العنصر الأب—
run.model_versionstring | nullمطلوب في العنصر الأب—
run.model_versionanyOf 1stringمطلوب في العنصر الأب
  • maxLength: 128
run.model_versionanyOf 2nullمطلوب في العنصر الأب—
messageobject | nullمطلوب في العنصر الأب—
messageanyOf 1objectمطلوب في العنصر الأب
  • additionalProperties: false
message.idanyOf 1stringمطلوب في العنصر الأب
  • format: "uuid"
message.run_idanyOf 1stringمطلوب في العنصر الأب
  • format: "uuid"
message.roleanyOf 1stringمطلوب في العنصر الأب
  • enum: ["user","assistant"]
message.questionanyOf 1string | nullمطلوب في العنصر الأب—
message.questionanyOf 1 / anyOf 1stringمطلوب في العنصر الأب
  • maxLength: 2000
message.questionanyOf 1 / anyOf 2nullمطلوب في العنصر الأب—
message.answeranyOf 1object | nullمطلوب في العنصر الأب—
message.answeranyOf 1 / anyOf 1objectمطلوب في العنصر الأب
  • additionalProperties: false
message.answer.answeranyOf 1 / anyOf 1objectمطلوب في العنصر الأب
  • additionalProperties: false
message.answer.answer.statementanyOf 1 / anyOf 1stringمطلوب في العنصر الأب
  • minLength: 1
  • maxLength: 2000
message.answer.answer.basisanyOf 1 / anyOf 1stringمطلوب في العنصر الأب
  • enum: ["observed","inferred","generated"]
message.answer.answer.evidenceanyOf 1 / anyOf 1arrayمطلوب في العنصر الأب
  • minItems: 1
  • maxItems: 20
message.answer.answer.evidence[]anyOf 1 / anyOf 1objectاختياري / عنصر
  • additionalProperties: false
message.answer.answer.evidence[].evidence_idanyOf 1 / anyOf 1stringمطلوب في العنصر الأب
  • format: "uuid"
message.answer.answer.evidence[].revisionanyOf 1 / anyOf 1integerمطلوب في العنصر الأب
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
message.answer.answer.uncertaintyanyOf 1 / anyOf 1stringمطلوب في العنصر الأب
  • maxLength: 1000
message.answer.findingsanyOf 1 / anyOf 1arrayمطلوب في العنصر الأب
  • maxItems: 12
message.answer.findings[]anyOf 1 / anyOf 1objectاختياري / عنصر
  • additionalProperties: false
message.answer.findings[].statementanyOf 1 / anyOf 1stringمطلوب في العنصر الأب
  • minLength: 1
  • maxLength: 2000
message.answer.findings[].basisanyOf 1 / anyOf 1stringمطلوب في العنصر الأب
  • enum: ["observed","inferred","generated"]
message.answer.findings[].evidenceanyOf 1 / anyOf 1arrayمطلوب في العنصر الأب
  • minItems: 1
  • maxItems: 20
message.answer.findings[].evidence[]anyOf 1 / anyOf 1objectاختياري / عنصر
  • additionalProperties: false
message.answer.findings[].evidence[].evidence_idanyOf 1 / anyOf 1stringمطلوب في العنصر الأب
  • format: "uuid"
message.answer.findings[].evidence[].revisionanyOf 1 / anyOf 1integerمطلوب في العنصر الأب
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
message.answer.findings[].uncertaintyanyOf 1 / anyOf 1stringمطلوب في العنصر الأب
  • maxLength: 1000
message.answer.sentimentanyOf 1 / anyOf 1arrayمطلوب في العنصر الأب
  • maxItems: 20
message.answer.sentiment[]anyOf 1 / anyOf 1objectاختياري / عنصر
  • additionalProperties: false
message.answer.sentiment[].evidence_idanyOf 1 / anyOf 1stringمطلوب في العنصر الأب
  • format: "uuid"
message.answer.sentiment[].revisionanyOf 1 / anyOf 1integerمطلوب في العنصر الأب
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
message.answer.sentiment[].labelanyOf 1 / anyOf 1stringمطلوب في العنصر الأب
  • enum: ["positive","negative","neutral","mixed","unknown"]
message.answer.sentiment[].uncertaintyanyOf 1 / anyOf 1stringمطلوب في العنصر الأب
  • maxLength: 1000
message.answer.query_suggestionsanyOf 1 / anyOf 1arrayمطلوب في العنصر الأب
  • maxItems: 5
message.answer.query_suggestions[]anyOf 1 / anyOf 1objectاختياري / عنصر
  • additionalProperties: false
message.answer.query_suggestions[].queryanyOf 1 / anyOf 1stringمطلوب في العنصر الأب
  • minLength: 1
  • maxLength: 2000
message.answer.query_suggestions[].excluded_termsanyOf 1 / anyOf 1arrayمطلوب في العنصر الأب
  • maxItems: 20
message.answer.query_suggestions[].excluded_terms[]anyOf 1 / anyOf 1stringاختياري / عنصر
  • minLength: 1
  • maxLength: 100
message.answer.query_suggestions[].evidenceanyOf 1 / anyOf 1arrayمطلوب في العنصر الأب
  • minItems: 1
  • maxItems: 20
message.answer.query_suggestions[].evidence[]anyOf 1 / anyOf 1objectاختياري / عنصر
  • additionalProperties: false
message.answer.query_suggestions[].evidence[].evidence_idanyOf 1 / anyOf 1stringمطلوب في العنصر الأب
  • format: "uuid"
message.answer.query_suggestions[].evidence[].revisionanyOf 1 / anyOf 1integerمطلوب في العنصر الأب
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
message.answer.query_suggestions[].rationaleanyOf 1 / anyOf 1stringمطلوب في العنصر الأب
  • minLength: 1
  • maxLength: 1000
message.answer.limitationsanyOf 1 / anyOf 1arrayمطلوب في العنصر الأب
  • minItems: 1
  • maxItems: 10
message.answer.limitations[]anyOf 1 / anyOf 1stringاختياري / عنصر
  • minLength: 1
  • maxLength: 1000
message.answer.quantitative_claimsanyOf 1 / anyOf 1booleanمطلوب في العنصر الأب
  • const: false
message.answer.method_versionanyOf 1 / anyOf 1stringمطلوب في العنصر الأب
  • const: "research-cited/v1"
message.answeranyOf 1 / anyOf 2nullمطلوب في العنصر الأب—
message.created_atanyOf 1stringمطلوب في العنصر الأب
  • format: "date-time"
  • pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
message.expires_atanyOf 1stringمطلوب في العنصر الأب
  • format: "date-time"
  • pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
messageanyOf 2nullمطلوب في العنصر الأب—
conversation_revisionintegerمطلوب في العنصر الأب
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
availabilityobjectمطلوب في العنصر الأب
  • additionalProperties: false
availability.configuredbooleanمطلوب في العنصر الأب—
availability.reasonstring | nullمطلوب في العنصر الأب—
availability.reasonanyOf 1stringمطلوب في العنصر الأب
  • enum: ["not_configured","budget_exhausted","access_changed","source_unavailable","context_changed","input_too_large","provider_unavailable","generation_unconfirmed","invalid_output","cancelled","expired","conversation_full"]
availability.reasonanyOf 2nullمطلوب في العنصر الأب—
availability.processorstringمطلوب في العنصر الأب
  • const: "Google Gemini"
availability.retention_hoursnumberمطلوب في العنصر الأب
  • const: 24
مخطط JSON Schema الكامل
{
  "type": "object",
  "properties": {
    "run": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "format": "uuid"
        },
        "workspace_id": {
          "type": "string",
          "format": "uuid"
        },
        "conversation_id": {
          "type": "string",
          "format": "uuid"
        },
        "conversation_revision": {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        },
        "generation": {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        },
        "request_kind": {
          "type": "string",
          "enum": [
            "question",
            "overview",
            "themes",
            "audiences",
            "sentiment",
            "query_suggestions"
          ]
        },
        "status": {
          "type": "string",
          "enum": [
            "queued",
            "processing",
            "completed",
            "failed",
            "cancelled",
            "expired",
            "unavailable"
          ]
        },
        "failure_code": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "not_configured",
                "budget_exhausted",
                "access_changed",
                "source_unavailable",
                "context_changed",
                "input_too_large",
                "provider_unavailable",
                "generation_unconfirmed",
                "invalid_output",
                "cancelled",
                "expired",
                "conversation_full"
              ]
            },
            {
              "type": "null"
            }
          ]
        },
        "created_at": {
          "type": "string",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
          "format": "date-time"
        },
        "expires_at": {
          "type": "string",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
          "format": "date-time"
        },
        "processor": {
          "type": "string",
          "const": "Google Gemini"
        },
        "model_id": {
          "anyOf": [
            {
              "type": "string",
              "maxLength": 128
            },
            {
              "type": "null"
            }
          ]
        },
        "model_version": {
          "anyOf": [
            {
              "type": "string",
              "maxLength": 128
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "id",
        "workspace_id",
        "conversation_id",
        "conversation_revision",
        "generation",
        "request_kind",
        "status",
        "failure_code",
        "created_at",
        "expires_at",
        "processor",
        "model_id",
        "model_version"
      ],
      "additionalProperties": false
    },
    "message": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "format": "uuid"
            },
            "run_id": {
              "type": "string",
              "format": "uuid"
            },
            "role": {
              "type": "string",
              "enum": [
                "user",
                "assistant"
              ]
            },
            "question": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 2000
                },
                {
                  "type": "null"
                }
              ]
            },
            "answer": {
              "anyOf": [
                {
                  "type": "object",
                  "properties": {
                    "answer": {
                      "type": "object",
                      "properties": {
                        "statement": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 2000
                        },
                        "basis": {
                          "type": "string",
                          "enum": [
                            "observed",
                            "inferred",
                            "generated"
                          ]
                        },
                        "evidence": {
                          "minItems": 1,
                          "maxItems": 20,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "evidence_id": {
                                "type": "string",
                                "format": "uuid"
                              },
                              "revision": {
                                "type": "integer",
                                "exclusiveMinimum": 0,
                                "maximum": 9007199254740991
                              }
                            },
                            "required": [
                              "evidence_id",
                              "revision"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "uncertainty": {
                          "type": "string",
                          "maxLength": 1000
                        }
                      },
                      "required": [
                        "statement",
                        "basis",
                        "evidence",
                        "uncertainty"
                      ],
                      "additionalProperties": false
                    },
                    "findings": {
                      "maxItems": 12,
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "statement": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 2000
                          },
                          "basis": {
                            "type": "string",
                            "enum": [
                              "observed",
                              "inferred",
                              "generated"
                            ]
                          },
                          "evidence": {
                            "minItems": 1,
                            "maxItems": 20,
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "evidence_id": {
                                  "type": "string",
                                  "format": "uuid"
                                },
                                "revision": {
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991
                                }
                              },
                              "required": [
                                "evidence_id",
                                "revision"
                              ],
                              "additionalProperties": false
                            }
                          },
                          "uncertainty": {
                            "type": "string",
                            "maxLength": 1000
                          }
                        },
                        "required": [
                          "statement",
                          "basis",
                          "evidence",
                          "uncertainty"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "sentiment": {
                      "maxItems": 20,
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "evidence_id": {
                            "type": "string",
                            "format": "uuid"
                          },
                          "revision": {
                            "type": "integer",
                            "exclusiveMinimum": 0,
                            "maximum": 9007199254740991
                          },
                          "label": {
                            "type": "string",
                            "enum": [
                              "positive",
                              "negative",
                              "neutral",
                              "mixed",
                              "unknown"
                            ]
                          },
                          "uncertainty": {
                            "type": "string",
                            "maxLength": 1000
                          }
                        },
                        "required": [
                          "evidence_id",
                          "revision",
                          "label",
                          "uncertainty"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "query_suggestions": {
                      "maxItems": 5,
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "query": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 2000
                          },
                          "excluded_terms": {
                            "maxItems": 20,
                            "type": "array",
                            "items": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            }
                          },
                          "evidence": {
                            "minItems": 1,
                            "maxItems": 20,
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "evidence_id": {
                                  "type": "string",
                                  "format": "uuid"
                                },
                                "revision": {
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991
                                }
                              },
                              "required": [
                                "evidence_id",
                                "revision"
                              ],
                              "additionalProperties": false
                            }
                          },
                          "rationale": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 1000
                          }
                        },
                        "required": [
                          "query",
                          "excluded_terms",
                          "evidence",
                          "rationale"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "limitations": {
                      "minItems": 1,
                      "maxItems": 10,
                      "type": "array",
                      "items": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 1000
                      }
                    },
                    "quantitative_claims": {
                      "type": "boolean",
                      "const": false
                    },
                    "method_version": {
                      "type": "string",
                      "const": "research-cited/v1"
                    }
                  },
                  "required": [
                    "answer",
                    "findings",
                    "sentiment",
                    "query_suggestions",
                    "limitations",
                    "quantitative_claims",
                    "method_version"
                  ],
                  "additionalProperties": false
                },
                {
                  "type": "null"
                }
              ]
            },
            "created_at": {
              "type": "string",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
              "format": "date-time"
            },
            "expires_at": {
              "type": "string",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
              "format": "date-time"
            }
          },
          "required": [
            "id",
            "run_id",
            "role",
            "question",
            "answer",
            "created_at",
            "expires_at"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "conversation_revision": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "availability": {
      "type": "object",
      "properties": {
        "configured": {
          "type": "boolean"
        },
        "reason": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "not_configured",
                "budget_exhausted",
                "access_changed",
                "source_unavailable",
                "context_changed",
                "input_too_large",
                "provider_unavailable",
                "generation_unconfirmed",
                "invalid_output",
                "cancelled",
                "expired",
                "conversation_full"
              ]
            },
            {
              "type": "null"
            }
          ]
        },
        "processor": {
          "type": "string",
          "const": "Google Gemini"
        },
        "retention_hours": {
          "type": "number",
          "const": 24
        }
      },
      "required": [
        "configured",
        "reason",
        "processor",
        "retention_hours"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "run",
    "message",
    "conversation_revision",
    "availability"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

مثال لاستدعاء أداة

تستخدم الأمثلة قيماً خيالية مفحوصة بالمخططات. استبدل المعرّفات بالمفوّض لك، والوسائط بأصول جاهزة، والتواريخ بوقت نشر مؤكد. افحص أهلية الحساب قبل الكتابة. لا تُرسل الصفحة طلبات API.

{
  "name": "sosoapi_research_assistant_request",
  "arguments": {
    "workspace_id": "11111111-1111-4111-8111-111111111111",
    "mutation_id": "11111111-1111-4111-8111-111111111111",
    "conversation_id": "11111111-1111-4111-8111-111111111111",
    "expected_revision": 1,
    "parent_message_id": null,
    "question": "example",
    "request_kind": "question",
    "processing_intent": "google_gemini_selected_context"
  }
}

structuredContent

{
  "run": {
    "id": "11111111-1111-4111-8111-111111111111",
    "workspace_id": "11111111-1111-4111-8111-111111111111",
    "conversation_id": "11111111-1111-4111-8111-111111111111",
    "conversation_revision": 1,
    "generation": 1,
    "request_kind": "question",
    "status": "queued",
    "failure_code": null,
    "created_at": "2099-01-15T09:00:00Z",
    "expires_at": "2099-01-15T09:00:00Z",
    "processor": "Google Gemini",
    "model_id": null,
    "model_version": null
  },
  "message": null,
  "conversation_revision": 1,
  "availability": {
    "configured": false,
    "reason": null,
    "processor": "Google Gemini",
    "retention_hours": 24
  }
}
تثبيت MCP أو ربطه