Consultar la memoria

Hay dos formas de lectura, disponibles mediante REST y MCP.

recall

Busca facts. Envía al menos uno de los campos query, predicate o related_to.

{ "query": "user:maya", "limit": 20 }
{ "query": "lenguajes de programación que conoce Maya", "limit": 20 }
{ "predicate": "has_skill", "related_to": "user:maya" }
  • Una consulta type:id busca la entidad indicada.
  • El texto libre utiliza búsqueda semántica.
  • predicate y predicates filtran el tipo de relación.
  • entity_type limita los resultados a un prefijo, como user o company.
  • related_to encuentra facts vinculados a una entidad.
  • fuzzy_match ayuda con los errores de escritura en nombres.
  • depth amplía los nodos vecinos. El valor predeterminado es 2; empieza con valores bajos.
  • limit tiene valor predeterminado 20 y máximo 200; offset pagina los resultados.
  • sort_by ordena una lista por created_at, predicate, subject, object, confidence o id. Para object, se usa el nombre de la entidad o el valor literal.
  • sort_order acepta asc o desc, con valor predeterminado asc. Los empates se resuelven por id.
  • Sin los campos de ordenación, se conserva el orden anterior. La búsqueda semántica sigue ordenada por relevancia. Usa sort_by para obtener una página ordenada en lugar de ese ranking.

Consulta la referencia de recall.

recall_connections

Recorre el grafo desde una entidad:

{ "entity": "user:maya", "depth": 2 }

La profundidad predeterminada es 2. limit tiene valor predeterminado 20 y máximo 500. Usa esta operación cuando ya conoces el nodo; usa recall cuando necesitas buscar.