> ## 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.

# Советы и лучшие практики

> Рекомендации по максимально эффективной работе с Велесом: как правильно ставить задачи и экономить время.

# Советы и лучшие практики

Здесь собраны советы по эффективному использованию Велеса в повседневной работе — от простых запросов до сложных цепочек разработки.

## 1. Явные установки лучше контекстных намеков

Велес умеет анализировать контекст, но он не экстрасенс. Если для вас что-то критически важно, скажите об этом прямо.

* ❌ *Не лучший вариант*: "Сделай так же, как мы делали в том файле."
* ✅ *Лучший вариант*: "Используй тот же подход маршрутизации, что и в `router.py`, и используй библиотеку FastAPI."
* ✅ *Лучший вариант для памяти*: "Запомни навсегда: в этом проекте мы используем только FastAPI."

## 2. Изоляция задач через сессии

Самая частая ошибка — пытаться решить десятки разных проблем в одной сессии. Это перегружает память Велеса и делает контекст грязным.

* Используйте команду новой сессии (например, `/new`), когда закончили одну большую задачу и переходите к следующей.
* Велес сохранит выжимки прошлой сессии в [долгосрочную память](/basics/memory_ru), а вы начнете новый диалог с чистого листа, но с сохраненным "общим знаменателем".

## 3. Рабочий цикл Велеса

Когда вы ставите Велесу сложную задачу, он часто проходит несколько внутренних шагов: обдумывает задачу, вызывает инструменты, читает результаты и снова уточняет план, пока не достигнет цели.

```mermaid theme={null}
stateDiagram-v2
    [*] --> ЗапросПользователя
    ЗапросПользователя --> МышлениеВелеса
    
    state Цикл_Велеса {
        МышлениеВелеса --> ВыборИнструмента
        ВыборИнструмента --> ВыполнениеИнструмента: Например, чтение файла
        ВыполнениеИнструмента --> АнализРезультата
        АнализРезультата --> МышлениеВелеса: Задача не завершена
    }
    
    АнализРезультата --> ОтветПользователю: Задача выполнена
    ОтветПользователю --> [*]
```

* **Дайте ему время подумать**: во время выполнения сложных задач, например глубокого исследования кода, Велес может сделать десятки внутренних шагов.
* **Ограничивайте границы**: если задача слишком общая, например «перепиши мне весь бекенд», работа может затянуться. Лучше разбивать её на средние шаги: «напиши мне план миграции базы данных», затем «начни с создания моделей».

## 4. Как указывать файлы проекта

Велес имеет доступ к вашей файловой системе, если она подключена.

* Не нужно копировать огромные куски кода в чат вручную.
* Просто скажите: "Прочитай `config.json` в корне и добавь туда новую секцию". Велес сам найдёт и прочитает его.

## 5. Задавайте форматы вывода

Велес подстраивается под вас.

* Если вам нужен только код, без пояснений, скажите "Выведи только код, без пояснений". Полезно, если вы хотите скопировать результат прямо в редактор.
* Если вы хотите, чтобы Велес сам сохранил файл, скажите: "Создай файл `script.py` и запиши этот код туда". Он воспользуется инструментом записи файлов.

## 6. Используйте Фоновые Задачи (Cron) для рутины

Если у вас есть повторяющаяся задача, например сбор отчётов, чистка кеша или разбор сайтов, настройте задачу в Велесе. Смотрите [Фоновые задачи](/basics/cron_ru) для деталей.