{"title":"Quick Start para agentes LLM","slug":"quick-start-llm","category":"getting-started","summary":"En 3 llamadas a la API: recuperar todas las memorias, almacenar una nueva, buscar. El flujo esencial del LLM.","audience":["llm"],"tags":["llm","agent","quickstart","memory"],"difficulty":"beginner","updated":"2026-06-27","word_count":381,"read_minutes":2,"llm_context":"Base URL: https://synapse.schaefer.zone\nAuth: Authorization: Bearer YOUR_MIND_KEY (header) OR ?key=YOUR_MIND_KEY (query)\nALWAYS call /memory/recall at the start of every session.\nWichtigste Befehle: GET /memory/recall, POST /memory, GET /memory/search?q=...\nCategories: identity, preference, fact, project, skill, mistake, context, note, credentials\nPriorities: low, normal, high, critical\nFTS5 search: multiple words = AND, \"phrases\" in quotes, prefix* for prefix search\n","lang":"es","translated":true,"requested_lang":"es","content_markdown":"\n# Quick Start para agentes LLM\n\nPierde toda la memoria entre sesiones. Synapse es su cerebro externo. Esta guía\nmuestra las tres llamadas esenciales a la API que todo agente LLM debe conocer.\n\n> [!CRITICAL]\n> Llame a `GET /memory/recall` al INICIO de CADA sesión.\n> Sin esta llamada, no tiene memoria de quién es el usuario, qué ha prometido,\n> ni en qué estaba trabajando la última vez.\n\n## Paso 1: Recuperar todas las memorias (SIEMPRE PRIMERO)\n\n```\nGET /memory/recall\nAuthorization: Bearer YOUR_MIND_KEY\n```\n\nDevuelve un resumen estructurado en texto plano de todas las memorias\nalmacenadas. Paréelo para reconstruir su modelo mental del usuario, sus\nproyectos y las interacciones pasadas.\n\nEjemplo de respuesta:\n\n```\nMind: Michael's Mind\nMemories: 12 total (10 verified)\n\n[001] identity (CRITICAL)\n user_name\n Michael Schäfer\n Tags: person, identity\n\n[002] preference (HIGH)\n communication_style\n Prefers concise technical responses, no fluff\n Tags: communication, preference\n\n[003] project (HIGH)\n project_synapse\n Synapse v1.5.0 deployed on vps1.schaefer.zone. Admin panel at /admin.\n Tags: synapse, deployment\n ...\n```\n\n## Paso 2: Almacenar una nueva memoria\n\nCuando aprenda algo que valga la pena recordar:\n\n```\nPOST /memory\nAuthorization: Bearer YOUR_MIND_KEY\nContent-Type: application/json\n\n{\n \"category\": \"fact\",\n \"key\": \"user_name\",\n \"content\": \"The user's name is Michael Schäfer\",\n \"tags\": [\"person\", \"identity\"],\n \"priority\": \"critical\"\n}\n```\n\n**Categorías:** `identity`, `preference`, `fact`, `project`, `skill`, `mistake`, `context`, `note`, `credentials`\n\n**Prioridades:** `low`, `normal`, `high`, `critical`\n\n> [!TIP]\n> Incluya siempre un campo `key` — un identificador corto para la memoria. Esto\n> le permite actualizar la misma memoria más tarde haciendo POST de nuevo con la\n> misma key.\n\n## Paso 3: Buscar una memoria específica\n\n```\nGET /memory/search?q=Docker+Swarm\nAuthorization: Bearer YOUR_MIND_KEY\n```\n\n> [!TIP]\n> Sintaxis FTS5: múltiples palabras = búsqueda AND. Frases entre comillas:\n> `\"docker swarm\"`. Búsqueda por prefijo: `docker*`. Booleano: `docker OR kubernetes`.\n\n## Herramientas abiertas (sin cabeceras de auth)\n\nSi su herramienta solo puede abrir URLs (sin cabeceras personalizadas), use el\nparámetro `?key=`:\n\n```\nGET /memory/recall?key=YOUR_MIND_KEY\nPOST /memory?key=YOUR_MIND_KEY (+ JSON body)\nGET /memory/search?key=YOUR_MIND_KEY&q=suchbegriff\n```\n\n> [!WARNING]\n> `?key=` está limitado a 60 peticiones/minuto. La cabecera Bearer no tiene\n> límite de frecuencia. Use la cabecera Bearer siempre que sea posible.\n\n## Flujo completo de sesión\n\n1. **Inicio de sesión:** `GET /memory/recall` — cargar todas las memorias\n2. **Durante el trabajo:** `GET /memory/search?q=...` — encontrar hechos específicos\n3. **Ante nueva información:** `POST /memory` — almacenarla (con categoría, key, etiquetas, prioridad)\n4. **Periódicamente:** `GET /chat/poll` — comprobar mensajes humanos\n5. **Fin de sesión:** almacenar cualquier aprendizaje final vía `POST /memory`\n\n## Patrones comunes\n\n### Actualizar una memoria existente\n\nPOST `/memory` con la misma `category` y `key` — la memoria existente se\nactualiza, no se duplica.\n\n### Almacenar el estado de un proyecto\n\n```json\n{\n \"category\": \"project\",\n \"key\": \"project_synapse_status\",\n \"content\": \"Synapse v1.5.0 deployed. Next: v1.6.0 with docs system. CI green.\",\n \"tags\": [\"synapse\", \"deployment\", \"status\"],\n \"priority\": \"high\"\n}\n```\n\n### Registrar un error (para no repetirlo)\n\n```json\n{\n \"category\": \"mistake\",\n \"key\": \"mistake_npm_version_bump\",\n \"content\": \"Always bump package.json version after changes — npm publish fails otherwise.\",\n \"tags\": [\"npm\", \"ci\", \"deployment\"],\n \"priority\": \"high\"\n}\n```\n\n### Comprobar mensajes humanos\n\n```\nGET /chat/poll\nAuthorization: Bearer YOUR_MIND_KEY\n```\n\nDevuelve los mensajes no leídos del humano. Responda con:\n\n```\nPOST /chat/reply\nAuthorization: Bearer YOUR_MIND_KEY\nContent-Type: application/json\n\n{\"content\": \"Got it! Working on it now.\"}\n```\n\n## Próximos pasos\n\n- [Autenticación](/docs/getting-started/authentication) — Mind Key vs JWT\n- [Referencia de la API de Memory](/docs/api/memory) — los 22 endpoints de memoria\n- [API de Chat](/docs/api/chat) — comunicación asíncrona con humanos\n- [LLM Cookbook](/docs/llm-cookbook/session-start-pattern) — patrones prácticos\n","content_html":"

Quick Start para agentes LLM

\n

Pierde toda la memoria entre sesiones. Synapse es su cerebro externo. Esta guía\nmuestra las tres llamadas esenciales a la API que todo agente LLM debe conocer.

\n
Llame a `GET /memory/recall` al INICIO de CADA sesión.\nSin esta llamada, no tiene memoria de quién es el usuario, qué ha prometido,\nni en qué estaba trabajando la última vez.

Paso 1: Recuperar todas las memorias (SIEMPRE PRIMERO)

\n
GET /memory/recall\nAuthorization: Bearer YOUR_MIND_KEY

Devuelve un resumen estructurado en texto plano de todas las memorias\nalmacenadas. Paréelo para reconstruir su modelo mental del usuario, sus\nproyectos y las interacciones pasadas.

\n

Ejemplo de respuesta:

\n
Mind: Michael's Mind\nMemories: 12 total (10 verified)\n\n[001] identity (CRITICAL)\n  user_name\n  Michael Schäfer\n  Tags: person, identity\n\n[002] preference (HIGH)\n  communication_style\n  Prefers concise technical responses, no fluff\n  Tags: communication, preference\n\n[003] project (HIGH)\n  project_synapse\n  Synapse v1.5.0 deployed on vps1.schaefer.zone. Admin panel at /admin.\n  Tags: synapse, deployment\n  ...

Paso 2: Almacenar una nueva memoria

\n

Cuando aprenda algo que valga la pena recordar:

\n
POST /memory\nAuthorization: Bearer YOUR_MIND_KEY\nContent-Type: application/json\n\n{\n  "category": "fact",\n  "key": "user_name",\n  "content": "The user's name is Michael Schäfer",\n  "tags": ["person", "identity"],\n  "priority": "critical"\n}

Categorías: identity, preference, fact, project, skill, mistake, context, note, credentials

\n

Prioridades: low, normal, high, critical

\n
Incluya siempre un campo `key` — un identificador corto para la memoria. Esto\nle permite actualizar la misma memoria más tarde haciendo POST de nuevo con la\nmisma key.

Paso 3: Buscar una memoria específica

\n
GET /memory/search?q=Docker+Swarm\nAuthorization: Bearer YOUR_MIND_KEY
Sintaxis FTS5: múltiples palabras = búsqueda AND. Frases entre comillas:\n`\"docker swarm\"`. Búsqueda por prefijo: `docker*`. Booleano: `docker OR kubernetes`.

Herramientas abiertas (sin cabeceras de auth)

\n

Si su herramienta solo puede abrir URLs (sin cabeceras personalizadas), use el\nparámetro ?key=:

\n
GET /memory/recall?key=YOUR_MIND_KEY\nPOST /memory?key=YOUR_MIND_KEY (+ JSON body)\nGET /memory/search?key=YOUR_MIND_KEY&q=suchbegriff
`?key=` está limitado a 60 peticiones/minuto. La cabecera Bearer no tiene\nlímite de frecuencia. Use la cabecera Bearer siempre que sea posible.

Flujo completo de sesión

\n
    \n
  1. Inicio de sesión: GET /memory/recall — cargar todas las memorias
    2. \n
  2. Durante el trabajo: GET /memory/search?q=... — encontrar hechos específicos
    3. \n
  3. Ante nueva información: POST /memory — almacenarla (con categoría, key, etiquetas, prioridad)
    4. \n
  4. Periódicamente: GET /chat/poll — comprobar mensajes humanos
    5. \n
  5. Fin de sesión: almacenar cualquier aprendizaje final vía POST /memory
    6. \n
\n

Patrones comunes

\n

Actualizar una memoria existente

\n

POST /memory con la misma category y key — la memoria existente se\nactualiza, no se duplica.

\n

Almacenar el estado de un proyecto

\n
{\n  "category": "project",\n  "key": "project_synapse_status",\n  "content": "Synapse v1.5.0 deployed. Next: v1.6.0 with docs system. CI green.",\n  "tags": ["synapse", "deployment", "status"],\n  "priority": "high"\n}

Registrar un error (para no repetirlo)

\n
{\n  "category": "mistake",\n  "key": "mistake_npm_version_bump",\n  "content": "Always bump package.json version after changes — npm publish fails otherwise.",\n  "tags": ["npm", "ci", "deployment"],\n  "priority": "high"\n}

Comprobar mensajes humanos

\n
GET /chat/poll\nAuthorization: Bearer YOUR_MIND_KEY

Devuelve los mensajes no leídos del humano. Responda con:

\n
POST /chat/reply\nAuthorization: Bearer YOUR_MIND_KEY\nContent-Type: application/json\n\n{"content": "Got it! Working on it now."}

Próximos pasos

\n\n","urls":{"html":"/docs/getting-started/quick-start-llm","text":"/docs/getting-started/quick-start-llm?format=text","json":"/docs/getting-started/quick-start-llm?format=json","llm":"/docs/getting-started/quick-start-llm?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}