Хорошее задание для агента держится на четырёх частях: контекст, итог, границы и проверка. Почти все неудачи — не про модель, а про постановку, поэтому начинать надо с них.
Что агент делает хорошо, а что — нет?
Хорошо: держит в голове длинный список требований и применяет его ко всем файлам сразу; сам составляет отчёт по вашим критериям; останавливается и спрашивает, если это прописано заранее; переделывает сколько угодно раз без обиды. Категорически плохо: читать между строк — он делает ровно то, что написано; угадывать, что архив трогать нельзя; решать за вас, какой итог вам на самом деле нужен; предлагать границы — их знаете только вы.
Анатомия задания
Контекст — что агент увидит и в каком оно состоянии: какие папки, файлы, данные ему открыты, что уже сделано, что считается образцом. Агент не читает мысли, но отлично читает файлы: то, что вы объяснили один раз, он потом применяет ко всему заданию.
Итог — что должно существовать в конце и в каком виде: файл, структура папок, отчёт, рабочая страница. Формулировка «чтобы было нормально» — не итог; «в папке отчёты лежит годовой файл-сводка по месяцам» — итог.
Границы — чего не трогать ни при каких условиях. Это самое недооценённое: человек инстинктивно молчит о святом («я и не думал, что можно удалить архив»), агент додумывает сам.
Проверка — как вы примете работу: три-пять пунктов, которые смотрит человек, и одно условие «считать выполненным, только когда…».
Правило отдела: если в задании нет хотя бы трёх частей из четырёх — агент допишет их по своему вкусу.
Шаг 1. Соберите задание из шаблона
Не сочиняйте каждый раз с нуля — держите рамку и заполняйте пустые места. Пять минут на заполнение экономят вечер переделок. Выглядит это так: «Контекст: в папке Документы — сканы договоров за три года, ничего не организовано; образец порядка — папка 2024, которую я делал сам. Итог: все файлы разложены по годам и типам, спорные — в папке „На проверку“ со списком причин. Границы: сканы не переименовывать и не сжимать, работать копиями. Проверка: отчёт по каждому году — сколько разложено, сколько осталось спорным». Четыре абзаца — и задача из «наведи порядок» превратилась в приёмку с критериями.
Если итог не формулируется — попросите агента задать вам три вопроса, ответы на которые превратят смутную идею в готовый итог. Рамку держите файлом: заполненная трижды, за месяц она становится вашим стандартом задания, и дописывать остаётся только факты.
1) Контекст: у меня есть [папки/файлы/данные] в состоянии [коротко: что уже сделано, что за образец]. 2) Итог: должно появиться [что, в каком виде, где]. 3) Границы: не трогай [святое]; оригиналы [файлов] не меняй, работай с копиями. 4) Проверка: после работы составь список «сделано / не сделано / не уверен» по каждому пункту итога. Если какой-то из четырёх частей у меня нет — не додумывай за меня, спроси одним вопросом.
Разбор: четыре расплывчатые формулировки и чем их заменить
Сплошь и рядом неудача не в модели, а в одной строчке задания, которая вам показалась понятной. Ни одна из четырёх ниже не читается агентом как приказ искать именно то, что вы имели в виду, — он берёт самый правдоподобный вариант и молча его делает. Замена всегда одна и та же по форме: вместо свойства назовите действие и место, где его видно.
| Что вы написали | Как это понимает агент | Чем заменить |
|---|---|---|
| «наведи порядок в папке» | пересортирует по своему вкусу и переименует файлы | «разложи по годам и типам, спорное — в „На проверку“ со списком причин» |
| «сделай красиво» | добавит то, что считает красивым, и не спросив | «предложи два варианта и жди моего выбора» |
| «почисти данные» | удалит дубли, которые удалять нельзя | «работай копиями; список намеченных удалений покажи до правки» |
| «проверь, чтобы всё работало» | напишет «работает» | «вот три проверки; приложи результат каждой строкой» |
У всех четырёх замен один корень: в исходной строчке нет итога, который можно посмотреть. «Порядок», «красиво», «чисто», «работает» — это оценки, а оценки агент ставить не может, потому что сверять их нечем. Как только вместо оценки появляется файл, папка или строка отчёта, задание перестаёт быть лотереей: вы получаете не обещание, а то, что можно открыть глазами и принять или отвергнуть за минуту.
Например, задание «разберись с папкой документов» агент решит на свой вкус и смолчит. А «разложи файлы из папки „Входящие“ по трём подпапкам — счета, акты, прочее; сомнительные оставь в корне и выпиши списком с причиной» — это итог, названный до отправки. Спорить не о чем.
Шаг 2. Задайте границу аварийной остановки
Кроме «не трогай X» полезно одно глобальное правило: что делать, когда агент не уверен. Без него он выбирает самый вероятный вариант молча; с ним — спрашивает, и вы ловите ошибку до правки. Формулировка занимает одну строку, но работает на всех задачах сразу.
Стоит это дёшево, а ловит три самых дорогих класса аварий: удалить, перезаписать, «я улучшил формат». Второе правило той же строки — не создавать ничего вне названной папки: иначе через неделю вы найдёте три версии одного файла и не вспомните, какая настоящая. Третье — «не доделывай по своему вкусу»: если задача звучит как «придумай красиво», пусть сначала предложит два варианта и ждёт вашего выбора. И примите сами, что вопрос — нормальный итог работы: иначе вы будете раздражаться, а агент начнёт молча угадывать.
Если во время работы окажется, что вариант больше одного или данных не хватает: 1) не выбирай сам — остановись, 2) выпиши вопрос и два-три варианта, как вижу я. Такой случай считается нормальным итогом, а не провалом. Не создавай файлы вне [папка]. Где нужно решение по вкусу — предложи два варианта и жди моего выбора, не реализовывай молча. Сверь ответ с правилом: агент не выбрал сам — в нём есть вопрос и два-три моих варианта.
Шаг 3. Встройте приёмку в задание
Проверять «потому что я так решил» — значит проверять дважды: работу агента и собственную память. Поэтому критерии записывайте прямо в задании: по ним агент сам составит отчёт, а вы просто пробежитесь списком. На повторяющихся задачах (отчёт, разбор папки) этот же текст становится регламентом — см. статью 0.3 про файлы правил.
Критерий должен проверяться одним действием: «в корне папки нет файлов старше 2023 года» — проверяется, «порядок наведён» — нет. Три критерия лучше десяти: длинный список приёмки начинает выполняться выборочно. Просите приложить результат самопроверки — это ловит «всё готово» раньше, чем вы откроете папку. И финальной строкой: пусть выпишет незакрытое — что не сделано и какие вопросы остались у него. Этот список обычно и есть следующее задание.
Считать задачу выполненной только когда: 1) [критерий]; 2) [критерий]; 3) [критерий]. Перед тем как сказать «готово», проверь эти пункты сам и приложи результат проверки. Если пункт не сходится — напиши честно, какой и почему. В конце отдельным списком: что осталось незакрытым и какие вопросы остались у тебя.
А если вопросов стало больше, чем работы?
Граница неуверенности имеет обратную сторону: агент, которого научили спрашивать, начинает спрашивать про всё на свете, и вечер уходит на ответы. Лечится это не отменой правила, а вторым слоем — правилами по умолчанию. Один раз соберите то, о чём он спрашивает из задачи в задачу (как именовать файлы, в каком формате писать даты, куда класть спорное, что считать оригиналом), согласуйте этот список сами и вклейте в типовое задание. После этого вопросов про решённое не остаётся, а настоящие вопросы — про то, чего вы сами ещё не решили, — остаются.
Вторая настройка — где именно спрашивать. Разбросанные по ходу работы семь вопросов хуже одного списка из семи строк: вы отвечаете на третий, а первый уже забыли. Просите выписывать их до первой правки — тогда вы один раз решаете всё и дальше только приёмка. Перекос в другую сторону тоже видно по одному признаку: после работы вы правите не содержимое, а решения — «я просил не это». Значит, автономии больше, чем вы заказывали, и правило «не выбирай сам — остановись, выпиши вопрос» из рецепта 2 пора снова вписывать в задание.
Из наших последних трёх задач [какие три брать] собери всё, о чём ты спрашивал меня по одному и тому же поводу, и сверни в правила по умолчанию: - именование файлов, - формат дат, - куда класть спорное, - что считать оригиналом, - когда останавливаться. Дай список для моего согласования — по строке на правило, без пояснений. Что я утвержу — вставляй в каждое следующее задание и больше про это не спрашивай. Вопросы, которых в правилах нет, выписывай одним списком до начала правок, а не по ходу работы, и считай такой список нормальным началом задачи. Сверь список правил с задачами: каждое подтверждается моим вопросом в трёх последних задачах.
Формулировка живёт недолго, если её каждый раз собирают заново: правила держат в файле правил, а итог сверяют на приёмке работы.
Осторожно: границы работают в обе стороны. Не открывайте агенту папку целиком, если задача в её углу: лишнее — это и риск задеть, и лишний мусор в контексте. Не ставьте проверку «на глаз» («должно быть красиво») — превратите её в два конкретных критерия, иначе отчёт о проверке будет вежливым, а не честным.
Если некогда делать самому — поручим: на странице услуги справочника — настройка агента под вашу задачу, по вашим файлам и правилам, а приёмка работы останется за вами.