Агент
Агент Уники AI выполняет задачи в чате в режиме агента и в шагах агента сценариев, включая системные сценарии и задачи по расписанию. Каждую задачу агент ведёт сессией — единицей работы над одним запросом, которая переживает перезапуск сервиса и паузу модели и продолжает с того же шага. Сессии обслуживает сервис агента — тот же, что выполняет шаги сценариев: без него агент недоступен. Администратор задаёт потолки работы агента в группе Сессии агента раздела Настройки агента.
Что вам понадобится
- глобальная роль
admin; - сервис агента, подключённый к платформе, — его устанавливает и подключает команда эксплуатации;
- основная модель агента в разделе Настройки агента.
Как подключён сервис агента
Сервис агента подключает команда эксплуатации при установке платформы. В интерфейсе адрес сервиса не задаётся и не показывается. Потолки работы агента настраиваются в Администрирование → LLM и сценарии → Настройки агента, группа Сессии агента.
В чате работа агента видна лентой хода: что агент делает сейчас, план со счётчиком пунктов и шаги.
Какие модели использует агент
Агент работает основной моделью из поля Основная модель агента. Если шаг сценария задаёт свою модель, агент работает ею.
Запасные модели задаёт список Запасные модели (каскад) в том же разделе. Если основная модель не отвечает три попытки подряд, агент переходит на следующую модель из списка и продолжает задачу с того же шага. Модели вне списка агент не использует.
Как агент изменяет данные платформы
Агент пользуется теми же возможностями, что открыты шагу агента в сценарии: операциями платформы, действиями рабочего пространства, инструментами MCP и операциями подключённых сервисов. Права — пользователя, который отправил запрос: чего нет у пользователя, недоступно и агенту.
Чтение агент выполняет сам. При записи в платформу в чате обычно появляется карточка с описанием операции, и пользователь нажимает Выполнить или Отмена. Пока решения нет, сессия ждёт. После Отмена агент операцию не повторяет. Правку неопубликованного черновика сценария, который агент создал в этом чате и к которому не привязаны ассистенты, он выполняет без новой карточки, если не меняет внешний периметр, код и права узла агента. У задачи по расписанию режим подтверждений задаётся отдельно: Подтверждать, Автосоздание или Без подтверждений. Права исполнителя действуют в каждом режиме.
Помощники агента, которым он поручает части задачи, только читают. Изменения выполняет сам агент.
Как агент выполняет задачи администратора
Глобальный администратор платформы поручает агенту администрирование в любом чате в режиме Агент, в том числе в Admin Console. Агент смотрит статистику использования платформы, находит пользователей, пространства и роли, заводит пользователей, меняет профиль, адрес электронной почты и глобальную роль, активирует и деактивирует учётные записи, сбрасывает пароль. Другим пользователям эти операции недоступны.
Изменения администрирования агент выполняет только после подтверждения карточкой в чате. Подтвердить карточку может только глобальный администратор.
В задаче по расписанию агент администратора только читает статистику, пользователей, пространства и роли. Создание, изменение и удаление учётных записей в автоматическом запуске не выполняются ни в одном режиме подтверждений: агент перечисляет, что нужно изменить, а изменение делает человек в чате. Если администратор сам продолжит чат запуска сообщением, агент снова работает с полными полномочиями и карточками.
Полномочия администратора в задаче по расписанию действуют, только если последнюю версию задачи сохранил сам исполнитель. Если задачу изменил другой участник пространства, операции администрирования в её запусках недоступны, пока исполнитель не сохранит задачу снова.
Статистика использования считает сутки по UTC.
Какие потолки задают работу агента
Потолки защищают инсталляцию от перегрузки и держат длинную задачу в рамках. Поле без значения работает по умолчанию — в нём видна подсказка Авто с этим значением.
| Параметр | Что ограничивает | По умолчанию | Когда менять |
|---|---|---|---|
| Активных сессий на установку | Сколько сессий идёт одновременно; остальные ждут в очереди | 200 | Добавили реплики сервиса агента |
| Активных сессий на пространство | Долю одного рабочего пространства | 20 | Одно пространство занимает очередь |
| Одновременных вызовов модели | Сколько обращений к модели идёт разом | 16 | По ёмкости GPU |
| Потолок токенов на сессию | Расход одной сессии | 30 млн | Длинные задачи не укладываются |
| Потолок длительности сессии, ч | Время одной сессии, вместе с ожиданием модели | 8 | Задачи идут дольше |
| Потолок ожидания модели, мин | Сколько сессия ждёт недоступную модель | 60 | Модель часто уходит на обслуживание |
| Потолок окна модели, токенов | Сколько текста агент держит в запросе к модели | 128 000 | Модель теряет начало разговора |
| Исполнителей одновременно | Сколько исполнителей одной сессии работают разом | 3 | Задача из многих однотипных пунктов идёт долго |
| Вызовов модели на поручение | Сколько раз один исполнитель обращается к модели | 20 | Исполнители не успевают доделать поручение |
| Простой песочницы до остановки, мин | Когда гасить среду запуска кода | 5 | Код запускают редко и долго |
| Процессоры песочницы | Ядер на одну среду запуска кода | 2 | Скрипты считают долго |
| Память песочницы, ГиБ | Память одной среды запуска кода | 2 | Скрипты разбирают большие файлы |
| Хранение данных сессии, дней | Срок хранения данных после конца сессии | 30 | Политика хранения инсталляции |
Исполнитель — помощник агента, которому агент поручает часть задачи, например один пункт проверки. Каждый исполнитель занимает место в Одновременных вызовов модели, поэтому больше исполнителей ускоряет задачу, но оставляет меньше места обычным чатам.
Песочница — изолированная среда без доступа к сети, где агент запускает свой код. Процессоры и память песочницы применяются при развёртывании в Kubernetes; при развёртывании в Docker их задаёт контролёр песочниц.
Как списываются кредиты за работу агента
Платформа списывает кредиты за работу агента по ходу задачи, а не только в конце: каждые 5 минут — за израсходованное с прошлого списания, по каждой модели отдельно, и остаток — когда сессия завершается. Длинная задача видна в балансе рабочего пространства уже во время работы.
Только облачная поставка. Если кредиты пространства закончились, агент останавливается и сдаёт сделанное.
Что происходит при сбоях и остановке
Сессия агента не теряет сделанное: после каждого шага сервис сохраняет точку восстановления.
| Ситуация | Что делает платформа |
|---|---|
| Модель недоступна | Сессия ждёт модель до Потолок ожидания модели, мин, при заданных запасных моделях переходит на следующую; дольше — завершается с ошибкой |
| Перезапустился или упал экземпляр сервиса агента | Сессию продолжает другой экземпляр с того же шага, обычно меньше чем через минуту |
| Сервис сессий недоступен при старте задачи | Задача завершается ошибкой «Агент сейчас недоступен», в журнале запусков — код AGENT_SESSION_SERVICE_UNAVAILABLE |
| Исчерпан потолок токенов или длительности | Сессия останавливается и сдаёт сделанное |
| Пользователь нажал Остановить в ленте хода | Сессия останавливается после текущего шага, израсходованные токены списываются |
| Чат удалён во время работы | Сессия останавливается, её данные удаляются сразу, израсходованные токены списываются |
Частые вопросы
Агент отвечает «Агент сейчас недоступен»
Платформа не может обратиться к сервису агента. Проверьте:
- в Центре активности у запуска агента указан код
AGENT_SESSION_SERVICE_UNAVAILABLE, а не другая причина; - команда эксплуатации подтверждает, что сервис агента запущен, готов принимать запросы и подключён к платформе.
Агент долго не начинает работу
Сессия ждёт в очереди: заняты все места по Активных сессий на установку или Активных сессий на пространство, либо все слоты Одновременных вызовов модели. Проверьте нагрузку и, если нужно, поднимите потолок вместе с числом экземпляров сервиса агента.
Агент остановился, не доделав задачу
Сессия упёрлась в потолок, пользователь остановил работу или в облачной поставке закончились кредиты. Причину остановки показывает карточка запуска агента в Центре активности.
Шаг сценария ждёт агента не дольше двух значений Потолка длительности сессии. Если время вышло, а агент ещё работает, платформа останавливает его: агент сдаёт сделанное, и шаг завершается частичным результатом с предупреждением. Если сдавать нечего, шаг завершается ошибкой.
Что дальше
- Первый запуск платформы — остальные параметры раздела Настройки агента.
- Центр активности — разбор запусков агента и причин остановки.
- Тарифы, кредиты и биллинг — как пополняется баланс рабочего пространства.
- Задачи по расписанию — режимы запуска агента и подтверждения изменений.