Как собрать навык AI-агента из повторяемой задачи

Нарисованная девушка читает инструкцию, коллега работает у доски

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

Чем разовая задача отличается от повторяемой

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

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

Именно здесь появляется понятие навыка.

Что такое навык агента простыми словами

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

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

Вход. Что именно агент получает: таблица в определённой структуре, письмо, список позиций. Без описания входа агент начинает угадывать.

Шаги. Последовательность действий. Не «обработай данные», а «сначала проверь колонку C на пустые ячейки, затем сравни итог с контрольной суммой в строке 47».

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

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

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

Если пока трудно описать задачу и нужный контекст, начните с разбора промптов от AI Masters. AI Masters - образовательный проект Сергея Шимы, сооснователя Majento. В статье показано, как задавать роль, ограничения и формат ответа. Затем запишите проверенные условия в инструкцию для навыка.

Как собрать навык: сначала один реальный прогон

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

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

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

Устройство навыка на примере отчёта

После прогона собираете короткий документ. Важна точность, а не объём.

Начало: что подаётся на вход, в каком формате, откуда берётся. Для учебного примера с отчётом это звучит примерно так: «Таблица от каждого подразделения, формат xlsx, столбцы от A до F, строка 1 - заголовки. Если структура отличается - остановиться и запросить уточнение».

Дальше - шаги по порядку, с конкретными ссылками на ячейки или колонки там, где это важно. Не «проверь данные», а «сравни сумму F2:F46 с контрольной ячейкой F47; при расхождении покажи предупреждение».

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

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

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

Испытание: коллега запускает навык без подсказок

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

Это не формальность. Именно в таком прогоне вылезают пробелы, которые автор не видит: он знает контекст и автоматически заполняет то, что не написал. Коллега этого контекста не имеет.

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

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

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

Когда навык живёт, а когда устаревает

Навык устаревает вместе с процессом. Поменялся шаблон - нужно обновить ссылку и дату. Изменились правила округления - правила в инструкции обновляются. Появилось новое подразделение с другой структурой таблицы - добавляется обработка этого случая.

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

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

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

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

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

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

Описывать развилки явно. «Если в таблице нет колонки D - запросить уточнение у автора». «Если сумма расходится больше чем на X - остановиться и показать предупреждение». Разнообразие входных данных нормально; главное, чтобы инструкция покрывала известные варианты и честно останавливалась на неизвестных.

Как часто нужно обновлять навык?

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

Можно ли один навык использовать для разных агентов?

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

Если хотите разобрать свой процесс и понять, стоит ли его упаковывать в навык - напишите в Telegram или на hello@majento.ai.

Источник

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

Открыть как Markdown