Colecciones

Crear una colección

Crea un nodo del árbol por el que se organiza el catálogo.

Herramienta

filmo_collections_create

Escrituracollections:write

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "filmo_collections_create",
    "arguments": {
      "name": "Example"
    }
  }
}

{
  "structuredContent": {
    "data": {
      "id": "id_8f2a1c",
      "name": "Example",
      "entityType": "item"
    },
    "meta": {
      "idempotencyKey": "<the key you sent, or the one the server generated>",
      "rateLimit": {
        "limit": 120,
        "remaining": 119,
        "reset": 42
      }
    }
  }
}

generado desde el esquema

entityType decide de qué es el árbol (artículos por defecto) y NO se puede cambiar después. Omite parentCollectionId para una colección de primer nivel.

Argumentos

namestringObligatorio

Nombre de la colección.

Límites: longitud mín. 1

descriptionstring

Descripción de la colección.

parentCollectionIdstring

Colección padre. Omítela para una colección de nivel superior.

iconstring

Icono de la colección.

entityTypestring

Qué agrupa la colección. Por defecto es "item". No se puede cambiar después.

Opciones disponibles: item, space, vehicle, staff, service

idempotencyKeystring

Clave de idempotencia elegida por el cliente (se recomienda un UUID). Repetir la misma clave con los mismos argumentos en 24 h devuelve la respuesta almacenada sin volver a ejecutar; con argumentos distintos responde 422. Es la forma segura de reintentar tras un fallo de red.

Límites: longitud mín. 1, longitud máx. 255

Resultado

En un éxito el resultado lleva structuredContent con data y meta. Estos son los atributos de data.

Ver los atributos de data

idstring

Identificador único de la colección.

namestring

Nombre de la colección.

entityTypestring

Qué agrupa la colección: item, space, vehicle, staff o service.

Opciones disponibles: item, space, vehicle, staff, service

Un error es un resultado con isError: true y el problema en content[0].text; no hay structuredContent. Consulta Errores.

La misma operación por REST

Esta herramienta ejecuta POST /api/v1/collections.

Colecciones
Crear una colección
Crea un nodo del árbol por el que se organiza el catálogo.
Guías
Escrituras seguras
Un asistente que puede escribir también puede escribir lo equivocado. Decide qué herramientas necesitan a una persona, reintenta sin duplicar y sabe qué pone en marcha una escritura.
Guías
Errores
Un error de herramienta es un resultado con isError: true y el problema en el primer bloque de texto. Ramifica por su code.

¿Te ha resultado útil esta página?

Resultado

Argumentos

Resultado

La misma operación por REST

Páginas relacionadas

Crear una colección

Escrituras seguras

Errores