forget_many
Exclua de 1 a 100 facts em uma chamada. Prefira isto a repetir forget.
POST/v1/forget_many
Também existe a ferramenta MCP forget_many.
Encontre os facts com recall primeiro. Cada item identifica um fact exatamente como no forget.
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
facts | object[] | sim | Facts a excluir. Mínimo 1, máximo 100. Cada item tem subject, predicate e ref (últimos 5 caracteres do id do fact, ou o id completo). Os itens não aceitam collection. |
collection | string | não | Collection da chamada inteira. Omita para usar o padrão da conexão. "" força o espaço padrão. |
A chamada é de melhor esforço. Os facts encontrados são excluídos juntos em uma transação. Os itens que não excluem nada voltam em failed, e a resposta continua sendo 200.
Requisição
{
"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" }
]
}
Resposta
deleted lista os facts removidos. failed lista os itens que não excluíram nada, ordenados por index (a posição do item em facts). Os dois são sempre 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 | Quando |
|:--|:--|
| fact not found | Nenhum fact corresponde |
| multiple facts match subject, predicate, and ref | Dois facts têm a mesma ref. Passe o id completo em ref |
| ref must be the last 5 characters of a fact id, or the full id | ref não tem 5 ou 26 caracteres de id |
| same fact as an earlier item | Um item anterior já identifica este fact. Ele é excluído uma vez |
O MCP retorna deleted (a contagem), uma tabela facts_deleted com as mesmas colunas do recall quando algo foi excluído e uma tabela failed só quando algum item falhou.
Erros
| Status | Quando |
|:--|:--|
| 400 | facts está vazio ou tem mais de 100 itens, ou um item não tem subject, predicate ou ref |
| 404 | Collection desconhecida |
Cada item é cobrado como uma chamada de forget, e a chamada segue os mesmos limites de forget. forget_many nunca exclui uma entidade. Use forget_entity para remover tudo sobre uma.