MCP-eszköz

Privát kutatási beszélgetés olvasása

sosoapi_research_conversations_get

Privát kérdések és nem megbízható, hivatkozásokkal ellátott válaszok újranyitása, amíg az aktuális hozzáférés, a források és a 24 órás kiszolgálás megengedi. agent:research szükséges.

Olvasás Markdown formátumban

Profilok és átviteli módok

Profilok: full · Átviteli módok: stdio, http

A core vagy full profillal szabályozhatod a kliens által látható eszközöket; ez nem változtat engedélyt. Helyi fájlfeltöltéshez stdio kell, HTTP-n nem elérhető. A SOSOAPI_OUTPUT_SCHEMAS=1 kimeneti sémákat ad a felderítéshez. Az eszközök e beállítással és nélküle is strukturált eredményt adnak.

Engedélyek és mellékhatások

A jelölések segítenek a kliensnek leírni az eszközt. Minden hívás továbbra is ellenőrzi a felhasználó hitelesítését, szerepkörét, erőforrás-hozzáférését és képességengedélyeit.

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

/research-api/conversations/get: agent:research · aktuálisan engedélyezett beszélgetés; a forrástartalmat az elérhetőség és a lejárat szabályozza

Bemeneti mezők

A kötelező jelölés a szülőobjektumon és a kiválasztott ágon belül érvényes. A kötelező gyermek nem teszi kötelezővé az opcionális szülőt. Az alábbi szabályok és mezőnevek a szerződésből származnak.

Bemeneti mezők
Mező / ág	Típus / kötelező	Korlátok
`$`	`object`A szülőn belül kötelező	`additionalProperties: false`
`workspace_id`	`string`A szülőn belül kötelező	`format: "uuid"`
`conversation_id`	`string`A szülőn belül kötelező	`format: "uuid"`

Teljes JSON Schema

{
  "type": "object",
  "properties": {
    "workspace_id": {
      "type": "string",
      "format": "uuid"
    },
    "conversation_id": {
      "type": "string",
      "format": "uuid"
    }
  },
  "required": [
    "workspace_id",
    "conversation_id"
  ],
  "additionalProperties": false
}

Strukturált kimenet

Ez a séma egy sikeres eszközeredmény structuredContent mezőjét írja le. Az MCP-válasz content mezőt is tartalmaz, és sikertelen hívásnál isError értéket állíthat be. Közzétételnél a bejegyzés végső eredményét olvasd el; ne tekintsd az elfogadott kérést vagy szöveges választ megerősítésnek. A kapcsolódó API-művelet ismerteti az engedélyeket és újrapróbálási szabályokat.

Strukturált kimenet
Mező / ág	Típus / kötelező	Korlátok
`$`	`object`A szülőn belül kötelező	`additionalProperties: false`
`conversation`	`object`A szülőn belül kötelező	`additionalProperties: false`
`conversation.id`	`string`A szülőn belül kötelező	`format: "uuid"`
`conversation.workspace_id`	`string`A szülőn belül kötelező	`format: "uuid"`
`conversation.revision`	`integer`A szülőn belül kötelező	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`conversation.title`	`string \| null`A szülőn belül kötelező	—
`conversation.title`anyOf 1	`string`A szülőn belül kötelező	`minLength: 1` `maxLength: 200`
`conversation.title`anyOf 2	`null`A szülőn belül kötelező	—
`conversation.context`	`object`A szülőn belül kötelező	`additionalProperties: false`
`conversation.context.project_id`	`string`A szülőn belül kötelező	`format: "uuid"`
`conversation.context.project_revision`	`integer`A szülőn belül kötelező	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`conversation.context.corpus_snapshot_id`	`string`A szülőn belül kötelező	`format: "uuid"`
`conversation.context.evidence`	`array`A szülőn belül kötelező	`minItems: 1` `maxItems: 20`
`conversation.context.evidence[]`	`object`Opcionális / elem	`additionalProperties: false`
`conversation.context.evidence[].evidence_id`	`string`A szülőn belül kötelező	`format: "uuid"`
`conversation.context.evidence[].revision`	`integer`A szülőn belül kötelező	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`conversation.language`	`string`A szülőn belül kötelező	`minLength: 1` `maxLength: 35`
`conversation.archived`	`boolean`A szülőn belül kötelező	—
`conversation.availability`	`string`A szülőn belül kötelező	`enum: ["available","expired","source_unavailable","access_changed","archived"]`
`conversation.created_at`	`string`A szülőn belül kötelező	`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_at`	`string`A szülőn belül kötelező	`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`	`array`A szülőn belül kötelező	`maxItems: 40`
`messages[]`	`object`Opcionális / elem	`additionalProperties: false`
`messages[].id`	`string`A szülőn belül kötelező	`format: "uuid"`
`messages[].run_id`	`string`A szülőn belül kötelező	`format: "uuid"`
`messages[].role`	`string`A szülőn belül kötelező	`enum: ["user","assistant"]`
`messages[].question`	`string \| null`A szülőn belül kötelező	—
`messages[].question`anyOf 1	`string`A szülőn belül kötelező	`maxLength: 2000`
`messages[].question`anyOf 2	`null`A szülőn belül kötelező	—
`messages[].answer`	`object \| null`A szülőn belül kötelező	—
`messages[].answer`anyOf 1	`object`A szülőn belül kötelező	`additionalProperties: false`
`messages[].answer.answer`anyOf 1	`object`A szülőn belül kötelező	`additionalProperties: false`
`messages[].answer.answer.statement`anyOf 1	`string`A szülőn belül kötelező	`minLength: 1` `maxLength: 2000`
`messages[].answer.answer.basis`anyOf 1	`string`A szülőn belül kötelező	`enum: ["observed","inferred","generated"]`
`messages[].answer.answer.evidence`anyOf 1	`array`A szülőn belül kötelező	`minItems: 1` `maxItems: 20`
`messages[].answer.answer.evidence[]`anyOf 1	`object`Opcionális / elem	`additionalProperties: false`
`messages[].answer.answer.evidence[].evidence_id`anyOf 1	`string`A szülőn belül kötelező	`format: "uuid"`
`messages[].answer.answer.evidence[].revision`anyOf 1	`integer`A szülőn belül kötelező	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`messages[].answer.answer.uncertainty`anyOf 1	`string`A szülőn belül kötelező	`maxLength: 1000`
`messages[].answer.findings`anyOf 1	`array`A szülőn belül kötelező	`maxItems: 12`
`messages[].answer.findings[]`anyOf 1	`object`Opcionális / elem	`additionalProperties: false`
`messages[].answer.findings[].statement`anyOf 1	`string`A szülőn belül kötelező	`minLength: 1` `maxLength: 2000`
`messages[].answer.findings[].basis`anyOf 1	`string`A szülőn belül kötelező	`enum: ["observed","inferred","generated"]`
`messages[].answer.findings[].evidence`anyOf 1	`array`A szülőn belül kötelező	`minItems: 1` `maxItems: 20`
`messages[].answer.findings[].evidence[]`anyOf 1	`object`Opcionális / elem	`additionalProperties: false`
`messages[].answer.findings[].evidence[].evidence_id`anyOf 1	`string`A szülőn belül kötelező	`format: "uuid"`
`messages[].answer.findings[].evidence[].revision`anyOf 1	`integer`A szülőn belül kötelező	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`messages[].answer.findings[].uncertainty`anyOf 1	`string`A szülőn belül kötelező	`maxLength: 1000`
`messages[].answer.sentiment`anyOf 1	`array`A szülőn belül kötelező	`maxItems: 20`
`messages[].answer.sentiment[]`anyOf 1	`object`Opcionális / elem	`additionalProperties: false`
`messages[].answer.sentiment[].evidence_id`anyOf 1	`string`A szülőn belül kötelező	`format: "uuid"`
`messages[].answer.sentiment[].revision`anyOf 1	`integer`A szülőn belül kötelező	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`messages[].answer.sentiment[].label`anyOf 1	`string`A szülőn belül kötelező	`enum: ["positive","negative","neutral","mixed","unknown"]`
`messages[].answer.sentiment[].uncertainty`anyOf 1	`string`A szülőn belül kötelező	`maxLength: 1000`
`messages[].answer.query_suggestions`anyOf 1	`array`A szülőn belül kötelező	`maxItems: 5`
`messages[].answer.query_suggestions[]`anyOf 1	`object`Opcionális / elem	`additionalProperties: false`
`messages[].answer.query_suggestions[].query`anyOf 1	`string`A szülőn belül kötelező	`minLength: 1` `maxLength: 2000`
`messages[].answer.query_suggestions[].excluded_terms`anyOf 1	`array`A szülőn belül kötelező	`maxItems: 20`
`messages[].answer.query_suggestions[].excluded_terms[]`anyOf 1	`string`Opcionális / elem	`minLength: 1` `maxLength: 100`
`messages[].answer.query_suggestions[].evidence`anyOf 1	`array`A szülőn belül kötelező	`minItems: 1` `maxItems: 20`
`messages[].answer.query_suggestions[].evidence[]`anyOf 1	`object`Opcionális / elem	`additionalProperties: false`
`messages[].answer.query_suggestions[].evidence[].evidence_id`anyOf 1	`string`A szülőn belül kötelező	`format: "uuid"`
`messages[].answer.query_suggestions[].evidence[].revision`anyOf 1	`integer`A szülőn belül kötelező	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`messages[].answer.query_suggestions[].rationale`anyOf 1	`string`A szülőn belül kötelező	`minLength: 1` `maxLength: 1000`
`messages[].answer.limitations`anyOf 1	`array`A szülőn belül kötelező	`minItems: 1` `maxItems: 10`
`messages[].answer.limitations[]`anyOf 1	`string`Opcionális / elem	`minLength: 1` `maxLength: 1000`
`messages[].answer.quantitative_claims`anyOf 1	`boolean`A szülőn belül kötelező	`const: false`
`messages[].answer.method_version`anyOf 1	`string`A szülőn belül kötelező	`const: "research-cited/v1"`
`messages[].answer`anyOf 2	`null`A szülőn belül kötelező	—
`messages[].created_at`	`string`A szülőn belül kötelező	`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_at`	`string`A szülőn belül kötelező	`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`	`array`A szülőn belül kötelező	`maxItems: 20`
`runs[]`	`object`Opcionális / elem	`additionalProperties: false`
`runs[].id`	`string`A szülőn belül kötelező	`format: "uuid"`
`runs[].workspace_id`	`string`A szülőn belül kötelező	`format: "uuid"`
`runs[].conversation_id`	`string`A szülőn belül kötelező	`format: "uuid"`
`runs[].conversation_revision`	`integer`A szülőn belül kötelező	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`runs[].generation`	`integer`A szülőn belül kötelező	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`runs[].request_kind`	`string`A szülőn belül kötelező	`enum: ["question","overview","themes","audiences","sentiment","query_suggestions"]`
`runs[].status`	`string`A szülőn belül kötelező	`enum: ["queued","processing","completed","failed","cancelled","expired","unavailable"]`
`runs[].failure_code`	`string \| null`A szülőn belül kötelező	—
`runs[].failure_code`anyOf 1	`string`A szülőn belül kötelező	`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_code`anyOf 2	`null`A szülőn belül kötelező	—
`runs[].created_at`	`string`A szülőn belül kötelező	`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_at`	`string`A szülőn belül kötelező	`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[].processor`	`string`A szülőn belül kötelező	`const: "Google Gemini"`
`runs[].model_id`	`string \| null`A szülőn belül kötelező	—
`runs[].model_id`anyOf 1	`string`A szülőn belül kötelező	`maxLength: 128`
`runs[].model_id`anyOf 2	`null`A szülőn belül kötelező	—
`runs[].model_version`	`string \| null`A szülőn belül kötelező	—
`runs[].model_version`anyOf 1	`string`A szülőn belül kötelező	`maxLength: 128`
`runs[].model_version`anyOf 2	`null`A szülőn belül kötelező	—
`availability`	`object`A szülőn belül kötelező	`additionalProperties: false`
`availability.configured`	`boolean`A szülőn belül kötelező	—
`availability.reason`	`string \| null`A szülőn belül kötelező	—
`availability.reason`anyOf 1	`string`A szülőn belül kötelező	`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.reason`anyOf 2	`null`A szülőn belül kötelező	—
`availability.processor`	`string`A szülőn belül kötelező	`const: "Google Gemini"`
`availability.retention_hours`	`number`A szülőn belül kötelező	`const: 24`

Teljes 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
}

Példa eszközhívás

A példák sémákkal ellenőrzött képzeletbeli értékeket használnak. Az azonosítókat engedélyezettekre, a médiát kész tartalomelemekre, a dátumokat megerősített közzétételi időpontra cseréld. Írás beküldése előtt ellenőrizd a fiók jogosultságát. Ez az oldal nem küld API-kérést.

{
  "name": "sosoapi_research_conversations_get",
  "arguments": {
    "workspace_id": "11111111-1111-4111-8111-111111111111",
    "conversation_id": "11111111-1111-4111-8111-111111111111"
  }
}

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
  }
}

/research-api/conversations/get

MCP telepítése vagy csatlakoztatása

Adatvédelmi beállítások

Szükséges funkciók

Opcionális használati analitika

Munkamenet-visszajátszás engedélyezése ezen a nyilvános webhelyen is

Privát kutatási beszélgetés olvasása

Profilok és átviteli módok

Engedélyek és mellékhatások

Bemeneti mezők

Strukturált kimenet

Példa eszközhívás

structuredContent

Privát kutatási beszélgetés olvasása

Profilok és átviteli módok

Engedélyek és mellékhatások

Bemeneti mezők

Strukturált kimenet

Példa eszközhívás

structuredContent

Mögöttes API-műveletek