Агенты ИИ: Claude и ChatGPT работают в TERVIO школы
Агент — это ИИ-ассистент школы (Claude, ChatGPT, Cursor), которому администратор выдал доступ к TERVIO. С ним цифры и настройки можно спросить обычным языком прямо в чате с ассистентом, а воронку, сайт или правило ИИ-куратора — попросить собрать. Урок о том, как подключить агента, сколько ему разрешить и почему опасное он делает только после вашего «Разрешить».
Зачем школе агент
Ассистент, подключённый к TERVIO, видит то же, что администратор видит на экранах, — но в тех разделах и на том уровне, что вы ему открыли. Типичные просьбы:
- Спросить цифры — «какая скорость ответов за неделю», «кто из кураторов сейчас перегружен», «сколько человек получит рассылку с таким фильтром».
- Разобрать настройку — «покажи схему воронки группового чата», «почему ИИ-куратор ответил так в этом чате».
- Собрать новое — воронку, черновик рассылки, теги и шаблоны, страницу сайта, правило ИИ-куратора.
Раздел называется «Агенты ИИ» и стоит в меню среди настроек. Видят его только администраторы школы: они заводят агентов, выдают и отзывают доступ. Агент не входит в TERVIO как человек, не пишет клиентам из чата, не меняет настройки школы и не видит пароли, токены, ключи интеграций и секреты вебхуков. Каждое его обращение записывается в «Журнал действий» под именем агента («Смены, команда и журнал»).
Два способа подключить
Сначала решите, где будет работать ассистент. Для ChatGPT и Claude в браузере или приложении удобнее кнопка: ключ копировать не нужно. Для программ на компьютере — Claude Code, Cursor, Claude Desktop — выдаётся ключ.
Кнопкой в ChatGPT или Claude
- В разделе «Агенты ИИ» скопируйте адрес сервера из карточки «Подключить в чате ChatGPT или Claude — без ключа».
- В ChatGPT: «Плагины» → «Добавить» → «Добавить пользовательский сервер MCP», вставьте адрес, аутентификация — OAuth. В «Расширенных настройках OAuth» в поле «Способ регистрации» выберите динамическую регистрацию клиента (DCR) и нажмите «Создать в виде плагина».
- В Claude: «Настройки» → «Коннекторы» → «Добавить пользовательский коннектор», вставьте адрес и больше ничего не меняйте.
- Приложение откроет TERVIO школы. Войдите под администратором, в блоке «Кому выдать доступ» выберите агента или «Новый агент», отметьте уровни по разделам и срок, нажмите «Разрешить доступ».
Если кнопка «Создать в виде плагина» не нажимается или TERVIO пишет «Подключение не создано», в «Способе регистрации» выбран не DCR. Переключите его, а если плагин уже создан — удалите его в «Плагинах» и создайте заново. Остальные поля OAuth не трогайте.
Подключение появится у агента как ключ с пометкой OAuth и адресом приложения. Закончился срок — подключите приложение заново.
По ключу
- «Добавить агента» — назовите его так, чтобы в журнале было понятно, чей он: «Claude Анны», «Отчёты для руководителя».
- «Выдать ключ» — название, права по разделам, срок (30, 90, 180 или 365 дней) и, если нужно, адреса, с которых ключом можно пользоваться: до 20 штук. Пусто — с любого адреса.
- Выберите «Промпт для агента» — один текст, который вы отправляете ассистенту, и он подключается сам, — или «Настроить вручную»: команда для Claude Code и настройки для Cursor и Claude Desktop.
Сохраните его сразу и никому не пересылайте в мессенджерах. Потеряли — отзовите ключ и выдайте новый: восстановить старый нельзя.
Сколько разрешить: уровни по разделам
У каждого раздела — свой уровень, и каждый следующий включает предыдущий:
- «Нет доступа» — раздела для агента нет, его инструментов он даже не видит.
- «Только смотреть» — видит, ничего не меняет.
- «Создавать и редактировать новое» — создаёт новое, а менять, запускать и публиковать может только то, что создал сам. Удалять не может, даже своё. Чужую воронку, тег или сайт он не тронет и скажет, что для этого нужны права выше.
- «Полный доступ» — всё в разделе, включая удаление.
Разделы: «Аналитика», «Сценарии», «Справочники» (теги, этапы, шаблоны, папки чатов), «Рассылки», «Сотрудники», «Боты», «Переписка», «Сайты», «Плагины» и «Кураторы» (настройки ИИ-куратора). У аналитики и переписки есть только «только смотреть». У нового ключа отмечено чтение аналитики, сценариев, сотрудников, ботов и справочников. Переписка — личные данные клиентов, поэтому там «нет доступа», пока вы не выберете уровень сами.
Права меняются без нового ключа: в строке ключа «Изменить права». Ключ и подключение в приложении остаются прежними, новые права действуют со следующего обращения, а изменение записывается в журнал.
Первую неделю дайте агенту «только смотреть»: так видно, правильно ли он понимает вашу школу, и ошибка ничего не стоит. Потом поднимите нужный раздел до «создавать и редактировать новое» — агент будет собирать новое рядом, не трогая то, что уже работает. «Полный доступ» нужен редко.
Что агент делает сам, а что — после «Разрешить»
Безопасное агент делает сам: новую воронку (всегда выключенной), правку выключенной воронки, теги и шаблоны, черновик рассылки и подсчёт аудитории, черновик страницы сайта. Опасное TERVIO не выполняет сразу, а создаёт запрос — он появляется наверху раздела в блоке «Запросы агентов»: кто просит, что именно и какие данные уйдут.
- Только с разрешения — включить или выключить воронку, изменить включённую, сохранить схему с вебхуком, удалить, запустить рассылку, опубликовать сайт впервые или страницу с формой, подключить свой домен. Сотрудники и боты — всегда с разрешения.
- «Разрешить» — TERVIO выполнит запрос, если ключ ещё действует, агент включён и права по-прежнему это позволяют.
- «Отклонить» — ничего не происходит, агент узнаёт об отказе.
- Без решения — через сутки запрос сгорает.
Галочка «Доверенный ключ — не спрашивать меня» снимает подтверждение с воронок, справочников и рассылок. Две вещи и с ней только после «Разрешить»: схема с мини-приложением (это код, который выполняется на сервере) и прогон воронки в одном чате — сообщения уйдут тому, кто в чате, поэтому убедитесь, что чат ваш тестовый.
Перед «Разрешить» откройте воронку кнопкой «Открыть воронку» и посмотрите схему. Ассистент уверенно соберёт развилку не туда, и включённая воронка сразу начнёт писать людям. Проверка на себе — та же, что для воронки, собранной руками: «Проверка воронки на себе и разбор сбоев».
Файл для блока «Медиа» агент загружает по прямой ссылке или по одноразовой ссылке на загрузку, которую он даст вам: она живёт 30 минут. Файл, приложенный в чате claude.ai, агенту не передаётся — для этого и нужна ссылка. До 10 МБ на файл. У одного ключа — не больше 300 изменений в сутки и 60 обращений в минуту.
Если доступ надо закрыть
- «Отозвать» у ключа — перестаёт работать сразу, но остаётся в списке для истории. «Удалить» — убирает насовсем. Что агент делал, остаётся в журнале.
- «Выключить» у агента — молчат все его ключи; после «Включить» действующие заработают снова.
- «ИИ-агент с нового адреса» — уведомление, когда ключом впервые пользуются с нового адреса. Если это были не вы, это первый признак утечки.
- «Подключение ИИ-агента отозвано» — TERVIO сам закрыл подключение из ChatGPT или Claude, потому что его старый токен предъявили повторно.
Уведомление о новом запросе — событие «ИИ-агент просит подтверждения» — само не включено: обычно агент и так пишет в чате, что ждёт решения. Как включать события, разобрано в «Уведомления: о чём TERVIO пишет в телеграм».
- Подключаете ChatGPT или Claude кнопкой и знаете, почему в ChatGPT нужен DCR.
- Выдаёте ключ со сроком и адресами и понимаете, что он показывается один раз.
- Объясните разницу между «создавать и редактировать новое» и «полным доступом».
- Знаете, почему у нового ключа нет доступа к переписке.
- Разбираете «Запросы агентов» и знаете, что доверенный ключ не снимает подтверждение с мини-приложений и прогона в чате.
- Умеете закрыть доступ и узнаёте признаки утечки ключа.
Дальше — модуль «Цифры и контроль»: «Аналитика: дашборды, скорость ответа и нагрузка».
Справочник по этому разделуДокументация TERVIO: что делает каждая кнопка на экране.