ПЕРВЫЙ КОНВЕЙЕР / СОЗДАНИЕ

Создать первый маршрут

Соберём процесс для небольшой функции. К концу урока у вас будет проверенный черновик, опубликованная версия и понятный следующий шаг — пробный запуск.

1. ПроектКод и репозитории
2. ПрофильОкружение и проверки
3. МаршрутЭтапы и приёмкаТекущий раздел

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

До начала

Подготовьте проект и профиль: репозитории, исполнителя, доступные команды и окружение задачи. Определите критерии приёмки. Для нашего примера это фильтр товаров по наличию на выбранном складе.

1. Создайте черновик

Откройте раздел «Маршруты» для проекта. Кнопка «Создать черновик из current» копирует полный опубликованный каталог: маршруты, начальную разведку и инструкции.

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

2. Добавьте этапы

Начните с небольшого процесса:

Изучить проект → Составить план → Утвердить план → Реализовать → Проверить → Принять работу

В редакторе список этапов и схема открывают один и тот же инспектор.

Этап	Тип	Зачем
Изучить проект	agent	Найти код и ограничения.
Составить план	agent	Подготовить подход и проверки.
Утвердить план	gate	Дождаться решения человека.
Реализовать	agent	Внести согласованные изменения.
Проверить	command	Выполнить объявленную проектом проверку.
Принять работу	gate	Проверить результат на стенде.

Это учебная схема. Рабочий маршрут может разделять тесты, сборку, ревью и проверку в браузере на самостоятельные этапы.

3. Напишите инструкции

Для каждого агента задайте:

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

Для планирования можно начать с такого текста:

Изучи текущую реализацию каталога и источник остатков.
Подготовь план фильтрации по наличию на выбранном складе.
Для каждого критерия приёмки укажи проверку.
Сохрани существующее поведение без фильтра.
Если необходимого контекста нет, сформулируй вопрос человеку.

В инспекторе инструкции задаются блоки Markdown и требуемый контекст. Кнопка «Показать инструкцию» позволяет увидеть собранный текст на учебных входных данных.

4. Соедините исходы

Переходы определяются для конкретных исходов этапа. Порядок в списке помогает читать схему, но не создаёт эти переходы автоматически.

Для учебного примера:

• успешный результат агента ведёт к следующему этапу;
• утверждение плана ведёт к реализации;
• отклонение плана возвращает работу его автору;
• провал проверки возвращает реализацию на доработку или останавливает процесс по правилам проекта;
• отклонение результата возвращает исполнителя к работе с вашим замечанием.

Назначайте возврат на этап, который может обработать замечание. Если его должен прочитать агент, цель возврата должна исполняться агентом.

5. Назначьте исполнителей

Исполнители и модели настраиваются в политике запуска проекта. Сам маршрут хранит процесс и инструкции, а не привязку к конкретному провайдеру.

Подробнее — в разделе об исполнителях.

6. Проверьте процесс

Перед публикацией:

1. Просмотрите собранные инструкции на подготовленном контексте.
2. Пройдите пробный сценарий успешного выполнения.
3. Проверьте отклонение плана и возврат с приёмки.
4. Нажмите «Проверить черновик» и исправьте найденные проблемы.

Проверка инструкций и симуляция переходов не запускают ИИ или команды проекта. Они помогают проверить устройство маршрута. Качество реального выполнения проверяется отдельным запуском.

7. Сравните и опубликуйте

«Сравнить с current» показывает изменения маршрутов и инструкций. После проверки используйте «Опубликовать этот снимок».

Если каталог раньше публиковался скриптом профиля, редактор предложит явно переключить источник на себя. Это решение определяет, кто управляет дальнейшей публикацией каталога.

Новые попытки возьмут опубликованную версию. Уже начатые сохранят предыдущую.

Если пропал ответ публикации

Используйте «Проверить результат», чтобы узнать исход уже отправленной операции. Потеря ответа сама по себе не означает, что публикация не состоялась.

8. Проведите пробный запуск

Возьмите небольшую задачу, подтвердите объём, выберите маршрут и проследите первый проход. На приёмке откройте стенд и проверьте критерии. Запишите, какого контекста или какой проверки не хватило, и используйте это для следующей версии маршрута.

Далее: управлять выполнением.