Как поручить AI-агенту договоры, счета и акты

Как это выглядело руками

Задача звучит скучно и от этого кажется простой. Открыть последний договор, заменить название компании, ИНН, адрес, банк, ФИО руководителя, сумму, номер и дату. Следом то же самое в счете, потом в акте. Ничего сложного, но полчаса уходит стабильно, и половина этого времени тратится на проверку того, что нигде не осталось чужих данных.

Проблема даже не во времени. Ошибки в таком копировании выглядят одинаково у всех.

Каждая мелочь стоит минуты. Стоимость исправления другая: документ уезжает клиенту, возвращается с правками и согласуется по второму кругу.

Отдельно раздражает то, что эта работа не становится легче с опытом. Сотый комплект собирается ровно так же внимательно, как первый.

---

Что получилось вместо этого

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

Живая часть работы остается агенту, механическая уходит скрипту. Дальше объясню, почему это разделение важнее, чем кажется.

Вычитка глазами остается за мной и занимает примерно минуту. Полчаса превращаются в эту минуту.

---

Почему хватает скилла и не нужен сервис

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

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

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

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

---

Что подготовить до старта

Три вещи, и ни одна из них не техническая.

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

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

---

Первый промпт

Соблазн понятный. Открыть агента и сказать, собери мне скилл для договоров. Получится пустая конструкция, которая ничего не знает про ваши бланки и ваши поля.

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

Запрет на код это точка контроля. Без него агент бодро напишет двести строк по своим догадкам о вашем бланке, и разбирать их будет дольше, чем сделать руками.

---

Карта полей: здесь и есть вся работа

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

С названием компании все просто, оно везде одинаковое. С ФИО руководителя уже нет.

Поле	Как ведет себя	Что из этого следует
Название компании	Одинаково во всех местах	Одно значение, простая подстановка
ФИО руководителя	Три формы: полная, сокращенная в родительном падеже, инициалы в подписи	Три отдельных поля, не одно
Род руководителя	Меняет окончания в шапке и по тексту	Отдельный признак, от него склоняются слова
КПП	Есть у общества, у предпринимателя отсутствует	Строка целиком убирается, пустое место не годится
Должность	Есть у общества, у предпринимателя отсутствует	Меняется вся конструкция шапки
Сумма	Цифрами, прописью и в скобках после цифр	Одно исходное значение, три разных вывода
Номер документа	У счета берется из номера договора	Связанные поля, второй раз номер не вводится

На этой таблице ловится примерно половина будущих ошибок, причем на бумаге и бесплатно. Час, потраченный здесь, экономит вечер отладки потом.

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

---

Сборка

Второй промпт получается коротким, потому что вся содержательная работа уже сделана.

Правило про бланк стоит повторить агенту дословно. Модель охотно перепишет ваш договор своими словами, если ей это прямо не запретить.

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

---

Грабли, о которых узнаешь только на практике

Четыре места, где первая версия ломается почти гарантированно. Знать про них полезно заранее, чтобы понимать, что происходит.

Документ разрезан на куски

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

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

Счет с формулами и его PDF

Заказчику обычно уезжает PDF. Тут вылезает тонкость: если суммы в бланке лежат формулами, в файле нет посчитанного значения, только само выражение. Экспорт сторонними средствами дает пустые ячейки или пустую страницу.

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

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

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

Сумма прописью

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

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

Мелочи, которые ломают удобство

• Куда падают файлы. На рабочий стол, а дальше вы их разбираете. Папка внутри проекта выглядит аккуратнее и на практике означает, что готовый комплект вы ищете лишние полминуты.
• Имя файла. Дата в начале в формате из шести цифр, потом тип документа, потом заказчик. Сортировка по имени сразу становится сортировкой по времени.
• Нумерация. Если за день собирается больше одного комплекта, второй получает номер с добавкой. Номер счета при этом берется из договора, чтобы связь между документами читалась.
• Правки в бланке. Бланк лежит отдельным файлом, поэтому новая редакция просто кладется сверху. Скрипт при этом трогать не нужно, пока не поменялся состав полей.
• Остановка при нехватке данных. Скрипт обязан останавливаться с понятным сообщением. Молча подставленное пустое значение вы заметите уже у клиента.

---

Тесты: восемь прогонов до первого клиента

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

Набор прогонов у меня получился такой.

Восьмой прогон проверяет поведение при нехватке данных. Он важнее остальных семи.

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

---

Куда это масштабируется

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

По этому признаку отлично ложатся:

• коммерческие предложения с фиксированной структурой;
• счета на регулярные услуги и абонентские платежи;
• кадровые документы, приказы, заявления, справки;
• акты сверки и закрывающие документы за период;
• доверенности, согласия и уведомления контрагентам.

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

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

---

Как повторить у себя за вечер

1. Соберите папку. Три пустых бланка и три заполненных образца в одном месте.
2. Отдайте их агенту с запретом писать код и требованием вернуть таблицу полей и список вопросов.
3. Проверьте карту полей построчно. Для каждого поля ответьте, всегда ли оно ведет себя одинаково. Это главный час работы.
4. Попросите собрать скилл с явным правилом брать текст из бланка и останавливаться при нехватке данных.
5. Прогоните восемь случаев из списка выше, обязательно включая женский род, предпринимателя и неполные данные.
6. Опишите ошибки словами и пройдите второй круг. Обычно этого достаточно.
7. Соберите первый живой комплект и вычитайте его целиком.

Технически ничего писать руками не придется, код пишет агент. От вас требуется внимательность на третьем шаге и честность на пятом. Как поставить среду, в которой это делается, разобрано в гайде про Claude Code.

---

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

Может ли AI-агент составить договор?

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

Что такое скилл для AI-агента простыми словами?

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

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

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

Почему нельзя просто попросить агента заменить текст в документе?

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

Какие ошибки чаще всего вылезают при автоматической сборке?

Четыре. Женский род руководителя, когда в шапке остаются формы действующего и именуемый. Лишняя строка КПП у предпринимателя. Сумма прописью, не согласованная по роду и числу. И совпадающие номера, когда за день делается больше одного комплекта. Все четыре ловятся тестовыми прогонами.

Для каких еще документов подходит такой скилл?

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

Безопасно ли отдавать агенту реквизиты клиентов?

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

Нужно ли уметь программировать?

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