Когда мы только начали строить с ИИ-агентами, мы делали то, что делали все — писали промпты. Длинные, подробные, тщательно выверенные промпты. И они работали... иногда.
Фундаментальная проблема промпт-ориентированных воркфлоу не в самих промптах. Проблема в допущении, что естественный язык в одиночку может нести весь груз инженерного намерения.
Слой спецификации
Спек — это не промпт. Спек — это структурированное объявление намерения, которое включает:
- Цель: Что агент должен сделать
- Ограничения: Что агент не должен делать
- Контекст: Что агенту нужно знать
- Верификация: Как мы узнаем, что агент справился
Это различие важно, потому что отделяет что от как. Агент решает как. Вы решаете что.
Результаты на практике
После миграции 23 внутренних воркфлоу с промпт-архитектуры на спек-архитектуру:
- Процент выполнения задач: 41% → 94%
- Процент восстановления после ошибок: 12% → 78%
- Частота вмешательства человека: каждая 3-я задача → каждая 15-я
«Лучший спек читается как контракт между намерением человека и исполнением машины.»
Паттерн реализации
interface AgentSpec {
goal: string;
constraints: string[];
context: Record<string, unknown>;
verification: VerificationRule[];
fallback: FallbackStrategy;
}
Ключевой инсайт: спеки компонуемы. Сложный воркфлоу превращается в DAG простых спеков, каждый из которых верифицируется независимо.