MCP-eszköz

A munkaterület márkakörnyezetének lekérése

sosoapi_get_workspace_brand_context

Kifejezett workspace_id megadásával olvasd a kézzel megerősített márkaútmutatást és a megváltoztathatatlan verzió eredetét. Legalább viewer szerepkör, ügynökös hozzáféréshez pedig agent:operate szükséges. A selection elhagyásával az aktuális környezet olvasható; másik lehetőség a korábban visszaadott pontos, megváltoztathatatlan selection megadása. A szerkesztői mezők nem megbízhatók; null vagy missing környezet esetén nincs használható útmutatás. Az olvasás nem készít képaláírást, nem kér le forrásokat, nem módosít beállításokat és nem tesz közzé semmit.

Olvasás Markdown formátumban

Profilok és átviteli módok

Profilok: core, 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
}

/studio-api/workspace-brand-profile/context-read: agent:operate · workspace_brand_immutable_manual_context_read

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"`
`selection`	`object`Opcionális / elem	`additionalProperties: false`
`selection.profile_id`	`string`A szülőn belül kötelező	`format: "uuid"`
`selection.version_id`	`string`A szülőn belül kötelező	`format: "uuid"`
`selection.revision`	`integer`A szülőn belül kötelező	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`selection.content_digest`	`string`A szülőn belül kötelező	`pattern: "^[a-f0-9]{64}$"`
`selection.context_digest`	`string`A szülőn belül kötelező	`pattern: "^[a-f0-9]{64}$"`

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

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`
`context`	`object \| null`A szülőn belül kötelező	—
`context`anyOf 1	`object`A szülőn belül kötelező	`additionalProperties: false`
`context.workspace_id`anyOf 1	`string`A szülőn belül kötelező	`format: "uuid"`
`context.selection`anyOf 1	`object`A szülőn belül kötelező	`additionalProperties: false`
`context.selection.profile_id`anyOf 1	`string`A szülőn belül kötelező	`format: "uuid"`
`context.selection.version_id`anyOf 1	`string`A szülőn belül kötelező	`format: "uuid"`
`context.selection.revision`anyOf 1	`integer`A szülőn belül kötelező	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`context.selection.content_digest`anyOf 1	`string`A szülőn belül kötelező	`pattern: "^[a-f0-9]{64}$"`
`context.selection.context_digest`anyOf 1	`string`A szülőn belül kötelező	`pattern: "^[a-f0-9]{64}$"`
`context.availability`anyOf 1	`string`A szülőn belül kötelező	`enum: ["available","missing"]`
`context.profile_state`anyOf 1	`string \| null`A szülőn belül kötelező	—
`context.profile_state`anyOf 1 / anyOf 1	`string`A szülőn belül kötelező	`enum: ["active","archived"]`
`context.profile_state`anyOf 1 / anyOf 2	`null`A szülőn belül kötelező	—
`context.content`anyOf 1	`object \| null`A szülőn belül kötelező	—
`context.content`anyOf 1 / anyOf 1	`object`A szülőn belül kötelező	`additionalProperties: false`
`context.content.name`anyOf 1 / anyOf 1	`string`A szülőn belül kötelező	`maxLength: 120`
`context.content.audience`anyOf 1 / anyOf 1	`string`A szülőn belül kötelező	`maxLength: 2000`
`context.content.voice`anyOf 1 / anyOf 1	`string`A szülőn belül kötelező	`maxLength: 2000`
`context.content.language`anyOf 1 / anyOf 1	`string \| null`A szülőn belül kötelező	—
`context.content.language`anyOf 1 / anyOf 1 / anyOf 1	`string`A szülőn belül kötelező	`minLength: 1` `maxLength: 64`
`context.content.language`anyOf 1 / anyOf 1 / anyOf 2	`null`A szülőn belül kötelező	—
`context.content.preferred_terms`anyOf 1 / anyOf 1	`array`A szülőn belül kötelező	`maxItems: 50`
`context.content.preferred_terms[]`anyOf 1 / anyOf 1	`string`Opcionális / elem	`minLength: 1` `maxLength: 120`
`context.content.prohibited_terms`anyOf 1 / anyOf 1	`array`A szülőn belül kötelező	`maxItems: 50`
`context.content.prohibited_terms[]`anyOf 1 / anyOf 1	`string`Opcionális / elem	`minLength: 1` `maxLength: 120`
`context.content.locked_facts`anyOf 1 / anyOf 1	`array`A szülőn belül kötelező	`maxItems: 50`
`context.content.locked_facts[]`anyOf 1 / anyOf 1	`string`Opcionális / elem	`minLength: 1` `maxLength: 500`
`context.content.call_to_action`anyOf 1 / anyOf 1	`string \| null`A szülőn belül kötelező	—
`context.content.call_to_action`anyOf 1 / anyOf 1 / anyOf 1	`string`A szülőn belül kötelező	`maxLength: 1000`
`context.content.call_to_action`anyOf 1 / anyOf 1 / anyOf 2	`null`A szülőn belül kötelező	—
`context.content`anyOf 1 / anyOf 2	`null`A szülőn belül kötelező	—
`context.sources`anyOf 1	`object`A szülőn belül kötelező	`additionalProperties: false`
`context.sources.website`anyOf 1	`string`A szülőn belül kötelező	`enum: ["available","not_available"]`
`context.sources.logo`anyOf 1	`string`A szülőn belül kötelező	`enum: ["none","present","missing"]`
`context.sources.own_posts`anyOf 1	`object`A szülőn belül kötelező	`additionalProperties: false`
`context.sources.own_posts.selected`anyOf 1	`integer`A szülőn belül kötelező	`minimum: 0` `maximum: 10`
`context.sources.own_posts.available`anyOf 1	`integer`A szülőn belül kötelező	`minimum: 0` `maximum: 10`
`context.sources.own_posts.unavailable`anyOf 1	`integer`A szülőn belül kötelező	`minimum: 0` `maximum: 10`
`context.sources.own_posts.erased`anyOf 1	`integer`A szülőn belül kötelező	`minimum: 0` `maximum: 10`
`context`anyOf 2	`null`A szülőn belül kötelező	—

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

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_get_workspace_brand_context",
  "arguments": {
    "workspace_id": "11111111-1111-4111-8111-111111111111"
  }
}

structuredContent

{
  "context": null
}

/studio-api/workspace-brand-profile/context-read

MCP telepítése vagy csatlakoztatása