Consultar a memória

Há duas formas de leitura, disponíveis por REST e MCP.

recall

Busque facts. Envie pelo menos um dos campos query, predicate ou related_to.

{ "query": "user:maya", "limit": 20 }
{ "query": "linguagens de programação que Maya conhece", "limit": 20 }
{ "predicate": "has_skill", "related_to": "user:maya" }
  • Uma consulta type:id procura a entidade indicada.
  • Texto livre usa busca semântica.
  • predicate e predicates filtram o tipo de relação.
  • entity_type restringe os resultados a um prefixo, como user ou company.
  • related_to encontra facts ligados a uma entidade.
  • fuzzy_match ajuda com erros de digitação em nomes.
  • depth expande os vizinhos. O padrão é 2; comece com valores baixos.
  • limit tem padrão 20 e máximo 200; offset pagina os resultados.
  • sort_by ordena uma listagem por created_at, predicate, subject, object, confidence ou id. Para object, vale o nome da entidade ou o valor literal.
  • sort_order aceita asc ou desc, com padrão asc. O desempate usa id.
  • Sem os dois campos de ordenação, a ordem anterior é mantida. A busca semântica continua ordenada por relevância. Use sort_by para obter uma página ordenada em vez do ranking de relevância.

Veja a referência de recall.

recall_connections

Percorra o grafo a partir de uma entidade:

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

A profundidade padrão é 2. limit tem padrão 20 e máximo 500. Use esta operação quando já souber qual é o nó; use recall para buscar.