Справочник

ИИ-помощник

ИИ-помощник — это чат с нейросетью прямо в кабинете. Он открывается справа кнопкой «ИИ» в шапке и умеет не только отвечать на вопросы, но и работать с вашим кабинетом: смотреть проекты и программы, собирать схемы, править страницы и списки. Доступен только творцу кабинета.

Помощник не встроен в МирБотов «из коробки»: вы подключаете свою нейросеть (любой сервис, совместимый с форматом OpenAI) и, если хотите, даёте ей доступ к кабинету через ключ. Эти два шага описаны ниже.

Как это устроено

В работе участвуют три части:

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

Подключение нейросети

  1. Откройте «Интеграции» и нажмите «Добавить интеграцию», выберите «ИИ».
  2. Заполните форму:
    • Название — любое, чтобы отличать подключения друг от друга (можно подключить несколько сервисов).
    • Тип соединения — сейчас доступен «OpenAI-совместимый».
    • Базовый URL — адрес API сервиса, обычно оканчивается на /v1, например https://api.example.com/v1.
    • API-ключ — ключ, который выдал сам сервис нейросети.
  3. Нажмите «Получить модели». Кабинет запросит у сервиса список доступных моделей. Отметьте галочками те, которыми хотите пользоваться, и выберите «Модель по умолчанию».
  4. Нажмите кнопку сохранения. Интеграция готова: кнопка «ИИ» в шапке теперь отвечает.

Ключ нейросети хранится в зашифрованном виде и после сохранения нигде не показывается. Если ошибиться в адресе, кабинет подскажет: например, если по адресу открылась обычная веб-страница, а не API — проверьте, что адрес оканчивается на /v1.

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

Доступ к кабинету: зачем нужен ключ и почему его создаёте вы

Чтобы помощник мог смотреть и менять кабинет, ему нужен ключ доступа МирБотов. Его создаёт человек — вы сами на вкладке «API» настроек. Автоматически, самим помощником или системой, ключ не выпускается, и это сделано намеренно.

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

Права задаёте вы. При создании ключа вы сами выбираете:

Если бы помощник мог сам себе выпускать ключи, он мог бы снять эти ограничения и выдать себе больше прав, чем вы планировали. Поэтому границы всегда ставите вы, а помощник работает внутри них.

Вы можете отозвать доступ в любой момент. Кнопка «Отозвать» рядом с ключом закрывает доступ сразу. В списке ключей видно, когда ключом пользовались в последний раз.

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

Как создать ключ и подключить его к помощнику

  1. Откройте «Настройки» → вкладка «API» (прямой адрес: /cabinet/settings/api).
  2. В карточке «Ключи API» нажмите «Новый ключ» и в открывшемся окне заполните:
    • Название — например, «ИИ-помощник».
    • Область — для начала лучше выбрать «Отдельный проект» и указать нужный проект: помощник не увидит остальные.
    • Уровень доступа — «Только чтение», если нужны лишь ответы о состоянии кабинета; «Полный (чтение + запись)», если помощник должен собирать и менять схемы.
    • «Только выключенные схемы (черновики)» — при полном уровне оставьте галочку: помощник не сможет публиковать и править работающие схемы.
  3. Нажмите «Сгенерировать». Форма закроется, и поверх страницы откроется окно «Ключ создан». Ключ показывается один раз, потом его не увидеть — только отозвать и создать новый. Окно закрывается только своей кнопкой: Esc и щелчок мимо окна его не закроют, чтобы ключ не потерялся.
  4. Нажмите «Скопировать ключ». (Кнопка «Скопировать подсказку» нужна для внешних ИИ-клиентов, для этого помощника она не нужна.) Затем нажмите «Ключ скопирован» — окно закроется.
  5. Откройте страницу вашей интеграции «ИИ»: «Интеграции» → интеграция → «Настройки ИИ». Вставьте ключ в поле «API-ключ МирБотов для MCP», а в поле «URL MCP-сервера» оставьте предложенный по умолчанию адрес. Нажмите «Сохранить настройки ИИ».

После этого в выпадающем списке интеграций в панели рядом с названием появится пометка «с инструментами».

Если ключ не задан, помощник просто отвечает как обычный чат и честно сообщает, что кабинета не видит.

Как пользоваться панелью

Нажмите «ИИ» в шапке — справа откроется панель. Напишите сообщение и отправьте кнопкой или клавишей Enter (Shift+Enter — перенос строки).

База знаний

В базу можно положить то, что помощник должен знать о вашем кабинете и МирБотов:

Помощник сам ищет в базе, когда вопрос касается правил, инструкций и документации, и отвечает по найденному; если ответа в базе нет, он так и скажет. В ленте виден вызов kb_search. Если вы просите «запомни…», помощник предложит сохранить заметку и спросит подтверждение (кроме режима «Без подтверждений»). Любой документ можно удалить крестиком в списке.

Поиск идёт по словам, а не по смыслу: формулируйте вопрос теми же словами, что встречаются в документах. Тексты из базы попадают в запросы к нейросети, поэтому не кладите туда пароли и ключи.

Базовый промпт

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

Каждый промпт — до 4 000 символов. Промпт не отменяет подтверждение действий и не расширяет права ключа. Не кладите в него пароли и ключи: текст уходит в запросы к нейросети.

Карточка участника

Карточка собирает всё, что ваш кабинет знает об одном участнике бота: проекты, списки, значения ресурсов и их последние изменения, ожидания и путь по схемам, рассылки. Откройте её, нажав на номер участника (#ID) в разделе «Списки» или среди значений ресурса. Карточка только для просмотра.

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

Помощнику карточку отдаёт инструмент get_member (по внутреннему ID, подтверждение не нужно). Через API: GET /api/v1/members/{id} (ключ кабинета; ключ проекта не подходит).

Вложения: скриншоты и файлы

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

Что подходит:

В одном сообщении — до 4 вложений, каждое не больше 1,9 МБ. Нейросети уходит не больше 30 000 символов одного файла и 60 000 всех файлов одного сообщения: остальное отбрасывается, в списке вложений вы увидите пометку об этом, а нейросеть узнает, что показано «первых N из M символов». Длинный файл заметно увеличивает расход: 30 000 символов кириллицы — это порядка 19 тысяч токенов, и они уходят в каждом следующем запросе чата, пока контекст не сожмётся. Лучше прикладывать нужный фрагмент.

Не читаются: старые форматы .doc и .xls (сохраните как .docx и .xlsx), PDF-сканы без текстового слоя (текст нужно распознать заранее), документы и PDF с паролем, картинки внутри документов, а также файлы вроде .env. Из таблиц Excel берутся значения, сохранённые в файле: формулы не пересчитываются.

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

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

Подтверждение действий

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

Если вместо ответа вы напишете новое сообщение, ожидающие действия отклоняются автоматически. Чтение (просмотр проектов, программ, страниц) идёт без подтверждения.

Если подтверждения мешают. Кнопка «Выполнить и не спрашивать 4 ч» на карточке или переключатель «Без подтверждений» в шапке панели разрешают помощнику выполнять действия сразу, без карточек, на 4 часа (потом подтверждения вернутся сами). Переключатель действует на все ваши чаты; выключить можно в любой момент той же кнопкой. Это не расширяет права: что именно доступно помощнику, по-прежнему определяет его ключ («Только чтение», «только черновики»).

Подтверждение — дополнительная защита, а не замена ограничениям ключа. Если вам важно, чтобы помощник вообще не мог что-то изменить, выдайте ключ «Только чтение» или с галочкой «только черновики».

Советы по безопасности

Частые проблемы

Кнопки «ИИ» нет в шапке. Помощник доступен только творцу кабинета.

Панель пишет «Нет подключённой интеграции». Подключите интеграцию «ИИ» (см. выше) и включите её на странице интеграции.

Список моделей не загружается. Проверьте базовый URL (обычно оканчивается на /v1) и API-ключ нейросети. Адреса внутренней сети и локальных серверов не принимаются.

Помощник отвечает, но кабинета не видит. Не задан ключ МирБотов для MCP (или он отозван). Создайте ключ по инструкции выше и вставьте его на странице интеграции.

Пишет «Ответ в этом чате ещё формируется». В этом чате уже идёт ответ. Дождитесь его или нажмите «Стоп».

Ключ потерялся. Показать его повторно нельзя. Отзовите старый и создайте новый.

Вложение отмечено красным. Оно не загрузилось. Наведите на него курсор — причина в подсказке: неподдерживаемый тип файла, больше 1,9 МБ, пустой или повреждённый файл, документ с паролем, PDF без текстового слоя или обрыв связи. Уберите вложение крестиком и прикрепите заново.

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

Кнопка микрофона не работает или её нет. Голосовой ввод требует браузера с распознаванием речи (Chrome, Edge, Safari) и разрешения на микрофон для сайта: проверьте значок замка в адресной строке. В Firefox кнопка скрыта.