> ## Documentation Index
> Fetch the complete documentation index at: https://docs.velesagent.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Общая схема работы Велеса: интерфейс, сообщения, модели, инструменты, память, сессии, файлы и фоновые задачи.

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

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

## Общая схема

```mermaid theme={null}
flowchart TD
    user[Пользователь] --> ui[Интерфейс Велеса]
    ui --> chat[Чат и сессии]
    chat --> model[Модель]
    model --> tools[Инструменты]
    tools --> files[Файлы и документы]
    tools --> web[Интернет и внешние сервисы]
    tools --> tasks[Фоновые задачи]
    chat --> memory[Память]
    chat --> history[История]
```

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

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

```mermaid theme={null}
sequenceDiagram
    participant U as Пользователь
    participant N as Интерфейс Nerve
    participant G as Gateway Велеса
    participant A as Цикл агента
    participant T as Инструменты
    participant S as Хранилища

    U->>N: Сообщение, файлы или голос
    N->>G: chat.send / attachment refs
    G->>A: сессия, личность, контекст
    A->>S: память, история, файлы, навыки
    A->>T: действия по необходимости
    T-->>A: результаты
    A-->>G: поток ответа и финальная история
    G-->>N: WebSocket / SSE события
    N-->>U: ответ, прогресс, вложения
```

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

| Часть           | Для чего нужна                                                      |
| --------------- | ------------------------------------------------------------------- |
| Чат             | Основное общение с Велесом                                          |
| Личности        | Разные варианты `SOUL.md` и настроек модели внутри одного workspace |
| Сессии          | Разделение диалогов по темам и задачам                              |
| Рабочая область | Файлы, документы, память и результаты работы                        |
| Память          | Долгосрочный контекст, который нужен в будущих сессиях              |
| Инструменты     | Действия за пределами обычного ответа текстом                       |
| Навыки          | Готовые сценарии работы для целых классов задач                     |
| Каналы          | Способы общаться с Велесом: веб-чат, Telegram и другие интеграции   |
| Фоновые задачи  | Напоминания, регулярные проверки и автоматические действия          |

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

Рабочая область — это папка, с которой работает Велес. В ней могут находиться:

* документы;
* заметки;
* файлы памяти;
* результаты работы;
* инструкции для поведения ассистента;
* файлы проекта.

Если вы хотите изолировать проекты, используйте разные рабочие области.

`SOUL.md` в корне workspace задаёт личность `main`; дополнительные личности лежат в `personalities/<id>/SOUL.md`. У дополнительной личности может быть свой каталог `personalities/<id>/skills`, который подключается только для активной личности. Файл `AGENTS.md` остаётся общим проектным контекстом для всех личностей. Подробнее: [Личности](/basics/personalities_ru).

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

История сессии нужна для текущего диалога. Память нужна для сведений, которые должны сохраниться надолго.

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

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

Инструменты позволяют Велесу выполнять практические действия:

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

Набор инструментов зависит от конфигурации конкретной установки.

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

Доска задач в интерфейсе — это клиент к задачам Велеса. Nerve не хранит workflow-состояние самостоятельно:

```mermaid theme={null}
flowchart LR
    ui[Доска задач в Nerve] --> nerveApi["/api/tasks/*"]
    legacy["/api/kanban/* legacy alias"] --> nerveApi
    nerveApi --> gateway[Gateway Велеса]
    gateway --> taskApi[REST API задач]
    taskApi --> files["workspace/tasks/*.md"]
    taskApi --> agent[Выполнение задач агентом]
```

Новые интеграции должны использовать `/api/tasks/*`. Старый путь `/api/kanban/*` оставлен только для совместимости.

## Секреты

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

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

* [Велес для пользователя](/veles_user_guide_ru)
* [Велес для продвинутого пользователя](/veles_power_user_ru)
* [Графический интерфейс Велеса](/basics/nerve_ui_ru)
* [Инструменты Велеса](/dive-deeper/tools_reference_ru)
* [Навыки Велеса](/skills/reference_ru)
* [Секреты и токены](/basics/secrets_ru)