Herramienta MCP

Leer el estado de un análisis de investigación con citas

sosoapi_research_assistant_status

Leer el estado del análisis y la salida no confiable con citas de una conversación/ejecución; nunca regenera el resultado. Requiere agent:research.

Leer en Markdown

Perfiles y transportes

Perfiles: full · Transportes: stdio, http

Elige core o full para controlar qué herramientas ve tu cliente; no cambia sus permisos. La carga de archivos locales requiere stdio y no está disponible por HTTP. Establece SOSOAPI_OUTPUT_SCHEMAS=1 para incluir esquemas de salida en la detección. Las herramientas devuelven resultados estructurados con o sin esa opción.

Permisos y efectos secundarios

Las anotaciones ayudan a los clientes a describir una herramienta. Cada llamada sigue comprobando la autenticación, el rol, el acceso al recurso y los permisos de capacidades del usuario.

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

/research-api/assistant/status: agent:research · estado actual de la ejecución; un resultado completado requiere fuentes y autoridad actuales

Campos de entrada

Obligatorio significa obligatorio dentro del objeto principal y la rama elegida. Un campo secundario obligatorio no convierte en obligatorio un objeto principal opcional. Las reglas y nombres de campos siguientes se copian del contrato.

Campos de entrada
Campo / rama	Tipo / obligatorio	Restricciones
`$`	`object`Obligatorio en el objeto principal	`additionalProperties: false`
`workspace_id`	`string`Obligatorio en el objeto principal	`format: "uuid"`
`conversation_id`	`string`Obligatorio en el objeto principal	`format: "uuid"`
`run_id`	`string`Obligatorio en el objeto principal	`format: "uuid"`

JSON Schema completo

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

Salida estructurada

Este esquema describe structuredContent en un resultado exitoso de herramienta. La respuesta MCP también incluye content y puede establecer isError si falla una llamada. Para publicación, consulta el resultado final de la publicación en vez de considerar una solicitud aceptada o una respuesta de texto como confirmación. La operación API enlazada explica los permisos y las reglas de reintento.

Salida estructurada
Campo / rama	Tipo / obligatorio	Restricciones
`$`	`object`Obligatorio en el objeto principal	`additionalProperties: false`
`run`	`object`Obligatorio en el objeto principal	`additionalProperties: false`
`run.id`	`string`Obligatorio en el objeto principal	`format: "uuid"`
`run.workspace_id`	`string`Obligatorio en el objeto principal	`format: "uuid"`
`run.conversation_id`	`string`Obligatorio en el objeto principal	`format: "uuid"`
`run.conversation_revision`	`integer`Obligatorio en el objeto principal	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`run.generation`	`integer`Obligatorio en el objeto principal	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`run.request_kind`	`string`Obligatorio en el objeto principal	`enum: ["question","overview","themes","audiences","sentiment","query_suggestions"]`
`run.status`	`string`Obligatorio en el objeto principal	`enum: ["queued","processing","completed","failed","cancelled","expired","unavailable"]`
`run.failure_code`	`string \| null`Obligatorio en el objeto principal	—
`run.failure_code`anyOf 1	`string`Obligatorio en el objeto principal	`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_code`anyOf 2	`null`Obligatorio en el objeto principal	—
`run.created_at`	`string`Obligatorio en el objeto principal	`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_at`	`string`Obligatorio en el objeto principal	`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.processor`	`string`Obligatorio en el objeto principal	`const: "Google Gemini"`
`run.model_id`	`string \| null`Obligatorio en el objeto principal	—
`run.model_id`anyOf 1	`string`Obligatorio en el objeto principal	`maxLength: 128`
`run.model_id`anyOf 2	`null`Obligatorio en el objeto principal	—
`run.model_version`	`string \| null`Obligatorio en el objeto principal	—
`run.model_version`anyOf 1	`string`Obligatorio en el objeto principal	`maxLength: 128`
`run.model_version`anyOf 2	`null`Obligatorio en el objeto principal	—
`message`	`object \| null`Obligatorio en el objeto principal	—
`message`anyOf 1	`object`Obligatorio en el objeto principal	`additionalProperties: false`
`message.id`anyOf 1	`string`Obligatorio en el objeto principal	`format: "uuid"`
`message.run_id`anyOf 1	`string`Obligatorio en el objeto principal	`format: "uuid"`
`message.role`anyOf 1	`string`Obligatorio en el objeto principal	`enum: ["user","assistant"]`
`message.question`anyOf 1	`string \| null`Obligatorio en el objeto principal	—
`message.question`anyOf 1 / anyOf 1	`string`Obligatorio en el objeto principal	`maxLength: 2000`
`message.question`anyOf 1 / anyOf 2	`null`Obligatorio en el objeto principal	—
`message.answer`anyOf 1	`object \| null`Obligatorio en el objeto principal	—
`message.answer`anyOf 1 / anyOf 1	`object`Obligatorio en el objeto principal	`additionalProperties: false`
`message.answer.answer`anyOf 1 / anyOf 1	`object`Obligatorio en el objeto principal	`additionalProperties: false`
`message.answer.answer.statement`anyOf 1 / anyOf 1	`string`Obligatorio en el objeto principal	`minLength: 1` `maxLength: 2000`
`message.answer.answer.basis`anyOf 1 / anyOf 1	`string`Obligatorio en el objeto principal	`enum: ["observed","inferred","generated"]`
`message.answer.answer.evidence`anyOf 1 / anyOf 1	`array`Obligatorio en el objeto principal	`minItems: 1` `maxItems: 20`
`message.answer.answer.evidence[]`anyOf 1 / anyOf 1	`object`Opcional / elemento	`additionalProperties: false`
`message.answer.answer.evidence[].evidence_id`anyOf 1 / anyOf 1	`string`Obligatorio en el objeto principal	`format: "uuid"`
`message.answer.answer.evidence[].revision`anyOf 1 / anyOf 1	`integer`Obligatorio en el objeto principal	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`message.answer.answer.uncertainty`anyOf 1 / anyOf 1	`string`Obligatorio en el objeto principal	`maxLength: 1000`
`message.answer.findings`anyOf 1 / anyOf 1	`array`Obligatorio en el objeto principal	`maxItems: 12`
`message.answer.findings[]`anyOf 1 / anyOf 1	`object`Opcional / elemento	`additionalProperties: false`
`message.answer.findings[].statement`anyOf 1 / anyOf 1	`string`Obligatorio en el objeto principal	`minLength: 1` `maxLength: 2000`
`message.answer.findings[].basis`anyOf 1 / anyOf 1	`string`Obligatorio en el objeto principal	`enum: ["observed","inferred","generated"]`
`message.answer.findings[].evidence`anyOf 1 / anyOf 1	`array`Obligatorio en el objeto principal	`minItems: 1` `maxItems: 20`
`message.answer.findings[].evidence[]`anyOf 1 / anyOf 1	`object`Opcional / elemento	`additionalProperties: false`
`message.answer.findings[].evidence[].evidence_id`anyOf 1 / anyOf 1	`string`Obligatorio en el objeto principal	`format: "uuid"`
`message.answer.findings[].evidence[].revision`anyOf 1 / anyOf 1	`integer`Obligatorio en el objeto principal	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`message.answer.findings[].uncertainty`anyOf 1 / anyOf 1	`string`Obligatorio en el objeto principal	`maxLength: 1000`
`message.answer.sentiment`anyOf 1 / anyOf 1	`array`Obligatorio en el objeto principal	`maxItems: 20`
`message.answer.sentiment[]`anyOf 1 / anyOf 1	`object`Opcional / elemento	`additionalProperties: false`
`message.answer.sentiment[].evidence_id`anyOf 1 / anyOf 1	`string`Obligatorio en el objeto principal	`format: "uuid"`
`message.answer.sentiment[].revision`anyOf 1 / anyOf 1	`integer`Obligatorio en el objeto principal	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`message.answer.sentiment[].label`anyOf 1 / anyOf 1	`string`Obligatorio en el objeto principal	`enum: ["positive","negative","neutral","mixed","unknown"]`
`message.answer.sentiment[].uncertainty`anyOf 1 / anyOf 1	`string`Obligatorio en el objeto principal	`maxLength: 1000`
`message.answer.query_suggestions`anyOf 1 / anyOf 1	`array`Obligatorio en el objeto principal	`maxItems: 5`
`message.answer.query_suggestions[]`anyOf 1 / anyOf 1	`object`Opcional / elemento	`additionalProperties: false`
`message.answer.query_suggestions[].query`anyOf 1 / anyOf 1	`string`Obligatorio en el objeto principal	`minLength: 1` `maxLength: 2000`
`message.answer.query_suggestions[].excluded_terms`anyOf 1 / anyOf 1	`array`Obligatorio en el objeto principal	`maxItems: 20`
`message.answer.query_suggestions[].excluded_terms[]`anyOf 1 / anyOf 1	`string`Opcional / elemento	`minLength: 1` `maxLength: 100`
`message.answer.query_suggestions[].evidence`anyOf 1 / anyOf 1	`array`Obligatorio en el objeto principal	`minItems: 1` `maxItems: 20`
`message.answer.query_suggestions[].evidence[]`anyOf 1 / anyOf 1	`object`Opcional / elemento	`additionalProperties: false`
`message.answer.query_suggestions[].evidence[].evidence_id`anyOf 1 / anyOf 1	`string`Obligatorio en el objeto principal	`format: "uuid"`
`message.answer.query_suggestions[].evidence[].revision`anyOf 1 / anyOf 1	`integer`Obligatorio en el objeto principal	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`message.answer.query_suggestions[].rationale`anyOf 1 / anyOf 1	`string`Obligatorio en el objeto principal	`minLength: 1` `maxLength: 1000`
`message.answer.limitations`anyOf 1 / anyOf 1	`array`Obligatorio en el objeto principal	`minItems: 1` `maxItems: 10`
`message.answer.limitations[]`anyOf 1 / anyOf 1	`string`Opcional / elemento	`minLength: 1` `maxLength: 1000`
`message.answer.quantitative_claims`anyOf 1 / anyOf 1	`boolean`Obligatorio en el objeto principal	`const: false`
`message.answer.method_version`anyOf 1 / anyOf 1	`string`Obligatorio en el objeto principal	`const: "research-cited/v1"`
`message.answer`anyOf 1 / anyOf 2	`null`Obligatorio en el objeto principal	—
`message.created_at`anyOf 1	`string`Obligatorio en el objeto principal	`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_at`anyOf 1	`string`Obligatorio en el objeto principal	`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`anyOf 2	`null`Obligatorio en el objeto principal	—
`conversation_revision`	`integer`Obligatorio en el objeto principal	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`availability`	`object`Obligatorio en el objeto principal	`additionalProperties: false`
`availability.configured`	`boolean`Obligatorio en el objeto principal	—
`availability.reason`	`string \| null`Obligatorio en el objeto principal	—
`availability.reason`anyOf 1	`string`Obligatorio en el objeto principal	`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`Obligatorio en el objeto principal	—
`availability.processor`	`string`Obligatorio en el objeto principal	`const: "Google Gemini"`
`availability.retention_hours`	`number`Obligatorio en el objeto principal	`const: 24`

JSON Schema completo

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

Ejemplo de llamada a herramienta

Estos ejemplos usan valores ficticios comprobados con los esquemas. Sustituye los IDs por otros autorizados, los archivos multimedia por recursos listos y las fechas por tu hora de publicación confirmada. Comprueba la elegibilidad de la cuenta antes de enviar una escritura. Esta página no envía solicitudes API.

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

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

/research-api/assistant/status

Instala o conecta MCP

Preferencias de privacidad

Funciones necesarias

Analítica opcional de uso

Permitir también la grabación de sesiones en este sitio web público

Leer el estado de un análisis de investigación con citas

Perfiles y transportes

Permisos y efectos secundarios

Campos de entrada

Salida estructurada

Ejemplo de llamada a herramienta

structuredContent

Leer el estado de un análisis de investigación con citas

Perfiles y transportes

Permisos y efectos secundarios

Campos de entrada

Salida estructurada

Ejemplo de llamada a herramienta

structuredContent

Operaciones API subyacentes