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

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

أداة MCP

تحديث أصل

sosoapi_update_asset

تغيير عنوان أصل أو وصفه أو وسومه (دور editor).

اقرأ بصيغة 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"
idinteger | stringمطلوب في العنصر الأب—
idanyOf 1integerمطلوب في العنصر الأب
  • minimum: -9007199254740991
  • maximum: 9007199254740991
idanyOf 2stringمطلوب في العنصر الأب—
titlestringاختياري / عنصر
  • maxLength: 200
descriptionstringاختياري / عنصر
  • maxLength: 2000
tagsarrayاختياري / عنصر
  • maxItems: 50
tags[]stringاختياري / عنصر
  • maxLength: 64
expected_versionintegerاختياري / عنصر

اختياري. الإصدار الذي قرأته. إذا تغيّر بعد ذلك، يفشل التحديث برمز 409 VERSION_CONFLICT بدلاً من الاستبدال.

  • maximum: 2147483647
  • exclusiveMinimum: 0
include_versionbooleanاختياري / عنصر

اختياري. تضيف true إصدار المورد إلى الإجابة.

—
مخطط JSON Schema الكامل
{
  "type": "object",
  "properties": {
    "workspace_id": {
      "type": "string",
      "format": "uuid"
    },
    "id": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        {
          "type": "string"
        }
      ]
    },
    "title": {
      "type": "string",
      "maxLength": 200
    },
    "description": {
      "type": "string",
      "maxLength": 2000
    },
    "tags": {
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 64
      }
    },
    "expected_version": {
      "description": "Optional. The version you read. If it changed since, the update fails with 409 VERSION_CONFLICT instead of overwriting.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 2147483647
    },
    "include_version": {
      "description": "Optional. true adds the resource version to the answer.",
      "type": "boolean"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

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

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

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

مخرجات منظّمة
الحقل / الفرعالنوع / مطلوبالقيود
$objectمطلوب في العنصر الأب
  • additionalProperties: false
assetobjectمطلوب في العنصر الأب
  • additionalProperties: false
asset.idinteger | stringمطلوب في العنصر الأب—
asset.idanyOf 1integerمطلوب في العنصر الأب
  • minimum: -9007199254740991
  • maximum: 9007199254740991
asset.idanyOf 2stringمطلوب في العنصر الأب—
asset.workspace_idstringمطلوب في العنصر الأب
  • format: "uuid"
asset.user_idstringمطلوب في العنصر الأب
  • format: "uuid"
asset.asset_typestringمطلوب في العنصر الأب
  • enum: ["text","image","video","audio"]
asset.asset_urlstring | nullمطلوب في العنصر الأب—
asset.asset_urlanyOf 1stringمطلوب في العنصر الأب—
asset.asset_urlanyOf 2nullمطلوب في العنصر الأب—
asset.preview_urlstring | nullاختياري / عنصر

URL قراءة مؤقت مفوّض من مساحة العمل. حدّثه بقراءة/عرض Asset بعد preview_expires_at؛ واحتفظ بـ asset_url هويةً مخزّنة للوسائط.

—
asset.preview_urlanyOf 1stringاختياري / عنصر
  • format: "uri"
asset.preview_urlanyOf 2nullاختياري / عنصر—
asset.preview_expires_atstring | nullاختياري / عنصر—
asset.preview_expires_atanyOf 1stringاختياري / عنصر
  • 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))$"
asset.preview_expires_atanyOf 2nullاختياري / عنصر—
asset.titlestring | nullمطلوب في العنصر الأب—
asset.titleanyOf 1stringمطلوب في العنصر الأب—
asset.titleanyOf 2nullمطلوب في العنصر الأب—
asset.descriptionstring | nullمطلوب في العنصر الأب—
asset.descriptionanyOf 1stringمطلوب في العنصر الأب—
asset.descriptionanyOf 2nullمطلوب في العنصر الأب—
asset.tagsarray | nullمطلوب في العنصر الأب—
asset.tagsanyOf 1arrayمطلوب في العنصر الأب—
asset.tags[]anyOf 1stringاختياري / عنصر—
asset.tagsanyOf 2nullمطلوب في العنصر الأب—
asset.metadataobject | nullمطلوب في العنصر الأب—
asset.metadataanyOf 1objectمطلوب في العنصر الأب
  • additionalProperties: {}
asset.metadata.*anyOf 1any JSON valueاختياري / عنصر—
asset.metadataanyOf 2nullمطلوب في العنصر الأب—
asset.sourcestring | nullاختياري / عنصر—
asset.sourceanyOf 1stringاختياري / عنصر—
asset.sourceanyOf 2nullاختياري / عنصر—
asset.source_metadataobject | nullاختياري / عنصر—
asset.source_metadataanyOf 1objectاختياري / عنصر
  • additionalProperties: {}
asset.source_metadata.*anyOf 1any JSON valueاختياري / عنصر—
asset.source_metadataanyOf 2nullاختياري / عنصر—
asset.created_atstringمطلوب في العنصر الأب—
asset.versionintegerاختياري / عنصر
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
مخطط JSON Schema الكامل
{
  "type": "object",
  "properties": {
    "asset": {
      "type": "object",
      "properties": {
        "id": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            {
              "type": "string"
            }
          ]
        },
        "workspace_id": {
          "type": "string",
          "format": "uuid"
        },
        "user_id": {
          "type": "string",
          "format": "uuid"
        },
        "asset_type": {
          "type": "string",
          "enum": [
            "text",
            "image",
            "video",
            "audio"
          ]
        },
        "asset_url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "preview_url": {
          "description": "Workspace-authorized temporary read URL. Refresh through Asset read/list after preview_expires_at; keep asset_url as persisted media identity.",
          "anyOf": [
            {
              "type": "string",
              "format": "uri"
            },
            {
              "type": "null"
            }
          ]
        },
        "preview_expires_at": {
          "anyOf": [
            {
              "type": "string",
              "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))$"
            },
            {
              "type": "null"
            }
          ]
        },
        "title": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "description": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "tags": {
          "anyOf": [
            {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            {
              "type": "null"
            }
          ]
        },
        "metadata": {
          "anyOf": [
            {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {}
            },
            {
              "type": "null"
            }
          ]
        },
        "source": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "source_metadata": {
          "anyOf": [
            {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {}
            },
            {
              "type": "null"
            }
          ]
        },
        "created_at": {
          "type": "string"
        },
        "version": {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        }
      },
      "required": [
        "id",
        "workspace_id",
        "user_id",
        "asset_type",
        "asset_url",
        "title",
        "description",
        "tags",
        "metadata",
        "created_at"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "asset"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

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

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

{
  "name": "sosoapi_update_asset",
  "arguments": {
    "id": 0
  }
}

structuredContent

{
  "asset": {
    "id": 0,
    "workspace_id": "11111111-1111-4111-8111-111111111111",
    "user_id": "11111111-1111-4111-8111-111111111111",
    "asset_type": "text",
    "asset_url": null,
    "title": null,
    "description": null,
    "tags": null,
    "metadata": null,
    "created_at": "example"
  }
}
تثبيت MCP أو ربطه