Туториал: первые флоу

Ни один из этих флоу собирать не нужно, и для настоящей работы собирать флоу тоже не придётся: агент сам выберет готовый флоу или создаст новый под задачу. Эти три примера нарочно маленькие — чтобы увидеть, что такое флоу и что делает Moira, пока агент его выполняет. В них нет переменных и циклов, а каждый шаг просит один короткий ответ.

Перед началом: подключите Moira к AI-клиенту (Быстрый старт) и придумайте любую небольшую задачу — переименовать файл, ответить на вопрос, написать заметку.

Чтобы посмотреть флоу: откройте Воркфлоу в веб-приложении. В разделе рекомендаций наверху есть все три примера; каждый открывается на виде Шаги — инструкции, которые получает агент, пронумерованными карточками, соединёнными стрелками. Карта и Граф показывают тот же флоу как процесс и как полный технический граф.

Раздел рекомендаций, другие блоки для новичков на главной и подсказки на страницах флоу и запуска можно скрыть навсегда. Скрытый блок не показывается ни на одном устройстве, где вы входите в аккаунт; вернуть его можно в Настройки → Предпочтения → Подсказки для новичков.

Уровень 1 — Простые шаги

moira/example-simple-steps-ru — прямая линия: четыре шага, без развилок. Он показывает суть Moira: агент получает ровно один шаг, выполняет его, возвращает короткий ответ и только тогда получает следующий.

Скажите агенту:

Запусти в Moira Пример 1: Простые шаги для этой задачи: …

Шаги, которые получает агент, по порядку:

1. Прочитайте запрос пользователя и перескажите задачу одним предложением. Если что-то важное непонятно, спросите пользователя, прежде чем продолжать.
2. Выполните задачу. Делайте только то, о чём просил пользователь, без лишней работы.
3. Сравните результат с запросом. Если что-то не совпадает, исправьте это, прежде чем продолжать.
4. Расскажите пользователю в нескольких предложениях, что вы сделали и как проверили.

У каждого шага есть и условие завершения — у первого это «Задача пересказана одним предложением, и ничего важного не осталось непонятным.», — и он просит вернуть одно поле. Если агент ответит без него, Moira отклонит ответ, и агент останется на том же шаге. Перескочить вперёд он не может.

Уровень 2 — Одна развилка

moira/example-one-choice-ru добавляет развилку. Ответ агента на один вопрос решает, куда пойдёт флоу.

Запусти в Moira Пример 2: Одна развилка для этой задачи: …

1. Выполните задачу, о которой просил пользователь.
2. Проверьте результат по запросу. Ответьте yes, если он полностью совпадает, или no, если чего-то не хватает.
   • да — совпадает → Расскажите пользователю в нескольких предложениях, что вы сделали.
   • нет — чего-то не хватает → Расскажите пользователю, чего не хватает и почему, и предложите, что делать дальше. Не начинайте задачу заново в этом флоу.

Ответ — одно поле с двумя допустимыми значениями, yes и no; Moira читает его и идёт по нужному пути. Цикла нет: «нет» не отправляет агента на второй круг, а завершает флоу честным объяснением, чего не хватает.

Уровень 3 — Несколько путей

moira/example-several-paths-ru расходится на три пути по одному ответу.

Запусти в Moira Пример 3: Несколько путей для этого запроса: …

1. Прочитайте запрос пользователя и решите, что это: вопрос (question), ошибка, которую надо исправить (bug), или новая идея (idea).
   • вопрос → Кратко ответьте на вопрос и укажите, откуда взят ответ.
   • ошибка → Воспроизведите ошибку, исправьте её и покажите пользователю, что она больше не возникает.
   • идея → Составьте короткий план идеи, не больше пяти шагов, и спросите пользователя, браться ли за неё.

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

Что вы увидели

• Флоу — это последовательность инструкций, которые агент получает по одной.
• У каждого шага есть условие завершения, и шаг просит подтверждение — здесь одно короткое поле.
• Развилку решает ответ агента, а не догадка.
• Moira проверяет каждый ответ, прежде чем флоу пойдёт дальше.

Настоящие флоу состоят из тех же частей, просто их больше: ревью, циклы исправления, файлы, заметки. С этой структурой разбирается агент; вы описываете задачу.

Дальше

• Какой готовый флоу выбрать — Quick Task, Robust Task и Todo List для повседневных задач.
• Чтобы получить свой флоу, скажите агенту: «Создай в Moira флоу для …». Он соберёт его через Workflow Management Flow, и его можно открыть в виде «Шаги», как примеры.
• Концепции — как устроены флоу, если захочется прочитать или собрать флоу самому.

У каждого примера есть и английская версия: moira/example-simple-steps, moira/example-one-choice и moira/example-several-paths.