ИИ-помощник
ИИ-помощник — это чат с нейросетью прямо в кабинете. Он открывается справа кнопкой «ИИ» в шапке и умеет не только отвечать на вопросы, но и работать с вашим кабинетом: смотреть проекты и программы, собирать схемы, править страницы и списки. Доступен только творцу кабинета.
Помощник не встроен в МирБотов «из коробки»: вы подключаете свою нейросеть (любой сервис, совместимый с форматом OpenAI) и, если хотите, даёте ей доступ к кабинету через ключ. Эти два шага описаны ниже.
Как это устроено
В работе участвуют три части:
- Нейросеть — сервис, который думает и отвечает. Вы указываете его адрес и ключ при подключении интеграции.
- Интеграция «ИИ» — настройка в кабинете: какую нейросеть и какие её модели использовать.
- Ключ доступа к кабинету (по желанию) — разрешение, с которым помощник может заглядывать в кабинет и менять его. Без этого ключа помощник работает как обычный чат: отвечает на вопросы, но кабинета не видит и ничего в нём не делает.
Ваши сообщения и ответы инструментов кабинета (названия программ, содержимое блоков и т. п.) отправляются выбранной нейросети — то есть стороннему сервису. Подключайте тот сервис, которому доверяете, и не просите помощника показывать то, что не должно покидать кабинет.
Подключение нейросети
- Откройте «Интеграции» и нажмите «Добавить интеграцию», выберите «ИИ».
- Заполните форму:
- Название — любое, чтобы отличать подключения друг от друга (можно подключить несколько сервисов).
- Тип соединения — сейчас доступен «OpenAI-совместимый».
- Базовый URL — адрес API сервиса, обычно оканчивается на
/v1, напримерhttps://api.example.com/v1. - API-ключ — ключ, который выдал сам сервис нейросети.
- Нажмите «Получить модели». Кабинет запросит у сервиса список доступных моделей. Отметьте галочками те, которыми хотите пользоваться, и выберите «Модель по умолчанию».
- Нажмите кнопку сохранения. Интеграция готова: кнопка «ИИ» в шапке теперь отвечает.
Ключ нейросети хранится в зашифрованном виде и после сохранения нигде не показывается. Если ошибиться в адресе, кабинет подскажет: например, если по адресу открылась обычная веб-страница, а не API — проверьте, что адрес оканчивается на /v1.
Все настройки (список моделей, адрес, ключи) можно менять на странице интеграции: «Интеграции» → ваша интеграция → блок «Настройки ИИ». Поле с ключом оставьте пустым, чтобы сохранённый ключ не менялся; для удаления ключа есть отдельная галочка.
Доступ к кабинету: зачем нужен ключ и почему его создаёте вы
Чтобы помощник мог смотреть и менять кабинет, ему нужен ключ доступа МирБотов. Его создаёт человек — вы сами на вкладке «API» настроек. Автоматически, самим помощником или системой, ключ не выпускается, и это сделано намеренно.
Ключ — это полномочия. С ним помощник действует от имени вашего кабинета: читает данные, меняет схемы, может запускать программы, которые пишут вашим подписчикам. Решение «дать ли ему такие права и какие именно» должно принимать человек, а не сама нейросеть.
Права задаёте вы. При создании ключа вы сами выбираете:
- область — весь кабинет или только один проект;
- уровень — только чтение, полный доступ или только статистика;
- «только черновики» — помощник сможет править выключенные схемы, но не сможет публиковать и менять работающие.
Если бы помощник мог сам себе выпускать ключи, он мог бы снять эти ограничения и выдать себе больше прав, чем вы планировали. Поэтому границы всегда ставите вы, а помощник работает внутри них.
Вы можете отозвать доступ в любой момент. Кнопка «Отозвать» рядом с ключом закрывает доступ сразу. В списке ключей видно, когда ключом пользовались в последний раз.
Нейросеть ключа не видит. Ключ хранится в кабинете в зашифрованном виде, и кабинет подставляет его сам при обращении к инструментам. В диалог с моделью он не попадает, поэтому её нельзя «попросить показать ключ» или вытянуть его из переписки.
Как создать ключ и подключить его к помощнику
- Откройте «Настройки» → вкладка «API» (прямой адрес:
/cabinet/settings/api). - В карточке «Ключи API» нажмите «Новый ключ» и в открывшемся окне заполните:
- Название — например, «ИИ-помощник».
- Область — для начала лучше выбрать «Отдельный проект» и указать нужный проект: помощник не увидит остальные.
- Уровень доступа — «Только чтение», если нужны лишь ответы о состоянии кабинета; «Полный (чтение + запись)», если помощник должен собирать и менять схемы.
- «Только выключенные схемы (черновики)» — при полном уровне оставьте галочку: помощник не сможет публиковать и править работающие схемы.
- Нажмите «Сгенерировать». Форма закроется, и поверх страницы откроется окно «Ключ создан». Ключ показывается один раз, потом его не увидеть — только отозвать и создать новый. Окно закрывается только своей кнопкой: Esc и щелчок мимо окна его не закроют, чтобы ключ не потерялся.
- Нажмите «Скопировать ключ». (Кнопка «Скопировать подсказку» нужна для внешних ИИ-клиентов, для этого помощника она не нужна.) Затем нажмите «Ключ скопирован» — окно закроется.
- Откройте страницу вашей интеграции «ИИ»: «Интеграции» → интеграция → «Настройки ИИ». Вставьте ключ в поле «API-ключ МирБотов для MCP», а в поле «URL MCP-сервера» оставьте предложенный по умолчанию адрес. Нажмите «Сохранить настройки ИИ».
После этого в выпадающем списке интеграций в панели рядом с названием появится пометка «с инструментами».
Если ключ не задан, помощник просто отвечает как обычный чат и честно сообщает, что кабинета не видит.
Как пользоваться панелью
Нажмите «ИИ» в шапке — справа откроется панель. Напишите сообщение и отправьте кнопкой или клавишей Enter (Shift+Enter — перенос строки).
- Выбор нейросети и модели. Кнопка «Настройки» вверху панели открывает два списка — интеграция и модель. Выбор запоминается за вами.
- Чаты. Выпадающий список чатов позволяет вернуться к прошлым разговорам; «Новый» начинает чистый чат, «Удалить» удаляет текущий. История видна только автору: другие пользователи кабинета в интерфейсе чужие чаты не увидят. Хранятся последние 100 чатов за 90 дней, более старые удаляются сами.
- Вызовы инструментов. Когда помощник обращается к кабинету, в ленте появляется сворачиваемый блок с названием вызова, его параметрами и результатом — видно, что именно он делал.
- Остановка. Пока идёт ответ, кнопка «Отправить» превращается в «Стоп».
- Код и таблицы в ответах оформляются, у блоков кода есть кнопка «Копировать».
- На всё окно. Кнопка со стрелками в углу панели разворачивает её на всю ширину окна — удобно для длинных ответов и схем. Повторное нажатие сворачивает обратно; выбор запоминается в браузере.
- Голосовой ввод. Кнопка с микрофоном под полем сообщения: нажмите, надиктуйте, нажмите ещё раз — распознанный текст появится в поле, его можно поправить и отправить. Если нажать «Отправить» во время записи, запись остановится и сообщение уйдёт сразу. Речь распознаёт сам браузер (русский язык), звук обрабатывает сервис производителя браузера, в Chrome это Google. В Firefox кнопки нет. При первом нажатии браузер попросит доступ к микрофону.
- Размышления. Если модель присылает ход своих рассуждений, он показывается в ленте серым сворачиваемым блоком «Размышления»: пока модель думает, блок открыт и растёт, с началом ответа сворачивается. Размышления видны только во время ответа и в истории чата не сохраняются. Не все модели и шлюзы их передают, тогда блока нет.
- Сброс контекста. Кнопка с круговой стрелкой в строке чатов: помощник забывает всё, что было в чате выше, а сообщения остаются на экране под пометкой «Контекст сброшен». Удобно, когда разговор ушёл не туда или стал слишком длинным.
- Автопрокрутка. Лента сама прокручивается вниз, пока приходит ответ. Если вы прокрутили вверх, чтобы перечитать, прокрутка не мешает; она возобновится, когда вы вернётесь к концу ленты или отправите сообщение.
- База знаний. Кнопка с книгой в строке чатов открывает базу знаний кабинета, она общая для всех творцев кабинета. См. раздел «База знаний» ниже.
База знаний
В базу можно положить то, что помощник должен знать о вашем кабинете и МирБотов:
- Заметка — введите заголовок и текст и нажмите «Добавить заметку» (правила, договорённости, описание ботов);
- Файл — «Загрузить файл»: текстовые .md, .txt, .csv, .json до 1,9 МБ (PDF и Word сначала сохраните как текст);
- Документация МирБотов — кнопка добавляет или обновляет разделы документации, чтобы помощник отвечал о конструкторе точнее.
Помощник сам ищет в базе, когда вопрос касается правил, инструкций и документации, и отвечает по найденному; если ответа в базе нет, он так и скажет. В ленте виден вызов kb_search. Если вы просите «запомни…», помощник предложит сохранить заметку и спросит подтверждение (кроме режима «Без подтверждений»). Любой документ можно удалить крестиком в списке.
Поиск идёт по словам, а не по смыслу: формулируйте вопрос теми же словами, что встречаются в документах. Тексты из базы попадают в запросы к нейросети, поэтому не кладите туда пароли и ключи.
Базовый промпт
Базовый промпт — ваши постоянные инструкции помощнику: терминология, стиль ответов, правила именования, что нельзя трогать. Он добавляется к каждому запросу, поэтому повторять его в чате не нужно. Уровней два:
- Промпт кабинета — в настройках интеграции с ИИ, поле «Базовый промпт кабинета». Действует во всех чатах и проектах кабинета.
- Промпт проекта — в панели помощника: «Настройки» (шестерёнка) → «Промпт проекта», выберите проект и сохраните текст. Действует, когда проект выбран текущим, и дополняет промпт кабинета. Текущий проект переключает помощник командой
select_project; новый проект подхватывается сразу, даже посреди разговора.
Каждый промпт — до 4 000 символов. Промпт не отменяет подтверждение действий и не расширяет права ключа. Не кладите в него пароли и ключи: текст уходит в запросы к нейросети.
Карточка участника
Карточка собирает всё, что ваш кабинет знает об одном участнике бота: проекты, списки, значения ресурсов и их последние изменения, ожидания и путь по схемам, рассылки. Откройте её, нажав на номер участника (#ID) в разделе «Списки» или среди значений ресурса. Карточка только для просмотра.
Ссылка подписана и привязана к вашему кабинету: чужой кабинет или подобранный номер её не откроют, а на любую ошибку вы увидите одинаковое «Карточка не найдена». Показываются только данные вашего кабинета, контакты и активность в чужих ботах не видны.
Помощнику карточку отдаёт инструмент get_member (по внутреннему ID, подтверждение не нужно). Через API: GET /api/v1/members/{id} (ключ кабинета; ключ проекта не подходит).
Вложения: скриншоты и файлы
Помощнику можно показать картинку — например, схему в редакторе, ошибку или то, как бот выглядит у подписчика, — или приложить файл: выгрузку, лог, таблицу, документ. Прикрепить можно тремя способами:
- вставить картинку из буфера обмена — Ctrl+V в поле сообщения (сначала сделайте снимок экрана системными средствами; сами файлы так не вставляются);
- перетащить файл в панель;
- нажать скрепку слева от поля ввода и выбрать файл.
Что подходит:
- картинки — PNG, JPEG, WebP, GIF; нейросеть получает саму картинку, крупные браузер сам уменьшит перед отправкой;
- текст и код — .txt, .md, .csv, .tsv, .json, .log, .xml, .yaml, .yml, .ini, .html, .css, .js, .ts, .php, .py, .sql, .sh; нейросеть получает текст файла (кодировка UTF-8 или Windows-1251 определяется сама);
- документы — .docx (Word), .xlsx (Excel) и .pdf; нейросеть получает текст, извлечённый из документа (у таблиц — по листам, ячейки через табуляцию).
В одном сообщении — до 4 вложений, каждое не больше 1,9 МБ. Нейросети уходит не больше 30 000 символов одного файла и 60 000 всех файлов одного сообщения: остальное отбрасывается, в списке вложений вы увидите пометку об этом, а нейросеть узнает, что показано «первых N из M символов». Длинный файл заметно увеличивает расход: 30 000 символов кириллицы — это порядка 19 тысяч токенов, и они уходят в каждом следующем запросе чата, пока контекст не сожмётся. Лучше прикладывать нужный фрагмент.
Не читаются: старые форматы .doc и .xls (сохраните как .docx и .xlsx), PDF-сканы без текстового слоя (текст нужно распознать заранее), документы и PDF с паролем, картинки внутри документов, а также файлы вроде .env. Из таблиц Excel берутся значения, сохранённые в файле: формулы не пересчитываются.
Прикреплённые вложения видны над полем ввода, лишнее можно убрать крестиком. Сообщение можно отправить и без текста — только с вложением. Вложения хранятся вместе с чатом и видны только вам; при удалении чата удаляются и они. Картинки нейросеть «видит» из последних трёх ваших сообщений — о более ранних знает только то, что они были, поэтому при необходимости приложите картинку заново; распознавать изображения умеет не каждая модель. Текст файлов входит в само сообщение и остаётся в разговоре, пока контекст не сожмётся, — тогда от него остаётся лишь краткая запись в сводке.
Осторожно с чужими файлами. Нейросеть читает файл как данные, но гарантии, что инструкция внутри него не повлияет на ответ, нет. Не прикладывайте файлы из недоверенных источников и внимательно читайте карточку подтверждения: изменения данных помощник выполняет только после вашего «Да». Содержимое файла уходит сервису нейросети, поэтому не прикладывайте пароли, ключи и персональные данные участников, если не готовы их передавать.
Подтверждение действий
Всё, что меняет данные или запускает схемы (создание и правка программ, блоков, страниц, списков, запуск программ и т. п.), помощник сам не выполняет. Вместо этого в чате появляется жёлтая карточка «Требуется подтверждение» с перечнем действий и их параметрами, а кнопки решают дело:
- «Выполнить» — действия выполняются, помощник продолжает работу;
- «Отклонить» — действия не выполняются, помощник предложит другой путь.
Если вместо ответа вы напишете новое сообщение, ожидающие действия отклоняются автоматически. Чтение (просмотр проектов, программ, страниц) идёт без подтверждения.
Если подтверждения мешают. Кнопка «Выполнить и не спрашивать 4 ч» на карточке или переключатель «Без подтверждений» в шапке панели разрешают помощнику выполнять действия сразу, без карточек, на 4 часа (потом подтверждения вернутся сами). Переключатель действует на все ваши чаты; выключить можно в любой момент той же кнопкой. Это не расширяет права: что именно доступно помощнику, по-прежнему определяет его ключ («Только чтение», «только черновики»).
Подтверждение — дополнительная защита, а не замена ограничениям ключа. Если вам важно, чтобы помощник вообще не мог что-то изменить, выдайте ключ «Только чтение» или с галочкой «только черновики».
Советы по безопасности
- Начните с ключа «Только чтение» и проекта вместо всего кабинета. Расширяйте права, когда убедитесь, что помощник делает то, что нужно.
- Для сборки схем используйте полный уровень с галочкой «только черновики»: результат работы всегда можно проверить глазами перед публикацией.
- Читайте карточку подтверждения, прежде чем нажимать «Выполнить», особенно для запуска программ, которые отправляют сообщения подписчикам.
- Отдельный ключ — на помощника, отдельный — на внешние ИИ-клиенты (см. «Доступ для агентов»): тогда отозвать один не придётся вместе с другим.
- Если ключ мог попасть не туда — сразу «Отозвать» его на вкладке «API» и создайте новый.
Частые проблемы
Кнопки «ИИ» нет в шапке. Помощник доступен только творцу кабинета.
Панель пишет «Нет подключённой интеграции». Подключите интеграцию «ИИ» (см. выше) и включите её на странице интеграции.
Список моделей не загружается. Проверьте базовый URL (обычно оканчивается на /v1) и API-ключ нейросети. Адреса внутренней сети и локальных серверов не принимаются.
Помощник отвечает, но кабинета не видит. Не задан ключ МирБотов для MCP (или он отозван). Создайте ключ по инструкции выше и вставьте его на странице интеграции.
Пишет «Ответ в этом чате ещё формируется». В этом чате уже идёт ответ. Дождитесь его или нажмите «Стоп».
Ключ потерялся. Показать его повторно нельзя. Отзовите старый и создайте новый.
Вложение отмечено красным. Оно не загрузилось. Наведите на него курсор — причина в подсказке: неподдерживаемый тип файла, больше 1,9 МБ, пустой или повреждённый файл, документ с паролем, PDF без текстового слоя или обрыв связи. Уберите вложение крестиком и прикрепите заново.
Помощник не понимает картинку или отвечает ошибкой. Выбранная модель может не поддерживать изображения — выберите другую в «Настройках» панели.
Кнопка микрофона не работает или её нет. Голосовой ввод требует браузера с распознаванием речи (Chrome, Edge, Safari) и разрешения на микрофон для сайта: проверьте значок замка в адресной строке. В Firefox кнопка скрыта.