Бесплатный материал · проверен на 40+ запущенных агентах

Шаблон ТЗ для ИИ-агента

Одностраничное письменное ТЗ, самый высокорычажный документ в любой сборке ИИ-агента. Оно вынуждает принять сложные решения до написания кода: именно поэтому агенты, собранные с ТЗ, работают чисто, а агенты без него начинают деградировать на второй неделе. Этот шаблон фиксирует 12 полей, на которые нужно ответить до того, как кто-то напишет первый промпт или подключит первый коннектор.

Что внутри

Шаблон выстроен вокруг 12 решений, которые каждый продакшн-агент должен закрыть до начала сборки. Пропустите любое из них, и переделаете работу на второй неделе.

01 · Название агента и цель в одном предложении

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

Название агентаЦель в одном предложении

02 · Триггер: когда агент запускается?

По расписанию? По событию? По запросу? Укажите точное условие. «Новый лид» слишком расплывчато, а «новый контакт в HubSpot с lifecyclestage = marketingqualifiedlead» уже нет.

Тип триггераТочное условиеЧасовой пояс

03 · Входные данные: что агент читает?

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

Источник данныхСкоупПоля / записиУровень доступа

04 · Решения / рассуждения

Какие суждения принимает агент? Формулировки «читает лид, пишет письмо» недостаточно. Перечислите каждое решение, заложенное в рабочий процесс.

05 · Результаты: что агент производит?

Основной результат. Куда он попадает. Формат и структура. Кто видит его первым. Чем точнее, тем меньше переделок на пятый день.

Основной результатНазначениеФорматПервый проверяющий

06 · Точки подтверждения

Каждое внешнее действие требует подтверждения человеком в первые 4–6 недель реальной эксплуатации. Укажите кто, что и когда подтверждает.

07 · Критерии успеха

Измеримый результат, по которому вы решите, продлевать, дорабатывать или вывести агента из работы через 30 дней. Количественные + качественные.

08 · Лимиты расходов

Лимит кредитов на агента с мягким предупреждением и жёстким стопом. Месячный бюджет. Имя ответственного, которому придёт уведомление.

Мягкое предупреждениеЖёсткий стопМесячный бюджет

09 · Владелец и регламент

Конкретный внутренний владелец (не «команда»). Резервный владелец. Расположение регламента. Периодичность проверки работоспособности.

10 · Критерии вывода из работы

Явные условия, при которых агент снимается с эксплуатации. Агенты без таких критериев незаметно деградируют и становятся риском.

11 · Зависимости и подводные камни

Всё внешнее, от чего зависит агент и что может его сломать. Известные пограничные случаи. Логика резервного поведения.

12 · Сроки и подписи

Дата составления ТЗ. Плановые даты начала и завершения сборки. Дата запуска. Дата проверки через 30 дней. Три подписи: владелец, администратор, разработчик.

Как команды используют этот шаблон

Заполняют перед каждой сборкой агента: это ловит расползание скоупа до кода, а разбор вслух вскрывает скрытые предположения.
Отправляют администратору для согласования доступа к коннекторам. Раздел 3 (Входные данные) интересует администратора больше всего.
Используют как критерии приёмки на День 7. Если агент соответствует ТЗ, сборка закрывается чисто. Если нет, ТЗ становится объективным эталоном.
Прикладывают к регламенту, чтобы 30-дневная проверка имела базу для сравнения. На месячной отметке удобно сопоставить «что планировали» с «что агент делает на самом деле».
Пересматривают ТЗ каждый квартал. Агенты дрейфуют. Исходное ТЗ плюс реальные дельты покажут, что нужно доточить, а что вывести из работы.

Хотите, чтобы ТЗ заполнили за вас и сразу собрали агента?

Мы превращаем заполненное ТЗ в работающего агента за 3–5 рабочих дней, стоимость по брифу. Запишитесь на 20-минутный скоупинг-звонок, и заполненное ТЗ будет в вашей почте в течение 24 часов.

Записаться на скоупинг-звонок →Запросить оценку