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.

CampoTipoObligatorioDescripción
querystringnoEntidad (type:id) o tema en lenguaje natural. Máximo de 2000 caracteres.
predicatestringnoFiltra un tipo de relación.
predicatesstring[]noFiltra cualquiera de los tipos de relación indicados. Máximo de 20.
entity_typestringnoConserva los resultados cuyo tipo de entidad coincida, como user.
related_tostringnoEncuentra facts vinculados a esta entidad.
depthintegernoAmpliación a nodos vecinos. Valor predeterminado 2.
fuzzy_matchbooleannoEncuentra nombres de entidades similares.
limitintegernoMáximo de facts. Valor predeterminado 20, máximo 200.
offsetintegernoOmite esta cantidad de facts. Usa los mismos sort_by y sort_order en cada página.
sort_bystringnoOrdena 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_orderstringnoAcepta asc o desc; valor predeterminado asc. Los empates se resuelven por id en la misma dirección.
collectionstringnoCó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

CampoTipoObligatorioDescripción
entitystringsíEntidad inicial (type:id).
depthintegernoNúmero de saltos. Valor predeterminado 2.
limitintegernoMáximo de conexiones. Valor predeterminado 20, máximo 500.
offsetintegernoOmite esta cantidad de conexiones.
collectionstringnoCódigo de la collection. Omítelo para el espacio predeterminado.
{
  "entity": "user:maya",
  "depth": 2
}