> ## 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 LR
    user[Пользователь] --> ui[Интерфейс Велеса]
    ui --> chat[Чат и сессии]
    ui --> workspace[Рабочая область]
    ui --> tasks[Задачи]
    ui --> secrets[Секреты]
    ui --> assistant[Велес]
```

## Когда использовать Велес

Велес полезен, когда задача требует контекста и действий:

* подготовить текст, план, письмо, документ или техническое описание;
* разобрать файл, заметку, изображение или фрагмент проекта;
* сохранить важные сведения в память и вернуться к ним позже;
* поставить напоминание или периодическую задачу;
* вести несколько рабочих диалогов без потери истории;
* поручить Велесу исследование, проверку или подготовку материалов.
* провести сложную работу через уточнение требований, утверждённый план и сохранённые результаты этапов.

Для быстрых одноразовых вопросов Велес тоже подходит, но его сильная сторона — длительная работа с вашим контекстом.

## Основной рабочий цикл

1. Откройте интерфейс Велеса и выберите нужного специалиста, если их несколько.
2. Напишите задачу в чат. Лучше сразу указать цель, входные данные и ожидаемый формат результата. Для сложной многоэтапной работы в пустом диалоге выберите режим **Проект**.
3. Прикрепите файлы, если Велес должен их прочитать.
4. Следите за ответом, прогрессом инструментов и уточняющими вопросами.
5. Если результат важен для будущей работы, попросите Велеса сохранить выводы в память.
6. Для длительной работы заведите задачу на доске или попросите Велеса сделать это за вас.

## Как писать хорошие запросы

Хороший запрос описывает не только действие, но и критерий готовности.

Плохо:

```text theme={null}
Посмотри документ.
```

Лучше:

```text theme={null}
Прочитай прикреплённый договор и составь список рисков для меня как исполнителя.
Раздели ответ на "критично", "важно" и "можно уточнить".
Не переписывай весь договор, дай выводы простым языком.
```

Для рабочих задач полезно добавлять:

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

## Чат и сессии

Сессия — это отдельная история общения. Используйте новые сессии, когда меняется тема или проект. Так Велесу проще держать контекст, а вам проще возвращаться к прошлым обсуждениям.

Практическое правило:

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

Подробнее: [Личности](/basics/personalities_ru), [Сессии](/basics/sessions_ru) и [Обмен сообщениями](/basics/messaging_ru).

В пустом новом диалоге можно выбрать **Проект**: Велес задаст уточняющие вопросы, предложит план, выполнит его этапы по очереди и сохранит итоговый документ. Пошаговое описание: [Режим «Проект»](/project_mode_ru).

## Файлы и рабочая область

Рабочая область — это набор файлов, с которыми может работать Велес. В интерфейсе она отображается как файловая панель. Через неё удобно:

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

Если вы прикладываете файл к сообщению, Велес сначала получает ссылку на файл в рабочей области, а затем использует её в обычном ходе работы. Поэтому вложения стоит считать частью рабочего контекста, а не временной картинкой в чате.

Подробнее: [Как работать с документами](/documents_ru).

## Память

Память нужна для сведений, которые должны пережить одну сессию: ваши предпочтения, правила проекта, постоянные ограничения, важные решения, справочные факты.

Не стоит сохранять в память всё подряд. Чем чище память, тем полезнее она в будущих задачах.

Хорошие кандидаты для памяти:

* “Всегда отвечай мне на русском”;
* “В этом проекте не запускать тесты без отдельного разрешения”;
* “Основной клиентский язык интерфейса — русский”;
* “Для отчётов использовать структуру: вывод, детали, риски, следующий шаг”.

Плохие кандидаты:

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

Подробнее: [Память Велеса](/basics/memory_ru) и [Долговременная память](/dive-deeper/long_term_memory_ru).

## Задачи и напоминания

Для работы, которую нужно отслеживать, используйте доску задач. Она подходит для поручений с этапами: “запланировано”, “в работе”, “на проверке”, “готово”.

Для действий по времени используйте фоновые задачи:

* одноразовые напоминания;
* регулярные проверки;
* периодические сообщения;
* задачи, которые должны выполняться без открытого чата.

Подробнее: [Фоновые задачи](/basics/cron_ru).

## Голос и мобильная работа

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

Для надёжной работы с телефона:

* дождитесь появления сообщения в истории после отправки;
* при возврате приложения из фона проверьте, не завершил ли Велес ответ в истории;
* не отправляйте повторно тот же запрос, если видите, что ответ уже появился в сессии.

Подробнее: [Интерфейс Велеса](/basics/nerve_ui_ru).

## Секреты

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

Никогда не отправляйте в сообщении:

* API-ключи;
* пароли;
* refresh tokens;
* приватные SSH-ключи;
* одноразовые коды входа.

Если Велесу нужен доступ к внешнему сервису, настройте секрет в интерфейсе или попросите администратора сделать это.

Подробнее: [Секреты и токены](/basics/secrets_ru).

## Маршрут для первого дня

1. Если Велес ещё не установлен, начните с [установки и первого запуска](/setup_ru).
2. Пройдите [Первые шаги в Велесе](/basics/getting_started_ru) — пятиминутный старт в интерфейсе, затем при желании откройте подробный [Интерфейс Велеса](/basics/nerve_ui_ru).
3. Если вам нужен другой стиль работы, создайте или выберите [личность](/basics/personalities_ru).
4. Создайте отдельную сессию для первой реальной задачи.
5. Попросите Велеса объяснить, какие файлы или данные ему нужны.
6. Приложите документы или создайте файлы в рабочей области.
7. После результата попросите Велеса кратко записать устойчивые правила в память.
8. Если задача продолжается, перенесите её на доску задач.