Советы и лучшие практики
Здесь собраны советы по эффективному использованию Велеса в повседневной работе — от простых запросов до сложных цепочек разработки.1. Явные установки лучше контекстных намеков
Велес умеет анализировать контекст, но он не экстрасенс. Если для вас что-то критически важно, скажите об этом прямо.- ❌ Не лучший вариант: “Сделай так же, как мы делали в том файле.”
- ✅ Лучший вариант: “Используй тот же подход маршрутизации, что и в
router.py, и используй библиотеку FastAPI.” - ✅ Лучший вариант для памяти: “Запомни навсегда: в этом проекте мы используем только FastAPI.”
2. Изоляция задач через сессии
Самая частая ошибка — пытаться решить десятки разных проблем в одной сессии. Это перегружает память Велеса и делает контекст грязным.- Используйте команду новой сессии (например,
/new), когда закончили одну большую задачу и переходите к следующей. - Велес сохранит выжимки прошлой сессии в долгосрочную память, а вы начнете новый диалог с чистого листа, но с сохраненным “общим знаменателем”.
3. Рабочий цикл Велеса
Когда вы ставите Велесу сложную задачу, он часто проходит несколько внутренних шагов: обдумывает задачу, вызывает инструменты, читает результаты и снова уточняет план, пока не достигнет цели.- Дайте ему время подумать: во время выполнения сложных задач, например глубокого исследования кода, Велес может сделать десятки внутренних шагов.
- Ограничивайте границы: если задача слишком общая, например «перепиши мне весь бекенд», работа может затянуться. Лучше разбивать её на средние шаги: «напиши мне план миграции базы данных», затем «начни с создания моделей».
4. Как указывать файлы проекта
Велес имеет доступ к вашей файловой системе, если она подключена.- Не нужно копировать огромные куски кода в чат вручную.
- Просто скажите: “Прочитай
config.jsonв корне и добавь туда новую секцию”. Велес сам найдёт и прочитает его.
5. Задавайте форматы вывода
Велес подстраивается под вас.- Если вам нужен только код, без пояснений, скажите “Выведи только код, без пояснений”. Полезно, если вы хотите скопировать результат прямо в редактор.
- Если вы хотите, чтобы Велес сам сохранил файл, скажите: “Создай файл
script.pyи запиши этот код туда”. Он воспользуется инструментом записи файлов.