Saltar al contenido
ClickHouse Loom
Esc
↑↓navegar↵abrir⌘Jvista previa
En esta página

Operaciones de `collection`

Esta página es una traducción automática de la página en inglés, que prevalece. Machine-translated from the English page, which is authoritative.

Los campos exactos que recibe y devuelve cada operación collection.*.

Cada op es POST /v1/<op> sobre HTTP y la herramienta MCP loom_<op>. Los campos de identidad (org, namespace, agent, user_id, session_id) se rellenan a partir del token y de la sesión MCP cuando el transporte puede hacerlo; en una llamada HTTP sin token en un servidor de un solo usuario, se usa la org de la instalación en todas las ops salvo code.* y tracker.* (que conservan la de su plano), y en algunas ops también su espacio de nombres y su agente; consulta identidades y espacios de nombres. El índice de operaciones explica el rol, el tipo y el listado all de MCP. Los campos de entrada desconocidos se atienden y se nombran en ignored_args.

collection.create

Crea una colección: un espacio de nombres que se lee y se escribe solo mediante permisos.

POST /v1/collection.create · MCP loom_collection_create · rol viewer · idempotente · auditada · no aparece en el conjunto de herramientas MCP all

Campo de entrada Tipo Valor por defecto Significado
org str obligatorio El tenant (primer elemento de la tupla de identidad).
namespace str '' El nombre de la colección, que es también su espacio de nombres (‘col-’ seguido de letras minúsculas, dígitos y ‘-’); se ignora con derive_name.
title str '' Cómo se llama la colección en pantalla (como máximo 200 caracteres, sin caracteres de control ni invisibles; los títulos se pueden repetir dentro de la org); ‘’ para ninguno.
derive_name bool False Deriva el nombre de title en lugar de namespace; si el título ya se usa bajo el padre (en el nivel superior: el del propio llamante), responde con esa colección.
parent str '' La colección en la que se sitúa y de la que hereda permisos; ‘’ para una de nivel superior.
description str '' Qué contiene la colección, que se muestra junto a su nombre (como máximo 2000 caracteres); ‘’ para ninguna.
Campo de salida Tipo Significado
namespace str El espacio de nombres que la op lee o escribe.
parent str La colección en la que se sitúa; ‘’ para una de nivel superior.
created bool False cuando la colección ya existía: la del propio llamante con ese nombre, o la que el título ya nombra allí.
title str El título de la colección; ‘’ para ninguno.

collection.delete

Elimina una colección junto con lo que contiene: un borrado con purga del espacio de nombres (los documentos, los fragmentos, los originales y la memoria desaparecen del disco), después sale del directorio y del árbol, y su nombre no se vuelve a usar…

POST /v1/collection.delete · MCP loom_collection_delete · rol admin · idempotente · auditada · no aparece en el conjunto de herramientas MCP all

Campo de entrada Tipo Valor por defecto Significado
org str obligatorio El tenant (primer elemento de la tupla de identidad).
namespace str obligatorio El espacio de nombres que la op lee o escribe.
Campo de salida Tipo Significado
namespace str El espacio de nombres que la op lee o escribe.
deleted bool False cuando ya estaba eliminada
erasure_id str El borrado de lo que contenía la colección; erasure.status le da seguimiento.
erasure_status str El resultado de ese borrado: completed, o failed mientras el worker de recuperación lo reintenta.

collection.list

Lista las colecciones que el llamante puede leer, por nombre.

POST /v1/collection.list · MCP loom_collection_list · rol viewer · lectura · no aparece en el conjunto de herramientas MCP all

Campo de entrada Tipo Valor por defecto Significado
org str obligatorio El tenant (primer elemento de la tupla de identidad).
limit int 500 Colecciones por página.
include_document_counts bool False Incluye directamente en cada colección el número de documentos activos; false por defecto.
cursor str | None None El next_cursor de la página anterior; ninguno para la primera.
Campo de salida Tipo Significado
collections list[_CollectionEntry] Las colecciones que el llamante puede leer en esta página, por nombre, con el rol del llamante y el título y la descripción de la colección.
next_cursor str | None Pásalo como cursor para la página siguiente; ninguno en la última.

collection.move

Coloca una colección bajo otra, o la separa.

POST /v1/collection.move · MCP loom_collection_move · rol admin · idempotente · auditada · no aparece en el conjunto de herramientas MCP all

Campo de entrada Tipo Valor por defecto Significado
org str obligatorio El tenant (primer elemento de la tupla de identidad).
namespace str obligatorio El espacio de nombres que la op lee o escribe.
parent str '' La nueva colección padre; ‘’ la separa y conserva solo sus propios permisos.
Campo de salida Tipo Significado
namespace str El espacio de nombres que la op lee o escribe.
parent str La colección en la que se sitúa ahora; ‘’ una vez separada.
moved bool False cuando ya estaba allí

¿Te ha resultado útil esta página?