Агент

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

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

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

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

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

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

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

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

Если в чате появился ответ, который вы ещё не видели, рядом с названием появится точка акцентного цвета с подсказкой «Новый ответ». Она исчезнет, когда ответ окажется в видимой области открытого чата. Скрытая вкладка и просмотр более ранней части переписки не снимают точку. Отметка сохраняется на сервере и действует между вкладками и устройствами. Промежуточные действия агента и ещё печатающийся ответ не считаются новым ответом.

Выберите значение Агент в списке Режим ответа в нижней панели поля ввода. Список Режим ответа содержит значения Чат и Агент, а у ассистента Уника AI в пространствах, где администратор включил функцию «Режим «Авто» у Уники AI», — ещё и Авто.

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

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

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

Режим «Авто» у Уники AI

В режиме Авто платформа сама решает, кто ответит: короткие реплики, объяснения, переписывание и ответы по источникам идут в чат, а задачи, где нужно действовать — собрать файл, посчитать по таблице, сравнить несколько документов, — уходят агенту. Часть решений платформа принимает без обращения к модели: короткая реплика вроде приветствия или благодарности отвечается чатом, а явная просьба о файле (docx, pdf, xlsx, «выгрузи», «скачать»), табличное вложение и ссылка на документ холста уходят агенту. В остальных случаях решает служебная модель за один короткий вызов, и сообщение уходит агенту, только когда модель уверена в этом; при недостатке уверенности и при отсутствии ответа модели вовремя отвечает чат. Режим Авто доступен только у Уника AI, включается администратором на пространство и в бета-периоде предлагается по умолчанию.

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

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

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

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

Приложенный документ Word агент правит в самом файле. На просьбу исправить, дополнить или переоформить документ, который лежит в этом чате, агент берёт исходный DOCX, вносит изменения и возвращает тот же файл вложением, поэтому таблицы, колонтитулы, отступы и нумерация остаются на месте. Если нужен именно новый документ, а не правка приложенного, скажите об этом прямо — «собери новый отчёт», «подготовь протокол», «составь реестр по вложениям»: по такой формулировке агент соберёт новый файл, а приложенный документ использует как источник. Счётный вопрос по таблице агент считает инструментом: на запрос вида «сколько строк с суммой больше 500 000 и какова их общая сумма» он отбирает подходящие строки и возвращает по срезу количество, сумму, минимум, максимум и среднее, а числа читает в том виде, в каком они лежат в таблице, — разряды через пробел, десятичная запятая, знак процента и обозначение валюты сравнению не мешают.

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

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

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

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

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

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

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

Когда агент поручает части работы исполнителям, под его строкой появляется блок исполнителей: сколько работ готово из общего числа, сколько принято с замечаниями, сколько не удалось, и полоса прогресса. Для каждого работающего исполнителя видно, над чем он работает, что делает сейчас и сколько. Нажмите на исполнителя, чтобы увидеть его шаги. Готовые свёрнуты в строку «Готово 23», а те, у кого работа не удалась, показаны отдельно с причиной.

После завершения история автоматически сворачивается в строку Работал на протяжении 1 мин 12 с над ответом. Нажмите эту строку, чтобы раскрыть историю. Если во время работы вы открыли подробности действия, они останутся раскрытыми после завершения. При повторном открытии чата история свёрнута. Ошибка или остановка явно указаны в строке итога; финальный ответ и готовые файлы остаются видимыми независимо от раскрытия истории. При ошибке раскройте строку итога, чтобы увидеть причину, в том числе если агент не успел начать действия. Если причина не сохранена, это явно указано внутри истории.

Файлы, которые агент сдал итогом работы, приходят в чат карточками после его ответа. Если файлов несколько, первый сданный показан карточкой, а остальные — строкой «Ещё 2 файла» под ней: нажмите на строку, чтобы открыть остальные. Промежуточные файлы и скрипты отдельным списком не показываются; действия с ними остаются в истории работы.

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

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

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

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

Агент присылает таблицы XLSX, документы DOCX, файлы PDF, презентации PPTX, HTML-страницы и изображения графиков отдельными вложениями с кнопкой скачивания. HTML-файл размером до 1 МБ открывается в панели просмотра как интерактивная страница; больший файл можно скачать.

Если агент собрал документ или таблицу по шаблону, проверьте незаполненные поля вида {поле}, итоговые числа и полноту файла. Если результат требует правки, попросите агента исправить его в этом же чате и прислать новую версию.

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

Черновик документа, который агент подготовил или изменил, приходит в ленту карточкой документа перед его ответом. С карточки черновик копируют или скачивают в DOCX или PDF, а кнопка Документ открывает его на холсте справа от ленты: там вы дочитываете и правите текст. Ссылка на документ в ответе агента ведёт туда же: по ней открывается чат с этим документом на холсте. Если агент правит черновик после вашего согласования, приходит новая карточка того же документа. Изменения в базе знаний — новый документ, переименованный раздел, обновлённый текст — появляются в самой базе знаний, а в чате остаётся запись о выполненной операции.

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

Базы знаний в задачах агента

Агент читает базы вашего пространства, системные базы инсталляции и базы, которые вам открыли из других пространств. Чужие и системные базы он только читает и показывает с подписью пространства- владельца; ссылок на их разделы не даёт, вместо ссылки называет базу и документ. Открывать базы другим пространствам можно только в коробочной поставке (on-prem); порядок выдачи доступа описан в главе «Базы знаний».

Нужную базу можно назвать прямо в сообщении — введите @ и выберите её из списка; названные базы агент читает вместе с теми, что ему и так доступны. Полный порядок работы с меню описан в главе «Чаты».

Когда баз много, агент не перебирает их по одной: он спрашивает у платформы, какие базы подходят под вопрос по смыслу (у каждой базы есть портрет — описание содержимого, которое платформа строит сама), и ищет в них; поиск без указания базы сам сужается до подходящих. Если подходящих баз не нашлось или портреты ещё не построены, поиск идёт по всем доступным базам.

Если документ не находится, попросите агента проверить состояние индексации, ошибки импорта и доступ к базе знаний. Агент покажет причину, которую видит в настройках и журнале обработки; повторную индексацию он запустит по отдельной просьбе и после согласования.

Если ассистент привязан к конкретным базам знаний, агент работает только в них: системные базы, как и остальные базы пространства, в таком прогоне не участвуют. Администратор может отключить системные базы для всей инсталляции — тогда агент, как и ассистент Уника AI, работает только по базам пространства.

Как попросить агента создать действие

Опишите агенту действие словами: что оно делает, где должно появиться и с каким текстом работает. Агент подбирает поля действия по словарю платформы, проверяет их пробным прогоном и показывает карточку согласования с названием, местом появления и инструкцией для модели дословно. После кнопки Выполнить действие появляется в Настройки → Рабочее пространство → Действия ассистентов и работает так же, как действие, созданное в форме.

Действие под сообщением ассистента или по стенограмме агент подключает к ассистенту отдельной карточкой: подключение — отдельная операция с правом «Управление действиями ассистентов». Команде из меню поля ввода подключение не нужно — она видна во всех чатах пространства сразу после создания.

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

Если к сообщению приложен файл, агент делает пробный запуск инструкции на его тексте и показывает ответ модели до карточки. Пробный запуск списывает кредиты, как обычный запрос к модели. Правку существующего действия агент показывает в карточке как «сейчас» и «станет» и называет ассистентов, которым действие подключено. Удаление и архивирование действий агент не выполняет — эти операции остаются в интерфейсе.

Примеры просьб:

• «Сделай команду для поля ввода «Тезисы по файлу»: беру прикреплённый файл и получаю пять тезисов, каждый с новой строки».
• «Сделай действие «Ответить письмом» под ответами ассистента и подключи его к этому ассистенту».
• «В команде «Тезисы по файлу» сделай три тезиса вместо пяти, остальное не меняй».
• «Сделай агентскую команду «Протокол встречи»: по вложениям собираешь протокол с решениями и поручениями, закрепи навык «Протокол»».

Как попросить агента создать ассистента

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

Навыки, файл из вложения чата и действия агент подключает отдельными карточками: каждая операция подтверждается отдельно. Файл из чата становится файлом ассистента в роли материала для ответов или источника знаний. Правку существующего ассистента агент показывает в карточке как «сейчас» и «станет», а для баз знаний — что добавится и что будет отвязано. Если попросить пробный вопрос, агент задаёт его модели без баз знаний и файлов и показывает ответ до карточки; пробный вопрос списывает кредиты.

Агент не удаляет и не архивирует ассистентов, не правит системных ассистентов, а у ассистента из сборки в режиме Только использовать меняет только базы знаний — как форма.

Примеры просьб:

• «Создай ассистента «Кадровые регламенты»: отвечает по базе знаний «Регламенты», если ответа нет — говорит об этом».
• «Ассистенту «Поддержка» добавь этот файл как материал для ответов и подключи навык «Вычитка»».
• «Сделай ассистента «Протоколист» на сценарии универсального агента».

Как попросить агента пополнить базу знаний или библиотеку промптов

Файл из чата агент кладёт в базу знаний тем же конвейером приёма, что и загрузка кнопкой: приложите файл, назовите базу и при желании папку. Карточка согласования показывает базу, папку, имя файла и размер; после кнопки Выполнить файл принят, а разбор и индексация идут в фоне, поэтому документ появляется в базе не сразу. Страницу по адресу агент импортирует одну, без обхода сайта; служебные и внутренние адреса он отклоняет ещё до карточки, а страницу, которая уже есть в базе, второй раз не добавляет. Индексацию базы агент запускает по просьбе: карточка называет режим (только изменённые документы, а по прямой просьбе «переиндексируй целиком» — вся база), число документов к индексации и напоминает, что индексация расходует эмбеддинги. Сброс, отмену и паузу индексации агент не выполняет.

Промпт библиотеки агент сохраняет из текста просьбы дословно: личный — только для вас, общий промпт пространства — для всех участников, если у вас есть право управления промптами. Правку промпта карточка показывает как «сейчас» и «станет». Глобальную переменную пространства агент заводит несекретной и задаёт ей значение отдельной карточкой «сейчас → станет»; секретные переменные, например токены и пароли, агент не создаёт и не записывает — их заводят в настройках пространства.

Примеры просьб:

• «Положи этот файл в базу знаний «Регламенты», в папку «Отпуска»».
• «Добавь в базу «Регламенты» страницу https://example.com/».
• «Переиндексируй базу «Регламенты» целиком».
• «Сохрани как мой личный промпт «Ответ на претензию»: …».
• «Заведи переменную «Название компании» и поставь ей значение «Уника AI»».

Как попросить агента прочитать, проверить или создать сценарий

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

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

Черновик сценария агент создаёт из опубликованного шаблона: карточка согласования показывает название, шаблон, состав узлов и узлы внешнего периметра — запросы во внешние системы, вебхуки, ответы внешним системам. После кнопки Выполнить черновик появляется в списке Настройки пространства → Сценарии и открывается в редакторе по ссылке из ответа; агент сразу проверяет его компилятором и называет замечания, если они есть. Шаблон с узлом кода агент возьмёт только у участника с правом на правку кода сценариев.

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

Примеры просьб:

• «Какие сценарии есть в пространстве и что делает «Классификатор обращений»?».
• «Почему сценарий «Ответ по регламенту» не публикуется?».
• «Что за узел «Маршрутизатор» и какие у него поля?».
• «Создай сценарий «Сортировка обращений» из шаблона «Классификатор запросов»».
• «Собери сценарий: на входе обращение, ИИ определяет тему, три ветки по теме, в конце ответ в чат».

Подробнее о редакторе и путях создания сценария — в главе «Сценарии».

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

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

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

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

Решение принимаете вы — автор запроса, если у вас есть право на саму операцию. Агент работает в ваших правах, поэтому карточку создания базы знаний подтверждает участник с правом «Создание баз знаний» (kb:create), карточку нового навыка — участник с правом «Создание и редактирование навыков пространства» (skills:author), карточку нового действия — участник с правом «Создание действий» (actions:create), карточку подключения действия к ассистенту — участник с правом «Управление действиями ассистентов» (assistants:actions:manage), карточку нового ассистента — участник с правом «Создание ассистентов» (assistants:create), а карточки правки ассистента, его навыков и файлов — участник с правом «Редактирование ассистентов» (assistants:edit), карточки файла или страницы в базу знаний и запуска индексации — участник с уровнем «Редактирование» в базах знаний (kb:document:import, kb:index), карточку личного промпта — участник с уровнем «Просмотр» в промптах (prompts:view), общего промпта пространства — «Управление» (prompts:manage), карточку определения глобальной переменной — участник с уровнем «Схема и секреты» (global_variables:define), карточку её значения — «Изменение значений» (global_variables:write), карточку нового сценария из шаблона — участник с правом «Создание сценариев» (workflows:create), карточку записи графа в сценарий — участник с правом «Редактирование сценариев» (workflows:edit). Права на операции с базами знаний перечислены в главе «Базы знаний». Участник с ролью owner или manager подтверждает любую карточку, которую видит в чате.

Если права на операцию у вас нет, карточка показывает сообщение Недостаточно прав для согласования. и остаётся без кнопок. Карточку прогона, запущенного не из чата, например по вебхуку, подтверждает только участник с ролью owner или manager. Административные операции с учётными записями подтверждает только глобальный администратор платформы.

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

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

Потолки работы агента задаёт администратор инсталляции в разделе Администрирование → LLM и сценарии → Настройки агента, группа Сессии агента. Потолок ограничивает одну задачу: когда он исчерпан, агент останавливается и сдаёт сделанное — ответ и собранные файлы.

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

Только облачная поставка. Работа агента списывает кредиты рабочего пространства по ходу задачи; если кредиты закончились, агент останавливается и сдаёт сделанное.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Агентская команда в меню «*» неактивна

Рядом с командой написана причина:

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

Агент описал действие, ассистента, файл для базы или промпт словами, но ничего не создал

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

• у вашей роли есть право «Создание действий» (actions:create) или «Создание ассистентов» (assistants:create), для подключения действия к ассистенту — право «Управление действиями ассистентов» (assistants:actions:manage), для файла или страницы в базу знаний и индексации — уровень «Редактирование» в базах знаний и доступ на запись в саму базу, для промптов и переменных — уровни «Просмотр» или «Управление» в промптах и «Изменение значений» или «Схема и секреты» в глобальных переменных;
• чат открыт с Уника AI или с ассистентом на глобальном сценарии агента: копия сценария в пространстве новые операции не получает;
• в просьбе названо, что нужно именно действие или команда для поля ввода, а не разовая обработка текста.

Что дальше

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