Как собрать своего агента аналитику: пошагово

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

Шаг 1. Выбрать задачу, которую не жалко сломать

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

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

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

• Частая, скучная, с понятным входом и выходом — берём.
• Дорогая ошибка без проверки — откладываем.
• Признак успеха записываем числами до начала работы.

Шаг 2. Собрать данные и инструменты

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

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

Проверьте каждый сервер до работы: список инструментов, параметры, поведение при ошибке. Если сервер умеет больше, чем нужно, это лишний риск.

• Данные: спецификации, глоссарий, выгрузки, задачи, вики.
• Подключение через MCP, режим только для чтения.
• Инвентаризация инструментов до первого запуска.

Шаг 3. Описать роль, цель и границы

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

Пример: «Ты помощник аналитика. Готовишь черновик требований по задаче: цель, сценарии, исключения, ссылки на источники. Не выдумывай метрики и не меняй данные. Если данных не хватает, задай вопрос и остановись».

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

• Четыре части инструкции: роль, цель, запреты, остановка.
• Отдельно проговорить запрет на выдуманные данные.
• Явное правило: при нехватке данных агент спрашивает.

Шаг 4. Добавить проверки и журнал

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

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

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

• Проверки: до действия, после ответа, перед необратимым шагом.
• Журнал: инструмент, параметры, результат, остановка.
• Лимиты по вызовам и времени на задачу.

Шаг 5. Прогнать на кейсах

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

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

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

• 20–30 кейсов с ожидаемым результатом.
• Разбор не по числу ошибок, а по их типам.
• Результаты прогонов сохраняем и сравниваем между версиями.

Шаг 6. Запустить в работу по-честному

Начните с режима подсказок: агент готовит черновик, человек проверяет и принимает решение. Так команда видит пользу и учится, а риск остаётся низким.

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

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

• Старт в режиме подсказок, решение за человеком.
• Через две недели — замер пользы и правок.
• Команда знает, где работает агент и кто отвечает за результат.

Где чаще всего ломается

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

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

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

Четвёртое: попытка заменить человека целиком. Агент хорошо делает черновик и плохо отвечает за решение; смешивать эти роли не стоит.

• Слишком широкая задача — нет критерия проверки.
• Избыточные права — рост цены ошибки.
• Нет набора кейсов — нет контроля регрессий.

Что считать результатом

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

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

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

• Результат — процесс и его измеримая польза.
• Следующая задача собирается по тому же шаблону.
• Инструменты и проверки переиспользуются.

Что сделать: короткий чеклист

• Выбрал первую задачу: частая, с понятным входом и низкой ценой ошибки.
• Записал признак успеха в числах до начала работы.
• Подключил данные через MCP в режиме только для чтения.
• Проверил список инструментов и права каждого сервера.
• Написал инструкцию: роль, цель, запреты, условие остановки.
• Добавил проверки до действия, после ответа и перед необратимым шагом.
• Включил журнал вызовов и лимиты по вызовам и времени.
• Собрал 20–30 кейсов и разобрал типы ошибок.
• Запустил в режиме подсказок и через две недели замерил пользу.

Где тренировать

Темы из гайда разобраны в тестах портала — каждый вопрос с объяснением ответа:

• Курс «ИИ для аналитика»: тесты по агентам и MCP
• Тема «Своя агентская система: сборка под задачи аналитика»
• MCP: что это и как настроить аналитику
• Требования к ИИ-агенту: спецификация, guardrails, метрики
• Подписка: доступ ко всем тестам и темам

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

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