Skip to main content

​
Как устроен Велес

Эта страница объясняет Велес как единый продукт. Внутренние названия компонентов здесь не важны: пользователь работает с Велесом, а Велес уже сам связывает чат, модели, инструменты, файлы, память и фоновые задачи.

​
Общая схема

​
Поток сообщения

  1. Пользователь отправляет сообщение в Велес.
  2. Велес определяет текущую сессию, активную личность и загружает нужный контекст.
  3. Модель анализирует задачу.
  4. Если нужны действия, Велес использует инструменты: читает файлы, ищет информацию, обращается к памяти, создаёт задачу или запускает внешний сервис.
  5. Результаты инструментов возвращаются в модель.
  6. Велес сохраняет историю и показывает ответ пользователю.

​
Основные части

​
Рабочая область

Рабочая область — это папка, с которой работает Велес. В ней могут находиться:
  • документы;
  • заметки;
  • файлы памяти;
  • результаты работы;
  • инструкции для поведения ассистента;
  • файлы проекта.
Если вы хотите изолировать проекты, используйте разные рабочие области. SOUL.md в корне workspace задаёт личность main; дополнительные личности лежат в personalities/<id>/SOUL.md. У дополнительной личности может быть свой каталог personalities/<id>/skills, который подключается только для активной личности. Файл AGENTS.md остаётся общим проектным контекстом для всех личностей. Подробнее: Личности.

​
Память и история

История сессии нужна для текущего диалога. Память нужна для сведений, которые должны сохраниться надолго. Не всё из истории должно попадать в память. Хорошая память короткая, проверяемая и полезная в будущем: предпочтения пользователя, правила проекта, постоянные ограничения, важные решения.

​
Инструменты

Инструменты позволяют Велесу выполнять практические действия:
  • читать и редактировать файлы;
  • искать информацию;
  • разбирать документы;
  • обращаться к внешним сервисам;
  • создавать фоновые задачи;
  • работать с долговременной памятью.
Набор инструментов зависит от конфигурации конкретной установки.

​
Задачи и доска

Доска задач в интерфейсе — это клиент к задачам Велеса. Nerve не хранит workflow-состояние самостоятельно: Новые интеграции должны использовать /api/tasks/*. Старый путь /api/kanban/* оставлен только для совместимости.

​
Секреты

API-ключи, токены и OAuth-подключения не должны попадать в чат. Велес хранит и использует секреты отдельно, а в интерфейсе показывает только состояние: настроен секрет или нет.

​
Что читать дальше