Как поставить задачу AI-агенту: 6 частей брифа

Агент сделал не то, и в разборе выясняется: задача была поставлена одной строкой. «Сделай сводку по заявкам» — во фразе нет ни источника, ни периода, ни формата, ни определения того, что считать заявкой. Модель не ошибалась: она достроила недостающее по своему усмотрению и не сообщила об этом.

Постановка задачи агенту отличается от просьбы коллеге только тем, что у агента нет офисного контекста. Он не знает, что заявка — это только обращения с сайта, и что сводка нужна до планёрки. Всё, чего нет в брифе, будет заполнено догадкой.

Почему агент «не понимает» задачу

Причин обычно три, и ни одна из них не связана с моделью.

Догадка вместо данных. В задаче не сказано, откуда брать вход. Агент берёт то, что оказалось под рукой: последнюю выгрузку, вчерашний файл, соседнюю таблицу. Результат выглядит правдоподобно, поэтому ошибку замечают через неделю.

Разная трактовка термина. «Лид», «заявка», «активный клиент», «просрочка» в компании значат одно, а в общем языке — другое. Пока определение не записано, каждый запуск будет трактовать его заново.

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

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

Бриф вместо просьбы

Просьба живёт в переписке, бриф — в файле. Разница не в объёме, а в проверяемости: у брифа есть версия, дата и владелец, поэтому после сбоя можно открыть документ и увидеть, что именно было написано, а не вспоминать формулировку.

• Просьба отвечает на вопрос «что мне нужно» и подразумевает общий контекст.
• Бриф отвечает на вопросы «откуда», «по какому правилу», «куда» и «как проверить» — и не подразумевает ничего.

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

Шесть частей брифа

1. Цель в терминах результата

Первая строка описывает не действие, а результат: что должно измениться в мире после работы агента. «Разослать напоминания» — действие. «Клиенты с бронью на завтра получили напоминание, а в системе стоит отметка об отправке» — результат, который можно проверить.

Второй элемент этой части — определение ключевых слов. Достаточно одной строки на термин: что считается заявкой, что считается завершённой задачей, что — отменой.

2. Вход: источник и его границы

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

Отдельная строка — про отсутствие данных. Это не ноль и не «пусто»: если источник недоступен, правильное поведение — остановиться и сказать об этом, а не собирать результат из остатков.

3. Правило: что делать при неоднозначности

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

Хорошее правило звучит как инструкция для новичка: «если в заявке нет телефона, не создавай сделку, а положи обращение в очередь на проверку и укажи причину». Оно проверяемо: видно и решение, и причину.

4. Выход: артефакт и место записи

Формулировка «сделай отчёт» даёт столько же вариантов, сколько исполнителей. В брифе фиксируется форма: таблица с перечисленными колонками, сообщение заданной структуры, файл с именем по шаблону, запись в конкретном разделе системы. Там же указывается, куда результат попадает и кто его увидит.

Если выход — запись в системе, стоит добавить требование обратного чтения: после записи агент проверяет, что запись действительно появилась и содержит нужные поля. Логика такого требования разобрана в статье про evidence-before-write.

5. Границы: чего нельзя и когда звать человека

Границы пишутся в двух видах: запрет на действие и условие остановки. Запрет отвечает на вопрос «чего агент не делает никогда»: не меняет статусы без подтверждённого факта, не пишет клиенту от лица руководителя, не правит закрытые периоды. Условие остановки отвечает на вопрос «когда он останавливается и передаёт задачу человеку».

Границы имеют смысл только тогда, когда у человека есть право остановить процесс. Если стоп-кнопка есть лишь у подрядчика, границы остаются декларацией.

6. Критерий приёмки

Последняя часть отвечает на вопрос, как проверить, что задача выполнена. Критерий должен быть проверяемым без интерпретации: результат открывается, сверяется с источником, сравнивается с ожидаемым форматом. «Сделано хорошо» критерием не является.

Полезно указывать и то, что считается неудачей: сколько попыток допустимо, что делать после них, кому уходит сигнал. Иначе сбой выглядит как бесконечная работа без результата.

Условный пример брифа

Ниже — пример для вымышленной компании, чтобы был виден формат. Названия и цифры условные.

• Цель: к утру у владельца есть список обращений, на которые не ответили вовремя, с причиной задержки.
• Вход: основная система обращений; период — последние сутки; источник считается свежим, если обновлялся после полуночи; при недоступности источника — остановиться и сообщить.
• Правило: если время ответа не зафиксировано, обращение попадает в раздел «нет данных», а не в «нарушения».
• Выход: сообщение из двух блоков — «нарушения» и «нет данных», у каждой строки номер обращения, дата, время ожидания, ответственный.
• Границы: не отвечать клиентам, не менять статусы, не делать выводов о причинах.
• Приёмка: число строк совпадает с числом обращений в источнике; раздел «нет данных» присутствует всегда, даже если пуст.

Пять ошибок в постановке задачи

• Цель через действие. «Отправить», «собрать», «проверить» — не цель. Цель — изменение, которое можно проверить.
• Два результата в одном брифе. Приёмка превращается в спор о том, что именно сдано.
• Правило «на твоё усмотрение». Агент выберет не худший вариант, а самый частый в обучающих данных.
• Нет строки про отсутствие данных. Пустота маскируется под нулевой результат и выглядит как успех.
• Критерий приёмки со слов. «Вроде нормально» нельзя повторить, значит нельзя и улучшить.

Тест брифа до запуска

Проверка занимает меньше часа и находит большинство проблем до того, как агент начнёт работать с реальными данными.

1. Прогнать пять настоящих задач разного типа: обычную, пограничную, с отсутствующими данными, с противоречием между источниками и явно ошибочную.
2. Задать один вопрос «а если» на каждую часть брифа — и посмотреть, есть ли в документе ответ. Отсутствие ответа и есть место, где агент начнёт угадывать.
3. Попросить человека, не участвовавшего в написании, принять результат по критерию. Если он задаёт вопросы, критерий не дописан.
4. Проверить выход на пустом наборе данных: правильное поведение — видимое «нет данных», а не аккуратный пустой отчёт.

Где хранить брифы

Бриф — рабочий документ, поэтому у него есть версия, дата и владелец. Один файл на задачу лучше папки: в нём видно историю изменений, а рядом — правило, по которому бриф меняется. Менять документ стоит после сбоя или после замечания приёмки, а не «когда появилось настроение».

Формат хранения значения не имеет; значение имеет то, что бриф открывается в момент разбора. Практика, при которой брифы живут в переписке, заканчивается одинаково: через месяц никто не может сказать, по какой версии правил агент работал в прошлый вторник. Как устроен один файл-инструкция на несколько десятков задач, разобрано в материале про AGENTS.md и инструкции для агентов.

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

Чек-лист постановки задачи

1. Цель записана как результат, а не как действие.
2. Термины определены одной строкой каждый.
3. Указан основной источник, признаки свежести и поведение при его недоступности.
4. Записано правило на случай неоднозначности — с примером.
5. Выход описан по форме и месту записи, включая обратное чтение.
6. Есть запреты и условие остановки с передачей человеку.
7. Критерий приёмки проверяется без интерпретации.
8. Бриф прогнан на пяти задачах, включая пустой набор данных.
9. У документа есть версия, дата и владелец.

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

Чем бриф для агента отличается от обычного технического задания?

Техническое задание описывает систему, а бриф описывает одну задачу и её приёмку: откуда брать данные, по какому правилу действовать при неоднозначности, куда писать результат и как проверить готовность. Бриф короче и меняется чаще — после каждого сбоя или замечания приёмки.

Сколько времени занимает составление брифа?

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

Можно ли обойтись без правил и написать «действуй по ситуации»?

Нет. Такая формулировка означает, что решение принимает модель по наиболее частому варианту, а не по вашему. Если вариантов поведения несколько, правило задаётся списком приоритетов или условием передачи человеку — но оно должно быть записано.

Что делать, если данных для задачи нет?

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

Как понять, что бриф пора переписать?

Три признака: приёмка всё чаще возвращает результат, агент задаёт человеку одни и те же уточняющие вопросы, в процесс добавился новый источник данных. В этих случаях меняется конкретная часть брифа, а не весь документ.