MCP-verktøy
Hent merkevarekontekst for arbeidsområdet
sosoapi_get_workspace_brand_contextLes manuelt bekreftede merkevareråd og opphavet til den uforanderlige versjonen for en eksplisitt workspace_id. Krever rollen viewer eller høyere og agent:operate for agenttilgang. Utelat selection for å lese gjeldende kontekst, eller oppgi den nøyaktige uforanderlige selection fra det tidligere svaret. Redaksjonelle felt er ikke pålitelige; null eller missing betyr at ingen råd er tilgjengelige. Denne leseoperasjonen lager ikke bildetekster, henter ikke kilder, endrer ikke innstillinger og publiserer ingenting.
Les som MarkdownProfiler og transporter
Profiler: core, 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
}- /studio-api/workspace-brand-profile/context-read: agent:operate · workspace_brand_immutable_manual_context_read
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.
| Felt / gren | Type / påkrevd | Begrensninger |
|---|---|---|
$ | objectPåkrevd i forelder |
|
workspace_id | stringPåkrevd i forelder |
|
selection | objectValgfritt / element |
|
selection.profile_id | stringPåkrevd i forelder |
|
selection.version_id | stringPåkrevd i forelder |
|
selection.revision | integerPåkrevd i forelder |
|
selection.content_digest | stringPåkrevd i forelder |
|
selection.context_digest | stringPåkrevd i forelder |
|
Fullstendig JSON Schema
{
"type": "object",
"properties": {
"workspace_id": {
"type": "string",
"format": "uuid"
},
"selection": {
"type": "object",
"properties": {
"profile_id": {
"type": "string",
"format": "uuid"
},
"version_id": {
"type": "string",
"format": "uuid"
},
"revision": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"content_digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"context_digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
}
},
"required": [
"profile_id",
"version_id",
"revision",
"content_digest",
"context_digest"
],
"additionalProperties": false
}
},
"required": [
"workspace_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.
| Felt / gren | Type / påkrevd | Begrensninger |
|---|---|---|
$ | objectPåkrevd i forelder |
|
context | object | nullPåkrevd i forelder | — |
contextanyOf 1 | objectPåkrevd i forelder |
|
context.workspace_idanyOf 1 | stringPåkrevd i forelder |
|
context.selectionanyOf 1 | objectPåkrevd i forelder |
|
context.selection.profile_idanyOf 1 | stringPåkrevd i forelder |
|
context.selection.version_idanyOf 1 | stringPåkrevd i forelder |
|
context.selection.revisionanyOf 1 | integerPåkrevd i forelder |
|
context.selection.content_digestanyOf 1 | stringPåkrevd i forelder |
|
context.selection.context_digestanyOf 1 | stringPåkrevd i forelder |
|
context.availabilityanyOf 1 | stringPåkrevd i forelder |
|
context.profile_stateanyOf 1 | string | nullPåkrevd i forelder | — |
context.profile_stateanyOf 1 / anyOf 1 | stringPåkrevd i forelder |
|
context.profile_stateanyOf 1 / anyOf 2 | nullPåkrevd i forelder | — |
context.contentanyOf 1 | object | nullPåkrevd i forelder | — |
context.contentanyOf 1 / anyOf 1 | objectPåkrevd i forelder |
|
context.content.nameanyOf 1 / anyOf 1 | stringPåkrevd i forelder |
|
context.content.audienceanyOf 1 / anyOf 1 | stringPåkrevd i forelder |
|
context.content.voiceanyOf 1 / anyOf 1 | stringPåkrevd i forelder |
|
context.content.languageanyOf 1 / anyOf 1 | string | nullPåkrevd i forelder | — |
context.content.languageanyOf 1 / anyOf 1 / anyOf 1 | stringPåkrevd i forelder |
|
context.content.languageanyOf 1 / anyOf 1 / anyOf 2 | nullPåkrevd i forelder | — |
context.content.preferred_termsanyOf 1 / anyOf 1 | arrayPåkrevd i forelder |
|
context.content.preferred_terms[]anyOf 1 / anyOf 1 | stringValgfritt / element |
|
context.content.prohibited_termsanyOf 1 / anyOf 1 | arrayPåkrevd i forelder |
|
context.content.prohibited_terms[]anyOf 1 / anyOf 1 | stringValgfritt / element |
|
context.content.locked_factsanyOf 1 / anyOf 1 | arrayPåkrevd i forelder |
|
context.content.locked_facts[]anyOf 1 / anyOf 1 | stringValgfritt / element |
|
context.content.call_to_actionanyOf 1 / anyOf 1 | string | nullPåkrevd i forelder | — |
context.content.call_to_actionanyOf 1 / anyOf 1 / anyOf 1 | stringPåkrevd i forelder |
|
context.content.call_to_actionanyOf 1 / anyOf 1 / anyOf 2 | nullPåkrevd i forelder | — |
context.contentanyOf 1 / anyOf 2 | nullPåkrevd i forelder | — |
context.sourcesanyOf 1 | objectPåkrevd i forelder |
|
context.sources.websiteanyOf 1 | stringPåkrevd i forelder |
|
context.sources.logoanyOf 1 | stringPåkrevd i forelder |
|
context.sources.own_postsanyOf 1 | objectPåkrevd i forelder |
|
context.sources.own_posts.selectedanyOf 1 | integerPåkrevd i forelder |
|
context.sources.own_posts.availableanyOf 1 | integerPåkrevd i forelder |
|
context.sources.own_posts.unavailableanyOf 1 | integerPåkrevd i forelder |
|
context.sources.own_posts.erasedanyOf 1 | integerPåkrevd i forelder |
|
contextanyOf 2 | nullPåkrevd i forelder | — |
Fullstendig JSON Schema
{
"type": "object",
"properties": {
"context": {
"anyOf": [
{
"type": "object",
"properties": {
"workspace_id": {
"type": "string",
"format": "uuid"
},
"selection": {
"type": "object",
"properties": {
"profile_id": {
"type": "string",
"format": "uuid"
},
"version_id": {
"type": "string",
"format": "uuid"
},
"revision": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"content_digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"context_digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
}
},
"required": [
"profile_id",
"version_id",
"revision",
"content_digest",
"context_digest"
],
"additionalProperties": false
},
"availability": {
"type": "string",
"enum": [
"available",
"missing"
]
},
"profile_state": {
"anyOf": [
{
"type": "string",
"enum": [
"active",
"archived"
]
},
{
"type": "null"
}
]
},
"content": {
"anyOf": [
{
"type": "object",
"properties": {
"name": {
"type": "string",
"maxLength": 120
},
"audience": {
"type": "string",
"maxLength": 2000
},
"voice": {
"type": "string",
"maxLength": 2000
},
"language": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 64
},
{
"type": "null"
}
]
},
"preferred_terms": {
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 120
}
},
"prohibited_terms": {
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 120
}
},
"locked_facts": {
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"call_to_action": {
"anyOf": [
{
"type": "string",
"maxLength": 1000
},
{
"type": "null"
}
]
}
},
"required": [
"name",
"audience",
"voice",
"language",
"preferred_terms",
"prohibited_terms",
"locked_facts",
"call_to_action"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"sources": {
"type": "object",
"properties": {
"website": {
"type": "string",
"enum": [
"available",
"not_available"
]
},
"logo": {
"type": "string",
"enum": [
"none",
"present",
"missing"
]
},
"own_posts": {
"type": "object",
"properties": {
"selected": {
"type": "integer",
"minimum": 0,
"maximum": 10
},
"available": {
"type": "integer",
"minimum": 0,
"maximum": 10
},
"unavailable": {
"type": "integer",
"minimum": 0,
"maximum": 10
},
"erased": {
"type": "integer",
"minimum": 0,
"maximum": 10
}
},
"required": [
"selected",
"available",
"unavailable",
"erased"
],
"additionalProperties": false
}
},
"required": [
"website",
"logo",
"own_posts"
],
"additionalProperties": false
}
},
"required": [
"workspace_id",
"selection",
"availability",
"profile_state",
"content",
"sources"
],
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"required": [
"context"
],
"$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_get_workspace_brand_context",
"arguments": {
"workspace_id": "11111111-1111-4111-8111-111111111111"
}
}structuredContent
{
"context": null
}