# Quick Start per agenti LLM
SUMMARY: In 3 chiamate API: richiama tutte le memorie, ne memorizza una nuova, cerca. Il workflow LLM essenziale.

KEY CONTEXT:
Base URL: https://synapse.schaefer.zone
Auth: Authorization: Bearer YOUR_MIND_KEY (header, required — ?key= DISABLED by default, AUTH_QUERY_KEY_MODE=deny hardened default; 401 + hint)
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 per agenti LLM
Perde tutta la memoria tra le sessioni. Synapse è il suo cervello esterno.
Questa guida mostra le tre chiamate API essenziali che ogni agente LLM deve
conoscere.
> [!CRITICAL]
> Chiami  all'INIZIO di OGNI sessione.
> Senza questa chiamata, non ha memoria di chi è l'utente, cosa ha promesso,
> o a cosa stava lavorando l'ultima volta.
Passo 1: Richiami tutte le memorie (SEMPRE PER PRIMO)
[CODE BLOCK]
Restituisce un riassunto strutturato in testo semplice di tutte le memorie
salvate. Lo analizzi per ricostruire il suo modello mentale dell'utente, dei
suoi progetti e delle interazioni passate.
Risposta di esempio:
[CODE BLOCK]
Passo 2: Memorizzi una nuova memoria
Quando impara qualcosa che vale la pena ricordare:
[CODE BLOCK]
Categorie: , , , , , , , , 
Priorità: , , , 
> [!TIP]
> Includa sempre un campo  — un breve identificatore per la memoria. Questo
> le permette di aggiornare la stessa memoria in seguito con un nuovo POST usando
> la stessa chiave.
Passo 3: Cerchi una memoria specifica
[CODE BLOCK]
> [!TIP]
> Sintassi FTS5: più parole = ricerca AND. Frasi tra virgolette: .
> Ricerca per prefisso: . Booleano: .
Strumenti aperti (nessun header di auth) — disabilitati per impostazione predefinita
Se il suo strumento può solo aprire URL (nessun header personalizzato): il parametro  è
disabilitato dal default indurito  — l'API è solo Bearer e 
risponde con 401 e il suggerimento "Query-param auth (?key=) is disabled". Solo se un operatore imposta esplicitamente :
[CODE BLOCK]
> [!WARNING]
> Solo in modalità allow,  è limitato a 60 richieste/minuto. I client Bearer esterni ottengono
> 120 req/min per identità; le reti interne affidabili non hanno limiti. Preferisca l'header Bearer.
Workflow completo di sessione
1. Inizio sessione:  — carica tutte le memorie
2. Durante il lavoro:  — trova fatti specifici
3. Su nuove info:  — le memorizza (con category, key, tags, priority)
4. Periodicamente:  — controlla i messaggi dell'umano
5. Fine sessione: Memorizzi gli ultimi apprendimenti tramite 
Modelli comuni
Aggiornare una memoria esistente
POST  con la stessa  e  — la memoria esistente viene
aggiornata, non duplicata.
Memorizzare lo stato di un progetto
[CODE BLOCK]
Registrare un errore (per non ripeterlo)
[CODE BLOCK]
Verificare i messaggi dell'umano
[CODE BLOCK]
Restituisce i messaggi non letti dall'umano. Risponda con:
[CODE BLOCK]
Prossimi passi
- Autenticazione — Mind Key vs JWT
- Riferimento Memory API — tutti i 22 endpoint memory
- Chat API — comunicazione asincrona con gli umani
- LLM Cookbook — modelli pratici