ИИ-агент за вечер: из чего он состоит

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

Из чего состоит агент

Четыре части. Если хотя бы одной нет, конструкция разваливается — и обычно именно на ней экономят.

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

Часть 1. Материалы: что положить в папку

Материалы — это то, что отличает рабочего агента от игрушки. Соберите четыре вида:

• Стандарты команды. Как у вас принято описывать требования, какие разделы обязательны, что считается антипаттерном.
• Примеры хороших документов. Два-три требования или ТЗ, за которые вам не стыдно. Агент ориентируется на образец лучше, чем на инструкцию.
• Шаблоны. Пустые формы, которые нужно заполнять: структура требований, чек-лист приёмки, формат вопросов к заказчику.
• Входящие постановки. Отдельная папка, куда падает текущая задача: переписка, заметки со встреч, старое ТЗ.

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

Часть 2. Правила: файл на 15 строк

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

Ты — помощник аналитика.

Что делаешь:
— читаешь материалы из папки inbox/
— собираешь структуру: цель, роли, сценарии, ограничения
— ищешь противоречия между документами

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

Формат ответа:
1) что понял
2) что в материалах противоречит друг другу
3) чего не хватает — список вопросов

Источник:
на каждое утверждение — файл и абзац.
данных нет — так и пиши.

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

Часть 3. Инструменты: чем меньше, тем лучше

Агенту аналитика на старте хватает трёх доступов:

• Чтение файлов — папка с материалами и базой знаний.
• Поиск — по тем же файлам, чтобы не читать всё целиком.
• Запись результата — отдельная папка outbox, чтобы черновики не смешивались с источниками.

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

Часть 4. Ворота проверки

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

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

Три задачи, чтобы проверить сборку

Не демо, а вчерашняя работа. Прогоните агента на трёх задачах — они проверяют разные части конструкции:

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

Если на третьей задаче вы ловите себя на «не знаю, откуда это» — ворота не работают, и добавлять инструменты бессмысленно.

Когда агент не нужен

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

Собранный за вечер агент — это зафиксированный процесс с материалами, правилами и воротами, а не «нейросеть, которая всё делает». Ценность даёт не модель, а то, насколько честно вы описали процесс до того, как её подключили.

Как этот агент встаёт в общий маршрут команды — в статье «ИИ в аналитике и UXUI: пайплайн от требований до прототипа». А готовые формулировки, которые агент использует внутри, — в «Требования и ТЗ с ИИ: шесть промптов».