Агент

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

Что вам понадобится

• доступ к чату рабочего пространства и право на отправку сообщений;
• функция «Режим сценария в Ассистентах», включённая администратором для вашего пространства;
• файлы, база знаний или данные, с которыми предстоит работать;
• роль владельца или администратора пространства, если задача включает операции с записью данных.

Чем агент отличается от обычного чата и от сценария

Обычный чат отвечает текстом: языковая модель (LLM) получает ваш вопрос вместе с найденными фрагментами и возвращает одно сообщение. Агент получает ту же задачу, но сам решает, какие шаги сделать и какие инструменты вызвать, и показывает этот путь в чате. Сценарий проходит фиксированный маршрут узлов, который заранее собрал автор сценария.

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

Как включить режим «Агент»

Выберите значение Агент в списке Режим ответа в нижней панели поля ввода. Список Режим ответа содержит два значения: Чат и Агент.

1. Откройте чат с ассистентом.
2. Нажмите список Режим ответа.
3. Выберите Агент.
4. Опишите задачу в поле ввода и отправьте сообщение.

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

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

Списка Режим ответа может не быть. Доступность режима задаёт функция «Режим сценария в Ассистентах» в разделе Администрирование → Доступ → Функции: пространству нужно значение «Стандартный режим и сценарий» и хотя бы один разрешённый источник сценариев. Пока пространству разрешён «Только стандартный режим», списка Режим ответа в поле ввода нет.

Что агент умеет

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

Отдельная возможность агента — выполнение кода в изолированной песочнице. Агент пишет короткую программу, считает по ней итоги, проверяет результат и присылает готовый файл. Доступа в сеть у песочницы нет, а в ленте шагов вместо кода агент показывает подпись вроде «Считаю итоги по таблице».

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

Административные операции — управление учётными записями и ролями — выполняет отдельный ассистент Admin Console, доступный только глобальному администратору платформы.

Как читать ход работы агента

Под вашим сообщением появляется карточка прогона: название, текущий статус, счётчик пройденных шагов вида «7 из 10» и кнопка Остановить. Сверните карточку прогона, если она мешает читать ленту сообщений. Статус прогона показывает стадию работы: В очереди, Выполняется, Ждёт согласования, Ждёт ваших данных, Готово, Ошибка, Прерван. При ошибке карточка прогона показывает код ошибки.

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

Внутри текущего шага платформа показывает строки живой активности: размышление модели с таймером («Думаю… · 8 с»), обращения к базам знаний, вызовы инструментов. Нажмите на любой шаг — раскроется панель результата с вкладками Кратко, Таблица и JSON.

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

Если задача сформулирована неоднозначно, агент завершает прогон уточняющим вопросом. Вопрос приходит обычным сообщением, поле ввода при этом разблокируется. Ответьте на вопрос — и агент продолжит работу следующим прогоном, уже с вашим уточнением.

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

Где появляются готовые файлы

Файл, который собрал агент, приходит отдельным сообщением-вложением с кнопкой скачивания — никаких дополнительных действий для этого не требуется. Так приходят таблицы XLSX, документы DOCX, файлы PDF и изображения графиков.

Кроме вложений у агента есть ещё два места для результата.

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

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

Как подтвердить операцию с записью данных

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

Нажмите Выполнить, чтобы агент продолжил работу и применил изменение, или Отмена, чтобы агент получил отказ и пошёл дальше по своему плану. Пока решения нет, карточка согласования держит статус Ожидает согласования, а прогон стоит на паузе. После решения статус меняется на Подтверждено или Отклонено; у необработанной карточки со временем появляется статус Истекло, а при остановке прогона — Отменено.

Решение принимает участник с ролью владельца или администратора рабочего пространства. Остальным участникам карточка показывает сообщение Недостаточно прав для согласования. — попросите подтвердить операцию того, у кого такая роль есть. Административные операции с учётными записями подтверждает только глобальный администратор платформы.

Важно. Подтверждение одноразовое и действует на одну операцию: следующая операция с записью данных потребует нового решения.

Какие ограничения действуют в бете

Агент ограничен по числу шагов, числу вызовов инструментов и времени работы. Ограничения действуют на всю инсталляцию платформы, а меняет их администратор в разделе Администрирование → LLM и сценарии → Настройки агента, секция «Параметры агента».

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

Агент не выдумывает данные: если источника для ответа нет или инструмент недоступен, он сообщает об этом вместо правдоподобного текста. Такой ответ — рабочее поведение, а не сбой.

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

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

Агент долго думает

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

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

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

Агент не увидел файл

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

• файл дозагрузился до отправки сообщения, а не остался в состоянии загрузки;
• файл приложен в этом чате, а не в соседнем;
• формат файла поддерживается платформой — см. Файлы, вложения и импорты;
• в запросе назван нужный файл, если вложений в чате много.

Агент не применил навык

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

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

В поле ввода нет переключателя «Чат/Агент»

Режим закрыт настройками пространства или системный сценарий агента не установлен в инсталляции. Проверьте:

• у пространства включена функция «Режим сценария в Ассистентах» со значением «Стандартный режим и сценарий»;
• в функции «Режим сценария в Ассистентах» разрешён хотя бы один источник сценариев;
• ассистент открыт в рабочем пространстве, для которого функция включена, а не в соседнем.

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

Что дальше

• Чаты — поле ввода, ответы, источники и карточки прогона.
• Навыки и конструктор навыков — научить агента повторяемому способу решения.
• Файлы, вложения и импорты — форматы, лимиты и способы передать агенту документы.
• Базы знаний — подготовить источники, по которым агент ищет ответы.
• Ассистенты — настроить ассистента, в чате которого работает агент.