Урок 5. Техническое задание (ТЗ) для AI-агента#
Зачем это нужно#
ТЗ — это документ, в котором вы описываете, что должен делать агент. Хорошее ТЗ помогает вам самому понять проект, а также передать его разработчику или клиенту.
Ключевая идея#
ТЗ = карта проекта
ТЗ отвечает на вопросы: зачем агент, что он делает, как работает, что нужно для запуска.
Структура ТЗ для AI-агента#
1. Общая информация
Что указать:
- Название проекта
- Заказчик (клиент или своя компания)
- Дата создания ТЗ
- Автор ТЗ
Пример:
Название проекта: AI-агент для квалификации лидов digital-агентства "WebPro"
Заказчик: ООО "WebPro"
Дата: 01.02.2026
Автор: Иван Петров, AI-консультант
2. Цель и задачи агента
Что указать:
- Зачем нужен агент
- Какую проблему решает
- Какой результат ожидается
Пример:
Цель:
Автоматизировать первичную квалификацию лидов, чтобы менеджеры получали только тёплых и горячих клиентов.
Задачи:
- Собирать данные от клиента (задача, бюджет, сроки)
- Оценивать лид (горячий/тёплый/холодный)
- Передавать тёплых и горячих лидов менеджеру
- Записывать всех лидов в Google Sheets для аналитики
Ожидаемый результат:
- Снижение нагрузки на менеджеров на 40%
- Увеличение скорости реакции на горячие лиды до 1 часа
- Сбор данных для аналитики (все лиды в одной таблице)
3. Целевая аудитория
Что указать:
- Кто будет общаться с агентом
- Какой уровень знаний
- Какие ожидания
Пример:
Целевая аудитория:
- Потенциальные клиенты digital-агентства
- Малый и средний бизнес
- Уровень: от начинающих предпринимателей до опытных маркетологов
- Ожидания: быстрая оценка стоимости и сроков, без долгих переговоров
4. Сценарий работы агента
Что указать:
- Шаг за шагом: что происходит
Пример:
Сценарий:
1. Клиент пишет боту в Telegram (например, "Здравствуйте, хочу заказать сайт")
2. Агент приветствует и задаёт первый вопрос: "Какая у вас задача? (сайт, реклама, SMM, дизайн, другое)"
3. Клиент отвечает (например, "сайт")
4. Агент задаёт второй вопрос: "Какой бюджет вы планируете? (до 50 тыс., 50–200 тыс., 200 тыс. и выше)"
5. Клиент отвечает (например, "200 тыс. и выше")
6. Агент задаёт третий вопрос: "Когда нужно? (срочно — до 2 недель, в течение месяца, планируем)"
7. Клиент отвечает (например, "срочно")
8. Агент оценивает лид: "Оценка лида: Горячий"
9. Агент записывает данные в Google Sheets (имя, контакт, задача, бюджет, сроки, оценка)
10. Агент отправляет уведомление менеджеру в Telegram: "Новый горячий лид! [данные]"
11. Агент говорит клиенту: "Отлично! Передаю ваш запрос менеджеру, свяжется в течение часа."
5. Промпт (инструкция агенту)
Что указать:
- Полный промпт (роль, задача, контекст, правила, формат)
Пример:
Промпт:
Ты — помощник менеджера по продажам digital-агентства "WebPro".
Твоя задача: задай клиенту 3 вопроса, оцени лид и передай менеджеру, если лид тёплый или горячий.
Вопросы:
1. Какая задача? (сайт, реклама, SMM, дизайн, другое)
2. Есть ли бюджет? (до 50 тыс., 50–200 тыс., 200 тыс. и выше)
3. Когда нужно? (срочно — до 2 недель, в течение месяца, планируем)
Оценка лида:
- Горячий: бюджет 200+ тыс., срочно
- Тёплый: бюджет 50–200 тыс., в течение месяца
- Холодный: остальные
Формат:
- Задавай вопросы по очереди (один вопрос в сообщении)
- После всех ответов выведи: "Оценка лида: [оценка]"
- Если лид горячий или тёплый, скажи: "Передаю менеджеру, свяжется в течение часа"
Правила:
- Тон деловой, но дружелюбный
- Если клиент не хочет отвечать на вопрос, переходи к следующему
- Не навязывайся
Действия:
- После оценки лида запиши данные в Google Sheets (используй инструмент)
- Если лид горячий или тёплый, отправь уведомление менеджеру в Telegram
6. База знаний (если нужна)
Что указать:
- Какие данные нужны
- Формат данных
Пример:
База знаний:
Для этого агента база знаний не требуется (агент задаёт вопросы, а не отвечает на них).
Если потребуется FAQ (например, "Какие услуги вы оказываете?"), добавить базу с вопросами и ответами.
7. Интеграции и инструменты
Что указать:
- Какие сервисы подключить
- Что настроить
Пример:
Интеграции:
1. Telegram Bot API
- Создать бота через @BotFather
- Получить токен
- Подключить к Coze
2. Google Sheets
- Создать таблицу "Лиды WebPro"
- Колонки: Дата, Имя, Контакт, Задача, Бюджет, Сроки, Оценка
- Подключить через плагин Google Sheets в Coze
- Настроить запись данных
3. Telegram-уведомления менеджеру
- Настроить webhook или использовать плагин Telegram для отправки сообщений
- ID чата менеджера: [указать ID]
8. Метрики и KPI
Что указать:
- Как измерять успех
Пример:
Метрики:
- Количество обработанных лидов в день
- Доля горячих/тёплых/холодных лидов
- Время от первого сообщения до передачи менеджеру
- Конверсия горячих лидов в сделки (отслеживать через CRM)
Целевые KPI:
- Обработка 50+ лидов в неделю
- 70% лидов квалифицированы автоматически (без участия менеджера)
- Время реакции на горячий лид: менее 1 часа
9. Сроки и этапы
Что указать:
- Когда что делать
Пример:
Этапы:
1. Разработка промпта и тестирование (1 день)
2. Создание бота в Telegram и настройка в Coze (1 день)
3. Настройка интеграций (Google Sheets, уведомления) (1 день)
4. Тестирование с тестовыми запросами (1 день)
5. Запуск в тестовом режиме (3 дня)
6. Сбор обратной связи и правки (2 дня)
7. Полный запуск (день 10)
10. Риски и ограничения
Что указать:
- Что может пойти не так
- Что агент НЕ делает
Пример:
Риски:
- Клиент может не отвечать на вопросы → агент передаст лид как "холодный"
- Агент может неправильно понять ответ (например, "бюджет гибкий") → нужно тестирование и уточнение промпта
- Google Sheets может быть недоступен → настроить резервное хранилище или уведомление об ошибке
Ограничения:
- Агент НЕ ведёт переговоры о цене
- Агент НЕ отвечает на вопросы о портфолио (только квалификация)
- Агент НЕ обрабатывает сложные запросы (например, "нужен сайт + реклама + SMM") — передаёт менеджеру