SosoAPI
התחילו בחינם
HE
EN繁中繁體中文（台灣）简体中文日本語한국어DeutschFrançaisEspañolPortuguês (Brasil)العربيةעבריתNederlandsहिन्दीBahasa IndonesiaNorsk bokmålSvenskaMagyar
התחילו בחינם

החיפוש נטען רק כשמשתמשים בו. עיינו בכל הקטגוריות שלהלן.

כלי MCP

קריאת הקשר המותג של סביבת העבודה

sosoapi_get_workspace_brand_context

קראו הנחיות מותג שאושרו ידנית ואת מקור הגרסה שאינה ניתנת לשינוי, עם workspace_id מפורש. נדרש תפקיד viewer ומעלה, ובגישת סוכנים גם agent:operate. השמיטו selection לקריאת ההקשר הנוכחי, או העבירו בדיוק את ה־selection הבלתי משתנה שהוחזרה קודם. שדות עריכה אינם מהימנים; הקשר null או missing אינו מספק הנחיות. הקריאה אינה יוצרת טקסט לפוסטים, אינה מושכת מקורות, אינה משנה הגדרות ואינה מפרסמת.

קריאה בפורמט Markdown

פרופילים ואמצעי תעבורה

פרופילים: core, full · אמצעי תעבורה: stdio, http

בחרו core או full כדי לשלוט בכלים שהלקוח רואה; הבחירה אינה משנה את ההרשאות שלו. העלאת קבצים מקומיים דורשת stdio ואינה זמינה דרך HTTP. הגדירו SOSOAPI_OUTPUT_SCHEMAS=1 להכללת סכמות פלט בגילוי הכלים. הכלים מחזירים תוצאות מובנות עם ההגדרה הזו או בלעדיה.

הרשאות והשפעות לוואי

הערות המטא-נתונים עוזרות ללקוחות לתאר כלי. כל קריאה עדיין בודקת את אימות המשתמש, תפקידו, גישתו למשאבים והרשאות היכולות שלו.

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

שדות קלט

שדה חובה נדרש בתוך אובייקט האב והענף הנבחר שלו. צאצא נדרש אינו הופך אב אופציונלי לנדרש. הכללים ושמות השדות שלהלן מועתקים מהחוזה.

שדות קלט
שדה / ענףסוג / חובהאילוצים
$objectחובה באובייקט האב
  • additionalProperties: false
workspace_idstringחובה באובייקט האב
  • format: "uuid"
selectionobjectרשות / פריט
  • additionalProperties: false
selection.profile_idstringחובה באובייקט האב
  • format: "uuid"
selection.version_idstringחובה באובייקט האב
  • format: "uuid"
selection.revisionintegerחובה באובייקט האב
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
selection.content_digeststringחובה באובייקט האב
  • pattern: "^[a-f0-9]{64}$"
selection.context_digeststringחובה באובייקט האב
  • pattern: "^[a-f0-9]{64}$"
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
}

פלט מובנה

הסכמה מתארת את structuredContent בתוצאת כלי מוצלחת. תגובת MCP כוללת גם content ועשויה להגדיר isError כשקריאה נכשלת. בפרסום, קראו את התוצאה הסופית של הפוסט במקום לראות בבקשה שהתקבלה או בתגובת טקסט אישור. פעולת ה-API המקושרת מסבירה הרשאות וכללי ניסיון חוזר.

שדה חובה נדרש בתוך אובייקט האב והענף הנבחר שלו. צאצא נדרש אינו הופך אב אופציונלי לנדרש. הכללים ושמות השדות שלהלן מועתקים מהחוזה.

פלט מובנה
שדה / ענףסוג / חובהאילוצים
$objectחובה באובייקט האב
  • additionalProperties: false
contextobject | nullחובה באובייקט האב—
contextanyOf 1objectחובה באובייקט האב
  • additionalProperties: false
context.workspace_idanyOf 1stringחובה באובייקט האב
  • format: "uuid"
context.selectionanyOf 1objectחובה באובייקט האב
  • additionalProperties: false
context.selection.profile_idanyOf 1stringחובה באובייקט האב
  • format: "uuid"
context.selection.version_idanyOf 1stringחובה באובייקט האב
  • format: "uuid"
context.selection.revisionanyOf 1integerחובה באובייקט האב
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
context.selection.content_digestanyOf 1stringחובה באובייקט האב
  • pattern: "^[a-f0-9]{64}$"
context.selection.context_digestanyOf 1stringחובה באובייקט האב
  • pattern: "^[a-f0-9]{64}$"
context.availabilityanyOf 1stringחובה באובייקט האב
  • enum: ["available","missing"]
context.profile_stateanyOf 1string | nullחובה באובייקט האב—
context.profile_stateanyOf 1 / anyOf 1stringחובה באובייקט האב
  • enum: ["active","archived"]
context.profile_stateanyOf 1 / anyOf 2nullחובה באובייקט האב—
context.contentanyOf 1object | nullחובה באובייקט האב—
context.contentanyOf 1 / anyOf 1objectחובה באובייקט האב
  • additionalProperties: false
context.content.nameanyOf 1 / anyOf 1stringחובה באובייקט האב
  • maxLength: 120
context.content.audienceanyOf 1 / anyOf 1stringחובה באובייקט האב
  • maxLength: 2000
context.content.voiceanyOf 1 / anyOf 1stringחובה באובייקט האב
  • maxLength: 2000
context.content.languageanyOf 1 / anyOf 1string | nullחובה באובייקט האב—
context.content.languageanyOf 1 / anyOf 1 / anyOf 1stringחובה באובייקט האב
  • minLength: 1
  • maxLength: 64
context.content.languageanyOf 1 / anyOf 1 / anyOf 2nullחובה באובייקט האב—
context.content.preferred_termsanyOf 1 / anyOf 1arrayחובה באובייקט האב
  • maxItems: 50
context.content.preferred_terms[]anyOf 1 / anyOf 1stringרשות / פריט
  • minLength: 1
  • maxLength: 120
context.content.prohibited_termsanyOf 1 / anyOf 1arrayחובה באובייקט האב
  • maxItems: 50
context.content.prohibited_terms[]anyOf 1 / anyOf 1stringרשות / פריט
  • minLength: 1
  • maxLength: 120
context.content.locked_factsanyOf 1 / anyOf 1arrayחובה באובייקט האב
  • maxItems: 50
context.content.locked_facts[]anyOf 1 / anyOf 1stringרשות / פריט
  • minLength: 1
  • maxLength: 500
context.content.call_to_actionanyOf 1 / anyOf 1string | nullחובה באובייקט האב—
context.content.call_to_actionanyOf 1 / anyOf 1 / anyOf 1stringחובה באובייקט האב
  • maxLength: 1000
context.content.call_to_actionanyOf 1 / anyOf 1 / anyOf 2nullחובה באובייקט האב—
context.contentanyOf 1 / anyOf 2nullחובה באובייקט האב—
context.sourcesanyOf 1objectחובה באובייקט האב
  • additionalProperties: false
context.sources.websiteanyOf 1stringחובה באובייקט האב
  • enum: ["available","not_available"]
context.sources.logoanyOf 1stringחובה באובייקט האב
  • enum: ["none","present","missing"]
context.sources.own_postsanyOf 1objectחובה באובייקט האב
  • additionalProperties: false
context.sources.own_posts.selectedanyOf 1integerחובה באובייקט האב
  • minimum: 0
  • maximum: 10
context.sources.own_posts.availableanyOf 1integerחובה באובייקט האב
  • minimum: 0
  • maximum: 10
context.sources.own_posts.unavailableanyOf 1integerחובה באובייקט האב
  • minimum: 0
  • maximum: 10
context.sources.own_posts.erasedanyOf 1integerחובה באובייקט האב
  • minimum: 0
  • maximum: 10
contextanyOf 2nullחובה באובייקט האב—
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
}

דוגמת קריאה לכלי

הדוגמאות משתמשות בערכים בדויים שנבדקו מול הסכמות. החליפו את המזהים בכאלה שאתם מורשים להשתמש בהם, את המדיה בנכסים מוכנים ואת התאריכים במועד הפרסום שאישרתם. בדקו את התאמת החשבון לפני שליחת כתיבה. העמוד הזה אינו שולח בקשות API.

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

structuredContent

{
  "context": null
}
התקנה או חיבור של MCP