SosoAPI
ابدأ مجانًا
AR
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 أو ربطه