В этой статье я дал вам один инструмент (отвертку), а в телеграм канале лежит много пользы, инструментов и видео.

Перейти в канал
Практика работы с ИИ-агентами

Почему агентная система часто выглядит умной, а работает криво

Обычно проблема не в “слабом ИИ”, а в бардаке в логике. Агент не запускается, оркестратор делает всё сам, поиск подменяется фантазией, а система ещё и объясняет этот бред уверенным тоном.

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

  • Главный агент поставлен не в ту роль и не может вызывать остальных.
  • Агенты вообще не загрузились, но система делает вид, что всё работает.
  • Оркестратор не маршрутизирует задачу, а начинает сам выдумывать ответ.
  • Поиск не происходит: вместо него идёт генерация “из головы”.
  • В проекте копится мусор: старые версии, битые шапки, скрытые символы, лишние файлы.

Что реально помогает

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

Короткий алгоритм

Шаг 1

Разделите роли

Не делайте “универсального гения”. Один агент рулит маршрутом, остальные делают узкие куски работы.

Шаг 2

Запретите самодеятельность

Если нужен поиск, должен быть реальный поиск. Если нужен отдельный агент, должен быть реальный вызов.

Шаг 3

Чистите систему

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

Чеклист перед запуском

Есть один главный оркестратор, а не толпа равных агентов.
Каждому агенту задана одна понятная функция.
Оркестратор сначала разбирает задачу, а не сразу сочиняет ответ.
Для каждой операции видно: кто вызван и что именно вернул.
Система не отвечает “по памяти”, если нужен повторный запрос к агенту.
Файлы проекта чистые: без мусорных символов, дублей и битых шапок.
Главная мысль: самый опасный агент — не тот, который врёт нагло, а тот, который врёт виновато, красиво извиняется и потом снова делает ту же самую херню.
Скрины из разговора
История наших отношений

1. Будущее уже здесь: ИИ-агенты забирают работу быстрее, чем вы думаете.

2. Ваш новый сотрудник — не человек: как ИИ-агенты меняют рынок прямо сейчас.

Такие заголовки доносятся из каждого утюга. И, конечно же, возникает вопрос: где в этом всём мой отдел, где я и сотни агентов.

Чтобы понять, кто такие агенты, я пошёл в терминал Gemini CLI. Оказалось, чтобы создать там агента, нужно сказать: «создай агента и множество субагентов».

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

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

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

Второй агент генерил бред-ключи.

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

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

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

Дальше стало ещё лучше. В какой-то момент агент сам признался, что нарушил собственный порядок работы. Не сделал цепочку «прочитал инструкцию — выполнил поиск — вытащил результаты», а местами просто использовал общие знания вместо нормальной работы по поиску. То есть вся магия агентов в нужный момент схлопнулась в старую добрую подмену процедуры фантазией. Не сходил в поиск, не вытащил данные, а просто начал импровизировать из памяти модели.

Параллельно выяснилось, что и логика поиска у этих умников была на уровне кружка для очень уставших. Я им объяснял: сначала надо искать не паблики, а сущности. Сначала понять, какие вообще есть школы, курсы, направления, статьи, подборки, кто по этой теме существует. А уже потом, когда есть названия, идти во «ВКонтакте» и искать паблики по этим названиям и ключевым словам. Но агент делал то, что делает плохая автоматизация: брал тупой шаблон, искал только по сайту «ВКонтакте», получал ноль результатов и продолжал делать вид, что работает. То есть проблема была не только в модели, а ещё и в тупой логике поиска. Агент искал не там и не так.

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

Потом пошёл советоваться к Gemini Pro с вопросом, как всё исправить. В чате Gemini был очень добр ко мне, утешал. Говорил: не мучайся, набери в терминале какую-нибудь очень умную команду. Я писал в терминале, смирялся, но на выходе получалась какая-то жесть. Я уставал и просил Gemini написать промпт для Claude Code, чтобы тот уже поставил задачу и исправил промпты для агентов. Gemini был в роли друга-советчика и по сути говорил: не пиши ему, сам делай, он не сможет. В какой-то момент я понял, что советов и утешений у меня уже достаточно.

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

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

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

Так что мораль у меня простая. Claude Code я нанял на роль директора над кодами Gemini CLI и Codex. Потому что когда один агент утешает, второй философствует, третий выдумывает паблики, четвёртый делает вид, что запускал поиск, а пятый вообще не загрузился из-за недоверенной папки, нужен не ещё один агент. Нужен надсмотрщик, который полезет в файлы и скажет: вот здесь насрано, вот это не подключилось, вот это врёт, вот это чиним.

[/result]

Made on
Tilda