forget_many
Elimina de 1 a 100 facts en una llamada. Prefiérelo a repetir forget.
POST/v1/forget_many
También existe la herramienta MCP forget_many.
Primero encuentra los facts con recall. Cada elemento identifica un fact exactamente como en forget.
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
facts | object[] | sí | Facts que se eliminan. Mínimo 1, máximo 100. Cada elemento tiene subject, predicate y ref (últimos 5 caracteres del id del fact, o el id completo). Los elementos no aceptan collection. |
collection | string | no | Collection de toda la llamada. Omítela para usar el valor de la conexión. "" fuerza el espacio predeterminado. |
La llamada es de mejor esfuerzo. Los facts encontrados se eliminan juntos en una transacción. Los elementos que no eliminan nada vuelven en failed, y la respuesta sigue siendo 200.
Petición
{
"facts": [
{ "subject": "user:maya", "predicate": "works_at", "ref": "X2C9A" },
{ "subject": "user:maya", "predicate": "has_skill", "ref": "Q7M2D" },
{ "subject": "user:maya", "predicate": "works_at", "ref": "X2C9A" }
]
}
Respuesta
deleted enumera los facts eliminados. failed enumera los elementos que no eliminaron nada, ordenados por index (la posición del elemento en facts). Ambos son siempre arrays.
{
"deleted": [
{ "id": "01KJ8Z3W5Q2YB7N4R6T8VX2C9A", "ref": "X2C9A", "subject": "user:maya", "predicate": "works_at", "object": "company:acme" }
],
"failed": [
{ "index": 1, "subject": "user:maya", "predicate": "has_skill", "ref": "Q7M2D", "error": "fact not found" },
{ "index": 2, "subject": "user:maya", "predicate": "works_at", "ref": "X2C9A", "error": "same fact as an earlier item" }
]
}
| error | Cuándo |
|:--|:--|
| fact not found | Ningún fact coincide |
| multiple facts match subject, predicate, and ref | Dos facts comparten la ref. Pasa el id completo en ref |
| ref must be the last 5 characters of a fact id, or the full id | ref no tiene 5 o 26 caracteres de id |
| same fact as an earlier item | Un elemento anterior ya identifica este fact. Se elimina una vez |
MCP devuelve deleted (el recuento), una tabla facts_deleted con las mismas columnas que recall cuando se eliminó algo y una tabla failed solo cuando falló algún elemento.
Errores
| Estado | Cuándo |
|:--|:--|
| 400 | facts está vacío o tiene más de 100 elementos, o a un elemento le falta subject, predicate o ref |
| 404 | Collection desconocida |
Cada elemento se cobra como una llamada a forget, y la llamada sigue los mismos límites que forget. forget_many nunca elimina una entidad. Usa forget_entity para quitar todo sobre una.