{"title":"Быстрый старт для LLM-агентов","slug":"quick-start-llm","category":"getting-started","summary":"За 3 вызова API: отозвать все воспоминания, сохранить новое, выполнить поиск. Базовый рабочий процесс LLM.","audience":["llm"],"tags":["llm","agent","quickstart","memory"],"difficulty":"beginner","updated":"2026-06-27","word_count":326,"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":"ru","translated":true,"requested_lang":"ru","content_markdown":"\n# Быстрый старт для LLM-агентов\n\nМежду сессиями вы теряете всю память. Synapse — ваш внешний мозг. Это руководство\nпоказывает три обязательных вызова API, которые должен знать каждый LLM-агент.\n\n> [!CRITICAL]\n> Вызывайте `GET /memory/recall` в НАЧАЛЕ КАЖДОЙ сессии.\n> Без этого вызова у вас нет памяти о том, кто пользователь, что вы обещали\n> и над чем работали в прошлый раз.\n\n## Шаг 1: отозвать все воспоминания (ВСЕГДА ПЕРВЫМ)\n\n```\nGET /memory/recall\nAuthorization: Bearer YOUR_MIND_KEY\n```\n\nВозвращает структурированное текстовое резюме всех сохранённых воспоминаний.\nРазберите его, чтобы восстановить ментальную модель пользователя, его проекты\nи прошлые взаимодействия.\n\nПример ответа:\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## Шаг 2: сохранить новое воспоминание\n\nКогда вы узнали что-то, что стоит запомнить:\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**Категории:** `identity`, `preference`, `fact`, `project`, `skill`, `mistake`, `context`, `note`, `credentials`\n\n**Приоритеты:** `low`, `normal`, `high`, `critical`\n\n> [!TIP]\n> Всегда включайте поле `key` — короткий идентификатор воспоминания. Это позволит\n> обновить его позже, повторно отправив POST с тем же ключом.\n\n## Шаг 3: найти конкретное воспоминание\n\n```\nGET /memory/search?q=Docker+Swarm\nAuthorization: Bearer YOUR_MIND_KEY\n```\n\n> [!TIP]\n> Синтаксис FTS5: несколько слов = AND-поиск. Фразы в кавычках: `\"docker swarm\"`.\n> Поиск по префиксу: `docker*`. Булево: `docker OR kubernetes`.\n\n## Открытые инструменты (без заголовков аутентификации)\n\nЕсли ваш инструмент может только открывать URL (без пользовательских заголовков),\nиспользуйте параметр `?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=` ограничен 60 запросами в минуту. Заголовок Bearer не имеет лимита.\n> Используйте заголовок Bearer всегда, когда возможно.\n\n## Полный рабочий процесс сессии\n\n1. **Начало сессии:** `GET /memory/recall` — загрузить все воспоминания\n2. **Во время работы:** `GET /memory/search?q=...` — найти конкретные факты\n3. **При новой информации:** `POST /memory` — сохранить (с category, key, tags, priority)\n4. **Периодически:** `GET /chat/poll` — проверять сообщения от человека\n5. **Конец сессии:** сохранить финальные знания через `POST /memory`\n\n## Типовые паттерны\n\n### Обновить существующее воспоминание\n\nPOST `/memory` с теми же `category` и `key` — существующее воспоминание\nобновится, а не дублируется.\n\n### Сохранить статус проекта\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### Записать ошибку (чтобы не повторять)\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### Проверить сообщения от человека\n\n```\nGET /chat/poll\nAuthorization: Bearer YOUR_MIND_KEY\n```\n\nВозвращает непрочитанные сообщения от человека. Ответьте:\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## Следующие шаги\n\n- [Аутентификация](/docs/getting-started/authentication) — Mind Key против JWT\n- [Справочник Memory API](/docs/api/memory) — все 22 эндпоинта памяти\n- [Chat API](/docs/api/chat) — асинхронное общение с людьми\n- [LLM Cookbook](/docs/llm-cookbook/session-start-pattern) — практические паттерны\n","content_html":"

Быстрый старт для LLM-агентов

\n

Между сессиями вы теряете всю память. Synapse — ваш внешний мозг. Это руководство\nпоказывает три обязательных вызова API, которые должен знать каждый LLM-агент.

\n

Вызывайте `GET /memory/recall` в НАЧАЛЕ КАЖДОЙ сессии.\nБез этого вызова у вас нет памяти о том, кто пользователь, что вы обещали\nи над чем работали в прошлый раз.

Шаг 1: отозвать все воспоминания (ВСЕГДА ПЕРВЫМ)

\n

GET /memory/recall\nAuthorization: Bearer YOUR_MIND_KEY

Возвращает структурированное текстовое резюме всех сохранённых воспоминаний.\nРазберите его, чтобы восстановить ментальную модель пользователя, его проекты\nи прошлые взаимодействия.

\n

Пример ответа:

\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  ...

Шаг 2: сохранить новое воспоминание

\n

Когда вы узнали что-то, что стоит запомнить:

\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}

Категории: identity, preference, fact, project, skill, mistake, context, note, credentials

\n

Приоритеты: low, normal, high, critical

\n

Всегда включайте поле `key` — короткий идентификатор воспоминания. Это позволит\nобновить его позже, повторно отправив POST с тем же ключом.

Шаг 3: найти конкретное воспоминание

\n

GET /memory/search?q=Docker+Swarm\nAuthorization: Bearer YOUR_MIND_KEY

Синтаксис FTS5: несколько слов = AND-поиск. Фразы в кавычках: `\"docker swarm\"`.\nПоиск по префиксу: `docker*`. Булево: `docker OR kubernetes`.

Открытые инструменты (без заголовков аутентификации)

\n

Если ваш инструмент может только открывать URL (без пользовательских заголовков),\nиспользуйте параметр ?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=` ограничен 60 запросами в минуту. Заголовок Bearer не имеет лимита.\nИспользуйте заголовок Bearer всегда, когда возможно.

Полный рабочий процесс сессии

\n

Начало сессии: GET /memory/recall — загрузить все воспоминания
Во время работы: GET /memory/search?q=... — найти конкретные факты
При новой информации: POST /memory — сохранить (с category, key, tags, priority)
Периодически: GET /chat/poll — проверять сообщения от человека
Конец сессии: сохранить финальные знания через POST /memory

\n

Типовые паттерны

\n

Обновить существующее воспоминание

\n

POST /memory с теми же category и key — существующее воспоминание\nобновится, а не дублируется.

\n

Сохранить статус проекта

\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  "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

GET /chat/poll\nAuthorization: Bearer YOUR_MIND_KEY

Возвращает непрочитанные сообщения от человека. Ответьте:

\n

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

Следующие шаги

\n

Аутентификация — Mind Key против JWT
Справочник Memory API — все 22 эндпоинта памяти
Chat API — асинхронное общение с людьми
LLM Cookbook — практические паттерны

\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"]}