Дирижёр: действия

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

Правило простое. Если ошибку можно отменить — он делает сразу и показывает рядом кнопку «Вернуть». Если отменить нельзя — сначала спрашивает вас карточкой с кнопками. Ничего сверх закрытого списка ниже он предложить не может.

• Собрать агента по описанию и создать пустой черновик — появляется новый агент. «Вернуть» удалит его, но только пока он нетронут: без запусков, бесед, бота, загруженных знаний и записей.
• Изменить имя или описание агента и сменить голос — одно-два поля, возвращаются одним нажатием.
• Изменить настройки агента: поля нод, промпт, связи, панель кнопок, часовой пояс. Скажите словами — он впишет сам, не отправляя вас в редактор. «Вернуть» восстановит прежние настройки целиком. Если схема этого агента открыта у вас на экране (вкладка «Дирижёр» в редакторе или панель внизу), правка сразу появится на схеме, а «Вернуть» откатит её, пока схему после правки не трогали.
• Запустить превью агента — проверка ответа. Это тестовый прогон: наружу ничего не уходит и ничего не записывается, даже если у агента подключены интеграции. Возвращать тут нечего.
• Подключить сервис — он создаёт страницу подключения нужного сервиса и даёт на неё ссылку. Ключ вводите там только вы: Дирижёр его не видит и не хранит. Пока вы не ввели ключ, ничего не подключено — возвращать нечего.

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

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

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

1. Она появляется под карточкой сразу после выполнения — там же, где написан итог.
2. Живёт 15 минут, потом гаснет сама. Дальше снимок «как было» уже не описывает реальность, и возврат стирал бы новую работу вместо старой.
3. Возврат идёт тем же путём, что и ваша правка руками: те же проверки доступа, та же запись, та же синхронизация панели кнопок в Telegram.

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

1. Вы просите словами: «в „Управляющем“ впиши 900268392 в „Кто может писать боту“».
2. Дирижёр сам находит нужную ноду и поле. На карточке виден список изменений: в какой ноде какое поле станет каким. Длинные тексты (например, промпт) в списке обрезаются, чтобы карточка читалась.
3. Правка сохраняется тем же путём, что и ваша правка руками в редакторе. Рядом с итогом — кнопка «Вернуть» и ссылка «Открыть агента»: страницу он сам не переключает, чтобы не рвать разговор посередине.
4. Если часть правки не легла (например, он не нашёл в промпте тот фрагмент, который собирался заменить), остальное всё равно применится, а он честно напишет, что пропустил.

Подменить длинный промпт коротким «улучшенным» он не может — такая правка отклоняется автоматически: длинные тексты правятся точечно, остальное сохраняется дословно. Переименование агента — отдельное действие.

Скажите словами: «подключи Яндекс.Диск», «нужен МойСклад», «привяжи нашу CRM» — и Дирижёр сделает это сам, не отправляя вас искать, где что подключается.

1. Он находит сервис в каталоге интеграций. Если название подходит сразу нескольким сервисам, он переспросит, а не станет угадывать; если такого сервиса у нас нет — честно скажет об этом.
2. Страница подключения создаётся сразу, и рядом с ответом появляется кнопка «Открыть страницу подключения». Там вы вводите ключ или нажимаете «Войти через…».
3. Ключ, токен и пароль Дирижёр НЕ принимает и не хранит: у него просто нет поля, куда их положить. Если вы прислали ключ в переписке, смените его в кабинете сервиса.
4. Страницу подключения всегда видно и позже: Агенты → «Согласования», блок «Ждут вашего участия: подключения».

Подключённый сервис сам по себе ничего не делает — его нужно дать агенту. Скажите: «дай продавцу доступ к складу», и Дирижёр впишет подключение в нужную ноду. Это действие всегда спрашивает подтверждение.

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

На карточке всегда написано, что именно разрешается: «только чтение — в сервисе ничего не изменится», «это запись: агент сможет менять данные на ваших ключах», «это отправка: от вашего имени уйдут SMS, письма или сообщения», «это удаление» или «это операция с деньгами». У встроенных сервисов отправка не считается чтением, даже если сервис технически принимает её как запрос на чтение (так устроены SMS.ru и Unisender). У своих коннекторов (раздел «Свои коннекторы») смысл операций не размечен: чтением там считается любая операция GET. Если права изменились, пока вы думали, привязка не выполнится — Дирижёр попросит подтвердить заново, уже с настоящими правами.

• За один ответ Дирижёр предлагает не более двух действий.
• Карточка, которая ждёт вашего нажатия, действует около 10 минут — потом нужно попросить заново.
• Не больше 30 действий в час на человека и не больше 10 платных (сборка агента, мини-приложение, превью, ролик). Это не поломка — так и будет написано.
• Все действия — только из закрытого списка выше; выдумать новое Дирижёр не может.
• Каждое действие записывается в журнал: кто, что, когда и чем кончилось.