MCP-verktøy

Hent en versjon av et forskningsnotat

sosoapi_research_briefs_get

Les et forskningsnotat etter ID, eventuelt ved en nøyaktig revisjon; returnert tekst er ikke klarert. Krever agent:research.

Les som Markdown

Profiler og transporter

Profiler: full · Transporter: stdio, http

Velg core eller full for å kontrollere hvilke verktøy klienten ser; dette endrer ikke tillatelsene. Lokal filopplasting krever stdio og er utilgjengelig over HTTP. Angi SOSOAPI_OUTPUT_SCHEMAS=1 for å inkludere utdataskjemaer i oppdagelsen. Verktøy returnerer strukturerte resultater med eller uten den innstillingen.

Tillatelser og sideeffekter

Merknader hjelper klienter med å beskrive et verktøy. Hvert kall kontrollerer fortsatt brukerens autentisering, rolle, ressurstilgang og funksjonstillatelser.

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

/research-api/briefs/get: agent:research · nøyaktige forskningsressursdata med gjeldende tillatelse

Inndatafelter

Påkrevd betyr påkrevd i foreldreobjektet og valgt gren. Et påkrevd underfelt gjør ikke en valgfri forelder påkrevd. Reglene og feltnavnene nedenfor er kopiert fra kontrakten.

Inndatafelter
Felt / gren	Type / påkrevd	Begrensninger
`$`	`object`Påkrevd i forelder	`additionalProperties: false`
`workspace_id`	`string`Påkrevd i forelder	`format: "uuid"`
`id`	`string`Påkrevd i forelder	`format: "uuid"`
`revision`	`integer`Valgfritt / element	`maximum: 9007199254740991` `exclusiveMinimum: 0`

Fullstendig JSON Schema

{
  "type": "object",
  "properties": {
    "workspace_id": {
      "type": "string",
      "format": "uuid"
    },
    "id": {
      "type": "string",
      "format": "uuid"
    },
    "revision": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "workspace_id",
    "id"
  ],
  "additionalProperties": false
}

Strukturert utdata

Dette skjemaet beskriver structuredContent i et vellykket verktøyresultat. MCP-svaret inkluderer også content og kan sette isError når et kall mislykkes. Ved publisering, les innleggets endelige resultat i stedet for å regne en akseptert forespørsel eller et tekstsvar som bekreftelse. Den lenkede API-operasjonen forklarer tillatelser og regler for nye forsøk.

Påkrevd betyr påkrevd i foreldreobjektet og valgt gren. Et påkrevd underfelt gjør ikke en valgfri forelder påkrevd. Reglene og feltnavnene nedenfor er kopiert fra kontrakten.

Strukturert utdata
Felt / gren	Type / påkrevd	Begrensninger
`$`	`object`Påkrevd i forelder	`additionalProperties: false`
`brief`	`object`Påkrevd i forelder	`additionalProperties: false`
`brief.id`	`string`Påkrevd i forelder	`format: "uuid"`
`brief.workspace_id`	`string`Påkrevd i forelder	`format: "uuid"`
`brief.revision`	`integer`Påkrevd i forelder	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`brief.archived`	`boolean`Påkrevd i forelder	—
`brief.created_at`	`string`Påkrevd i forelder	`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)))$"`
`brief.updated_at`	`string`Påkrevd i forelder	`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)))$"`
`brief.content`	`object`Påkrevd i forelder	`additionalProperties: false`
`brief.content.title`	`string`Påkrevd i forelder	`minLength: 1` `maxLength: 200`
`brief.content.question`	`string`Påkrevd i forelder	`minLength: 1` `maxLength: 2000`
`brief.content.summary`	`string`Påkrevd i forelder	`maxLength: 10000`
`brief.content.findings`	`array`Påkrevd i forelder	`maxItems: 100`
`brief.content.findings[]`	`object`Valgfritt / element	`additionalProperties: false`
`brief.content.findings[].id`	`string`Påkrevd i forelder	`format: "uuid"`
`brief.content.findings[].statement`	`string`Påkrevd i forelder	`minLength: 1` `maxLength: 4000`
`brief.content.findings[].basis`	`string`Påkrevd i forelder	`enum: ["observed","inferred","generated"]`
`brief.content.findings[].evidence`	`array`Påkrevd i forelder	`maxItems: 500`
`brief.content.findings[].evidence[]`	`object`Valgfritt / element	`additionalProperties: false`
`brief.content.findings[].evidence[].evidence_id`	`string`Påkrevd i forelder	`format: "uuid"`
`brief.content.findings[].evidence[].revision`	`integer`Påkrevd i forelder	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`brief.content.findings[].uncertainty`	`string`Påkrevd i forelder	`maxLength: 1000`
`brief.content.angles`	`array`Påkrevd i forelder	`maxItems: 30`
`brief.content.angles[]`	`string`Valgfritt / element	`minLength: 1` `maxLength: 2000`
`brief.content.notes`	`string`Påkrevd i forelder	`maxLength: 10000`
`brief.content.project_id`	`string \| null`Påkrevd i forelder	—
`brief.content.project_id`anyOf 1	`string`Påkrevd i forelder	`format: "uuid"`
`brief.content.project_id`anyOf 2	`null`Påkrevd i forelder	—
`brief.content.project_revision`	`integer \| null`Påkrevd i forelder	—
`brief.content.project_revision`anyOf 1	`integer`Påkrevd i forelder	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`brief.content.project_revision`anyOf 2	`null`Påkrevd i forelder	—
`brief.content.corpus_snapshot_id`	`string \| null`Påkrevd i forelder	—
`brief.content.corpus_snapshot_id`anyOf 1	`string`Påkrevd i forelder	`format: "uuid"`
`brief.content.corpus_snapshot_id`anyOf 2	`null`Påkrevd i forelder	—
`brief.content.language`	`string`Påkrevd i forelder	`minLength: 1` `maxLength: 35`
`brief.reviewed_revision`	`integer \| null`Påkrevd i forelder	—
`brief.reviewed_revision`anyOf 1	`integer`Påkrevd i forelder	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`brief.reviewed_revision`anyOf 2	`null`Påkrevd i forelder	—

Fullstendig JSON Schema

{
  "type": "object",
  "properties": {
    "brief": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "format": "uuid"
        },
        "workspace_id": {
          "type": "string",
          "format": "uuid"
        },
        "revision": {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        },
        "archived": {
          "type": "boolean"
        },
        "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"
        },
        "updated_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"
        },
        "content": {
          "type": "object",
          "properties": {
            "title": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            },
            "question": {
              "type": "string",
              "minLength": 1,
              "maxLength": 2000
            },
            "summary": {
              "type": "string",
              "maxLength": 10000
            },
            "findings": {
              "maxItems": 100,
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "format": "uuid"
                  },
                  "statement": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 4000
                  },
                  "basis": {
                    "type": "string",
                    "enum": [
                      "observed",
                      "inferred",
                      "generated"
                    ]
                  },
                  "evidence": {
                    "maxItems": 500,
                    "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": [
                  "id",
                  "statement",
                  "basis",
                  "evidence",
                  "uncertainty"
                ],
                "additionalProperties": false
              }
            },
            "angles": {
              "maxItems": 30,
              "type": "array",
              "items": {
                "type": "string",
                "minLength": 1,
                "maxLength": 2000
              }
            },
            "notes": {
              "type": "string",
              "maxLength": 10000
            },
            "project_id": {
              "anyOf": [
                {
                  "type": "string",
                  "format": "uuid"
                },
                {
                  "type": "null"
                }
              ]
            },
            "project_revision": {
              "anyOf": [
                {
                  "type": "integer",
                  "exclusiveMinimum": 0,
                  "maximum": 9007199254740991
                },
                {
                  "type": "null"
                }
              ]
            },
            "corpus_snapshot_id": {
              "anyOf": [
                {
                  "type": "string",
                  "format": "uuid"
                },
                {
                  "type": "null"
                }
              ]
            },
            "language": {
              "type": "string",
              "minLength": 1,
              "maxLength": 35
            }
          },
          "required": [
            "title",
            "question",
            "summary",
            "findings",
            "angles",
            "notes",
            "project_id",
            "project_revision",
            "corpus_snapshot_id",
            "language"
          ],
          "additionalProperties": false
        },
        "reviewed_revision": {
          "anyOf": [
            {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "id",
        "workspace_id",
        "revision",
        "archived",
        "created_at",
        "updated_at",
        "content",
        "reviewed_revision"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "brief"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Eksempel på verktøykall

Disse eksemplene bruker fiktive verdier kontrollert mot skjemaene. Erstatt ID-ene med noen du har lov til å bruke, mediene med klare ressurser og datoene med bekreftet publiseringstidspunkt. Kontroller kontoens kvalifikasjon før en skriveoperasjon sendes inn. Siden sender ingen API-forespørsler.

{
  "name": "sosoapi_research_briefs_get",
  "arguments": {
    "workspace_id": "11111111-1111-4111-8111-111111111111",
    "id": "11111111-1111-4111-8111-111111111111"
  }
}

structuredContent

{
  "brief": {
    "id": "11111111-1111-4111-8111-111111111111",
    "workspace_id": "11111111-1111-4111-8111-111111111111",
    "revision": 1,
    "archived": false,
    "created_at": "2099-01-15T09:00:00Z",
    "updated_at": "2099-01-15T09:00:00Z",
    "content": {
      "title": "example",
      "question": "example",
      "summary": "example",
      "findings": [],
      "angles": [],
      "notes": "example",
      "project_id": null,
      "project_revision": null,
      "corpus_snapshot_id": null,
      "language": "example"
    },
    "reviewed_revision": null
  }
}

/research-api/briefs/get

Installer eller koble til MCP

Personvernvalg

Nødvendige funksjoner

Valgfri bruksanalyse

Tillat også øktopptak på dette offentlige nettstedet

Hent en versjon av et forskningsnotat

Profiler og transporter

Tillatelser og sideeffekter

Inndatafelter

Strukturert utdata

Eksempel på verktøykall

structuredContent

Hent en versjon av et forskningsnotat

Profiler og transporter

Tillatelser og sideeffekter

Inndatafelter

Strukturert utdata

Eksempel på verktøykall

structuredContent

Underliggende API-operasjoner