Действия ассистентов

Действие — это кнопка в чате, которая прогоняет готовый промпт по конкретному тексту: по расшифровке аудиофайла или по ответу ассистента. Библиотека действий рабочего пространства находится в разделе Настройки → Рабочее пространство → Действия ассистентов (/settings/preferences/actions); там же вы создаёте и редактируете действия. Само по себе действие в чате не появляется: его нужно включить у конкретного ассистента на вкладке Подключенные действия. Действие обрабатывает один текст за один запуск и не продолжает переписку — для многошаговой работы с инструментами используйте агента.

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

право actions:view для входа в раздел и право actions:create для создания действия;
право assistants:actions:manage, чтобы подключить готовое действие к ассистенту;
сохранённый ассистент рабочего пространства: у системных ассистентов действия не настраиваются;
активный провайдер языковой модели (LLM), если действие получает собственную модель;
заведённые глобальные переменные, если вы планируете подставлять их в промпт действия.

Чем действие отличается от навыка и стартовой подсказки

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

Сущность	Кто запускает	Где настраивается
Действие	вы, кнопкой в чате	Настройки → Рабочее пространство → Действия ассистентов
Навык	агент, когда операция подходит по релевантности	Настройки → Рабочее пространство → Навыки
Стартовая подсказка	вы, отправляя готовый текст первым сообщением	вкладка Стартовые подсказки в настройках ассистента

Как открыть библиотеку действий

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

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

Роль	Просмотр и запуск	Создание и правка	Архивирование
`owner`	да	да	да
`manager`	да	да	да
`member`	да	да	да
`viewer`	да	нет	нет

Как создать действие

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

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

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

Редактор нового действия: шаги «Общая информация», «С чем работает» и «Как выполняется» с полем «Промпт» — **Редактор действия: общая информация, объект работы и промпт**. Шаги редактора идут сверху вниз и нумеруются. Кнопки сохранения появляются внизу, как только в форме есть изменения.

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

Какой тип действия выбрать и куда попадёт результат

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

Тип действия	Что делает	Что заполнить дополнительно
Промпт	прогоняет входной текст через языковую модель	только поле Промпт
Инструмент	вызывает серверный инструмент платформы	Инструмент (toolName) со значением `create_document`, `rename_document` или `format_document` и Конфигурация инструмента (JSON-объект)
Гибрид	сочетает промпт и вызов инструмента	промпт, инструмент и его конфигурацию

Шаг Результат задаёт, куда попадёт ответ. Вариант Документ на холсте открывает результат отдельной вкладкой холста, вариант Сообщение ассистента добавляет ответ новым сообщением в чат. Колонку Размещение в библиотеке платформа заполняет сама: Холст для документа и Сообщение для ответа в чате.

Шаг Модель и инструкция управляет тем, чья модель считает результат. Режим Наследовать от ассистента берёт модель и инструкцию того ассистента, из чьего чата запущено действие; переключатель Наследовать инструкцию отключает подстановку инструкции ассистента. Режим Управляется действием закрепляет за действием собственную модель и открывает блок Расширенные параметры LLM с полями Температура, Max Completion Tokens, Top P, Top K, Repeat Penalty и Seed.

Как подключить действие к ассистенту

Действие появляется в чате только после того, как вы включите его у ассистента. Откройте ассистента, перейдите на вкладку Подключенные действия, включите нужную строку переключателем и сохраните ассистента — у этой вкладки нет отдельной кнопки сохранения.

Вкладка делится на два блока: Подключенные действия и Доступные действия. В меню строки есть пункты Переименовать (локальное название только для этого ассистента) и Открыть страницу (переход в редактор действия). Кнопки Создать действие и Библиотека действий в шапке вкладки ведут в тот же раздел настроек.

Поле С чем работает определяет, где появится кнопка. Действие с источником Стенограмма появляется на карточке расшифровки аудиофайла, действие с источником Сообщение ассистента — под ответом ассистента. Действие с источником Стенограмма можно назначить автозапуском: на вкладке Транскрипция выберите режим Транскрипция + авто-действие и укажите действие в поле Действие для авто-запуска.

Вкладка «Подключенные действия» в настройках ассистента: блоки «Подключенные действия» и «Доступные действия», строки с переключателями и метками происхождения, входного текста и результата — **Подключение действий к ассистенту: доступные и включённые**. Метки в строке показывают, системное это действие или созданное в пространстве, с чем оно работает и куда попадёт результат.

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

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

Глобальные переменные подставляют в промпт значения рабочего пространства — например, название организации или шаблон оформления, — и не требуют правки текста при каждом изменении. В поле Промпт нажмите кнопку {} в правом верхнем углу или сочетание Ctrl+Space: откроется каталог переменных с поиском. Выбранная переменная вставляется в позицию курсора токеном вида {{globals.<ключ>}} и подсвечивается в тексте.

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

Ограничения каталога:

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

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

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

Почему действие не появилось в чате

Чаще всего действие создано, но не включено у ассистента. Проверьте:

действие включено на вкладке Подключенные действия и ассистент сохранён;
чат открыт с тем ассистентом, у которого действие включено;
ассистент не системный: у системных ассистентов действия не настраиваются;
действие не архивировано — архивные действия не показываются нигде;
у вашей роли есть право assistants:actions:execute.

Почему действие запускается, но не видит нужный текст

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

Почему раздела «Действия ассистентов» нет в меню настроек

У вашей роли нет права actions:view, поэтому пункт меню скрыт, а прямая ссылка /settings/preferences/actions не открывается. Все системные роли пространства, включая viewer, получают это право по умолчанию, поэтому обычная причина — настроенная вручную роль. Попросите владельца пространства добавить право actions:view в вашу роль.

Что дальше

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