Integritetsinställningar

Nödvändiga funktioner

Krävs för säkerhet och webbplatsens grundfunktioner.

Alltid aktiva

Valfri användningsanalys

Tillåta användningsanalys med PostHog? Ändra ditt val när som helst i sidfoten.

Tillåt även sessionsinspelning på den här offentliga webbplatsen

Inspelningen visar offentliga sidor och interaktioner, med inmatningar och privat innehåll maskerade. Inspelning i appen är ett separat val.

Kräver analys; webbplatsinspelning är avstängd som standard.

Så använder vi data

När du tillåter analys kan PostHog dela en anonym cookie mellan den här webbplatsen och vår app, med lokal webbläsarlagring på varje webbplats. Med ditt samtycke kan ett verifierat besök i samma flik kopplas till ditt nya konto efter att registreringen har bekräftats.

Inspelningen visar offentliga sidor och interaktioner, med inmatningar och privat innehåll maskerade. Inspelning i appen är ett separat val.

Webbplatsinspelning är avstängd som standard. Avmarkera den och spara för att stoppa nya inspelningar; detta val ändrar inte kontoinställningar.

Integritetsmeddelande och separat aggregerad Cloudflare-mätning.

Webbläsaranalys aktiverar inte kontoanalys.

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

Sökningen laddas först när du använder den. Bläddra bland alla kategorier nedan.

MCP-verktyg

Begär källsentiment med källhänvisningar

sosoapi_research_sentiment_request

Begär avgränsat sentiment med källhänvisningar och uttryckligt processing_intent; kan vara otillgängligt. Samma mutation genererar aldrig på nytt. Kräver agent:research.

Läs som Markdown

Profiler och transporter

Profiler: full · Transporter: stdio, http

Välj core eller full för att styra vilka verktyg klienten ser; detta ändrar inte dess behörigheter. Lokal filuppladdning kräver stdio och är inte tillgänglig via HTTP. Ange SOSOAPI_OUTPUT_SCHEMAS=1 för att inkludera utdatascheman vid identifiering. Verktygen returnerar strukturerade resultat med eller utan inställningen.

Behörigheter och sidoeffekter

Annoteringar hjälper klienter att beskriva ett verktyg. Varje anrop kontrollerar fortfarande användarens autentisering, roll, resursåtkomst och tilldelade funktionsbehörigheter.

{
  "readOnlyHint": false,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": true
}
  • /research-api/sentiment/request: agent:research · godkänd sentimentkörning för valda källor eller uttryckligen otillgängligt; ingen härledd demografi

Indatafält

Obligatoriskt betyder obligatoriskt inom sitt överordnade objekt och vald gren. Ett obligatoriskt underfält gör inte ett valfritt överordnat objekt obligatoriskt. Regler och fältnamn nedan kopieras från kontraktet.

Indatafält
Fält / grenTyp / obligatorisktBegränsningar
$objectObligatoriskt i överordnat objekt
  • additionalProperties: false
workspace_idstringObligatoriskt i överordnat objekt
  • format: "uuid"
mutation_idstringObligatoriskt i överordnat objekt
  • format: "uuid"
conversation_idstringObligatoriskt i överordnat objekt
  • format: "uuid"
expected_revisionintegerObligatoriskt i överordnat objekt
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
parent_message_idstring | nullObligatoriskt i överordnat objekt—
parent_message_idanyOf 1stringObligatoriskt i överordnat objekt
  • format: "uuid"
parent_message_idanyOf 2nullObligatoriskt i överordnat objekt—
questionstringObligatoriskt i överordnat objekt
  • minLength: 1
  • maxLength: 2000
request_kindstringObligatoriskt i överordnat objekt
  • enum: ["sentiment"]
processing_intentstringObligatoriskt i överordnat objekt
  • enum: ["google_gemini_selected_context"]
Fullständigt 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": [
        "sentiment"
      ]
    },
    "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
}

Strukturerat resultat

Detta schema beskriver structuredContent i ett lyckat verktygsresultat. MCP-svaret innehåller även content och kan ange isError när ett anrop misslyckas. För publicering ska du läsa inläggets slutresultat i stället för att tolka en accepterad begäran eller ett textsvar som bekräftelse. Den länkade API-åtgärden förklarar behörigheter och regler för nya försök.

Obligatoriskt betyder obligatoriskt inom sitt överordnade objekt och vald gren. Ett obligatoriskt underfält gör inte ett valfritt överordnat objekt obligatoriskt. Regler och fältnamn nedan kopieras från kontraktet.

Strukturerat resultat
Fält / grenTyp / obligatorisktBegränsningar
$objectObligatoriskt i överordnat objekt
  • additionalProperties: false
runobjectObligatoriskt i överordnat objekt
  • additionalProperties: false
run.idstringObligatoriskt i överordnat objekt
  • format: "uuid"
run.workspace_idstringObligatoriskt i överordnat objekt
  • format: "uuid"
run.conversation_idstringObligatoriskt i överordnat objekt
  • format: "uuid"
run.conversation_revisionintegerObligatoriskt i överordnat objekt
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
run.generationintegerObligatoriskt i överordnat objekt
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
run.request_kindstringObligatoriskt i överordnat objekt
  • enum: ["question","overview","themes","audiences","sentiment","query_suggestions"]
run.statusstringObligatoriskt i överordnat objekt
  • enum: ["queued","processing","completed","failed","cancelled","expired","unavailable"]
run.failure_codestring | nullObligatoriskt i överordnat objekt—
run.failure_codeanyOf 1stringObligatoriskt i överordnat objekt
  • 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 2nullObligatoriskt i överordnat objekt—
run.created_atstringObligatoriskt i överordnat objekt
  • 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_atstringObligatoriskt i överordnat objekt
  • 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.processorstringObligatoriskt i överordnat objekt
  • const: "Google Gemini"
run.model_idstring | nullObligatoriskt i överordnat objekt—
run.model_idanyOf 1stringObligatoriskt i överordnat objekt
  • maxLength: 128
run.model_idanyOf 2nullObligatoriskt i överordnat objekt—
run.model_versionstring | nullObligatoriskt i överordnat objekt—
run.model_versionanyOf 1stringObligatoriskt i överordnat objekt
  • maxLength: 128
run.model_versionanyOf 2nullObligatoriskt i överordnat objekt—
messageobject | nullObligatoriskt i överordnat objekt—
messageanyOf 1objectObligatoriskt i överordnat objekt
  • additionalProperties: false
message.idanyOf 1stringObligatoriskt i överordnat objekt
  • format: "uuid"
message.run_idanyOf 1stringObligatoriskt i överordnat objekt
  • format: "uuid"
message.roleanyOf 1stringObligatoriskt i överordnat objekt
  • enum: ["user","assistant"]
message.questionanyOf 1string | nullObligatoriskt i överordnat objekt—
message.questionanyOf 1 / anyOf 1stringObligatoriskt i överordnat objekt
  • maxLength: 2000
message.questionanyOf 1 / anyOf 2nullObligatoriskt i överordnat objekt—
message.answeranyOf 1object | nullObligatoriskt i överordnat objekt—
message.answeranyOf 1 / anyOf 1objectObligatoriskt i överordnat objekt
  • additionalProperties: false
message.answer.answeranyOf 1 / anyOf 1objectObligatoriskt i överordnat objekt
  • additionalProperties: false
message.answer.answer.statementanyOf 1 / anyOf 1stringObligatoriskt i överordnat objekt
  • minLength: 1
  • maxLength: 2000
message.answer.answer.basisanyOf 1 / anyOf 1stringObligatoriskt i överordnat objekt
  • enum: ["observed","inferred","generated"]
message.answer.answer.evidenceanyOf 1 / anyOf 1arrayObligatoriskt i överordnat objekt
  • minItems: 1
  • maxItems: 20
message.answer.answer.evidence[]anyOf 1 / anyOf 1objectValfritt / objekt
  • additionalProperties: false
message.answer.answer.evidence[].evidence_idanyOf 1 / anyOf 1stringObligatoriskt i överordnat objekt
  • format: "uuid"
message.answer.answer.evidence[].revisionanyOf 1 / anyOf 1integerObligatoriskt i överordnat objekt
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
message.answer.answer.uncertaintyanyOf 1 / anyOf 1stringObligatoriskt i överordnat objekt
  • maxLength: 1000
message.answer.findingsanyOf 1 / anyOf 1arrayObligatoriskt i överordnat objekt
  • maxItems: 12
message.answer.findings[]anyOf 1 / anyOf 1objectValfritt / objekt
  • additionalProperties: false
message.answer.findings[].statementanyOf 1 / anyOf 1stringObligatoriskt i överordnat objekt
  • minLength: 1
  • maxLength: 2000
message.answer.findings[].basisanyOf 1 / anyOf 1stringObligatoriskt i överordnat objekt
  • enum: ["observed","inferred","generated"]
message.answer.findings[].evidenceanyOf 1 / anyOf 1arrayObligatoriskt i överordnat objekt
  • minItems: 1
  • maxItems: 20
message.answer.findings[].evidence[]anyOf 1 / anyOf 1objectValfritt / objekt
  • additionalProperties: false
message.answer.findings[].evidence[].evidence_idanyOf 1 / anyOf 1stringObligatoriskt i överordnat objekt
  • format: "uuid"
message.answer.findings[].evidence[].revisionanyOf 1 / anyOf 1integerObligatoriskt i överordnat objekt
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
message.answer.findings[].uncertaintyanyOf 1 / anyOf 1stringObligatoriskt i överordnat objekt
  • maxLength: 1000
message.answer.sentimentanyOf 1 / anyOf 1arrayObligatoriskt i överordnat objekt
  • maxItems: 20
message.answer.sentiment[]anyOf 1 / anyOf 1objectValfritt / objekt
  • additionalProperties: false
message.answer.sentiment[].evidence_idanyOf 1 / anyOf 1stringObligatoriskt i överordnat objekt
  • format: "uuid"
message.answer.sentiment[].revisionanyOf 1 / anyOf 1integerObligatoriskt i överordnat objekt
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
message.answer.sentiment[].labelanyOf 1 / anyOf 1stringObligatoriskt i överordnat objekt
  • enum: ["positive","negative","neutral","mixed","unknown"]
message.answer.sentiment[].uncertaintyanyOf 1 / anyOf 1stringObligatoriskt i överordnat objekt
  • maxLength: 1000
message.answer.query_suggestionsanyOf 1 / anyOf 1arrayObligatoriskt i överordnat objekt
  • maxItems: 5
message.answer.query_suggestions[]anyOf 1 / anyOf 1objectValfritt / objekt
  • additionalProperties: false
message.answer.query_suggestions[].queryanyOf 1 / anyOf 1stringObligatoriskt i överordnat objekt
  • minLength: 1
  • maxLength: 2000
message.answer.query_suggestions[].excluded_termsanyOf 1 / anyOf 1arrayObligatoriskt i överordnat objekt
  • maxItems: 20
message.answer.query_suggestions[].excluded_terms[]anyOf 1 / anyOf 1stringValfritt / objekt
  • minLength: 1
  • maxLength: 100
message.answer.query_suggestions[].evidenceanyOf 1 / anyOf 1arrayObligatoriskt i överordnat objekt
  • minItems: 1
  • maxItems: 20
message.answer.query_suggestions[].evidence[]anyOf 1 / anyOf 1objectValfritt / objekt
  • additionalProperties: false
message.answer.query_suggestions[].evidence[].evidence_idanyOf 1 / anyOf 1stringObligatoriskt i överordnat objekt
  • format: "uuid"
message.answer.query_suggestions[].evidence[].revisionanyOf 1 / anyOf 1integerObligatoriskt i överordnat objekt
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
message.answer.query_suggestions[].rationaleanyOf 1 / anyOf 1stringObligatoriskt i överordnat objekt
  • minLength: 1
  • maxLength: 1000
message.answer.limitationsanyOf 1 / anyOf 1arrayObligatoriskt i överordnat objekt
  • minItems: 1
  • maxItems: 10
message.answer.limitations[]anyOf 1 / anyOf 1stringValfritt / objekt
  • minLength: 1
  • maxLength: 1000
message.answer.quantitative_claimsanyOf 1 / anyOf 1booleanObligatoriskt i överordnat objekt
  • const: false
message.answer.method_versionanyOf 1 / anyOf 1stringObligatoriskt i överordnat objekt
  • const: "research-cited/v1"
message.answeranyOf 1 / anyOf 2nullObligatoriskt i överordnat objekt—
message.created_atanyOf 1stringObligatoriskt i överordnat objekt
  • 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 1stringObligatoriskt i överordnat objekt
  • 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 2nullObligatoriskt i överordnat objekt—
conversation_revisionintegerObligatoriskt i överordnat objekt
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
availabilityobjectObligatoriskt i överordnat objekt
  • additionalProperties: false
availability.configuredbooleanObligatoriskt i överordnat objekt—
availability.reasonstring | nullObligatoriskt i överordnat objekt—
availability.reasonanyOf 1stringObligatoriskt i överordnat objekt
  • 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 2nullObligatoriskt i överordnat objekt—
availability.processorstringObligatoriskt i överordnat objekt
  • const: "Google Gemini"
availability.retention_hoursnumberObligatoriskt i överordnat objekt
  • const: 24
Fullständigt 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
}

Exempel på verktygsanrop

Exemplen använder fiktiva värden som kontrollerats mot schemana. Ersätt ID:n med sådana du får använda, medier med färdiga mediefiler och datum med din bekräftade publiceringstid. Kontrollera kontots behörighet före en skrivning. Denna sida skickar inga API-anrop.

{
  "name": "sosoapi_research_sentiment_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": "sentiment",
    "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
  }
}
Installera eller anslut MCP