Skip to main content

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

beginner 🤖 LLM-дружелюбно 2 мин · 326 слов Обновлено: 2026-06-27 Русский

За 3 вызова API: отозвать все воспоминания, сохранить новое, выполнить поиск. Базовый рабочий процесс LLM.

Читать эту статью как: 📄 Простой текст ⚡ JSON 🤖 LLM-формат
Язык: English中文हिन्दीEspañolFrançaisالعربيةPortuguêsРусский日本語DeutschItaliano한국어NederlandsPolskiTürkçeSvenskaTiếng ViệtไทยBahasa IndonesiaУкраїнська

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

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

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

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

GET /memory/recall
Authorization: Bearer YOUR_MIND_KEY

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

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

Mind: Michael's Mind
Memories: 12 total (10 verified)

[001] identity (CRITICAL)
  user_name
  Michael Schäfer
  Tags: person, identity

[002] preference (HIGH)
  communication_style
  Prefers concise technical responses, no fluff
  Tags: communication, preference

[003] project (HIGH)
  project_synapse
  Synapse v1.5.0 deployed on vps1.schaefer.zone. Admin panel at /admin.
  Tags: synapse, deployment
  ...

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

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

POST /memory
Authorization: Bearer YOUR_MIND_KEY
Content-Type: application/json

{
  "category": "fact",
  "key": "user_name",
  "content": "The user's name is Michael Schäfer",
  "tags": ["person", "identity"],
  "priority": "critical"
}

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

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

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

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

GET /memory/search?q=Docker+Swarm
Authorization: Bearer YOUR_MIND_KEY
Синтаксис FTS5: несколько слов = AND-поиск. Фразы в кавычках: `"docker swarm"`. Поиск по префиксу: `docker*`. Булево: `docker OR kubernetes`.

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

Если ваш инструмент может только открывать URL (без пользовательских заголовков), используйте параметр ?key=:

GET /memory/recall?key=YOUR_MIND_KEY
POST /memory?key=YOUR_MIND_KEY (+ JSON body)
GET /memory/search?key=YOUR_MIND_KEY&q=suchbegriff
`?key=` ограничен 60 запросами в минуту. Заголовок Bearer не имеет лимита. Используйте заголовок Bearer всегда, когда возможно.

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

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

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

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

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

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

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

Записать ошибку (чтобы не повторять)

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

Проверить сообщения от человека

GET /chat/poll
Authorization: Bearer YOUR_MIND_KEY

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

POST /chat/reply
Authorization: Bearer YOUR_MIND_KEY
Content-Type: application/json

{"content": "Got it! Working on it now."}

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

← Назад к Начало работы