Alat MCP

Buat aset

sosoapi_create_asset

Daftarkan catatan aset untuk media atau teks yang sudah Anda host (asset_url, asset_type). Operasi ini tidak mengunggah apa pun: gunakan sosoapi_upload_asset untuk file lokal atau sosoapi_import_asset_url agar SosoAPI mengambil URL publik. Sertakan workspace_id (ditolak jika tidak ada setelah penargetan eksplisit diberlakukan). idempotency_key opsional.

Baca sebagai Markdown

Profil dan transport

Profil: full · Transport: stdio, http

Pilih core atau full untuk mengatur alat yang terlihat oleh klien; ini tidak mengubah izinnya. Unggahan file lokal memerlukan stdio dan tidak tersedia melalui HTTP. Atur SOSOAPI_OUTPUT_SCHEMAS=1 untuk menyertakan skema output saat penemuan. Alat mengembalikan hasil terstruktur dengan atau tanpa pengaturan itu.

Izin dan efek samping

Anotasi membantu klien menjelaskan alat. Setiap panggilan tetap memeriksa autentikasi pengguna, peran, akses sumber daya, dan izin kemampuan.

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

/assets-api/create: agent:operate · synchronous_http_response

Kolom input

Wajib berarti wajib dalam objek induk dan cabang yang dipilih. Anak wajib tidak membuat induk opsional menjadi wajib. Aturan dan nama kolom di bawah disalin dari kontrak.

Kolom input
Kolom / cabang	Jenis / wajib	Batasan
`$`	`object`Wajib dalam induk	`additionalProperties: false`
`workspace_id`	`string`Opsional / item	`format: "uuid"`
`asset_type`	`string`Wajib dalam induk	`enum: ["text","image","video"]`
`asset_url`	`string`Wajib dalam induk	`minLength: 1` `maxLength: 2048`
`title`	`string`Opsional / item	`maxLength: 200`
`description`	`string`Opsional / item	`maxLength: 2000`
`tags`	`array`Opsional / item	`maxItems: 50`
`tags[]`	`string`Opsional / item	`maxLength: 64`
`metadata`	`object`Opsional / item	Objek JSON bebas; ukuran UTF-8 setelah serialisasi tidak boleh melebihi 16384 byte. `additionalProperties: {}`
`metadata.*`	`any JSON value`Opsional / item	—
`source`	`string`Opsional / item	`maxLength: 64`
`source_metadata`	`object`Opsional / item	Objek JSON bebas; ukuran UTF-8 setelah serialisasi tidak boleh melebihi 16384 byte. `additionalProperties: {}`
`source_metadata.*`	`any JSON value`Opsional / item	—
`idempotency_key`	`string`Opsional / item	`minLength: 8` `maxLength: 160`

JSON Schema lengkap

{
  "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
}

Output terstruktur

Skema ini menjelaskan structuredContent dalam hasil alat yang berhasil. Respons MCP juga menyertakan content dan dapat menetapkan isError saat panggilan gagal. Untuk publikasi, baca hasil akhir postingan alih-alih menganggap permintaan diterima atau respons teks sebagai konfirmasi. Operasi API yang ditautkan menjelaskan izin dan aturan percobaan ulang.

Wajib berarti wajib dalam objek induk dan cabang yang dipilih. Anak wajib tidak membuat induk opsional menjadi wajib. Aturan dan nama kolom di bawah disalin dari kontrak.

Output terstruktur
Kolom / cabang	Jenis / wajib	Batasan
`$`	`object`Wajib dalam induk	`additionalProperties: false`
`asset`	`object`Wajib dalam induk	`additionalProperties: false`
`asset.id`	`integer \| string`Wajib dalam induk	—
`asset.id`anyOf 1	`integer`Wajib dalam induk	`minimum: -9007199254740991` `maximum: 9007199254740991`
`asset.id`anyOf 2	`string`Wajib dalam induk	—
`asset.workspace_id`	`string`Wajib dalam induk	`format: "uuid"`
`asset.user_id`	`string`Wajib dalam induk	`format: "uuid"`
`asset.asset_type`	`string`Wajib dalam induk	`enum: ["text","image","video","audio"]`
`asset.asset_url`	`string \| null`Wajib dalam induk	—
`asset.asset_url`anyOf 1	`string`Wajib dalam induk	—
`asset.asset_url`anyOf 2	`null`Wajib dalam induk	—
`asset.preview_url`	`string \| null`Opsional / item	URL baca sementara sesuai kewenangan ruang kerja. Perbarui melalui pembacaan/daftar Aset setelah preview_expires_at; pertahankan asset_url sebagai identitas media persisten. —
`asset.preview_url`anyOf 1	`string`Opsional / item	`format: "uri"`
`asset.preview_url`anyOf 2	`null`Opsional / item	—
`asset.preview_expires_at`	`string \| null`Opsional / item	—
`asset.preview_expires_at`anyOf 1	`string`Opsional / item	`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_at`anyOf 2	`null`Opsional / item	—
`asset.title`	`string \| null`Wajib dalam induk	—
`asset.title`anyOf 1	`string`Wajib dalam induk	—
`asset.title`anyOf 2	`null`Wajib dalam induk	—
`asset.description`	`string \| null`Wajib dalam induk	—
`asset.description`anyOf 1	`string`Wajib dalam induk	—
`asset.description`anyOf 2	`null`Wajib dalam induk	—
`asset.tags`	`array \| null`Wajib dalam induk	—
`asset.tags`anyOf 1	`array`Wajib dalam induk	—
`asset.tags[]`anyOf 1	`string`Opsional / item	—
`asset.tags`anyOf 2	`null`Wajib dalam induk	—
`asset.metadata`	`object \| null`Wajib dalam induk	—
`asset.metadata`anyOf 1	`object`Wajib dalam induk	`additionalProperties: {}`
`asset.metadata.*`anyOf 1	`any JSON value`Opsional / item	—
`asset.metadata`anyOf 2	`null`Wajib dalam induk	—
`asset.source`	`string \| null`Opsional / item	—
`asset.source`anyOf 1	`string`Opsional / item	—
`asset.source`anyOf 2	`null`Opsional / item	—
`asset.source_metadata`	`object \| null`Opsional / item	—
`asset.source_metadata`anyOf 1	`object`Opsional / item	`additionalProperties: {}`
`asset.source_metadata.*`anyOf 1	`any JSON value`Opsional / item	—
`asset.source_metadata`anyOf 2	`null`Opsional / item	—
`asset.created_at`	`string`Wajib dalam induk	—
`asset.version`	`integer`Opsional / item	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`deduped`	`boolean`Wajib dalam induk	—

JSON Schema lengkap

{
  "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
}

Contoh panggilan alat

Contoh ini menggunakan nilai fiktif yang diperiksa terhadap skema. Ganti ID dengan yang diizinkan bagi Anda, media dengan aset siap, dan tanggal dengan waktu publikasi yang dikonfirmasi. Periksa kelayakan akun sebelum mengirim penulisan. Halaman ini tidak mengirim permintaan 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
}

/assets-api/create

Instal atau hubungkan MCP