Skip to content
PПромтбук
RUEN
03Оркестрация

Последовательный пайплайн агентов

Когда параллель не подходит: цепочка агентов с явными контрактами между шагами.

Спроектируй последовательный пайплайн агентов для: {{task}}.

Когда нужен пайплайн (а не один агент или параллель)

  • Каждый шаг — отдельная компетенция
  • Выход одного шага — вход следующего
  • Распараллелить нельзя (есть зависимость)
  • Нужны промежуточные human-checks

Структура

Шаг 1: [Агент A] → промежуточный артефакт
Шаг 2: [Агент B] (получает артефакт A) → артефакт
Шаг 3: [Агент C] (получает артефакт B) → финал

Для каждого шага

Агент: [роль]
Вход:
  - артефакт от предыдущего шага (если есть)
  - контекст: [что ещё нужно]
Выход:
  - формат: [строгая спецификация]
  - размер: [лимит]
Тесты:
  - [3-5 кейсов которые должны пройти]

Контракты между шагами

Это критично. Если контракт сломается — пайплайн сломается.

# Артефакт от Шага 1 (Researcher)
findings:
  - source: "https://..."
    quote: "..."
    relevance: high | medium | low
summary: "..."
open_questions:
  - "..."

Следующий агент знает: "я получу такую структуру". Парсит, проверяет, работает.

Обработка ошибок

Что делать если агент N выдал плохой результат?

  • Retry с подсказкой: "Ты вернул некорректный JSON. Попробуй ещё раз, помни про схему ниже: ..."
  • Откат к предыдущему шагу: "Не могу продолжить — нужно больше контекста с шага N-1"
  • Human-in-the-loop: позови человека, дай ему контекст
  • Fallback на простой: если умный агент не справляется, попробуй простой fallback

Логирование

Логируй на каждом шаге:

  • Вход (с какими данными агент получен)
  • Выход (что вернул)
  • Время / токены / стоимость
  • Версия промта

Это даст возможность дебажить если что-то идёт не так.

Контрольные точки (checkpoints)

Длинный пайплайн? Сохраняй промежуточные результаты:

  • Если шаг 3 провалился, не перезапускай 1 и 2
  • Восстанавливайся с последней успешной точки

Анти-паттерны

  • Пайплайн из 10 шагов где каждый делает чуть-чуть — медленно, дорого, хрупко
  • Шаг возвращает свободный текст вместо структуры — следующий не парсит
  • Нет логов — невозможно дебажить
  • Все агенты дублируют контекст — лишние токены

В конце дай

  • Диаграмму пайплайна
  • Контракты для каждого шага
  • Промты для каждого агента
  • 3 тестовых кейса end-to-end
К подразделу «Оркестрация»
Похожие промты