העדפות פרטיות

תכונות חיוניות

נדרשות לאבטחה ולפעולות הבסיסיות של האתר.

פעילות תמיד

ניתוח שימוש אופציונלי

לאפשר ניתוח שימוש באמצעות PostHog? אפשר לשנות את הבחירה בכל עת בתחתית האתר.

לאפשר גם הקלטת הפעלות באתר הציבורי הזה

הקלטת ההפעלות מציגה עמודים ציבוריים ואינטראקציות, תוך הסתרת שדות קלט ותוכן פרטי. הקלטת הפעלות באפליקציה היא בחירה נפרדת.

נדרש ניתוח שימוש; שחזור האתר כבוי כברירת מחדל.

איך אנחנו משתמשים בנתונים

אישור ניתוח שימוש מאפשר ל-PostHog לשתף קובץ Cookie אנונימי בין האתר הזה לאפליקציה שלנו, עם אחסון מקומי בדפדפן בכל אחד מהאתרים. בהסכמתכם, ניתן לקשר ביקור מאומת באותה לשונית לחשבון החדש שלכם לאחר אישור ההרשמה.

הקלטת ההפעלות מציגה עמודים ציבוריים ואינטראקציות, תוך הסתרת שדות קלט ותוכן פרטי. הקלטת הפעלות באפליקציה היא בחירה נפרדת.

הקלטת הפעלות באתר כבויה כברירת מחדל. בטלו את הסימון ושמרו כדי להפסיק הקלטות חדשות; בחירה זו אינה משנה את הגדרות החשבון.

הודעת פרטיות ומדידה מצטברת נפרדת באמצעות Cloudflare.

ניתוח השימוש בדפדפן אינו מפעיל ניתוח שימוש בחשבון.

SosoAPI
התחילו בחינם
HE
EN繁中繁體中文（台灣）简体中文日本語한국어DeutschFrançaisEspañolPortuguês (Brasil)العربيةעבריתNederlandsहिन्दीBahasa IndonesiaNorsk bokmålSvenskaMagyar
התחילו בחינם

החיפוש נטען רק כשמשתמשים בו. עיינו בכל הקטגוריות שלהלן.

כלי MCP

העברת שיחת מחקר לארכיון

sosoapi_research_conversations_archive

העברת טקסט שיחה פרטי לארכיון וביטול ניתוח פעיל באמצעות expected_revision; עותקי תמצית שמורים נשארים נפרדים. נדרשת agent:research.

קריאה בפורמט Markdown

פרופילים ואמצעי תעבורה

פרופילים: full · אמצעי תעבורה: stdio, http

בחרו core או full כדי לשלוט בכלים שהלקוח רואה; הבחירה אינה משנה את ההרשאות שלו. העלאת קבצים מקומיים דורשת stdio ואינה זמינה דרך HTTP. הגדירו SOSOAPI_OUTPUT_SCHEMAS=1 להכללת סכמות פלט בגילוי הכלים. הכלים מחזירים תוצאות מובנות עם ההגדרה הזו או בלעדיה.

הרשאות והשפעות לוואי

הערות המטא-נתונים עוזרות ללקוחות לתאר כלי. כל קריאה עדיין בודקת את אימות המשתמש, תפקידו, גישתו למשאבים והרשאות היכולות שלו.

{
  "readOnlyHint": false,
  "destructiveHint": true,
  "idempotentHint": true,
  "openWorldHint": true
}

שדות קלט

שדה חובה נדרש בתוך אובייקט האב והענף הנבחר שלו. צאצא נדרש אינו הופך אב אופציונלי לנדרש. הכללים ושמות השדות שלהלן מועתקים מהחוזה.

שדות קלט
שדה / ענףסוג / חובהאילוצים
$objectחובה באובייקט האב
  • additionalProperties: false
workspace_idstringחובה באובייקט האב
  • format: "uuid"
mutation_idstringחובה באובייקט האב
  • format: "uuid"
conversation_idstringחובה באובייקט האב
  • format: "uuid"
expected_revisionintegerחובה באובייקט האב
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
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
    }
  },
  "required": [
    "workspace_id",
    "mutation_id",
    "conversation_id",
    "expected_revision"
  ],
  "additionalProperties": false
}

פלט מובנה

הסכמה מתארת את structuredContent בתוצאת כלי מוצלחת. תגובת MCP כוללת גם content ועשויה להגדיר isError כשקריאה נכשלת. בפרסום, קראו את התוצאה הסופית של הפוסט במקום לראות בבקשה שהתקבלה או בתגובת טקסט אישור. פעולת ה-API המקושרת מסבירה הרשאות וכללי ניסיון חוזר.

שדה חובה נדרש בתוך אובייקט האב והענף הנבחר שלו. צאצא נדרש אינו הופך אב אופציונלי לנדרש. הכללים ושמות השדות שלהלן מועתקים מהחוזה.

פלט מובנה
שדה / ענףסוג / חובהאילוצים
$objectחובה באובייקט האב
  • additionalProperties: false
conversationobjectחובה באובייקט האב
  • additionalProperties: false
conversation.idstringחובה באובייקט האב
  • format: "uuid"
conversation.workspace_idstringחובה באובייקט האב
  • format: "uuid"
conversation.revisionintegerחובה באובייקט האב
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
conversation.titlestring | nullחובה באובייקט האב—
conversation.titleanyOf 1stringחובה באובייקט האב
  • minLength: 1
  • maxLength: 200
conversation.titleanyOf 2nullחובה באובייקט האב—
conversation.contextobjectחובה באובייקט האב
  • additionalProperties: false
conversation.context.project_idstringחובה באובייקט האב
  • format: "uuid"
conversation.context.project_revisionintegerחובה באובייקט האב
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
conversation.context.corpus_snapshot_idstringחובה באובייקט האב
  • format: "uuid"
conversation.context.evidencearrayחובה באובייקט האב
  • minItems: 1
  • maxItems: 20
conversation.context.evidence[]objectרשות / פריט
  • additionalProperties: false
conversation.context.evidence[].evidence_idstringחובה באובייקט האב
  • format: "uuid"
conversation.context.evidence[].revisionintegerחובה באובייקט האב
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
conversation.languagestringחובה באובייקט האב
  • minLength: 1
  • maxLength: 35
conversation.archivedbooleanחובה באובייקט האב—
conversation.availabilitystringחובה באובייקט האב
  • enum: ["available","expired","source_unavailable","access_changed","archived"]
conversation.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)))$"
conversation.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)))$"
messagesarrayחובה באובייקט האב
  • maxItems: 40
messages[]objectרשות / פריט
  • additionalProperties: false
messages[].idstringחובה באובייקט האב
  • format: "uuid"
messages[].run_idstringחובה באובייקט האב
  • format: "uuid"
messages[].rolestringחובה באובייקט האב
  • enum: ["user","assistant"]
messages[].questionstring | nullחובה באובייקט האב—
messages[].questionanyOf 1stringחובה באובייקט האב
  • maxLength: 2000
messages[].questionanyOf 2nullחובה באובייקט האב—
messages[].answerobject | nullחובה באובייקט האב—
messages[].answeranyOf 1objectחובה באובייקט האב
  • additionalProperties: false
messages[].answer.answeranyOf 1objectחובה באובייקט האב
  • additionalProperties: false
messages[].answer.answer.statementanyOf 1stringחובה באובייקט האב
  • minLength: 1
  • maxLength: 2000
messages[].answer.answer.basisanyOf 1stringחובה באובייקט האב
  • enum: ["observed","inferred","generated"]
messages[].answer.answer.evidenceanyOf 1arrayחובה באובייקט האב
  • minItems: 1
  • maxItems: 20
messages[].answer.answer.evidence[]anyOf 1objectרשות / פריט
  • additionalProperties: false
messages[].answer.answer.evidence[].evidence_idanyOf 1stringחובה באובייקט האב
  • format: "uuid"
messages[].answer.answer.evidence[].revisionanyOf 1integerחובה באובייקט האב
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
messages[].answer.answer.uncertaintyanyOf 1stringחובה באובייקט האב
  • maxLength: 1000
messages[].answer.findingsanyOf 1arrayחובה באובייקט האב
  • maxItems: 12
messages[].answer.findings[]anyOf 1objectרשות / פריט
  • additionalProperties: false
messages[].answer.findings[].statementanyOf 1stringחובה באובייקט האב
  • minLength: 1
  • maxLength: 2000
messages[].answer.findings[].basisanyOf 1stringחובה באובייקט האב
  • enum: ["observed","inferred","generated"]
messages[].answer.findings[].evidenceanyOf 1arrayחובה באובייקט האב
  • minItems: 1
  • maxItems: 20
messages[].answer.findings[].evidence[]anyOf 1objectרשות / פריט
  • additionalProperties: false
messages[].answer.findings[].evidence[].evidence_idanyOf 1stringחובה באובייקט האב
  • format: "uuid"
messages[].answer.findings[].evidence[].revisionanyOf 1integerחובה באובייקט האב
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
messages[].answer.findings[].uncertaintyanyOf 1stringחובה באובייקט האב
  • maxLength: 1000
messages[].answer.sentimentanyOf 1arrayחובה באובייקט האב
  • maxItems: 20
messages[].answer.sentiment[]anyOf 1objectרשות / פריט
  • additionalProperties: false
messages[].answer.sentiment[].evidence_idanyOf 1stringחובה באובייקט האב
  • format: "uuid"
messages[].answer.sentiment[].revisionanyOf 1integerחובה באובייקט האב
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
messages[].answer.sentiment[].labelanyOf 1stringחובה באובייקט האב
  • enum: ["positive","negative","neutral","mixed","unknown"]
messages[].answer.sentiment[].uncertaintyanyOf 1stringחובה באובייקט האב
  • maxLength: 1000
messages[].answer.query_suggestionsanyOf 1arrayחובה באובייקט האב
  • maxItems: 5
messages[].answer.query_suggestions[]anyOf 1objectרשות / פריט
  • additionalProperties: false
messages[].answer.query_suggestions[].queryanyOf 1stringחובה באובייקט האב
  • minLength: 1
  • maxLength: 2000
messages[].answer.query_suggestions[].excluded_termsanyOf 1arrayחובה באובייקט האב
  • maxItems: 20
messages[].answer.query_suggestions[].excluded_terms[]anyOf 1stringרשות / פריט
  • minLength: 1
  • maxLength: 100
messages[].answer.query_suggestions[].evidenceanyOf 1arrayחובה באובייקט האב
  • minItems: 1
  • maxItems: 20
messages[].answer.query_suggestions[].evidence[]anyOf 1objectרשות / פריט
  • additionalProperties: false
messages[].answer.query_suggestions[].evidence[].evidence_idanyOf 1stringחובה באובייקט האב
  • format: "uuid"
messages[].answer.query_suggestions[].evidence[].revisionanyOf 1integerחובה באובייקט האב
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
messages[].answer.query_suggestions[].rationaleanyOf 1stringחובה באובייקט האב
  • minLength: 1
  • maxLength: 1000
messages[].answer.limitationsanyOf 1arrayחובה באובייקט האב
  • minItems: 1
  • maxItems: 10
messages[].answer.limitations[]anyOf 1stringרשות / פריט
  • minLength: 1
  • maxLength: 1000
messages[].answer.quantitative_claimsanyOf 1booleanחובה באובייקט האב
  • const: false
messages[].answer.method_versionanyOf 1stringחובה באובייקט האב
  • const: "research-cited/v1"
messages[].answeranyOf 2nullחובה באובייקט האב—
messages[].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)))$"
messages[].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)))$"
runsarrayחובה באובייקט האב
  • maxItems: 20
runs[]objectרשות / פריט
  • additionalProperties: false
runs[].idstringחובה באובייקט האב
  • format: "uuid"
runs[].workspace_idstringחובה באובייקט האב
  • format: "uuid"
runs[].conversation_idstringחובה באובייקט האב
  • format: "uuid"
runs[].conversation_revisionintegerחובה באובייקט האב
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
runs[].generationintegerחובה באובייקט האב
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
runs[].request_kindstringחובה באובייקט האב
  • enum: ["question","overview","themes","audiences","sentiment","query_suggestions"]
runs[].statusstringחובה באובייקט האב
  • enum: ["queued","processing","completed","failed","cancelled","expired","unavailable"]
runs[].failure_codestring | nullחובה באובייקט האב—
runs[].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"]
runs[].failure_codeanyOf 2nullחובה באובייקט האב—
runs[].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)))$"
runs[].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)))$"
runs[].processorstringחובה באובייקט האב
  • const: "Google Gemini"
runs[].model_idstring | nullחובה באובייקט האב—
runs[].model_idanyOf 1stringחובה באובייקט האב
  • maxLength: 128
runs[].model_idanyOf 2nullחובה באובייקט האב—
runs[].model_versionstring | nullחובה באובייקט האב—
runs[].model_versionanyOf 1stringחובה באובייקט האב
  • maxLength: 128
runs[].model_versionanyOf 2nullחובה באובייקט האב—
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": {
    "conversation": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "format": "uuid"
        },
        "workspace_id": {
          "type": "string",
          "format": "uuid"
        },
        "revision": {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        },
        "title": {
          "anyOf": [
            {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            },
            {
              "type": "null"
            }
          ]
        },
        "context": {
          "type": "object",
          "properties": {
            "project_id": {
              "type": "string",
              "format": "uuid"
            },
            "project_revision": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991
            },
            "corpus_snapshot_id": {
              "type": "string",
              "format": "uuid"
            },
            "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
              }
            }
          },
          "required": [
            "project_id",
            "project_revision",
            "corpus_snapshot_id",
            "evidence"
          ],
          "additionalProperties": false
        },
        "language": {
          "type": "string",
          "minLength": 1,
          "maxLength": 35
        },
        "archived": {
          "type": "boolean"
        },
        "availability": {
          "type": "string",
          "enum": [
            "available",
            "expired",
            "source_unavailable",
            "access_changed",
            "archived"
          ]
        },
        "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",
        "workspace_id",
        "revision",
        "title",
        "context",
        "language",
        "archived",
        "availability",
        "created_at",
        "expires_at"
      ],
      "additionalProperties": false
    },
    "messages": {
      "maxItems": 40,
      "type": "array",
      "items": {
        "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
      }
    },
    "runs": {
      "maxItems": 20,
      "type": "array",
      "items": {
        "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
      }
    },
    "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": [
    "conversation",
    "messages",
    "runs",
    "availability"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

דוגמת קריאה לכלי

הדוגמאות משתמשות בערכים בדויים שנבדקו מול הסכמות. החליפו את המזהים בכאלה שאתם מורשים להשתמש בהם, את המדיה בנכסים מוכנים ואת התאריכים במועד הפרסום שאישרתם. בדקו את התאמת החשבון לפני שליחת כתיבה. העמוד הזה אינו שולח בקשות API.

{
  "name": "sosoapi_research_conversations_archive",
  "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
  }
}

structuredContent

{
  "conversation": {
    "id": "11111111-1111-4111-8111-111111111111",
    "workspace_id": "11111111-1111-4111-8111-111111111111",
    "revision": 1,
    "title": null,
    "context": {
      "project_id": "11111111-1111-4111-8111-111111111111",
      "project_revision": 1,
      "corpus_snapshot_id": "11111111-1111-4111-8111-111111111111",
      "evidence": [
        {
          "evidence_id": "11111111-1111-4111-8111-111111111111",
          "revision": 1
        }
      ]
    },
    "language": "example",
    "archived": false,
    "availability": "available",
    "created_at": "2099-01-15T09:00:00Z",
    "expires_at": "2099-01-15T09:00:00Z"
  },
  "messages": [],
  "runs": [],
  "availability": {
    "configured": false,
    "reason": null,
    "processor": "Google Gemini",
    "retention_hours": 24
  }
}
התקנה או חיבור של MCP