# remember

Grave memória duradoura somente depois que os limites da política de captura, do escopo e da remoção de segredos forem atendidos.

- Canonical: https://docs.xmemo.dev/pt-br/docs/tools/remember
- Locale: pt-BR
- Content-Locale: pt-BR
- Canonical-Content-Digest: b5d03421cd10a63875746f6339e99b93d92fcef8443db7176726d5aea32edd65
- Edition-Digest: 9317462f4214c3e062decf5f2d0d3c66ce09f58bcba17aff8634659fd6f2e29d
- Source-Revision: sha256:9a04d6faf83e5b7c52876a378ff80d66a4b9561a8bd8f786716b130083cffebb

## Tool Reference: `remember`

### Purpose

Persista informações duradouras que um agente aprovado possa recuperar mais tarde. Esta é a API direta de gravação duradoura; fluxos de eventos devem passar pela política de captura antes de chamá-la.

### Parameters

- `content` (string, required): Corpo da memória duradoura. Mantenha-o factual, limitado e sem segredos.
- `path` (string, required): Local lógico usado para vincular a memória a um projeto ou namespace duradouro.
- `create_project` (boolean, optional, default: false): Somente no perfil público genérico: cria o projeto proprietário se o path indicar um. Não é aceito nos perfis de plugin do ChatGPT ou Claude.

### Returns

O texto de sucesso inclui a referência/ID da memória gravada, o path lógico, a identidade do autor, a conta e o rótulo do dispositivo. Clientes públicos devem tratar a referência como identificador opaco.

### Errors

- 401/403: o token MCP está ausente ou não inclui memory:write.
- Falha de validação: content ou path está vazio, foi fornecido JSON malformado ou algum valor viola o contrato de armazenamento.
- Falha de autorização: o chamador não pode gravar no escopo, projeto ou equipe solicitados.
- Rejeição de segurança: conteúdo semelhante a segredo ou metadados de identidade reservados foi bloqueado ou sanitizado.

### Examples

#### Salve uma decisão duradoura explícita



```typescript
remember({
  content: "Use OAuth for hosted ChatGPT connections.",
  path: "projects/memory-os/decisions"
})
```

### Related Tools

- [recall](/docs/tools/recall): Busque algumas memórias relevantes depois de salvar um fato duradouro.
- [recall_context](/docs/tools/recall-context): Monte um pacote de contexto limitado antes de uma tarefa posterior.
- [ledger](/docs/tools/ledger): Armazene registros financeiros governados em vez de usar memória genérica.

## Confirme que a gravação foi concluída

Leia a memória novamente por meio de uma busca com escopo, em vez de confiar apenas na resposta da gravação.

```ts
search_memory({
  query: "OAuth for hosted ChatGPT connections",
  limit: 3
})
```