Наконец, последняя глава. К этому моменту вы дошли до того, чтобы понимать структуру агента, создать первого, подключить инструменты, разделить на несколько, измерить оценкой и защитить ограждениями. Осталась одна тема — превратить это в «продакшн-систему, которая работает каждый день». В этой главе разберём выбор фреймворка, два пути сборки на Claude, а также ключевые моменты эксплуатации — деплой, мониторинг, затраты и надёжность. Проектирование защиты, изученное в предыдущей главе про ограждения и безопасность, здесь приносит плоды как эксплуатация.
Цель — «превратить прототип в продакшн-агента, стабильно работающего дальше»
Самому или на фреймворке
«Делать агента на фреймворке или писать цикл самому?» — вопрос, у которого спотыкается каждый в начале. Ответ прост: пока мало — изучайте устройство своими руками, а когда выросло — повышайте продуктивность с SDK или фреймворком. В главе 2 мы вручную собрали минимальную конфигурацию именно на этой стадии «сначала понять, делая самому». Если внутренности видны, вы и позже, пересев на фреймворк, будете эксплуатировать, держа в голове, что происходит. И наоборот — свалив всё на фреймворк, не зная устройства, вы застрянете и не сможете ничего сделать.
💡 Ориентир для решения. Когда писать самому цикл, вызовы инструментов и управление состоянием становится в тягость, — это сигнал ввести фреймворк. Наоборот, пока всё маленькое и на стадии экспериментов, тонкий самописный код быстрее и глубже прорабатывается. Вводите не «потому что удобно», а «потому что убирается дублирование».
Как выбирать фреймворк
Фреймворков много, но прежде чем гнаться за именами и свежими версиями, важно иметь мерило: «по какому критерию выбирать». Инструменты меняются, а эти ракурсы служат долго. Оценивайте кандидатов по следующим пяти.
Чем выше, тем меньше кода нужно, но тем хуже видно, что происходит внутри. Выбирать в балансе с обучением и отладкой.
Можно ли вставить свой цикл и управление. Чем изощрённее требования, тем важнее гибкая конструкция с путями отхода.
Толщина компонентов интеграции, документации, примеров и сообщества. Найдётся ли информация в трудный момент — на практике это важно.
Есть ли механизмы трасс, логов и оценки. Поддерживает ли «из коробки» ту «визуализацию», что изучали в главе 5.
Не слишком ли привязан к конкретной модели или платформе. Лёгкость перехода и удобство замкнутого решения — компромисс.
Если грубо упорядочить характерные примеры по категориям, картина проясняется. Универсальные оркестрационные (собирают обработку LLM из цепочек и графов — библиотеки в духе LangChain), мультиагентные (фреймворки с упором на разделение и кооперацию нескольких агентов) и официальные SDK от производителей (комплекты разработки, выпускаемые провайдером модели и оптимизированные под неё). Во многих случаях они не взаимоисключающи, а используются в сочетании.
📊 Выбирать по «ракурсам», а не по конкретным именам. Расстановка сил среди фреймворков меняется быстро, и прошлогодний фаворит не обязательно останется таким и в этом году. Именно поэтому надёжнее взять пять ракурсов выше за мерило и приложить их к своим требованиям. Конкретные имена по категориям и их применение сверьте с актуальным составом в сравнении фреймворков ИИ-агентов.
Два варианта сборки на Claude
Этот курс строился вокруг Claude. При выводе агента на Claude в продакшн есть в основном два пути. Оба — реальные варианты, а сущностное различие в том, «кто хостит цикл агента и песочницу».
Комплект, чтобы цикл, выполнение инструментов и управление состоянием агента гонять в вашей среде (серверы, контейнеры). Тонкий контроль и глубокая встройка в существующие системы.
Когда подходит: хотите плотно связать со своей средой выполнения, инструментами и данными.
Способ, при котором цикл и песочницу (изолированную среду выполнения) на стороне сервера хостит Anthropic. Снижается эксплуатационная нагрузка на среду выполнения, и работать можно в изолированной безопасной среде.
Когда подходит: хотите убавить хлопот со средой выполнения и быстро, безопасно стартовать.
Грубо говоря, понятнее всего взять за ось: хотите тонко контролировать сами — SDK, хотите передать хлопоты эксплуатации — managed. Оба на фундаменте возможностей Claude позволяют как есть задействовать изученные в предыдущих главах подключение инструментов, оценку и ограждения. Конкретная настройка и охват могут меняться, поэтому детали доверим разбору и официальной документации.
💡 Сначала концепция, детали — из первоисточника. «Крутить цикл самому (SDK)» или «пусть хостят (managed)» — держите в голове только это противопоставление, и достаточно. Порядок реализации — введение в Claude Agent SDK, а идею managed-способа — что такое managed-агенты Claude. Спецификация обновляется, поэтому в итоге безопаснее сверяться с официальной документацией как с первоисточником.
Ключевые моменты продакшн-эксплуатации
Различие прототипа и продакшна — в скачке от «работает разок» к «работает и дальше». Демо состоится, если несколько раз удачно прошло, а продакшн ежедневно подвергается массовому и разнообразному вводу. Усвоим ключевые моменты, важные здесь, в шести коробках.
Управлять ключами через переменные окружения, разделить настройки и код. Выкатывать в воспроизводимом виде (контейнеры и т. п.) и иметь возможность в любой момент откатиться.
Подключить наблюдаемость из главы 5 к продакшну. Постоянно следить за трассами шагов, долей успеха и задержками и рано замечать аномалии.
Визуализировать расход токенов, задать оповещения по лимиту. Убрать лишние перезапуски и слишком длинный контекст, а модели использовать по назначению.
Предполагая лимиты API и временные сбои, упорствовать с экспоненциальной задержкой (повтор с нарастающим интервалом). Избегать бесконечных ретраев, задавать предел.
Безопасно сохранять и восстанавливать промежуточное состояние диалога и работы. Конструкция, где можно продолжить с места после падения, поддерживает долгие задачи.
Обновления модели и SDK — сначала проверить поведение на оценочном наборе. Сравнением до и после не упустить тихое изменение качества.
⚠️ Затраты решаются «проектированием». Агент за одну задачу много раз вызывает модель, поэтому по устройству склонен к скачкам затрат. Этапы, где хватает дешёвой модели, отдавать дешёвой модели, а контекст передавать только в нужном объёме — такие кропотливые ухищрения работают. Конкретные приёмы снижения практично изложены в оптимизации затрат на ИИ-программирование и как есть применимы и к эксплуатации агентов.
Проектирование, которое не разваливается
Продакшн-агент однажды непременно встретит непредвиденный ввод, сбой внешнего API, капризы модели. Важно не «ни за что не дать сбоя», а собрать так, чтобы даже при сбое вред не разрастался и восстановление шло тихо. Доведём ограждения предыдущей главы до механизма эксплуатации.
Не открывать сразу всем, а с небольшого числа пользователей или части трафика. Нет проблем — расширять, плохо — тут же откатывать.
Когда инструмент или модель не отвечает, отступить на альтернативный путь или безопасный ответ по умолчанию. Выбирать частичную деградацию вместо полной остановки.
Перед неотменимыми и влиятельными операциями вставить проверку человеком (см. главу 6). Заранее определить границу, где безопасность важнее скорости.
Прошёл раз — не конец. Меняются и характер ввода, и модель. Регулярно прогонять оценочный набор и обнаруживать деградацию качества.
✅ Проектируйте «тихое самовосстановление». Хорошая продакшн-система не поднимает переполоха, даже когда случается неприятность. Поэтапным релизом держать влияние малым, откатом уходить в частичную деградацию, воротами одобрения предотвращать смертельный удар, переоценкой опережать деградацию. Только когда все четыре сцеплены, система «не разваливается».
Что учить дальше
Напоследок — немного о будущем. Экосистема агентов — фреймворки, SDK, модели, стандарты подключения — и дальше будет двигаться бешено быстро. Сегодняшнее оптимальное решение не обязательно останется таким и через год. Именно поэтому гнаться стоит не за модными именами инструментов, а за неизменными основами.
📊 Активом становятся именно основы. Четыре составляющие (голова, инструменты, память, цикл) из главы 1, оценка и наблюдаемость из главы 5, проектирование безопасности из главы 6 — это фундамент, годный при любой моде на фреймворки. Каждый раз, как выходит новый инструмент, вы этим мерилом быстро распознаёте, «что именно он абстрагирует». Инструменты сменяются, основы остаются. Наработанное до сих пор понимание — ваш главный актив.
Дальше — пусть маленькое, но реально выведите одно в продакшн. Запустить, измерить, починить — опыт прокрутки этого цикла в собственном проекте даст больше сил, чем любой учебник.
- Пока мало — учиться самому, выросло — повышать продуктивность фреймворком. Вводить не «потому что удобно», а «потому что убирается дублирование».
- Фреймворк выбирать по пяти ракурсам: абстракция, гибкость, экосистема, наблюдаемость, привязка к вендору. Мерило важнее конкретных имён.
- На Claude — либо Claude Agent SDK с самописным циклом, либо хостящиеся managed-агенты. Выбор — контроль или простота.
- Ключевое в продакшне — деплой, мониторинг, затраты, ретраи, управление состоянием, обновления. И поэтапный релиз, откат, ворота одобрения, переоценка — чтобы не развалилось.
- Экосистема движется быстро. Основы — четыре элемента, оценка, безопасность — и есть актив, работающий долго.
Все семь глав пройдены, поздравляем. Вы прошли весь путь целиком — спроектировать агента, создать, подключить, размножить, измерить, защитить и эксплуатировать. Дальше — ваш черёд браться за дело в собственном продукте.
Для тех, кто хочет, отступив от роли создателя, отточить и взгляд на применение ИИ в работе.
К курсу «ИИ на работе» →Для тех, кто хочет освоить инструменты вроде Claude Code для программирования.
К курсу «ИИ-программирование» →Для тех, кто хочет вырастить созданного агента в продукт индивидуальной разработки и выпустить в мир.
К курсу «Индивидуальная разработка с ИИ» →