АгентеоАгентео
Практика

Что должно быть в техзадании на AI-агента

Плохое техзадание — это описание того, что агент должен «уметь». Хорошее отвечает на вопрос, по каким признакам мы поймём, что он работает. Разбираем структуру по пунктам.

Опубликовано

Девять разделовЧто забывают чаще всегоКритерии приёмки

Девять разделов

  1. Цель и метрика. Один показатель, его текущее значение, способ замера и целевое значение. Не «улучшить обработку заявок», а конкретное число.
  2. Границы процесса. Где он начинается и заканчивается. Что агент точно не делает — этот пункт важнее, чем кажется.
  3. Источники данных. Из каких систем берутся данные, через какие механизмы, под какой учётной записью, с какими правами.
  4. Правила принятия решений. Записанные словами условия, по которым агент выбирает вариант. Здесь всплывают правила, которые жили в головах.
  5. Точки согласования человеком. Какие действия требуют подтверждения и кто подтверждает.
  6. Обработка исключений. Что делает агент, когда не уверен, когда данных не хватает, когда система недоступна.
  7. Что уходит наружу и что пишется в логи. Перечень полей поимённо.
  8. Критерии приёмки. На какой выборке и как проверяется результат.
  9. Условия признания неудачи. При каком значении метрики проект закрывается.

Что забывают чаще всего

РазделЧем оборачивается пропуск
Что агент НЕ делаетБесконечное расширение объёма по ходу проекта
Обработка исключенийАгент угадывает там, где должен был спросить
Критерии приёмкиСпор о том, готово или нет, на защите результата
Условия неудачиПроект не закрывается никогда и тянет бюджет
Права на результатНепонятно, чьи промпты и настройки после расторжения

Про правила принятия решений

Это самый трудоёмкий раздел и самый полезный. Когда вы садитесь записывать словами, по каким признакам менеджер квалифицирует лид или бухгалтер принимает документ, выясняется, что единых правил нет — каждый делает по-своему.

Это открытие само по себе ценно, независимо от внедрения. Но пока правила не записаны, агента учить нечему.

Критерии приёмки: как формулировать

Формулировка должна быть проверяемой на конкретной выборке:

«На выборке из 200 обращений за последний месяц агент корректно определяет тему не менее чем в 85% случаев; ошибки категории „передал не в ту группу“ — не более 5%».

Такую формулировку нельзя истолковать двояко. «Агент должен корректно обрабатывать обращения» — можно, и в этом вся разница.

Кто пишет техзадание

В нашем случае — мы, по результатам аудита, и отдаём вам как документ, с которым можно идти к любому подрядчику. Это сознательно: техзадание, написанное подрядчиком под себя, обычно нельзя использовать больше нигде.

Частые вопросы

Может ли заказчик написать ТЗ сам?

Может, если внутри есть человек, знающий и процесс, и возможности технологии. На практике чаще получается либо слишком общее описание, либо список функций без метрики.

Нужно ли ТЗ для небольшого агента?

Нужны как минимум метрика, границы и критерии приёмки. Без них спор о готовности неизбежен даже на маленьком проекте.

Что делать, если правила нигде не записаны?

Записать. Это часть работы на аудите: садимся с владельцем процесса и формулируем словами то, что он делает по интуиции.

Кому принадлежит ТЗ?

У нас — заказчику, включая случай, когда вы решили не продолжать. Мы считаем это нормой: вы за него заплатили.

Составим техзадание на аудите

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

Оставить заявку

Готовы начать?

Проще всего написать нам в Telegram: разберём задачу и скажем, есть ли смысл в аудите. Ответим в течение часа.

Написать в Telegram

или оставьте контакты

Оставьте телефон или Telegram - что вам удобнее. Достаточно одного.

Спасибо! Заявка отправлена - свяжемся с вами в ближайшее время.
Не удалось отправить заявку. Напишите нам в Telegram @dimax_web.

Или позвоните: +7 (949) 365-03-18 · dimaxeod@gmail.com