Как устроен Велес
Эта страница объясняет Велес как единый продукт. Внутренние названия компонентов здесь не важны: пользователь работает с Велесом, а Велес уже сам связывает чат, модели, инструменты, файлы, память и фоновые задачи.Общая схема
Поток сообщения
- Пользователь отправляет сообщение в Велес.
- Велес определяет текущую сессию, активную личность и загружает нужный контекст.
- Модель анализирует задачу.
- Если нужны действия, Велес использует инструменты: читает файлы, ищет информацию, обращается к памяти, создаёт задачу или запускает внешний сервис.
- Результаты инструментов возвращаются в модель.
- Велес сохраняет историю и показывает ответ пользователю.
Основные части
| Часть | Для чего нужна |
|---|---|
| Чат | Основное общение с Велесом |
| Личности | Разные варианты SOUL.md и настроек модели внутри одного workspace |
| Сессии | Разделение диалогов по темам и задачам |
| Рабочая область | Файлы, документы, память и результаты работы |
| Память | Долгосрочный контекст, который нужен в будущих сессиях |
| Инструменты | Действия за пределами обычного ответа текстом |
| Навыки | Готовые сценарии работы для целых классов задач |
| Каналы | Способы общаться с Велесом: веб-чат, Telegram и другие интеграции |
| Фоновые задачи | Напоминания, регулярные проверки и автоматические действия |
Рабочая область
Рабочая область — это папка, с которой работает Велес. В ней могут находиться:- документы;
- заметки;
- файлы памяти;
- результаты работы;
- инструкции для поведения ассистента;
- файлы проекта.
SOUL.md в корне workspace задаёт личность main; дополнительные личности лежат в personalities/<id>/SOUL.md. У дополнительной личности может быть свой каталог personalities/<id>/skills, который подключается только для активной личности. Файл AGENTS.md остаётся общим проектным контекстом для всех личностей. Подробнее: Личности.
Память и история
История сессии нужна для текущего диалога. Память нужна для сведений, которые должны сохраниться надолго. Не всё из истории должно попадать в память. Хорошая память короткая, проверяемая и полезная в будущем: предпочтения пользователя, правила проекта, постоянные ограничения, важные решения.Инструменты
Инструменты позволяют Велесу выполнять практические действия:- читать и редактировать файлы;
- искать информацию;
- разбирать документы;
- обращаться к внешним сервисам;
- создавать фоновые задачи;
- работать с долговременной памятью.
Задачи и доска
Доска задач в интерфейсе — это клиент к задачам Велеса. Nerve не хранит workflow-состояние самостоятельно: Новые интеграции должны использовать/api/tasks/*. Старый путь /api/kanban/* оставлен только для совместимости.