Escrever na memória

Há três formas de registrar informações. Escolha conforme o conteúdo que você já tem.

Você tem triplas

Use remember para um fact ou remember_many para um lote de 1 a 100. Prefira o lote quando houver vários facts. Ambas as operações existem em REST e MCP.

{
  "facts": [
    { "subject": "user:maya", "predicate": "display_name", "object": "Maya" },
    { "subject": "user:maya", "predicate": "has_skill", "object": "TypeScript" }
  ],
  "source": "onboarding"
}

source é um rótulo definido por você; não é pesquisado como uma tripla.

Você tem texto

Use feed pela API REST. Envie content como texto ou um array messages. O GoMind extrai triplas e as guarda.

Passe reason: true se quiser que a ingestão consulte a memória existente antes: ela preserva facts duráveis, usa namespaces type:id, normaliza e evita duplicatas. Por padrão, feed faz uma única extração.

feed não é uma ferramenta MCP. Se o agente já tiver triplas, use remember ou remember_many.

Você precisa desfazer

POST /v1/forget (MCP forget) exclui uma tripla. POST /v1/forget_entity (MCP forget_entity) exclui todos os facts sobre uma entidade. Use o mesmo type:id registrado.

Fluxo de agente apenas com REST

POST /v1/mind executa um agente no servidor que pode chamar remember e recall. Use-o quando o prompt for o trabalho a realizar; não o use para ingestão determinística.