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