II. Как устроен агент
4

Карта системы

Три зоны на сервере, путь сообщения, два режима работы

Сервер разделён на три изолированные зоны. Понимание этой архитектуры поможет вам ориентироваться в файлах агента и понимать, что происходит «под капотом».

Три зоны на сервере

Личность

Характер, память, цели, база знаний, навыки

~/workspace/
Вы + агент

Проекты

Код, репозитории, рабочие папки

~/projects/
Вы + агент

Движок

Бот, API-ключи, мониторинг

~/.iia/
Мы (авто-обновления)

Принцип разделения: обновления движка не затрагивают ваши файлы. Вы меняете ДНК-файлы — движок продолжает работать.

Структура workspace

SOUL.mdХарактер агента (тон, стиль, манера)
USER.mdПрофиль пользователя (профессия, контекст)
MEMORY.mdДолгосрочная память (факты)
GOALS.mdТекущие цели
MISSION.mdГлобальная миссия
PROJECTS.mdАктивные проекты и статус
PREFERENCES.mdПредпочтения по стилю работы
LEARNED.mdВыводы агента из сессий
memory/Дневник по дням
knowledge/База знаний

Путь сообщения

1Бот получает сообщение (systemd-сервис на сервере)
2Медиа обрабатывается (голос → расшифровка, фото → Claude Vision, видео → аудио + кадры)
3Загружается контекст (SOUL.md, USER.md, MEMORY.md, навыки, дневник, история)
4Запрос отправляется в Claude (подписка или API)
5Claude выполняет цепочку действий (поиск, загрузка, сохранение)
6Ответ стримится в чат в реальном времени
7В конце — футер со статистикой (время, стоимость, кэш)

Два режима работы

Подписка

  • Фиксированная цена — без подсчёта токенов
  • Сессии переживают перезапуск
  • Контекст до 1M токенов (Max)
  • Для ежедневного общения

API

  • Оплата за каждый запрос
  • Нет rate limits
  • Prompt caching — 90% экономия
  • Для автоматизации и таймеров

При исчерпании лимита подписки система автоматически переключается на API (если ключ подключён). Рекомендуется подключить оба режима.