Руководство5 мин чтения
Запуск AI-агента в продакшене: как проверить, что он работает
Агент на DADA Cloud сохраняется асинхронно: статус Committed значит, что описание лежит в git, и это ещё не ответ агента. Перед тем как пустить к нему клиентов, проверьте состояние, версию промпта и перезапуски, а затем задайте пробный вопрос.
$ claude› Проверь агента shop-support, прежде чем открывать его клиентам✓ validateAgent: имя, промпт и инструменты в порядке✓ saveAgent: операция принята, статус Committed✓ getAgentState: ready true, перезапусков 0✓ sendAgentMessage: «Где мой заказ?» -> агент ответилСохранённый агент ещё не работает
Агент попадает в git, а запускает его Argo. Между этими двумя шагами проходит время, и точный срок зависит от очереди выкатки. Поэтому ответ на сохранение говорит только о записи.
Проверка занимает четыре вызова, а общая картина описана в руководстве по агентам. Сначала validateAgent ловит плохое имя, пустой промпт и несуществующий инструмент, пока они не превратились в сбой синхронизации через несколько минут. Затем saveAgent возвращает операцию, а getOperation ждёт статуса Committed. После него getAgentState показывает, что происходит на самом деле.
Что показывает getAgentState
Ответ собран из трёх мест, и каждое знает свою часть. Описание агента говорит, принято ли оно. Поды говорят, отвечает ли он. Конфигурация промпта говорит, какой текст загрузил работающий процесс.
| Поле | Что оно говорит |
|---|---|
accepted | платформа приняла описание агента |
ready | агент готов отвечать |
pods[].restarts | сколько раз перезапускался контейнер этой реплики |
prompt_version | какой промпт загрузил работающий процесс |
Последнее поле нужно, когда вы правите промпт. Работающий агент отвечает по тому тексту, с которым запустился, пока его контейнер не пересоздадут. Версия в git и версия, которая говорит с пользователями, расходятся на пару минут, а при застрявшей выкатке надолго.
Число перезапусков у реплики с ready: true ещё не повод для тревоги. Растущее число за час значит, что агент падает и поднимается заново, и клиенты видят это как обрывы ответов.
Пробный вопрос до клиентов
sendAgentMessage отправляет агенту текст и возвращает ответ в том же вызове, ждать можно до 90 секунд. Каждый вызов начинается с чистого листа: памяти между ними нет, поэтому проверять диалог из нескольких реплик им нельзя.
Это удобный цикл правки. Вы отправляете вопрос, читаете ответ, меняете промпт через saveAgent и спрашиваете снова. Сохранение заменяет описание целиком, так что присылайте промпт целиком.
$ ddc agent smoke$ ddc agent eval$ ddc agent invoke --text "Где мой заказ?"$ ddc agent logs -f# ddc agent up поднимает агента локально, для этого нужен DockerДля проверки без облака есть ddc agent up: агент стартует в Docker на вашей машине, а smoke и eval прогоняют заготовленные вопросы.
Что в расходах контролирует платформа
Агент ходит в модель через OpenAI-совместимый шлюз, и ключ проекта умеет одно: ограничивать список моделей. В списке до 100 моделей, запрос за его пределами получает 403 model_not_allowed, а изменение вступает в силу в течение минуты. Дорогую модель можно закрыть для агента, которому она ни к чему.
Если вы подключили ключи своих провайдеров, запрос с таким ключом обслуживает только провайдер, и запасного пути через общий пул нет. У песочницы Box есть собственный потолок расходов, по умолчанию 500 ₽: при его достижении бокс приостанавливается и остаётся на месте. В проверенном коде потолка расходов у агента на платформе нет, поэтому следите за расходом у провайдера.
Как вернуться к прошлой версии
Агент описан в репозитории, поэтому откат делают его же средствами. Вы возвращаете прежний промпт в agents/shop-support/core.md и снова запускаете ddc agent deploy --project shop --env prod. Дальше работают те же проверки: Committed, затем getAgentState, затем пробный вопрос.
Если попытка сорвалась совсем, deleteAgent убирает её. Инструмент помечен разрушающим, как и setAgentEngine, и вызывать его стоит осознанно.
Телеграм-бота к агенту подключают отдельно: POST /api/v1/agents/{agentName}/telegram с токеном бота. Через MCP это сделать нельзя, и до подключения проверка выше остаётся единственной.
Частые вопросы
Сколько ждать после сохранения агента?
Фиксированного срока в нашей проверке не нашлось: агент запускает Argo уже после записи в git. Опрашивайте getAgentState и смотрите на ready и prompt_version. Если и через пару минут всё по-прежнему, начните с validateAgent и логов агента.
Почему агент отвечает по старому промпту?
Работающий процесс держит тот промпт, с которым запустился, пока контейнер не пересоздан. Сравните prompt_version с тем, что вы сохранили. Расхождение в несколько минут нормально, а долгое значит, что выкатка застряла.
Можно ли задать агенту предел расходов?
Для агента на платформе предела расходов в коде мы не нашли. Ключ проекта ограничивает список моделей, до 100 штук, и это основной рычаг. У Box потолок есть, по умолчанию 500 ₽.
Что делать, если агент перезапускается каждые несколько минут?
Откройте поле restarts у реплики и логи через ddc agent logs -f. Частые перезапуски обычно оставляют след в логах. Если причина в новом промпте, верните предыдущую версию и разверните её.
- Руководство
- 2026
Автор
Команда DADA Cloud