recall

Busque facts armazenados. REST POST /v1/recall e ferramenta MCP recall.

POST/v1/recall

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

Campo	Tipo	Obrigatório	Descrição
`query`	string	não	Entidade (`type:id`) ou tema em linguagem natural. Máximo de 2.000 caracteres.
`predicate`	string	não	Filtra um tipo de relação.
`predicates`	string[]	não	Filtra qualquer um dos tipos de relação informados. Máximo de 20.
`entity_type`	string	não	Mantém os resultados cujo tipo de entidade corresponde ao informado, como `user`.
`related_to`	string	não	Encontra facts ligados a esta entidade.
`depth`	integer	não	Expansão para nós vizinhos. Padrão 2 quando omitido.
`fuzzy_match`	boolean	não	Encontra nomes de entidades semelhantes.
`limit`	integer	não	Máximo de facts. Padrão 20, máximo 200.
`offset`	integer	não	Pula esta quantidade de facts. Use o mesmo `sort_by` e `sort_order` em cada página.
`sort_by`	string	não	Ordena os resultados por `created_at`, `predicate`, `subject`, `object`, `confidence` ou `id`. `object` usa o nome da entidade ou o literal em `value`. Omita para manter a ordem anterior (relevância semântica na busca vetorial). Quando definido, recall retorna uma página ordenada, sem ranking por embedding nem preenchimento por profundidade.
`sort_order`	string	não	Aceita `asc` ou `desc`; padrão `asc`. Empates usam `id` na mesma direção.
`collection`	string	não	Código da collection. Omita ou passe `""` para o espaço padrão.

Resposta

{
  "facts": [
    { "subject": "user:maya", "predicate": "has_skill", "object": "TypeScript" }
  ],
  "count": 1
}

Cada fact pode incluir value (objeto literal), context, source, score (apenas na busca semântica) e created_at.

Percorra os vizinhos de uma entidade. REST POST /v1/recall_connections e ferramenta MCP recall_connections.

POST/v1/recall_connections

Campo	Tipo	Obrigatório	Descrição
`entity`	string	sim	Entidade inicial (`type:id`).
`depth`	integer	não	Número de saltos. Padrão 2.
`limit`	integer	não	Máximo de conexões. Padrão 20, máximo 500.
`offset`	integer	não	Pula esta quantidade de conexões.
`collection`	string	não	Código da collection. Omita para o espaço padrão.

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