Memory

Cada workspace tem uma memória de longo prazo apoiada em vetores. Salve fatos, decisões e notas; recupere-os por significado (não apenas palavras-chave). Os agents pesquisam automaticamente via rag_search, e você pode ler e gravar diretamente pela API.

Salvar uma memória

POST/v1/workspaces/{workspace_id}/memory —

campos: content (obrigatório, o texto a lembrar), e opcionais kind, title, tags (array de strings), source.

bash

curl https://nexevo.ai/v1/workspaces/$NEXEVO_WORKSPACE/memory \
  -H "Authorization: Bearer $NEXEVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Refunds over 30 days require a manager approval.",
    "kind": "policy",
    "tags": ["refunds", "support"]
  }'

Pesquisar

GET/v1/workspaces/{workspace_id}/memory/search —

parâmetros de query: q (obrigatório, a consulta em linguagem natural) e top_k (quantos resultados). Os resultados são classificados por relevância semântica.

bash

curl -G https://nexevo.ai/v1/workspaces/$NEXEVO_WORKSPACE/memory/search \
  -H "Authorization: Bearer $NEXEVO_API_KEY" \
  --data-urlencode "q=what is our refund policy" \
  --data-urlencode "top_k=5"

Listar e esquecer

GET/v1/workspaces/{workspace_id}/memory —

lista as memórias armazenadas.

DELETE/v1/workspaces/{workspace_id}/memory/{point_id} —

esquece uma única memória.

DELETE/v1/workspaces/{workspace_id}/memory —

purga toda a memória do workspace (irreversível).

Memória vs Projects vs Corpora: Memory é a recordação evolutiva do agent em todas as tarefas; Projects contêm contexto permanente para um trabalho específico; coleções de conhecimento nomeadas (corpora) alimentam material de referência maior no mesmo armazenamento. Os agents puxam da memória automaticamente — salvar bons fatos aqui torna toda tarefa futura mais inteligente.