# Quick Start para agentes LLM
SUMMARY: En 3 llamadas a la API: recuperar todas las memorias, almacenar una nueva, buscar. El flujo esencial del 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
Pierde toda la memoria entre sesiones. Synapse es su cerebro externo. Esta guía
muestra las tres llamadas esenciales a la API que todo agente LLM debe conocer.
> [!CRITICAL]
> Llame a  al INICIO de CADA sesión.
> Sin esta llamada, no tiene memoria de quién es el usuario, qué ha prometido,
> ni en qué estaba trabajando la última vez.
Paso 1: Recuperar todas las memorias (SIEMPRE PRIMERO)
[CODE BLOCK]
Devuelve un resumen estructurado en texto plano de todas las memorias
almacenadas. Paréelo para reconstruir su modelo mental del usuario, sus
proyectos y las interacciones pasadas.
Ejemplo de respuesta:
[CODE BLOCK]
Paso 2: Almacenar una nueva memoria
Cuando aprenda algo que valga la pena recordar:
[CODE BLOCK]
Categorías: , , , , , , , , 
Prioridades: , , , 
> [!TIP]
> Incluya siempre un campo  — un identificador corto para la memoria. Esto
> le permite actualizar la misma memoria más tarde haciendo POST de nuevo con la
> misma key.
Paso 3: Buscar una memoria específica
[CODE BLOCK]
> [!TIP]
> Sintaxis FTS5: múltiples palabras = búsqueda AND. Frases entre comillas:
> . Búsqueda por prefijo: . Booleano: .
Herramientas abiertas (sin cabeceras de auth)
Si su herramienta solo puede abrir URLs (sin cabeceras personalizadas), use el
parámetro :
[CODE BLOCK]
> [!WARNING]
>  está limitado a 60 peticiones/minuto. La cabecera Bearer no tiene
> límite de frecuencia. Use la cabecera Bearer siempre que sea posible.
Flujo completo de sesión
1. Inicio de sesión:  — cargar todas las memorias
2. Durante el trabajo:  — encontrar hechos específicos
3. Ante nueva información:  — almacenarla (con categoría, key, etiquetas, prioridad)
4. Periódicamente:  — comprobar mensajes humanos
5. Fin de sesión: almacenar cualquier aprendizaje final vía 
Patrones comunes
Actualizar una memoria existente
POST  con la misma  y  — la memoria existente se
actualiza, no se duplica.
Almacenar el estado de un proyecto
[CODE BLOCK]
Registrar un error (para no repetirlo)
[CODE BLOCK]
Comprobar mensajes humanos
[CODE BLOCK]
Devuelve los mensajes no leídos del humano. Responda con:
[CODE BLOCK]
Próximos pasos
- Autenticación — Mind Key vs JWT
- Referencia de la API de Memory — los 22 endpoints de memoria
- API de Chat — comunicación asíncrona con humanos
- LLM Cookbook — patrones prácticos