Proanalytics.tech

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

12 мин чтения 8 разделов

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Проверьте себя

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

Вопросы

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

Нужно ли уметь программировать, чтобы собрать агента?

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

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

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

Что делать, если данных для агента нет в удобном виде?

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

Как убедить команду пользоваться агентом?

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

Когда агента стоит выключить?

Если правок больше, чем экономии времени, если ошибки не удаётся поймать проверками или если задача изменилась настолько, что старая рамка мешает. Отключить и пересобрать дешевле, чем поддерживать бесполезное.

Ещё по теме

Другие гайды

Как подготовиться к собеседованию аналитика: план по шагам и срокам Что делать, если не знаешь ответ на собеседовании С чего начать в аналитике: направления, порядок обучения и план первых недель Вопросы на собеседовании системного аналитика: блоки, примеры и логика ответа Вопросы на собеседовании бизнес-аналитика: блоки, примеры и логика ответов Вопросы на собеседовании продуктового аналитика: блоки, примеры и логика ответов Вопросы на собеседовании аналитика данных: блоки и задачи Собеседование джуна аналитика: чего ждут и как отвечать Собеседование на Мидл-аналитика: блоки вопросов, логика ответов и кейсы Собеседование на Сеньор аналитика: что проверяют и как отвечать SQL задачи на собеседовании: типы, логика решения и типичные ошибки Как посчитать A/B-тест: выборка, длительность и чтение результата Кейсы на собеседовании аналитика: как разбирать и отвечать по шагам Кейсы системного аналитика: 8 рабочих ситуаций с логикой решения Как читать чужой SQL запрос: пошаговый разбор Ошибки в отчётах: как найти расхождение и перестать терять доверие к цифрам Первая неделя работы аналитика: спокойный план действий Как подготовиться к тестовому заданию аналитика Метрики продукта: с чего начать Как вести документацию аналитика Собеседование без опыта: план на месяц ИИ и системный аналитик: что делать, чтобы не заменили MCP: что это и как настроить аналитику Требования к ИИ-агенту: спецификация, guardrails и метрики Языковые модели для аналитика: минимум понятий Аналитик данных с нуля: что учить по шагам Системный аналитик с нуля: что учить и в каком порядке Бизнес-аналитик с нуля: с чего начать и что учить