Задача AI-агенту: бриф, данные, приёмка

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

Почему «сделай отчёт по продажам» не работает

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

Агент справится с тем, что явно описано. Всё остальное он либо додумает по собственной логике, либо остановится с сообщением об ошибке в самый неудобный момент. Ни первый, ни второй исход не устраивает руководителя, который ждёт слайды к понедельнику.

Результат: что именно должно получиться

Начинайте бриф с описания конечного файла. Не с процесса, а с артефакта: его формат, структура, объём, получатель. Агент оптимизирует работу под то, что вы описали как финиш.

Плохо: «Сделай аналитику продаж».

Хорошо: «Подготовь презентацию в формате PPTX, 8-10 слайдов, для ежемесячного совещания директоров. Первый слайд - итоговые цифры за месяц, второй - динамика по неделям, третий - топ-5 продуктов по выручке. Остальные слайды по структуре согласуй со мной до финальной сборки».

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

Исходные данные: где лежат и насколько им можно доверять

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

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

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

Границы: что нельзя менять и к чему нельзя обращаться

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

Укажите три вещи: какие данные агент может только читать, а не изменять; какие системы или файлы вне задачи (например, агент работает только с выгрузкой за текущий месяц, архив за прошлые годы не трогает); какие решения агент не принимает самостоятельно - выбор методологии расчёта, изменение структуры отчёта, округление показателей.

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

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

Образец брифа для одной задачи

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

Задача: подготовить презентацию по итогам продаж за июль для совещания директоров.
Результат: файл sales_july.pptx, 8 слайдов, структура согласована со мной до финальной сборки.
Источник: выгрузка CRM_July_2026.xlsx, лист «Сделки», строки 2-1450.
  Столбец F - выручка без НДС, столбец K - статус (учитывать только «Закрыта»).
Ограничения: файл только для чтения, архивные данные не использовать,
  методологию расчёта не менять без согласования.
Промежуточный шаг: перед сборкой слайдов показать карту полей
  и список строк с пустым значением в столбце F.
Проверка: итоговая выручка в слайде совпадает с суммой F2:F1450
  только по строкам со статусом K = «Закрыта». Для каждого итога
  указать диапазон, фильтр и формулу; для отдельной сделки - строку.
При неопределённости: остановиться и сообщить о проблеме,
  не принимать решение самостоятельно. Контакт для вопросов - менеджер проекта.

Это не универсальный промпт. Это структура, которую вы заполняете под конкретную задачу и конкретные данные.

Как проверить, что работа выполнена правильно

Агент не знает, что для вас значит «хорошо». Критерии приёмки нужно описать заранее, иначе вы получите результат, который формально соответствует заданию, но расходится с ожиданиями.

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

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

Где агент остановится и попросит человека

Агент не всегда сам задаёт уточняющие вопросы. Одни инструменты спрашивают, другие молча делают выбор. Поэтому лучше явно указать, при каких условиях агент должен остановиться и написать вам, а не продолжать.

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

Это особенно важно для задач, где ошибка в данных влечёт ошибку в выводах, которые увидит руководство. Согласование до финального файла дешевле, чем объяснение на совещании, откуда взялась неверная цифра.

О том, как выстроить такие процессы в команде, читайте в материале о пилоте AI в команде и в разделе о внедрении AI в рабочие процессы.

FAQ

Нужно ли писать такой бриф для каждой задачи?

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

Что делать, если данные меняются каждый раз?

Опишите не конкретный файл, а правило его нахождения: «последняя выгрузка в папке /reports/crm/, название начинается с CRM_». Агент применит правило к актуальному файлу. Обязательно добавьте промежуточный шаг проверки структуры - разные выгрузки могут отличаться по формату.

Агент сделал что-то не так. Кто отвечает за результат?

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

Можно ли один бриф использовать повторно?

Да, если задача повторяется с теми же требованиями. Сохраните бриф как шаблон и обновляйте только переменные части: период, путь к файлу, получателя. Остальная структура остаётся рабочей.

Если хотите разобрать конкретную задачу или проверить, насколько ваш бриф закрывает все точки риска, напишите в Telegram или на hello@majento.ai.

Источник

Консультации и обучающие курсы Majento.