# Quick Start para agentes LLM
SUMMARY: Em 3 chamadas de API: recupere todas as memórias, armazene uma nova, busque. O workflow essencial de LLM.

KEY CONTEXT:
Base URL: https://synapse.schaefer.zone
Auth: Authorization: Bearer YOUR_MIND_KEY (header) OR ?key=YOUR_MIND_KEY (query)
ALWAYS call /memory/recall at the start of every session.
Wichtigste Befehle: GET /memory/recall, POST /memory, GET /memory/search?q=...
Categories: identity, preference, fact, project, skill, mistake, context, note, credentials
Priorities: low, normal, high, critical
FTS5 search: multiple words = AND, "phrases" in quotes, prefix* for prefix search

Quick Start para agentes LLM
Você perde toda a memória entre sessões. O Synapse é seu cérebro externo. Este
guia mostra as três chamadas de API essenciais que todo agente LLM precisa
conhecer.
> [!CRITICAL]
> Chame  no INÍCIO de CADA sessão.
> Sem essa chamada, você não tem memória de quem é o usuário, do que prometeu
> ou no que estava trabalhando da última vez.
Passo 1: recuperar todas as memórias (SEMPRE PRIMEIRO)
[CODE BLOCK]
Retorna um resumo estruturado em texto puro de todas as memórias armazenadas.
Faça parse disso para reconstruir seu modelo mental do usuário, seus projetos e
interações passadas.
Exemplo de resposta:
[CODE BLOCK]
Passo 2: armazenar uma nova memória
Quando você aprender algo que vale a pena lembrar:
[CODE BLOCK]
Categorias: , , , , , , , , 
Prioridades: , , , 
> [!TIP]
> Sempre inclua um campo  — um identificador curto para a memória. Isso
> permite atualizar a mesma memória depois refazendo POST com a mesma key.
Passo 3: buscar uma memória específica
[CODE BLOCK]
> [!TIP]
> Sintaxe FTS5: múltiplas palavras = busca AND. Frases em aspas: .
> Busca por prefixo: . Booleano: .
Ferramentas abertas (sem cabeçalhos de auth)
Se sua ferramenta só consegue abrir URLs (sem cabeçalhos personalizados), use o
parâmetro :
[CODE BLOCK]
> [!WARNING]
>  é limitado a 60 requisições/minuto. O cabeçalho Bearer não tem limite
> de taxa. Use o cabeçalho Bearer sempre que possível.
Workflow completo de sessão
1. Início da sessão:  — carregar todas as memórias
2. Durante o trabalho:  — encontrar fatos específicos
3. Em nova informação:  — armazenar (com category, key, tags, priority)
4. Periodicamente:  — verificar mensagens humanas
5. Fim da sessão: Armazenar quaisquer aprendizados finais via 
Padrões comuns
Atualizar uma memória existente
Faça POST  com a mesma  e  — a memória existente é
atualizada, não duplicada.
Armazenar status de projeto
[CODE BLOCK]
Registrar um erro (para não repeti-lo)
[CODE BLOCK]
Verificar mensagens humanas
[CODE BLOCK]
Retorna mensagens não lidas do humano. Responda com:
[CODE BLOCK]
Próximos passos
- Autenticação — Mind Key vs JWT
- Referência da API de Memória — todos os 22 endpoints de memória
- API de Chat — comunicação assíncrona com humanos
- Cookbook de LLM — padrões práticos