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
Похожие промты
agents / createFeatured
Создать специализированного агента
Определить роль, инструменты, границы и системный промт нового агента для Claude Code.
agentssubagentsystem-prompt
Открыть
Средний30-60 мин
agents / create
Шаблон системного промта агента
Готовая структура: роль, контекст, инструменты, алгоритм, формат, anti-patterns.
agentssystem-prompttemplate
Открыть
Начальный15-30 мин
agents / orchestration
Декомпозиция задачи на агентов
Разбить большую задачу на параллельных независимых агентов с чёткими интерфейсами.
agentsorchestrationparallel
Открыть
Продвинутый15-30 мин