{"title":"Створення постійного LLM-агента","slug":"persistent-llm-agent","category":"guides","summary":"Покроковий посібник зі створення LLM-агента, що пам'ятає між сесіями за допомогою Synapse.","audience":["human","llm"],"tags":["guide","agent","persistence","architecture"],"difficulty":"intermediate","updated":"2026-06-27","word_count":201,"read_minutes":1,"lang":"uk","translated":true,"requested_lang":"uk","content_markdown":"\n# Огляд\n\nЦей посібник проведе вас через побудову LLM-агента, що зберігає контекст між\nсесіями за допомогою Synapse. Наприкінці ваш агент зможе:\n\n- Відкликати минулий контекст на початку сесії\n- Зберігати нові висновки в міру їхньої появи\n- Відстежувати багатокрокові завдання між сесіями\n- Спілкуватися з людьми через асинхронний чат\n\n## Архітектура\n\n```text\n┌──────────────┐ recall/store ┌──────────┐\n│ LLM Agent │ ◀──────────────▶ │ Synapse │\n│ (your code) │ │ API │\n└──────────────┘ └──────────┘\n │\n │ poll/reply\n ▼\n┌──────────────┐\n│ Human │ (browser or chat UI)\n└──────────────┘\n```\n\n## Крок 1: Налаштуйте Mind Key\n\n```bash\n# Зареєструйтесь та отримайте JWT\nJWT=$(curl -s -X POST https://synapse.schaefer.zone/register \\\n -H \"Content-Type: application/json\" \\\n -d '{\"email\":\"agent@example.com\",\"password\":\"secret\"}' | jq -r .jwt)\n\n# Створіть mind та отримайте Mind Key\nMIND_KEY=$(curl -s -X POST https://synapse.schaefer.zone/minds \\\n -H \"Authorization: Bearer $JWT\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"name\":\"persistent-agent\",\"description\":\"My persistent agent\"}' | jq -r .mind_key)\n\necho \"Save this: $MIND_KEY\"\n```\n\n## Крок 2: Протокол початку сесії\n\nНа початку кожної сесії відкличайте всі спогади:\n\n```python\nimport os\nimport requests\n\nMIND_KEY = os.environ[\"SYNAPSE_MIND_KEY\"]\nURL = \"https://synapse.schaefer.zone\"\n\ndef session_start():\n \"\"\"Call this at the start of every session.\"\"\"\n # 1. Відкликати всі спогади\n r = requests.get(\n f\"{URL}/memory/recall\",\n headers={\"Authorization\": f\"Bearer {MIND_KEY}\"}\n )\n memories = r.text # текстове резюме\n \n # 2. Перевірити непрочитані повідомлення чату\n r = requests.get(\n f\"{URL}/chat/poll\",\n headers={\"Authorization\": f\"Bearer {MIND_KEY}\"}\n )\n messages = r.json().get(\"messages\", [])\n \n # 3. Перевірити завдання в процесі\n r = requests.get(\n f\"{URL}/mind/tasks?status=in_progress\",\n headers={\"Authorization\": f\"Bearer {MIND_KEY}\"}\n )\n tasks = r.json().get(\"tasks\", [])\n \n return {\n \"memories\": memories,\n \"unread_messages\": messages,\n \"active_tasks\": tasks,\n }\n\ncontext = session_start()\n# Побудувати системний промпт із цим контекстом\n```\n\n## Крок 3: Зберігання нових висновків\n\nЩоразу, коли агент дізнається щось варте запам'ятовування:\n\n```python\ndef remember(category, key, content, tags=None, priority=\"normal\"):\n \"\"\"Store a memory.\"\"\"\n requests.post(\n f\"{URL}/memory\",\n headers={\n \"Authorization\": f\"Bearer {MIND_KEY}\",\n \"Content-Type\": \"application/json\",\n },\n json={\n \"category\": category,\n \"key\": key,\n \"content\": content,\n \"tags\": tags or [],\n \"priority\": priority,\n }\n )\n\n# Приклади\nremember(\"identity\", \"user_name\", \"User is Michael Schäfer\", \n tags=[\"person\"], priority=\"critical\")\nremember(\"preference\", \"communication_style\", \n \"User prefers concise technical responses\",\n tags=[\"communication\"])\nremember(\"project\", \"current_project\", \n \"Building Synapse v1.6.0 with docs system\",\n tags=[\"synapse\", \"docs\"], priority=\"high\")\nremember(\"mistake\", \"npm_version_bump\", \n \"Always bump package.json version after changes\",\n tags=[\"npm\", \"ci\"], priority=\"high\")\n```\n\n## Крок 4: Керування завданнями\n\nВідстежуйте багатокрокову роботу між сесіями:\n\n```python\ndef create_task(title, description=\"\", priority=\"normal\"):\n r = requests.post(\n f\"{URL}/mind/task\",\n headers={\"Authorization\": f\"Bearer {MIND_KEY}\",\n \"Content-Type\": \"application/json\"},\n json={\"title\": title, \"description\": description, \"priority\": priority}\n )\n return r.json()[\"id\"]\n\ndef update_task(task_id, status=None, description=None):\n payload = {}\n if status: payload[\"status\"] = status\n if description: payload[\"description\"] = description\n requests.put(\n f\"{URL}/mind/task/{task_id}\",\n headers={\"Authorization\": f\"Bearer {MIND_KEY}\",\n \"Content-Type\": \"application/json\"},\n json=payload\n )\n\n# Багатосесійний робочий процес\ntask_id = create_task(\"Deploy v1.6.0\", \"Push docs system to production\", \"high\")\nupdate_task(task_id, status=\"in_progress\")\n# ... робота через кілька сесій ...\nupdate_task(task_id, status=\"done\")\n```\n\n## Крок 5: Асинхронний чат з людьми\n\nОпитуйте повідомлення між викликами інструментів:\n\n```python\nimport time\n\ndef poll_messages():\n r = requests.get(\n f\"{URL}/chat/poll\",\n headers={\"Authorization\": f\"Bearer {MIND_KEY}\"}\n )\n return r.json().get(\"messages\", [])\n\ndef reply(content):\n requests.post(\n f\"{URL}/chat/reply\",\n headers={\"Authorization\": f\"Bearer {MIND_KEY}\",\n \"Content-Type\": \"application/json\"},\n json={\"content\": content}\n )\n\n# Головний цикл\nwhile working:\n # Опитати повідомлення від людини\n for msg in poll_messages():\n print(f\"Human: {msg['content']}\")\n reply(f\"Got it: {msg['content']}. Working on it.\")\n \n # Виконати одиницю роботи\n do_work()\n \n time.sleep(30) # не опитувати занадто часто\n```\n\n## Крок 6: Протокол кінця сесії\n\nНаприкінці сесії зберігайте фінальний контекст:\n\n```python\ndef session_end():\n \"\"\"Call this before terminating the session.\"\"\"\n # Зберегти, чого досягли\n remember(\"context\", \"last_session_summary\",\n f\"Session ended at {time.now()}. Accomplished: ...\",\n tags=[\"session\"], priority=\"normal\")\n \n # Оновити статуси завдань\n for task in get_active_tasks():\n if task_in_progress(task):\n update_task(task[\"id\"], description=f\"In progress: {current_step}\")\n\nsession_end()\n```\n\n## Повний шаблон\n\n```python\nclass PersistentAgent:\n def __init__(self):\n self.mind_key = os.environ[\"SYNAPSE_MIND_KEY\"]\n self.url = \"https://synapse.schaefer.zone\"\n \n def run(self):\n # 1. Відкликати контекст\n context = self.session_start()\n \n # 2. Обробити непрочитані повідомлення\n for msg in context[\"unread_messages\"]:\n self.handle_message(msg)\n \n # 3. Продовжити активні завдання\n for task in context[\"active_tasks\"]:\n self.continue_task(task)\n \n # 4. Виконати нову роботу\n self.do_work()\n \n # 5. Зберегти стан\n self.session_end()\n```\n\n## Найкращі практики\n\n> [!TIP]\n>\n> - **Завжди відкликати спочатку** — ніколи не починайте роботу без завантаження контексту\n> - **Зберігайте проактивно** — не чекайте до кінця сесії\n> - **Використовуйте змістовні ключі** — `user_name`, `project_status`, а не `mem_001`\n> - **Тегуйте все** — теги забезпечують пошук та фільтрацію\n> - **Встановлюйте реалістичні пріоритети** — не все `critical`\n\n## Наступні кроки\n\n- [Куховарська книга LLM](/docs/llm-cookbook/session-start-pattern) — практичні шаблони\n- [Найкращі практики роботи з пам'яттю](/docs/guides/memory-best-practices)\n- [Координація кількох агентів](/docs/guides/multi-agent-coordination)\n","content_html":"

Огляд

\n

Цей посібник проведе вас через побудову LLM-агента, що зберігає контекст між\nсесіями за допомогою Synapse. Наприкінці ваш агент зможе:

\n\n

Архітектура

\n
┌──────────────┐   recall/store   ┌──────────┐\n│  LLM Agent   │ ◀──────────────▶ │ Synapse  │\n│ (your code)  │                  │   API    │\n└──────────────┘                  └──────────┘\n       │\n       │ poll/reply\n       ▼\n┌──────────────┐\n│    Human     │ (browser or chat UI)\n└──────────────┘

Крок 1: Налаштуйте Mind Key

\n
# Зареєструйтесь та отримайте JWT\nJWT=$(curl -s -X POST https://synapse.schaefer.zone/register \\\n  -H "Content-Type: application/json" \\\n  -d '{"email":"agent@example.com","password":"secret"}' | jq -r .jwt)\n\n# Створіть mind та отримайте Mind Key\nMIND_KEY=$(curl -s -X POST https://synapse.schaefer.zone/minds \\\n  -H "Authorization: Bearer $JWT" \\\n  -H "Content-Type: application/json" \\\n  -d '{"name":"persistent-agent","description":"My persistent agent"}' | jq -r .mind_key)\n\necho "Save this: $MIND_KEY"

Крок 2: Протокол початку сесії

\n

На початку кожної сесії відкличайте всі спогади:

\n
import os\nimport requests\n\nMIND_KEY = os.environ["SYNAPSE_MIND_KEY"]\nURL = "https://synapse.schaefer.zone"\n\ndef session_start():\n    """Call this at the start of every session."""\n    # 1. Відкликати всі спогади\n    r = requests.get(\n        f"{URL}/memory/recall",\n        headers={"Authorization": f"Bearer {MIND_KEY}"}\n    )\n    memories = r.text  # текстове резюме\n    \n    # 2. Перевірити непрочитані повідомлення чату\n    r = requests.get(\n        f"{URL}/chat/poll",\n        headers={"Authorization": f"Bearer {MIND_KEY}"}\n    )\n    messages = r.json().get("messages", [])\n    \n    # 3. Перевірити завдання в процесі\n    r = requests.get(\n        f"{URL}/mind/tasks?status=in_progress",\n        headers={"Authorization": f"Bearer {MIND_KEY}"}\n    )\n    tasks = r.json().get("tasks", [])\n    \n    return {\n        "memories": memories,\n        "unread_messages": messages,\n        "active_tasks": tasks,\n    }\n\ncontext = session_start()\n# Побудувати системний промпт із цим контекстом

Крок 3: Зберігання нових висновків

\n

Щоразу, коли агент дізнається щось варте запам'ятовування:

\n
def remember(category, key, content, tags=None, priority="normal"):\n    """Store a memory."""\n    requests.post(\n        f"{URL}/memory",\n        headers={\n            "Authorization": f"Bearer {MIND_KEY}",\n            "Content-Type": "application/json",\n        },\n        json={\n            "category": category,\n            "key": key,\n            "content": content,\n            "tags": tags or [],\n            "priority": priority,\n        }\n    )\n\n# Приклади\nremember("identity", "user_name", "User is Michael Schäfer", \n         tags=["person"], priority="critical")\nremember("preference", "communication_style", \n         "User prefers concise technical responses",\n         tags=["communication"])\nremember("project", "current_project", \n         "Building Synapse v1.6.0 with docs system",\n         tags=["synapse", "docs"], priority="high")\nremember("mistake", "npm_version_bump", \n         "Always bump package.json version after changes",\n         tags=["npm", "ci"], priority="high")

Крок 4: Керування завданнями

\n

Відстежуйте багатокрокову роботу між сесіями:

\n
def create_task(title, description="", priority="normal"):\n    r = requests.post(\n        f"{URL}/mind/task",\n        headers={"Authorization": f"Bearer {MIND_KEY}",\n                 "Content-Type": "application/json"},\n        json={"title": title, "description": description, "priority": priority}\n    )\n    return r.json()["id"]\n\ndef update_task(task_id, status=None, description=None):\n    payload = {}\n    if status: payload["status"] = status\n    if description: payload["description"] = description\n    requests.put(\n        f"{URL}/mind/task/{task_id}",\n        headers={"Authorization": f"Bearer {MIND_KEY}",\n                 "Content-Type": "application/json"},\n        json=payload\n    )\n\n# Багатосесійний робочий процес\ntask_id = create_task("Deploy v1.6.0", "Push docs system to production", "high")\nupdate_task(task_id, status="in_progress")\n# ... робота через кілька сесій ...\nupdate_task(task_id, status="done")

Крок 5: Асинхронний чат з людьми

\n

Опитуйте повідомлення між викликами інструментів:

\n
import time\n\ndef poll_messages():\n    r = requests.get(\n        f"{URL}/chat/poll",\n        headers={"Authorization": f"Bearer {MIND_KEY}"}\n    )\n    return r.json().get("messages", [])\n\ndef reply(content):\n    requests.post(\n        f"{URL}/chat/reply",\n        headers={"Authorization": f"Bearer {MIND_KEY}",\n                 "Content-Type": "application/json"},\n        json={"content": content}\n    )\n\n# Головний цикл\nwhile working:\n    # Опитати повідомлення від людини\n    for msg in poll_messages():\n        print(f"Human: {msg['content']}")\n        reply(f"Got it: {msg['content']}. Working on it.")\n    \n    # Виконати одиницю роботи\n    do_work()\n    \n    time.sleep(30)  # не опитувати занадто часто

Крок 6: Протокол кінця сесії

\n

Наприкінці сесії зберігайте фінальний контекст:

\n
def session_end():\n    """Call this before terminating the session."""\n    # Зберегти, чого досягли\n    remember("context", "last_session_summary",\n             f"Session ended at {time.now()}. Accomplished: ...",\n             tags=["session"], priority="normal")\n    \n    # Оновити статуси завдань\n    for task in get_active_tasks():\n        if task_in_progress(task):\n            update_task(task["id"], description=f"In progress: {current_step}")\n\nsession_end()

Повний шаблон

\n
class PersistentAgent:\n    def __init__(self):\n        self.mind_key = os.environ["SYNAPSE_MIND_KEY"]\n        self.url = "https://synapse.schaefer.zone"\n    \n    def run(self):\n        # 1. Відкликати контекст\n        context = self.session_start()\n        \n        # 2. Обробити непрочитані повідомлення\n        for msg in context["unread_messages"]:\n            self.handle_message(msg)\n        \n        # 3. Продовжити активні завдання\n        for task in context["active_tasks"]:\n            self.continue_task(task)\n        \n        # 4. Виконати нову роботу\n        self.do_work()\n        \n        # 5. Зберегти стан\n        self.session_end()

Найкращі практики

\n

Наступні кроки

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