Соберите свой первый конвейер

Что вы создадите

К концу этого руководства у вас будет:

• Сохранённый шаблон конвейера, который запускает агента с промптом
• Включённые на нём ручные запуски, чтобы его можно было запускать вручную
• Один завершённый запуск с видимыми входом и выходом шага

Предварительное условие: пройденное руководство Запустите первого агента, так что у вас есть агент с адаптером и моделью.

Конвейер — это DAG из шагов. Шаблоны определяют граф; запуски — это выполнения. О лежащей в основе модели читайте в разделе Конвейеры и автоматизация; полный словарь шагов — в разделе Типы шагов конвейера.

Шаг 1. Создайте шаблон

1. Перейдите в Настройки → Рабочее пространство → Шаблоны конвейеров
2. Нажмите Новый шаблон

Редактор открывается на предзаполненной заготовке с именем Новый конвейер (id pipeline_N). Нажмите на название в заголовке и переименуйте её — для этого руководства code_quality_check — хорошее имя. Диалога для идентификатора нет, как нет и поля описания.

Холст не пуст. Новый шаблон приходит уже собранным как Trigger → Step → терминал, где «Step» — узел промпт-агента, а терминал — невидимый сторожевой элемент, который редактор переподключает к каждому достижимому стоку.

Вы настраиваете узел Step, который уже есть на холсте.

Шаг 2. Настройте шаг

1. Нажмите на узел Step на холсте
2. На панели Настройки узла справа задайте:
   • Агент: агент из предыдущего руководства
   • Шаблон промпта: «Проверьте код в текущей ветке на проблемы качества. Перечислите, что найдёте.»
3. Не трогайте Triggers from — узел уже настроен срабатывать после узла Trigger

Шаг 3. Сохраните

Нажмите Сохранить в заголовке редактора.

Контрольная точка. Подпись «Несохранённые изменения» исчезает.

Шаг 4. Разрешите ручные запуски

1. Нажмите пунктирную плитку Добавить триггер на холсте (или перетащите Ручной запуск из раздела Триггеры библиотеки узлов) и выберите Ручной запуск.
2. Выберите этот узел. В инспекторе справа включите Включено — «Показывать на странице запуска и запускать вручную.»

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

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

Шаг 5. Запустите его

1. Нажмите Конвейеры на боковой панели
2. Нажмите Запустить конвейер в шапке
3. Выберите code_quality_check на панели слева
4. Нажмите Запустить конвейер в форме — ваш шаблон не объявляет входных данных, поэтому заполнять нечего

Контрольная точка. Всплывающее уведомление подтверждает, что запуск начался, и Control Center открывает детали запуска.

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

Шаг 6. Проверьте результат

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

• Отметки времени Начато и Завершено, а также Длительность
• Вход: состояние, переданное в шаг
• Выход: то, что он произвёл, — здесь ответ агента
• Активность агента со ссылкой на разговор, который вёл этот шаг

Контрольная точка. Шаг отображается как завершённый, а в его выходе — ревью агента.

Добавление новых шагов

Узлы добавляются перетаскиванием элемента из библиотеки узлов слева на холст или нажатием Добавить шаг (+) сразу после узла. Перетащите из порта выхода узла на другой узел, чтобы соединить их, или выберите новый узел и отметьте его вышестоящий шаг в разделе Triggers from.

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

Итоги

Вы создали шаблон, настроили узел промпт-агента, которым он был предзаполнен, сохранили его, сделали запускаемым вручную, начали запуск и прочитали вход и выход шага.

Конвейеры бывают куда больше — условные маршрутизаторы, параллельные ветви, узлы объединения, fan-out для каждого элемента, шлюзы с участием человека, — но форма не меняется никогда: шаги в DAG, которые передают состояние.

Далее: Подключите Slack к рабочему пространству — последнее руководство в этой последовательности.

• Настройте триггеры конвейера, чтобы запускать конвейеры по событиям или по расписанию
• Конвейеры и автоматизация, чтобы понять лежащую в основе модель
• Типы шагов конвейера, чтобы изучить все типы шагов