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

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

כלי MCP

יצירת נכס

sosoapi_create_asset

רישום רשומת נכס עבור מדיה או טקסט שכבר מאוחסנים אצלכם (asset_url, asset_type). הפעולה אינה מעלה דבר: השתמשו ב-sosoapi_upload_asset לקובץ מקומי או ב-sosoapi_import_asset_url כדי ש-SosoAPI ימשוך URL ציבורי. העבירו workspace_id (הבקשה תידחה בלעדיו לאחר אכיפת יעד מפורש). idempotency_key אופציונלי.

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

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

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

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

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

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

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

שדות קלט

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

שדות קלט
שדה / ענףסוג / חובהאילוצים
$objectחובה באובייקט האב
  • additionalProperties: false
workspace_idstringרשות / פריט
  • format: "uuid"
asset_typestringחובה באובייקט האב
  • enum: ["text","image","video"]
asset_urlstringחובה באובייקט האב
  • minLength: 1
  • maxLength: 2048
titlestringרשות / פריט
  • maxLength: 200
descriptionstringרשות / פריט
  • maxLength: 2000
tagsarrayרשות / פריט
  • maxItems: 50
tags[]stringרשות / פריט
  • maxLength: 64
metadataobjectרשות / פריט

אובייקט JSON חופשי; הגודל המסודר שלו ב-UTF-8 לא יעלה על 16384 בתים.

  • additionalProperties: {}
metadata.*any JSON valueרשות / פריט—
sourcestringרשות / פריט
  • maxLength: 64
source_metadataobjectרשות / פריט

אובייקט JSON חופשי; הגודל המסודר שלו ב-UTF-8 לא יעלה על 16384 בתים.

  • additionalProperties: {}
source_metadata.*any JSON valueרשות / פריט—
idempotency_keystringרשות / פריט
  • minLength: 8
  • maxLength: 160
JSON Schema מלא
{
  "type": "object",
  "properties": {
    "workspace_id": {
      "type": "string",
      "format": "uuid"
    },
    "asset_type": {
      "type": "string",
      "enum": [
        "text",
        "image",
        "video"
      ]
    },
    "asset_url": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2048
    },
    "title": {
      "type": "string",
      "maxLength": 200
    },
    "description": {
      "type": "string",
      "maxLength": 2000
    },
    "tags": {
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 64
      }
    },
    "metadata": {
      "type": "object",
      "additionalProperties": {},
      "description": "Free-form JSON object; its serialized UTF-8 size must not exceed 16384 bytes."
    },
    "source": {
      "type": "string",
      "maxLength": 64
    },
    "source_metadata": {
      "type": "object",
      "additionalProperties": {},
      "description": "Free-form JSON object; its serialized UTF-8 size must not exceed 16384 bytes."
    },
    "idempotency_key": {
      "type": "string",
      "minLength": 8,
      "maxLength": 160
    }
  },
  "required": [
    "asset_type",
    "asset_url"
  ],
  "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 זמני לקריאה בהרשאת סביבת העבודה. רעננו דרך קריאת נכס/רשימת נכסים לאחר 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
dedupedbooleanחובה באובייקט האב—
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
    },
    "deduped": {
      "type": "boolean"
    }
  },
  "required": [
    "asset",
    "deduped"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

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

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

{
  "name": "sosoapi_create_asset",
  "arguments": {
    "asset_type": "text",
    "asset_url": "example"
  }
}

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"
  },
  "deduped": false
}
התקנה או חיבור של MCP