SosoAPI
ابدأ مجانًا
AR
EN繁中繁體中文（台灣）简体中文日本語한국어DeutschFrançaisEspañolPortuguês (Brasil)العربيةעבריתNederlandsहिन्दीBahasa IndonesiaNorsk bokmålSvenskaMagyar
ابدأ مجانًا

يُحمّل البحث عند استخدامه فقط. تصفّح جميع الفئات أدناه.

أداة MCP

حفظ إصدار من قالب تقرير موجّه

sosoapi_save_report_template

حفظ إصدار من قالب تقرير موجّه. يستخدم مجموعة البيانات والإصدار المحددين صراحةً بعد المراجعة؛ ولا يحدّث المصدر تلقائياً. يمكن تمرير مدخلات الإخراج عبر قناة إلى sosoapi report render --output FILE.

اقرأ بصيغة Markdown

الملفات التعريفية ووسائل النقل

الملفات التعريفية: full · وسائل النقل: stdio, http

اختر core أو full للأدوات التي يراها عميلك؛ لا يغيّر ذلك أذوناته. يحتاج رفع الملفات المحلية stdio ولا يتاح بـ HTTP. اضبط SOSOAPI_OUTPUT_SCHEMAS=1 لمخططات المخرجات بالاكتشاف. النتائج منظّمة بهذا الإعداد أوبدونه.

الأذونات والآثار الجانبية

تساعد الشروح العملاء على وصف الأداة. يظل كل استدعاء يفحص مصادقة المستخدم ودوره ووصوله إلى المورد وتفويض الإمكانات.

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

حقول الإدخال

تعني «مطلوب» داخل الكائن الأب والفرع المختار. الحقل الابن المطلوب لا يجعل الأب الاختياري مطلوباً. نُسخت القواعد وأسماء الحقول أدناه من العقد.

حقول الإدخال
الحقل / الفرعالنوع / مطلوبالقيود
$objectمطلوب في العنصر الأب
  • additionalProperties: false
workspace_idstringمطلوب في العنصر الأب
  • format: "uuid"
templateobjectمطلوب في العنصر الأب
  • additionalProperties: false
template.idstringمطلوب في العنصر الأب
  • format: "uuid"
template.versionintegerمطلوب في العنصر الأب
  • minimum: 1
  • maximum: 1000000
template.namestringمطلوب في العنصر الأب
  • minLength: 1
  • maxLength: 100
template.formatstringمطلوب في العنصر الأب
  • enum: ["pptx","docx","xlsx"]
template.sourceBase64stringمطلوب في العنصر الأب
  • maxLength: 12582912
  • pattern: "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$"
template.sourceSha256stringمطلوب في العنصر الأب
  • pattern: "^[a-f0-9]{64}$"
template.mappingsobjectمطلوب في العنصر الأب
  • additionalProperties: {"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["text"]},"value":{"type":"string","maxLength":2000}},"required":["kind","value"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["selection"]},"field":{"type":"string","enum":["accounts","period","timezone","platforms","dataset","reviewed","coverage"]}},"required":["kind","field"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["metric"]},"platform":{"type":"string","enum":["facebook","instagram","threads","youtube"]},"key":{"type":"string","minLength":1,"maxLength":150},"unit":{"type":"string","minLength":1,"maxLength":100},"grain":{"type":"string","enum":["post","account"]},"measurementKind":{"type":"string","enum":["lifetime","snapshot","period","unknown"]},"accountId":{"type":"string","format":"uuid"},"providerResourceId":{"anyOf":[{"type":"string","minLength":1,"maxLength":512},{"type":"null"}]},"sourcePath":{"type":"string","maxLength":2000},"requestId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]}},"required":["kind","platform","key","unit","grain","measurementKind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["formula"]},"id":{"type":"string","format":"uuid"},"version":{"type":"integer","minimum":1,"maximum":1000000}},"required":["kind","id","version"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["table"]},"source":{"type":"string","enum":["measurements","formulas"]},"limit":{"type":"integer","minimum":1,"maximum":100}},"required":["kind","source","limit"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["chart"]},"source":{"type":"string","enum":["publication_by_platform"]}},"required":["kind","source"],"additionalProperties":false}]}
template.mappings.*objectاختياري / عنصر—
template.mappings.*anyOf 1objectاختياري / عنصر
  • additionalProperties: false
template.mappings.*.kindanyOf 1stringمطلوب في العنصر الأب
  • enum: ["text"]
template.mappings.*.valueanyOf 1stringمطلوب في العنصر الأب
  • maxLength: 2000
template.mappings.*anyOf 2objectاختياري / عنصر
  • additionalProperties: false
template.mappings.*.kindanyOf 2stringمطلوب في العنصر الأب
  • enum: ["selection"]
template.mappings.*.fieldanyOf 2stringمطلوب في العنصر الأب
  • enum: ["accounts","period","timezone","platforms","dataset","reviewed","coverage"]
template.mappings.*anyOf 3objectاختياري / عنصر
  • additionalProperties: false
template.mappings.*.kindanyOf 3stringمطلوب في العنصر الأب
  • enum: ["metric"]
template.mappings.*.platformanyOf 3stringمطلوب في العنصر الأب
  • enum: ["facebook","instagram","threads","youtube"]
template.mappings.*.keyanyOf 3stringمطلوب في العنصر الأب
  • minLength: 1
  • maxLength: 150
template.mappings.*.unitanyOf 3stringمطلوب في العنصر الأب
  • minLength: 1
  • maxLength: 100
template.mappings.*.grainanyOf 3stringمطلوب في العنصر الأب
  • enum: ["post","account"]
template.mappings.*.measurementKindanyOf 3stringمطلوب في العنصر الأب
  • enum: ["lifetime","snapshot","period","unknown"]
template.mappings.*.accountIdanyOf 3stringاختياري / عنصر
  • format: "uuid"
template.mappings.*.providerResourceIdanyOf 3string | nullاختياري / عنصر—
template.mappings.*.providerResourceIdanyOf 3 / anyOf 1stringاختياري / عنصر
  • minLength: 1
  • maxLength: 512
template.mappings.*.providerResourceIdanyOf 3 / anyOf 2nullاختياري / عنصر—
template.mappings.*.sourcePathanyOf 3stringاختياري / عنصر
  • maxLength: 2000
template.mappings.*.requestIdanyOf 3string | nullاختياري / عنصر—
template.mappings.*.requestIdanyOf 3 / anyOf 1stringاختياري / عنصر
  • format: "uuid"
template.mappings.*.requestIdanyOf 3 / anyOf 2nullاختياري / عنصر—
template.mappings.*anyOf 4objectاختياري / عنصر
  • additionalProperties: false
template.mappings.*.kindanyOf 4stringمطلوب في العنصر الأب
  • enum: ["formula"]
template.mappings.*.idanyOf 4stringمطلوب في العنصر الأب
  • format: "uuid"
template.mappings.*.versionanyOf 4integerمطلوب في العنصر الأب
  • minimum: 1
  • maximum: 1000000
template.mappings.*anyOf 5objectاختياري / عنصر
  • additionalProperties: false
template.mappings.*.kindanyOf 5stringمطلوب في العنصر الأب
  • enum: ["table"]
template.mappings.*.sourceanyOf 5stringمطلوب في العنصر الأب
  • enum: ["measurements","formulas"]
template.mappings.*.limitanyOf 5integerمطلوب في العنصر الأب
  • minimum: 1
  • maximum: 100
template.mappings.*anyOf 6objectاختياري / عنصر
  • additionalProperties: false
template.mappings.*.kindanyOf 6stringمطلوب في العنصر الأب
  • enum: ["chart"]
template.mappings.*.sourceanyOf 6stringمطلوب في العنصر الأب
  • enum: ["publication_by_platform"]
expected_versioninteger | nullمطلوب في العنصر الأب—
expected_versionanyOf 1integerمطلوب في العنصر الأب
  • minimum: 1
  • maximum: 1000000
expected_versionanyOf 2nullمطلوب في العنصر الأب—
mutation_idstringمطلوب في العنصر الأب
  • format: "uuid"
مخطط JSON Schema الكامل
{
  "type": "object",
  "properties": {
    "workspace_id": {
      "type": "string",
      "format": "uuid"
    },
    "template": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "format": "uuid"
        },
        "version": {
          "type": "integer",
          "minimum": 1,
          "maximum": 1000000
        },
        "name": {
          "type": "string",
          "minLength": 1,
          "maxLength": 100
        },
        "format": {
          "type": "string",
          "enum": [
            "pptx",
            "docx",
            "xlsx"
          ]
        },
        "sourceBase64": {
          "type": "string",
          "maxLength": 12582912,
          "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$"
        },
        "sourceSha256": {
          "type": "string",
          "pattern": "^[a-f0-9]{64}$"
        },
        "mappings": {
          "type": "object",
          "additionalProperties": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "kind": {
                    "type": "string",
                    "enum": [
                      "text"
                    ]
                  },
                  "value": {
                    "type": "string",
                    "maxLength": 2000
                  }
                },
                "required": [
                  "kind",
                  "value"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "kind": {
                    "type": "string",
                    "enum": [
                      "selection"
                    ]
                  },
                  "field": {
                    "type": "string",
                    "enum": [
                      "accounts",
                      "period",
                      "timezone",
                      "platforms",
                      "dataset",
                      "reviewed",
                      "coverage"
                    ]
                  }
                },
                "required": [
                  "kind",
                  "field"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "kind": {
                    "type": "string",
                    "enum": [
                      "metric"
                    ]
                  },
                  "platform": {
                    "type": "string",
                    "enum": [
                      "facebook",
                      "instagram",
                      "threads",
                      "youtube"
                    ]
                  },
                  "key": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 150
                  },
                  "unit": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100
                  },
                  "grain": {
                    "type": "string",
                    "enum": [
                      "post",
                      "account"
                    ]
                  },
                  "measurementKind": {
                    "type": "string",
                    "enum": [
                      "lifetime",
                      "snapshot",
                      "period",
                      "unknown"
                    ]
                  },
                  "accountId": {
                    "type": "string",
                    "format": "uuid"
                  },
                  "providerResourceId": {
                    "anyOf": [
                      {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 512
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "sourcePath": {
                    "type": "string",
                    "maxLength": 2000
                  },
                  "requestId": {
                    "anyOf": [
                      {
                        "type": "string",
                        "format": "uuid"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  }
                },
                "required": [
                  "kind",
                  "platform",
                  "key",
                  "unit",
                  "grain",
                  "measurementKind"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "kind": {
                    "type": "string",
                    "enum": [
                      "formula"
                    ]
                  },
                  "id": {
                    "type": "string",
                    "format": "uuid"
                  },
                  "version": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 1000000
                  }
                },
                "required": [
                  "kind",
                  "id",
                  "version"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "kind": {
                    "type": "string",
                    "enum": [
                      "table"
                    ]
                  },
                  "source": {
                    "type": "string",
                    "enum": [
                      "measurements",
                      "formulas"
                    ]
                  },
                  "limit": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 100
                  }
                },
                "required": [
                  "kind",
                  "source",
                  "limit"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "kind": {
                    "type": "string",
                    "enum": [
                      "chart"
                    ]
                  },
                  "source": {
                    "type": "string",
                    "enum": [
                      "publication_by_platform"
                    ]
                  }
                },
                "required": [
                  "kind",
                  "source"
                ],
                "additionalProperties": false
              }
            ]
          }
        }
      },
      "required": [
        "id",
        "version",
        "name",
        "format",
        "sourceBase64",
        "sourceSha256",
        "mappings"
      ],
      "additionalProperties": false
    },
    "expected_version": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 1,
          "maximum": 1000000
        },
        {
          "type": "null"
        }
      ]
    },
    "mutation_id": {
      "type": "string",
      "format": "uuid"
    }
  },
  "required": [
    "workspace_id",
    "template",
    "expected_version",
    "mutation_id"
  ],
  "additionalProperties": false
}

مخرجات منظّمة

يصف المخطط structuredContent في نتيجة أداة ناجحة. تشمل استجابة MCP أيضاً content وقد تضبط isError عند الفشل. للنشر، اقرأ النتيجة النهائية بدلاً من اعتبار القبول أوالنص تأكيداً. تشرح عملية API المرتبطة الأذونات وقواعد المحاولة.

تعني «مطلوب» داخل الكائن الأب والفرع المختار. الحقل الابن المطلوب لا يجعل الأب الاختياري مطلوباً. نُسخت القواعد وأسماء الحقول أدناه من العقد.

مخرجات منظّمة
الحقل / الفرعالنوع / مطلوبالقيود
$objectمطلوب في العنصر الأب
  • additionalProperties: false
contractVersionstringمطلوب في العنصر الأب
  • const: "analytics-template/v1"
workspaceIdstringمطلوب في العنصر الأب
  • format: "uuid"
idstringمطلوب في العنصر الأب
  • format: "uuid"
versionintegerمطلوب في العنصر الأب
  • minimum: 1
  • maximum: 1000000
namestringمطلوب في العنصر الأب
  • minLength: 1
  • maxLength: 100
formatstringمطلوب في العنصر الأب
  • enum: ["pptx","docx","xlsx"]
sourceBase64stringمطلوب في العنصر الأب
  • maxLength: 12582912
  • pattern: "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$"
sourceSha256stringمطلوب في العنصر الأب
  • pattern: "^[a-f0-9]{64}$"
mappingsobjectمطلوب في العنصر الأب
  • additionalProperties: {"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"text"},"value":{"type":"string","maxLength":2000}},"required":["kind","value"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"selection"},"field":{"type":"string","enum":["accounts","period","timezone","platforms","dataset","reviewed","coverage"]}},"required":["kind","field"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"metric"},"platform":{"type":"string","enum":["facebook","instagram","threads","youtube"]},"key":{"type":"string","minLength":1,"maxLength":150},"unit":{"type":"string","minLength":1,"maxLength":100},"grain":{"type":"string","enum":["post","account"]},"measurementKind":{"type":"string","enum":["lifetime","snapshot","period","unknown"]},"accountId":{"type":"string","format":"uuid"},"providerResourceId":{"anyOf":[{"type":"string","minLength":1,"maxLength":512},{"type":"null"}]},"sourcePath":{"type":"string","maxLength":2000},"requestId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]}},"required":["kind","platform","key","unit","grain","measurementKind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"formula"},"id":{"type":"string","format":"uuid"},"version":{"type":"integer","minimum":1,"maximum":1000000}},"required":["kind","id","version"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"table"},"source":{"type":"string","enum":["measurements","formulas"]},"limit":{"type":"integer","minimum":1,"maximum":100}},"required":["kind","source","limit"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"chart"},"source":{"type":"string","const":"publication_by_platform"}},"required":["kind","source"],"additionalProperties":false}]}
mappings.*objectاختياري / عنصر—
mappings.*oneOf 1objectاختياري / عنصر
  • additionalProperties: false
mappings.*.kindoneOf 1stringمطلوب في العنصر الأب
  • const: "text"
mappings.*.valueoneOf 1stringمطلوب في العنصر الأب
  • maxLength: 2000
mappings.*oneOf 2objectاختياري / عنصر
  • additionalProperties: false
mappings.*.kindoneOf 2stringمطلوب في العنصر الأب
  • const: "selection"
mappings.*.fieldoneOf 2stringمطلوب في العنصر الأب
  • enum: ["accounts","period","timezone","platforms","dataset","reviewed","coverage"]
mappings.*oneOf 3objectاختياري / عنصر
  • additionalProperties: false
mappings.*.kindoneOf 3stringمطلوب في العنصر الأب
  • const: "metric"
mappings.*.platformoneOf 3stringمطلوب في العنصر الأب
  • enum: ["facebook","instagram","threads","youtube"]
mappings.*.keyoneOf 3stringمطلوب في العنصر الأب
  • minLength: 1
  • maxLength: 150
mappings.*.unitoneOf 3stringمطلوب في العنصر الأب
  • minLength: 1
  • maxLength: 100
mappings.*.grainoneOf 3stringمطلوب في العنصر الأب
  • enum: ["post","account"]
mappings.*.measurementKindoneOf 3stringمطلوب في العنصر الأب
  • enum: ["lifetime","snapshot","period","unknown"]
mappings.*.accountIdoneOf 3stringاختياري / عنصر
  • format: "uuid"
mappings.*.providerResourceIdoneOf 3string | nullاختياري / عنصر—
mappings.*.providerResourceIdoneOf 3 / anyOf 1stringاختياري / عنصر
  • minLength: 1
  • maxLength: 512
mappings.*.providerResourceIdoneOf 3 / anyOf 2nullاختياري / عنصر—
mappings.*.sourcePathoneOf 3stringاختياري / عنصر
  • maxLength: 2000
mappings.*.requestIdoneOf 3string | nullاختياري / عنصر—
mappings.*.requestIdoneOf 3 / anyOf 1stringاختياري / عنصر
  • format: "uuid"
mappings.*.requestIdoneOf 3 / anyOf 2nullاختياري / عنصر—
mappings.*oneOf 4objectاختياري / عنصر
  • additionalProperties: false
mappings.*.kindoneOf 4stringمطلوب في العنصر الأب
  • const: "formula"
mappings.*.idoneOf 4stringمطلوب في العنصر الأب
  • format: "uuid"
mappings.*.versiononeOf 4integerمطلوب في العنصر الأب
  • minimum: 1
  • maximum: 1000000
mappings.*oneOf 5objectاختياري / عنصر
  • additionalProperties: false
mappings.*.kindoneOf 5stringمطلوب في العنصر الأب
  • const: "table"
mappings.*.sourceoneOf 5stringمطلوب في العنصر الأب
  • enum: ["measurements","formulas"]
mappings.*.limitoneOf 5integerمطلوب في العنصر الأب
  • minimum: 1
  • maximum: 100
mappings.*oneOf 6objectاختياري / عنصر
  • additionalProperties: false
mappings.*.kindoneOf 6stringمطلوب في العنصر الأب
  • const: "chart"
mappings.*.sourceoneOf 6stringمطلوب في العنصر الأب
  • const: "publication_by_platform"
createdAtstringمطلوب في العنصر الأب
  • 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)))$"
مخطط JSON Schema الكامل
{
  "type": "object",
  "properties": {
    "contractVersion": {
      "type": "string",
      "const": "analytics-template/v1"
    },
    "workspaceId": {
      "type": "string",
      "format": "uuid"
    },
    "id": {
      "type": "string",
      "format": "uuid"
    },
    "version": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000000
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "format": {
      "type": "string",
      "enum": [
        "pptx",
        "docx",
        "xlsx"
      ]
    },
    "sourceBase64": {
      "type": "string",
      "maxLength": 12582912,
      "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$"
    },
    "sourceSha256": {
      "type": "string",
      "pattern": "^[a-f0-9]{64}$"
    },
    "mappings": {
      "type": "object",
      "propertyNames": {
        "type": "string",
        "pattern": "^[A-Za-z][A-Za-z0-9_.-]{0,63}$"
      },
      "additionalProperties": {
        "oneOf": [
          {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "const": "text"
              },
              "value": {
                "type": "string",
                "maxLength": 2000
              }
            },
            "required": [
              "kind",
              "value"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "const": "selection"
              },
              "field": {
                "type": "string",
                "enum": [
                  "accounts",
                  "period",
                  "timezone",
                  "platforms",
                  "dataset",
                  "reviewed",
                  "coverage"
                ]
              }
            },
            "required": [
              "kind",
              "field"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "const": "metric"
              },
              "platform": {
                "type": "string",
                "enum": [
                  "facebook",
                  "instagram",
                  "threads",
                  "youtube"
                ]
              },
              "key": {
                "type": "string",
                "minLength": 1,
                "maxLength": 150
              },
              "unit": {
                "type": "string",
                "minLength": 1,
                "maxLength": 100
              },
              "grain": {
                "type": "string",
                "enum": [
                  "post",
                  "account"
                ]
              },
              "measurementKind": {
                "type": "string",
                "enum": [
                  "lifetime",
                  "snapshot",
                  "period",
                  "unknown"
                ]
              },
              "accountId": {
                "type": "string",
                "format": "uuid"
              },
              "providerResourceId": {
                "anyOf": [
                  {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 512
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "sourcePath": {
                "type": "string",
                "maxLength": 2000
              },
              "requestId": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "uuid"
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "required": [
              "kind",
              "platform",
              "key",
              "unit",
              "grain",
              "measurementKind"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "const": "formula"
              },
              "id": {
                "type": "string",
                "format": "uuid"
              },
              "version": {
                "type": "integer",
                "minimum": 1,
                "maximum": 1000000
              }
            },
            "required": [
              "kind",
              "id",
              "version"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "const": "table"
              },
              "source": {
                "type": "string",
                "enum": [
                  "measurements",
                  "formulas"
                ]
              },
              "limit": {
                "type": "integer",
                "minimum": 1,
                "maximum": 100
              }
            },
            "required": [
              "kind",
              "source",
              "limit"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "const": "chart"
              },
              "source": {
                "type": "string",
                "const": "publication_by_platform"
              }
            },
            "required": [
              "kind",
              "source"
            ],
            "additionalProperties": false
          }
        ]
      }
    },
    "createdAt": {
      "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"
    }
  },
  "required": [
    "contractVersion",
    "workspaceId",
    "id",
    "version",
    "name",
    "format",
    "sourceBase64",
    "sourceSha256",
    "mappings",
    "createdAt"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

مثال لاستدعاء أداة

تستخدم الأمثلة قيماً خيالية مفحوصة بالمخططات. استبدل المعرّفات بالمفوّض لك، والوسائط بأصول جاهزة، والتواريخ بوقت نشر مؤكد. افحص أهلية الحساب قبل الكتابة. لا تُرسل الصفحة طلبات API.

{
  "name": "sosoapi_save_report_template",
  "arguments": {
    "workspace_id": "11111111-1111-4111-8111-111111111111",
    "template": {
      "id": "11111111-1111-4111-8111-111111111111",
      "version": 1,
      "name": "example",
      "format": "pptx",
      "sourceBase64": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "sourceSha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "mappings": {}
    },
    "expected_version": null,
    "mutation_id": "11111111-1111-4111-8111-111111111111"
  }
}

structuredContent

{
  "contractVersion": "analytics-template/v1",
  "workspaceId": "11111111-1111-4111-8111-111111111111",
  "id": "11111111-1111-4111-8111-111111111111",
  "version": 1,
  "name": "example",
  "format": "pptx",
  "sourceBase64": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "sourceSha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "mappings": {},
  "createdAt": "2099-01-15T09:00:00Z"
}
تثبيت MCP أو ربطه