Туториал: первые флоу
Ни один из этих флоу собирать не нужно, и для настоящей работы собирать флоу тоже не придётся: агент сам выберет готовый флоу или создаст новый под задачу. Эти три примера нарочно маленькие — чтобы увидеть, что такое флоу и что делает Moira, пока агент его выполняет. В них нет переменных и циклов, а каждый шаг просит один короткий ответ.
Перед началом: подключите Moira к AI-клиенту (Быстрый старт) и придумайте любую небольшую задачу — переименовать файл, ответить на вопрос, написать заметку.
Чтобы посмотреть флоу: откройте Воркфлоу в веб-приложении. В разделе рекомендаций наверху есть все три примера, а за ними — Практика, туториал в приложении; каждый пример открывается на виде Шаги — инструкции, которые получает агент, пронумерованными карточками, соединёнными стрелками. Карта и Граф показывают тот же флоу как процесс и как полный технический граф.
Раздел рекомендаций, другие блоки для новичков на главной и подсказки на страницах флоу и запуска можно скрыть навсегда. Скрытый блок не показывается ни на одном устройстве, где вы входите в аккаунт; вернуть его можно в Настройки → Предпочтения → Подсказки для новичков.
Уровень 1 — Простые шаги
moira/example-simple-steps-ru — прямая линия: четыре шага, без развилок. Он показывает суть
Moira: агент получает ровно один шаг, выполняет его, возвращает короткий ответ и только тогда
получает следующий.
Скажите агенту:
Запусти в Moira Пример 1: Простые шаги для этой задачи: …
Шаги, которые получает агент, по порядку:
- Прочитайте запрос пользователя и перескажите задачу одним предложением. Если что-то важное непонятно, спросите пользователя, прежде чем продолжать.
- Выполните задачу. Делайте только то, о чём просил пользователь, без лишней работы.
- Сравните результат с запросом. Если что-то не совпадает, исправьте это, прежде чем продолжать.
- Расскажите пользователю в нескольких предложениях, что вы сделали и как проверили.
У каждого шага есть и условие завершения — у первого это «Задача пересказана одним предложением, и ничего важного не осталось непонятным.», — и он просит вернуть одно поле. Если агент ответит без него, Moira отклонит ответ, и агент останется на том же шаге. Перескочить вперёд он не может.
Уровень 2 — Одна развилка
moira/example-one-choice-ru добавляет развилку. Ответ агента на один вопрос решает, куда пойдёт
флоу.
Запусти в Moira Пример 2: Одна развилка для этой задачи: …
- Выполните задачу, о которой просил пользователь.
- Проверьте результат по запросу. Ответьте yes, если он полностью совпадает, или no, если чего-то не хватает.
- да — совпадает → Расскажите пользователю в нескольких предложениях, что вы сделали.
- нет — чего-то не хватает → Расскажите пользователю, чего не хватает и почему, и предложите, что делать дальше. Не начинайте задачу заново в этом флоу.
Ответ — одно поле с двумя допустимыми значениями, yes и no; Moira читает его и идёт по
нужному пути. Цикла нет: «нет» не отправляет агента на второй круг, а завершает флоу честным
объяснением, чего не хватает.
Уровень 3 — Несколько путей
moira/example-several-paths-ru расходится на три пути по одному ответу.
Запусти в Moira Пример 3: Несколько путей для этого запроса: …
- Прочитайте запрос пользователя и решите, что это: вопрос (question), ошибка, которую надо исправить (bug), или новая идея (idea).
- вопрос → Кратко ответьте на вопрос и укажите, откуда взят ответ.
- ошибка → Воспроизведите ошибку, исправьте её и покажите пользователю, что она больше не возникает.
- идея → Составьте короткий план идеи, не больше пяти шагов, и спросите пользователя, браться ли за неё.
Каждый путь короткий и заканчивается сам. В виде Шаги развилка нарисована тремя стрелками, каждая подписана ответом, который по ней ведёт.
Что вы увидели
- Флоу — это последовательность инструкций, которые агент получает по одной.
- У каждого шага есть условие завершения, и шаг просит подтверждение — здесь одно короткое поле.
- Развилку решает ответ агента, а не догадка.
- Moira проверяет каждый ответ, прежде чем флоу пойдёт дальше.
Настоящие флоу состоят из тех же частей, просто их больше: ревью, циклы исправления, файлы, заметки. С этой структурой разбирается агент; вы описываете задачу.
Соберите сами, в приложении
В веб-приложении есть туториал «Соберите свой первый флоу»: откройте «Покажите, что к чему» в боковой панели и выберите его в разделе «Туториалы». Он работает на компьютере — для правки нужен экран побольше — и на языке интерфейса. Это практика, чтобы читать и поправлять то, что собирает агент; для настоящей работы вы по-прежнему просите агента.
- Как делаются флоу. Агент собирает флоу через Workflow Management Flow и согласует с вами глубину; туториал собирает маленький флоу руками.
- Своя копия. «Использовать как шаблон» на примере «Простые шаги» (или «Сделайте за меня») даёт приватную копию для практики. Туториал запоминает её и в следующий раз возвращается к ней.
- Добавьте шаг. Добавьте в блок «Сделать» шаг с директивой и условием завершения. Чтобы шаг
сохранился, он должен куда-то вести: направьте его на
check-resultи подпишите эту связь — она уходит в другой блок. К шагу пока не ведёт ни один путь — проверка это скажет. - Подключите его. Направьте
do-taskна ваш шаг, чтобы каждый шаг оказался на пути от начала до конца. - Добавьте развилку. На
check-result«Добавить развилку» спрашивает, соответствует ли результат: yes идёт дальше к отчёту, no — к новому шагу в блоке «Проверить», который объясняет, чего не хватает, и ведёт к концу. Так устроен пример 2. - Используйте значение прежнего шага. Вставьте
{{understand-task.task}}в директиву отчёта, чтобы отчёт повторял задачу так, как её пересказал агент. - Попробуйте (необязательно). Попросите агента запустить вашу копию фразой, которую даёт карточка; когда запуск завершится, «Проверить ещё раз» найдёт его, и урок засчитается, если запуск ответил на ваш новый шаг. Его можно пропустить.
- Что дальше. Итог того, что вы попробовали, и как это соотносится с тем, что собирает агент, с предложением удалить копию.
Карточка урока стоит поверх схемы. После каждой правки она проверяет черновик и называет, чего ещё не хватает, — в карточке и на шаге, к которому это относится; урок засчитывается, только когда проверка проходит на сохранённом флоу. «Сделайте за меня» один раз вносит правку урока, чтобы вы посмотрели и сохранили её. Если копию изменили в другом месте, сохранение отклоняется, и карточка предлагает её перезагрузить.
Дальше
- «Соберите свой первый флоу» в веб-приложении (см. выше): откройте его через «Покажите, что к чему» → «Туториалы» или карточку «Практика» после примеров.
- Какой готовый флоу выбрать — Quick Task, Robust Task и Todo List для повседневных задач.
- Чтобы получить свой флоу, скажите агенту: «Создай в Moira флоу для …». Он соберёт его через Workflow Management Flow — простым или основательным, как вы с ним договоритесь, — и его можно открыть в виде «Шаги», как примеры.
- Концепции — как устроены флоу, если захочется прочитать или собрать флоу самому.
У каждого примера есть и английская версия: moira/example-simple-steps, moira/example-one-choice
и moira/example-several-paths.