recall
Busca facts guardados. REST POST /v1/recall y herramienta MCP recall.
POST/v1/recall
Envía al menos uno de los campos query, predicate o related_to.
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
query | string | no | Entidad (type:id) o tema en lenguaje natural. Máximo de 2000 caracteres. |
predicate | string | no | Filtra un tipo de relación. |
predicates | string[] | no | Filtra cualquiera de los tipos de relación indicados. Máximo de 20. |
entity_type | string | no | Conserva los resultados cuyo tipo de entidad coincida, como user. |
related_to | string | no | Encuentra facts vinculados a esta entidad. |
depth | integer | no | Ampliación a nodos vecinos. Valor predeterminado 2. |
fuzzy_match | boolean | no | Encuentra nombres de entidades similares. |
limit | integer | no | Máximo de facts. Valor predeterminado 20, máximo 200. |
offset | integer | no | Omite esta cantidad de facts. Usa los mismos sort_by y sort_order en cada página. |
sort_by | string | no | Ordena los resultados por created_at, predicate, subject, object, confidence o id. object utiliza el nombre de la entidad o el literal de value. Omítelo para conservar el orden anterior (relevancia semántica en búsqueda vectorial). Si se define, recall devuelve una página ordenada, sin clasificación por embedding ni rellenado por profundidad. |
sort_order | string | no | Acepta asc o desc; valor predeterminado asc. Los empates se resuelven por id en la misma dirección. |
collection | string | no | Código de la collection. Omítelo o indica "" para el espacio predeterminado. |
Respuesta
{
"facts": [
{ "subject": "user:maya", "predicate": "has_skill", "object": "TypeScript" }
],
"count": 1
}
Cada fact puede incluir value (objeto literal), context, source, score (solo en búsqueda semántica) y created_at.
recall_connections
Recorre los nodos vecinos de una entidad. REST POST /v1/recall_connections y herramienta MCP recall_connections.
POST/v1/recall_connections
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
entity | string | sí | Entidad inicial (type:id). |
depth | integer | no | Número de saltos. Valor predeterminado 2. |
limit | integer | no | Máximo de conexiones. Valor predeterminado 20, máximo 500. |
offset | integer | no | Omite esta cantidad de conexiones. |
collection | string | no | Código de la collection. Omítelo para el espacio predeterminado. |
{
"entity": "user:maya",
"depth": 2
}