Skip to main content

Workflows

Что такое workflows?​

Функция Workflows позволяет сохранять повторяющиеся промпты и использовать их вручную, когда это уместно. Workflow — это простой файл Markdown, который вы добавляете к своему промпту через поле ввода. Это позволяет переиспользовать эффективные пайплайны и повышать продуктивность.

Workflow может быть как глобальным, так и локальным:

  • Глобальные Workflows хранятся в папке .veai в домашнем каталоге и доступны во всех проектах на вашей машине.
  • Локальные Workflows хранятся в папке .veai в каталоге проекта и видны только в этом проекте. Некоторые Workflows проекта можно коммитить в VCS, чтобы делиться эффективными решениями с коллегами.

Чтобы создать Workflow, выполните шаги:

  • Откройте новый чат
  • Откройте диалог создания Workflow
  • Введите имя файла, выберите локальный или глобальный и нажмите OK
  • В открытом файле добавьте Markdown‑содержимое Workflow

Чтобы добавить Workflow, начните вводить #workflow в поле ввода — появится подсказка с доступными вариантами.

Интерфейс для работы с workflows​

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

Если вы нажмёте на название workflow, откроется окно всех workflows. Также его можно открыть в любой момент, нажав на иконку Workflows сверху агентского чата.

Фильтр и поиск по workflows​

Слева в окне всех workflows вы увидите стандартные и созданные вами workflow с их тегами. Нажав на фильтр слева вы можете выбрать workflows по нужным тегам. Также в верхней части панели вы можете отфильтровать workflows по названию.

Запуск workflow из панели​

Чтобы запустить сценарий, нажмите на кнопку запуска в правой части панели.

Создание своего workflow на основе существующего​

Чтобы создать свою копию workflow и внести в неё правки под свои нужды, нажмите на кнопку Copy and Modify Workflow в правой части панели.

Рекомендации​

Несколько советов, как повысить эффективность использования workflows:

  • Попросите агента задать уместные вопросы перед переходом к реализации
  • Опишите, как агенту собирать контекст для запроса
  • Укажите ожидаемые шаги, которые агент должен выполнить
  • Вы можете прикреплять файлы к запросу и ссылаться на них в рабочем процессе
  • Делайте workflows переиспользуемыми с помощью плейсхолдеров (например: {goal}, {files}) и подставляйте значения при запуске

Примеры​

Workflow, который просит агента найти все TODO в прикреплённых файлах и реализовать их.

---
title: "Найти и реализовать TODO в прикреплённых файлах (и в текущем открытом файле, если уместно)"
tags: [todo, реализация]
---

Область:
- Работай только с прикреплёнными файлами и текущим открытым файлом. Если нужны более широкие изменения — спроси сначала.

Шаги:
1) Разбери предоставленные файлы и перечисли все TODO с путями к файлам и номерами строк.
2) Сгруппируй TODO по файлам/подсистемам и выяви зависимости или порядок выполнения.
3) Задай уточняющие вопросы по неоднозначным TODO (намерения автора, ограничения, критерии приёмки).
4) Предложи минимальный и безопасный план реализации со списком правок по файлам и запроси одобрение.
5) Реализуй TODO, сохраняя изменения маленькими и сфокусированными. Избегай несвязанных рефакторингов.
6) После правок кратко суммируй изменения (какие файлы затронуты, ключевые решения, возможные последующие шаги).

Вывод:
- Инвентарь TODO: таблица/пункты с file:line и кратким описанием.
- Вопросы (если есть): пункты.
- План (ожидает одобрения): пронумерованные шаги.
- Правки: выполни после одобрения и предоставь краткое резюме.

Workflow, который просит агента добавить комментарии в текущий открытый файл.

---
title: "Улучшить читаемость кода, добавив краткие и точные комментарии без изменения поведения"
tags: [читаемость, комментарии]
---

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

Шаги:
1) Прочти весь файл, чтобы понять назначение, публичный API и сложную логику.
2) Составь план комментирования: комментарий к файлу/заголовку (если отсутствует), doc‑комментарии к функциям/классам и построчные комментарии к нетривиальной логике/инвариантам.
3) Уточни предпочтения по стилю, если неясно; иначе следуй существующим соглашениям проекта.
4) Добавь комментарии, делая их точными и избегая повторения очевидного кода.
5) Дай краткое резюме: что было прокомментировано и зачем.

Ограничения:
- Не меняй логику программы и форматирование дальше необходимого для комментариев.
- Держи комментарии краткими (обычно 1–3 строки) и выдерживай единый тон.

Вывод:
- План комментирования (кратко)
- Сводка внесённых комментариев с обоснованием