Каталог навыков

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

Начните с «Навыки» → «Каталог» или попросите в чате: «Найди навык для…». Через чат можно установить, обновить или снять навык с витрины, подать или отозвать заявку на публикацию. Такие действия требуют вашего подтверждения; установкой в организацию управляют её владелец и администраторы.

Несколько навыков в одной задаче

В одной беседе можно сочетать чтение подключённых сервисов с подготовкой документов. Укажите нужные источники и конечный результат:

Письмо → CRM → предложение. «Найди письмо клиента, сопоставь его со сделкой amoCRM и подготовь в чате ответ с предложением в Word». Нужны настроенные «Почта» и amoCRM с правами чтения; если ящиков несколько, назовите нужный. Проверьте адресата, условия сделки и файл. Сохранить ответ в почтовые черновики или отправить его попросите отдельно.
Протокол → сделки → план встреч. «Разбери этот протокол, сопоставь договорённости со сделками CRM и предложи задачи и встречи». Приложите протокол и подключите CRM; для проверки занятости нужен настроенный календарь с доступом к нужным событиям. Сначала проверьте предложенный план. Изменить сделку, создать запись в «Планах» или встречу попросите явно и подтвердите действие, когда появится форма. Событие через CalDAV само не рассылает приглашения.
Google Drive → сверка → документ. «Найди отчёт на Google Диске, сверь его с приложенной таблицей и подготовь итоговый документ и текст письма». Google Drive поддерживается Искрой, когда оператор включил подключение; установите навык и подключите свой Google-аккаунт с доступом к исходному файлу. Установка навыка для организации не подключает за вас личный аккаунт. Правку исходного документа, загрузку результата на Диск или отправку письма закажите отдельно и проверьте запрошенные права.

Подготовка текста или файла завершается результатом в чате. Запись во внешний сервис и отправка — отдельные действия с правилами подтверждения соответствующего навыка; режим «Авто» эти правила не меняет. Для повторения по расписанию настройте запуск в «Планах».

Витрина

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

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

«Обзор» — описание, состав и справка: автор, версия и категория;
«Настройки» — вся форма настроек этой версии. Поля доступны только для чтения: заполнить их можно после установки. У навыков с несколькими подключениями, например 1С, форма нового подключения сразу развёрнута: видно, что понадобится, а добавить подключение можно после установки;
«Содержимое» — инструменты с таблицами параметров, сценарии автора с шагами и ручной запуск. Кнопки «Пуск» и «Запустить» заработают после установки. «Исходный код» и описание «Как устроен навык» составляются по установленному навыку, поэтому до установки неактивны.

Над «Настройками» и «Содержимым» плашка напоминает: «Это навык каталога. Заполнить настройки и запускать его можно после установки». Сама кнопка «Установить» одна — справа в ряду вкладок. Режима и меню «⋯» до установки нет: они появляются у установленного навыка.

Кнопка «Установить» стоит справа в ряду вкладок. Ряд остаётся на экране при прокрутке, поэтому кнопка видна на любой вкладке. Иконочная кнопка «+» на карточке ставит навык сразу, не открывая страницу; у установленного навыка на её месте галочка.

Названия и краткие описания встроенных навыков доступны на русском, английском, французском и китайском. У сторонних авторов остаётся их текст; в интерфейсе не на русском он отмечен «текст автора». Подробное описание показывается на языке интерфейса, если автор подготовил перевод, иначе — на языке автора. Описания инструментов также остаются авторскими.

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

Установка себе

На странице навыка нажмите «Установить» в ряду вкладок или на карточке каталога — иконочную кнопку «+» справа. Если Искра спросит, куда установить навык, выберите «Только для себя». Навык появится в секции «Личные» списка навыков (в меню «⋯» карточки отмечено «Из каталога») и получит режим «Авто».

После установки со страницы навыка вы остаётесь на этой странице. В шапке появляются режим и меню «⋯», а если навыку нужны ключи, открывается вкладка «Настройки». Режим можно сразу сменить на «По команде» или «Выкл». «Назад» сразу после установки ведёт обратно в каталог.

Если навык уже установила ваша организация, кнопка на странице навыка называется «Установить себе». Личная установка заменяет для вас установку организации, в том числе её версию.

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

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

Навыки с секретами

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

После установки кнопкой «+» на карточке каталога Искра откроет окно «Настройки навыка»: заполните значения и нажмите «Сохранить» внизу окна — одна кнопка записывает всё окно сразу. Заполнять прямо сейчас не обязательно: «Настрою позже» оставляет навык установленным, настроить его можно потом на его странице. А вот «Отмена» и крестик, пока ничего не сохранено и не начато подключение сервиса, отменяют и саму установку — навык не останется подключённым «наполовину». Такое окно с откатом есть только у «+» на карточке. Настроенные секреты принадлежат вам и другим пользователям не видны.

Если в настройках появилась ошибка объявления секретов, остальные поля остаются доступны. Поля с пустыми или повторяющимися именами недоступны для ввода. Попросите Искру исправить описание настроек вашего навыка и выпустить новую версию; для навыка из каталога обратитесь к его автору, затем обновите установку. Уже сохранённые ключи и параметры при показе ошибки не удаляются.

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

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

Исключение явно указывается в карточке навыка. Например, у «Нейросетей для медиа», «Внешней модели», Reputation.ru и 2ГИС при способе подключения «Свой ключ» ключ всегда личный: даже если этот способ выбран для всей организации, каждый участник вводит свой ключ, а общего ключа организации нет. При ошибке личного ключа такие навыки не переключаются на ключ Искры. Похожим образом устроены Wildberries Seller и Ozon Seller: установка организации делает навык доступным участникам, но каждый профиль подключает собственный кабинет продавца и хранит свои реквизиты отдельно.

Согласие на запись

Некоторые навыки просят право самостоятельно записывать значения в свои секреты (например, сохранить полученный токен). Перед установкой такого навыка Искра покажет диалог согласия со списком слотов — отметьте каждый и подтвердите. Без вашего согласия навык писать в секреты не сможет.

Обновления

Навыки из каталога обновляются автоматически: переключатель «Автообновление» на вкладке «Настройки» в блоке «Работа навыка» включён по умолчанию у новых установок из каталога. Новая версия ставится в течение минуты после выхода, кроме двух случаев: ей нужно ваше новое согласие на запись в секреты или новые обязательные ключи и настройки, либо переход отключил бы ваши дополнительные подключения. Тогда, как и при выключенном автообновлении, на карточке появляется значок «Доступно обновление», а в строке «Версия» — кнопка «Обновить до N»: она переносит установку на актуальную версию.

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

Если администратор отозвал версию, установки на ней переходят на текущую версию каталога (подробнее — «Отзыв версии» в справке о навыках).

Если у новой версии изменился набор секретов, в которые навык имеет право писать, в строке «Версия» вместо обновления будет кнопка «Дать согласие». До подтверждения запись в секреты для навыка заблокирована — это защита, а не поломка.

Удаление установки

На вкладке «Мои навыки» в секции «Личные» откройте меню «⋯» карточки или страницы навыка, выберите «Удалить установку» и подтвердите действие. После этого навык исчезнет из ваших навыков. Если удаляли со страницы навыка, она останется открытой: с неё навык можно сразу установить снова. Настроенные секреты не стираются: если позже установить навык снова, они подхватятся. Исключение — аккаунты внешних сервисов, подключённые через браузер, например Plaud: при удалении навыка из личных навыков доступ к ним удаляется, и после новой установки аккаунт нужно подключить заново.

Публикация своего навыка

Свой работающий навык (личный или навык организации — для организации это может сделать владелец или администратор) можно предложить в общий каталог.

Откройте страницу «Навыки» и нажмите на карточку своего навыка.
Нажмите «Опубликовать» в шапке страницы. Кнопка есть, когда вы управляете навыком и его есть куда опубликовать: каталог включён на платформе или личный навык можно передать организации.
В окне «Опубликовать «…»» выберите «Отправить в каталог» («Увидят все пользователи Искры. Проверка ИИ, затем модератор») и категорию. У личного навыка в профиле организации в окне есть и второй вариант — «В организацию «…»»: это передача навыка организации, она описана в руководстве по навыкам.
Блок «Перед отправкой» проверяет описание навыка — файл README.md. «Всё готово» — можно отправлять. «Нет описания README.md» или «README.md не по шаблону» со списком, что исправить, — в каталог такой навык не отправить. Кнопка «Составить описание» (она есть, если на платформе доступно управление навыками из чата) откроет чат обсуждения навыка с подставленной просьбой: Искра составит README.md по шаблону и сохранит его новой версией навыка. Шаблон описан в разделе «Описание навыка (README.md)».
При желании напишите комментарий в поле «Модератору» (необязательно, до 1000 символов) и нажмите «Отправить в каталог». Для уже опубликованного навыка пункт и кнопка называются «Отправить обновление», для снятого с каталога — «Опубликовать повторно». В окне видны версия исходника и известная версия каталога; категория существующей публикации предзаполнена и доступна для изменения.

Краткое описание для витрины отдельно писать не нужно: им становится первый абзац README.md.

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

Доработка и обновление из чата

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

Личный исходник остаётся в профиле, где его создали. В другом вашем профиле может быть только установка из каталога. Если доступного исходника нет, Искра объяснит ограничение и предложит проверить другой профиль; она не может по отсутствию исходника определить, в каком профиле вы его создали. Самостоятельная копия создаётся по вашему отдельному выбору и подтверждению. Её публикация будет самостоятельной и не заменит прежнюю.

Обновление существующей публикации подаётся из того же исходного навыка. Если имя в каталоге уже связано с другим исходником, Искра объяснит это до создания заявки. Для обновления вернитесь к исходнику той публикации; отдельное имя выбирают для самостоятельной публикации. Простое переименование новой копии не превращает её в продолжение старой публикации.

Что проверяют ИИ и модератор

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

Каждую принятую заявку — и каждое обновление — проверяет ИИ (если ИИ-проверка включена на платформе), а решение принимает модератор (администратор платформы); он может решить и до окончания проверки ИИ. Проверка ищет угрозы безопасности, утечки данных, несоответствие навыка своему описанию и привязку к автору или организации.

Навык из каталога должен работать у любого, кто его установит. Поэтому:

не опирайтесь на свои папки Памяти, почту, аккаунты и файлы: если навыку нужны материалы, объясните в инструкции, что делать, когда папка не привязана, — например, попросить пользователя привязать свою;
не вписывайте в инструкцию, описание инструментов, README.md или код свои адрес почты, телефон, имя, внутренние адреса организации и пути к своим файлам;
что пользователю нужно подключить самому — ключи, доступы, папки Памяти и что в них лежит, — перечислите в разделе README.md «Что нужно для подключения».

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

Статус заявки

После отправки вверху «Обзора» страницы навыка появляется блок «Публикация в каталог». В нём указаны вид и версия заявки: например, «Обновление до 1.0.2 · На модерации». Даже если готовый исходник уже версии 1.0.3, рассматривается именно поданная 1.0.2. Далее показаны этапы:

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

Рядом со статусом — «Переписка» с модератором: до решения он может задать вопрос, вопрос приходит уведомлением, ответ пишется там же (подробнее — «Переписка по заявке»). Причину отказа модератор указывает обязательно. О решении приходит уведомление.

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

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

После одобрения в справке на «Обзоре» появляется строка «Каталог · Опубликован» с версией каталога. «Версия исходника» показывает номер отдельно от версии каталога: например, исходник 1.0.2 и каталог 1.0.1 означают, что доработка ещё не опубликована в каталоге. Отзыв версии показывается отдельным предупреждением: сам номер исходника не означает, что версия доступна для использования. Если сервер не подтвердил номер версии каталога, интерфейс сообщает, что версия неизвестна. На витрину попадает именно та версия, которая была у навыка в момент подачи заявки, — более поздние ваши правки на неё не влияют.

Что ещё полезно знать:

Публикация — это независимая копия. Ваш навык остаётся вашим: вы можете менять его и даже удалить — у тех, кто установил навык с витрины, ничего не сломается.
Материалы и подключения. Общие файлы комплекта входят в опубликованную версию. Привязки к папкам Памяти автора и его настройки подключений не передаются. Папки Памяти пользователь привязывает в текущем профиле; подключения настраивает в пределах своих прав. Руководство по навыкам поможет выбрать место для шаблонов, прайса и материалов одной задачи.
Обновление публикации. Развивайте навык как обычно — изменения не попадают на витрину сами. Когда ваша версия станет новее опубликованной, снова нажмите «Опубликовать» → «Отправить обновление» — это новая заявка с той же модерацией. Отправка заявки ещё не меняет версию каталога; готовность навыка для автора и проверка его внешнего API также не заменяют решение модератора. Версия обязана быть новее опубликованной: пока в каталоге ваша последняя версия, вариант обновления каталога недоступен с пояснением «Опубликована актуальная версия». Установки с включённым автообновлением получат разрешённую новую версию автоматически; остальным потребуется обновление в настройках. Новые обязательные настройки и согласия сохраняют ограничения раздела «Обновления».
Лимит — не больше 20 опубликованных навыков на одного автора.
Фоновые навыки (работающие по расписанию) в каталог пока не принимаются.
Контейнерные навыки (OCI-образ) в каталог не подаются: их файлы платформа не хранит, поэтому README.md взять неоткуда.
Снять с каталога можно самому. Пока навык опубликован, рядом со строкой «Каталог · Опубликован» на «Обзоре» есть кнопка «Снять». Искра попросит подтвердить: «Снять навык с каталога? У тех, кто его установил, навык продолжит работать; вернуть его можно новой заявкой.» После подтверждения навык исчезнет из каталога. Вернуть его можно новой заявкой на публикацию (той же версии, модерация проводится заново).
Если навык заблокировал модератор, в справке на «Обзоре» видно «Каталог · Заблокирован модерацией».

Установка в организацию

Если вы работаете в профиле организации с ролью владельца или администратора, навык ставится в организацию той же кнопкой «Установить» в ряду вкладок страницы навыка или кнопкой «+» на карточке каталога. Если навык ещё не установлен ни лично, ни в организацию, после нажатия Искра спросит, куда установить: «Только для себя» или «Для вашей организации». Под каждой кнопкой написано, где окажется навык. «Только для себя» ставит навык лично вам в профиле этой организации: в вашем личном профиле его не будет. Перед установкой в организацию выберите группы, которым будет доступен навык; пустой выбор означает всю организацию. Ограничение сохраняется до настройки общего секрета, поэтому ключ не открывается участникам на время установки.

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

Кнопка в ряду вкладок остаётся и у установленного навыка, пока свободна вторая область. Если личная установка уже есть, кнопка подписана «Установить в организацию»; если навык уже установлен в организацию, кнопка «Установить себе» создаёт личную установку. Рядом с кнопкой — ссылка на другую установку того же навыка: «Открыть личную установку» или «Открыть установку организации». После установки вы остаётесь на странице навыка, как и при личной установке. Установить навык в организацию из личного профиля нельзя — переключитесь в профиль организации. Установленный в организацию навык появляется у разрешённых участников в секции «Организации» списка навыков в режиме «Авто»; каждый участник может выбрать у себя «По команде» или «Выкл».

Управление орг-установками — там же, в секции «Организации» раздела «Навыки» (со страницы организации вкладка «Навыки» сразу открывает /skills): клик по карточке открывает страницу навыка с пометкой «Установка организации». На вкладке «Настройки» в строке «Версия» видна установленная версия, кнопка «Вернуть» и, когда вышла новая, «Обновить до N»: они меняют версию сразу для всей организации; там же переключатель «Автообновление» установки организации. Пункт «Удалить из организации» в меню «⋯» убирает навык у всех участников. Участники видят автообновление и версию только для чтения с пометкой «версией управляет владелец организации».

Если один и тот же навык установлен и лично вам, и в организацию, действует ваша личная установка — в том числе её версия.

Кому виден навык: группы

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

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

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

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

Подключение внешнего сервиса навыка

Некоторые навыки работают с сервисом через вход в ваш аккаунт. Например, Google Drive, Plaud или навык MCP-сервиса со входом. Такие подключения собраны в блоке «Подключения сервисов». Он есть на вкладке «Настройки» страницы навыка и в окне «Настройки навыка», которое открывается из каталога или карточкой «Настроить» в чате.

В строке подключения видны название сервиса и состояние: «Подключено» или «Не подключено». У MCP-сервиса показан ещё и его адрес — его задаёт навык.

Чтобы подключить сервис:

Нажмите «Подключить» в строке сервиса. Страница сервиса откроется в новой вкладке, а в приложении для macOS — в браузере.
Войдите в свой аккаунт и подтвердите доступ.
Вернитесь в окно Искры. Состояние обновится само.

Если в чате открыта форма подключения, нажмите в ней «Готово». Если окно «Настройки навыка» открыто карточкой «Настроить», Искра продолжит прерванную задачу после подключения, когда остальные обязательные параметры уже заполнены, иначе — после их сохранения. Начатое подключение сохраняет только что установленный навык: «Отмена» в окне его уже не удалит.

Google Drive и Plaud можно подключить и в чате: попросите Искру, и она покажет форму входа. Это одно и то же подключение — в настройках и в чате. Ключи и токены в чат вставлять не нужно.

Одно подключение хранит один аккаунт. «Подключить заново» позволяет сменить аккаунт. «Отключить» удаляет доступ, который Искра сохранила для этого навыка. Разрешение в самом сервисе при этом остаётся: отозвать его можно в настройках аккаунта сервиса, например в аккаунте Google или в Plaud. У участников организации подключения личные.

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

Блока нет, если вход через этот сервис для навыка на вашей Искре не настроен. Тогда навык может показать обычное поле для ключа. Заполняйте его по инструкции администратора.

Некоторые сервисы выдают доступ на ограниченный срок без автоматического продления. Искра покажет это после подключения. Если сервис отклонил набор запрашиваемых разрешений, на странице результата может появиться кнопка «Подключить без автопродления». Это ваш выбор: после окончания доступа потребуется подключиться заново. Отмена нового входа сохраняет прежнее рабочее подключение.

Для нового MCP-сервиса сообщите Искре его адрес и попросите создать навык. Если нужна авторизация, сначала подключитесь в настройках предварительного навыка. После получения списка инструментов можно добавить нужные действия. Возможность подключения зависит от поддерживаемого сервисом способа входа и настроек вашей Искры.

Навык Google Drive

Официальный навык Искры Google Drive находится в категории «Интеграции», если оператор платформы настроил и включил подключение Google. Навык умеет искать файлы и смотреть содержимое папки, читать текстовые файлы и Google-документы, скачивать файл в разговор и загружать файл разговора на Диск, создавать папки и текстовые файлы, переименовывать и перемещать файлы, отправлять их в корзину и выдавать доступ конкретному пользователю. Также он создаёт документы Google Docs и меняет выбранный текст в существующих документах, читает, создаёт и правит Google Таблицы и собирает и правит презентации Google.

При режиме «Только через /» сначала выберите Google Drive в меню / рядом с полем сообщения. Разовое подключение сохраняет этот режим. В автоматическом режиме достаточно обычной просьбы.

После установки попросите Искру, например: «найди на Google Диске отчёт за июнь». При первом вызове Искра предложит подключить ваш Google-аккаунт. Пока приложение Искры не прошло проверку Google, окно подключения покажет предупреждение и подсказки по входу. Продолжайте, только если доверяете своему экземпляру Искры и согласны дать ему доступ к файлам. Нажмите «Продолжить в Google»: Google откроется в новой вкладке и может показать экран «приложение не проверено». После предоставления доступа вернитесь в Искру и нажмите «Готово». Искра проверит подключение перед продолжением работы. В тестовом режиме Google подключиться могут только аккаунты, которые оператор добавил в список тестовых пользователей.

Выберите нужный Google-аккаунт, проверьте название приложения и запрашиваемые разрешения, затем подтвердите доступ.

Подключить Google Диск можно и заранее, не дожидаясь вопроса в чате. На вкладке «Настройки» навыка нажмите «Подключить» в строке «Google Диск» (см. «Подключение внешнего сервиса навыка»). Одно подключение открывает навыку файлы Диска, документы, таблицы и презентации Google.

Чтобы отключить Google Диск, попросите Искру «Отключи Google Диск» или нажмите «Отключить» в той же строке. Искра удалит сохранённый доступ, и при следующей просьбе навык снова предложит вход. Разрешение в аккаунте Google при этом остаётся. Чтобы закрыть доступ полностью, отзовите доступ приложения Искры в настройках своего аккаунта Google. Если раньше вы отдельно подключали Google Документы, этот прежний доступ тоже снимается только там: Искра им больше не пользуется.

Документы, таблицы и презентации работают на доступе к Google Диску. Поэтому даже если вы начинаете с документа, Google попросит разрешение на весь Диск, а не только на документы.

В десктоп-приложении для macOS окно Google открывается в браузере. Если в этом браузере вы не вошли в Искру, после подтверждения доступа появится страница с кнопкой «Открыть приложение Искра». Нажмите её: приложение откроется, завершит подключение и само продолжит работу в чате. Если такая страница появилась, а вы подключаете сервис не из приложения для macOS, войдите в Искру в этом браузере и начните подключение заново в настройках навыка или в чате.

Токен и пароль не отправляйте сообщением в чат. Если на уже установленном навыке браузерное подключение недоступно, он может предложить резервную защищённую форму для access token или OAuth-данных; используйте её только по инструкции администратора вашего экземпляра. Когда подключение Google на вашем экземпляре настроено, резервного поля в настройках навыка нет: Диск подключается только через браузер. Эта форма закрывает только работу с файлами Диска: документы, таблицы и презентации Google через неё не работают — если браузерное подключение на вашем экземпляре не настроено, Искра об этом скажет и предложит обратиться к администратору.

Поиск и содержимое папки

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

Как скачать файл в разговор

Чтение показывает Искре только текст, поэтому договор в PDF, таблицу или картинку лучше сразу скачать: попросите, например, «скачай карточку компании с Диска». Файл появится среди файлов разговора, и Искра назовёт его имя и размер. Дальше с ним можно работать как с любым файлом, который вы принесли сами, — например, попросить распознать документ или приложить его к сделке в amoCRM.

Документы, таблицы, презентации и рисунки Google сохраняются в привычных форматах: Word, Excel, PowerPoint и PDF соответственно. Если нужен другой формат, скажите об этом — например, «сохрани таблицу в PDF». Остальные файлы скачиваются как есть.

Предел скачивания — 20 МБ. Более крупный файл или папку целиком заберите в самом Google Диске: навык сообщит об ограничении.

Как загрузить файл на Диск

Обратное тоже работает: «сохрани этот договор на Диск в папку Клиенты» — Искра возьмёт файл разговора, ваш или созданный ею самой, и положит его на Диск. Подходят PDF, офисные документы, изображения и архивы; предел здесь меньше, чем у скачивания, — 3 МБ (3 000 000 байт).

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

Создание и правка Google Docs

Попросите, например: «Создай Google-документ с планом встречи, заголовками и маркированным списком» или «В этом документе на вкладке “План” замени второй абзац и добавь итоги в конец». Искра умеет создавать пустые документы, добавлять абзацы и менять или удалять выбранный фрагмент. Поддерживаются заголовки и маркированные списки; таблицы, изображения и остальные вкладки вне изменяемого фрагмента сохраняются. Создание таблиц, изображений и вкладок в эти операции не входит. За один вызов можно передать до 100 абзацев и 32 КиБ текста, название нового документа — до 200 символов. Полный предпросмотр также должен помещаться в форму подтверждения. Если текст содержит много специальных символов или названия слишком длинные, Искра попросит уменьшить объём правки или длину названий. До этого запись не выполняется, содержимое предпросмотра не обрезается. Точечная замена текста работает внутри одного абзаца. Для изменения нескольких абзацев Искра предлагает заменить абзацы целиком.

Документы работают на том же подключении Google Диска, отдельного входа для них нет. Если Диск ещё не подключён, Искра покажет ту же форму входа Google Диска. При создании документа она сначала покажет, что будет создано, а вход попросит после вашего подтверждения.

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

Перед правкой Искра проверяет версию документа. Если кто-то успел изменить его, нужно заново прочитать документ и проверить новое предложение. Если документ создан, но его начальное заполнение не удалось, Искра сообщает об этом и возвращает адрес созданного документа. При потере ответа Google результат может быть неизвестен: сначала проверьте документ в Google Docs, затем решайте, нужен ли новый запрос. Повторная запись и создание ещё одного документа автоматически не запускаются.

Google Таблицы

Попросите, например: «покажи, что в книге со сметой», «собери таблицу с выручкой по месяцам» или «допиши эти три строки в лист Данные». Искра читает книгу окном: показывает листы, их размеры и значения выбранного фрагмента — например, «Данные!A1:D50», — и сама продолжает с того места, где остановилась, если фрагмент не поместился. Она отличает «показано не всё» от «дальше пусто» и говорит об этом прямо.

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

Презентации Google

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

Что видно в подтверждении

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

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

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

Навык MAX

Навык подключает к Искре собственного бота вашей компании. Чтобы писать самой Искре в MAX, навык не нужен: используйте бота Искры (в облаке — «Моя Искра») — см. «Бот Искры в MAX».

Официальный навык Искры MAX находится в категории «Интеграции», если его включил оператор платформы. Он подключает не личный аккаунт, а созданного вами чат-бота MAX. Отдельный запуск или сценарий не нужен: установите навык и напишите в обычном чате, например «Помоги создать бота MAX» или «Подключи моего бота MAX». Искра выяснит, на каком этапе вы находитесь, объяснит следующий шаг и вызовет нужные инструменты навыка. Одна ссылка-приглашение в чат сама по себе ничего не подключает: нужен подключённый бот, добавленный в чат с нужными правами.

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

Создание и модерация бота

Искра объясняет действия, но не создаёт профиль или бота и не влияет на решение модерации. Эти шаги вы выполняете на платформе MAX для партнёров.

По официальной документации MAX, проверенной 3 августа 2026 года:

создать бота может организация, ИП или самозанятый — резидент РФ — с верифицированным профилем;
организация или ИП может создать до 5 ботов, самозанятый — до 2;
путь создания: нужный профиль → «Чат-боты» → «Создать»;
для карточки обязательны логотип, название и описание; актуальные размеры, форматы и ограничения Искра предложит сверить перед отправкой;
каждый бот проходит модерацию, заявленный срок — до 48 часов по рабочим дням;
статус «на модерации» означает ожидание, «создан» — успешную проверку, «требует исправлений» — необходимость открыть замечание в карточке, исправить данные и отправить их повторно.

Если лимит ботов достигнут или профиль не соответствует условиям, Искра скажет об этом прямо и не будет предлагать обход. Если проверка идёт дольше заявленного срока, проверьте уведомления и статус на платформе и обратитесь в официальную поддержку MAX. Изменение данных уже созданного бота запускает повторную модерацию.

Актуальные требования и правила:

Токен и подключение к Искре

После успешной модерации откройте «Чат-боты» → «Перейти» → «Расширенные настройки» → «Настроить». Там находится токен и переключатель, разрешающий добавлять бота в групповые чаты; по умолчанию такое добавление запрещено.

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

Токен нельзя вставлять в обычное сообщение Искре. Попросите её подключить MAX: если токен ещё не задан, Искра покажет под ответом карточку «Навыку нужны секреты» с кнопкой «Настроить». Карточка видна и тогда, когда ход выполнения свёрнут, — в самом ходе выполнения та же форма открывается кнопкой «Настроить секреты навыка» со значком замка. По нажатию откроется защищённая форма установленного навыка. При личной установке токен сохраняется для вашего профиля, при организационной — в общей форме организации. Если токен всё же попал в чат, он останется в истории чата, поэтому считайте его скомпрометированным: обновите токен в расширенных настройках MAX и сохраните новый через защищённую форму. Если новый токен относится к другому боту, при следующем обращении навык очистит подключение и список чатов прежнего бота, а затем подключит нового. Данные двух ботов не смешиваются.

Когда вы задаёте настройки навыка впервые, после успешного сохранения формы, открытой из чата, исходный чат автоматически продолжит предыдущую задачу: Искра подключит или проверит бота в соответствии с вашим запросом. Плановая замена уже сохранённого токена ничего в чат не отправляет — как и сохранение токена на отдельной странице настроек; после неё попросите Искру подключить или проверить MAX. Затем можно добавить бота в нужную группу или канал. Личный диалог подключается отдельно для каждого профиля Искры — это защищает участников организации от доступа к перепискам друг друга.

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

Личный диалог с ботом

Чтобы работать из Искры со своим личным диалогом:

Откройте личный чат с подключённым ботом в MAX.
Напишите Искре: «Подключи мой личный диалог MAX».
Искра покажет защищённую форму с одноразовым кодом. Отправьте этот код отдельным сообщением в личный чат именно с указанным ботом MAX.
Вернитесь в Искру и нажмите «Проверить привязку». Код действует 5 минут.

Имя и числовой MAX ID вводить не нужно: владение диалогом подтверждает только сообщение с одноразовым кодом. После привязки текущий профиль Искры увидит историю и сможет писать в этот личный диалог от имени бота. Другие участники организации его не увидят. Если тот же диалог привязать к другому профилю Искры, прежняя привязка перестанет действовать. Команда «Отключи мой личный диалог MAX» удаляет только вашу привязку и не отключает общего бота, группы или каналы.

Чтобы подключить группу или канал:

В расширенных настройках бота разрешите его добавление в групповые чаты.
В MAX добавьте бота в нужный чат как участника — найти его можно по нику или публичной ссылке из карточки бота.
Назначьте бота администратором и дайте право read_all_messages. Без него бот не получает новые сообщения группы или канала, поэтому чат может не появиться в Искре, а доступная история будет неполной.
Выдайте только права, нужные для ваших задач: write — изменение и удаление сообщений в группе и публикация в канале; edit и delete — изменение и удаление постов канала; pin_message — закрепление; change_chat_info — изменение чата; add_remove_members и add_admins — управление участниками и администраторами.

MAX не предоставляет общий список всех чатов бота, поэтому список Искры пополняется по мере новой активности. После добавления бота отправьте в группу или канал любое сообщение, затем попросите Искру показать доступные чаты. Если известен chat_id, попросите Искру добавить по нему группу или канал; сначала она безопасно проверит, что чат доступен боту. У групп и каналов идентификатор может быть отрицательным. Искра хранит до 500 последних известных групп и каналов; если их больше, общий список может быть неполным, но нужный чат можно проверить и добавить по chat_id. В списке показываются только чаты, где бот сейчас активен. Чтение сообщений и действия в известном чате выполняются напрямую через MAX.

Навык позволяет читать известные чаты и сообщения, отправлять, редактировать и удалять сообщения, работать с участниками, названием и закреплённым сообщением в пределах Bot API MAX. При чтении истории 50 сообщений — значение по умолчанию, а не максимальный лимит: за один запрос можно получить до 100 сообщений. Для более глубокой истории Искра может выполнить следующие запросы с временными границами. Навык показывает ту доступную историю, которую возвращает MAX для этого бота и чата; она не обязательно начинается с момента подключения Искры. Перед изменением сообщения, чата, участника или закрепления Искра показывает отдельное подтверждение с точной целью. При неопределённом ответе изменение автоматически не повторяется. Перед удалением навык также сверяет получателя самого сообщения: chat_id для группы или канала и recipient.user_id для личного диалога с ботом.

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

Файлы и вложения MAX

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

Отправить файл тоже можно: приложите его к сообщению Искре (или возьмите файл, который уже есть в этом диалоге) и попросите отправить — он уйдёт вложением с сохранёнными именем и типом. Речь именно о файлах вашего диалога с Искрой, а не о файлах чата MAX: загружать что-либо в MAX заранее не нужно. Перед отправкой Искра покажет подтверждение с точным чатом, именем и размером файла; сообщение уходит только после того, как файл полностью загрузился, — незавершённая загрузка не превращается в отправленное сообщение.

Предел файла — 3,5 МБ в обе стороны; файл больше отклоняется понятной ошибкой заранее.

Навык Telegram

Навык подключает к Искре собственного бота вашей компании. Чтобы писать самой Искре в Telegram, навык не нужен: используйте бота Искры (в облаке — «Моя Искра») — см. «Боты Искры в Telegram и MAX».

Для истории и переписки личного аккаунта доступен отдельный навык «Telegram — личный аккаунт». Раздел ниже описывает работу через бота.

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

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

Создание бота и токен

Бота создаёт пользователь у @BotFather; Искра объясняет шаги, но не делает это за вас. По официальной документации Telegram, проверенной 30 июля 2026 года:

откройте @BotFather и отправьте команду /newbot;
задайте отображаемое имя, затем username — он обязан заканчиваться на «bot»;
в ответ придёт токен вида <цифры>:<буквы и цифры>.

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

Токен нельзя вставлять в обычное сообщение Искре. Попросите её подключить Telegram: если токен ещё не задан, Искра покажет кнопку «Настроить секреты навыка» со значком замка, и по нажатию откроется защищённая форма. Область хранения токена выбирается при установке навыка — личная или общая для организации. Если токен всё же попал в чат, считайте его скомпрометированным: сделайте /revoke у @BotFather и сохраните новый через форму. Если новый токен относится к другому боту, навык очистит реестр разговоров, сохранённые сообщения и очередь событий прежнего бота и попросит подключиться заново — данные двух ботов не смешиваются.

Как Искра получает события

При подключении Искра выдаёт боту собственный защищённый адрес и просит Telegram слать события туда. Дальше события приходят сразу, как только что-то происходит, и складываются в очередь вашей установки. Разбирает очередь навык — в тот момент, когда вы к нему обращаетесь. Ваше присутствие нужно для разбора, но не для получения.

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

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

Группы, каналы и privacy mode

Чтобы работать с группой или каналом, добавьте в него бота. Одна ссылка-приглашение в группу или канал сама по себе чат к Искре не подключает: бот должен стать участником чата и получить нужные права. По умолчанию бот видит в группе только команды и обращения к себе. Чтобы он читал все сообщения:

у @BotFather выполните /setprivacy и выберите Disable, либо назначьте бота администратором группы;
после смены режима приватности удалите бота из группы и добавьте заново — иначе настройка не применится.

Проверить текущее состояние можно, попросив Искру показать состояние бота: в ответе есть признак того, читает ли бот все сообщения группы.

Один бот — одна установка

Область хранения токена выбирается при установке навыка: личная или общая для организации. Общее подключение организации подключает и отключает владелец или администратор. Если у вас нет таких прав, Искра так и ответит и предложит установить навык лично: тогда бот будет вашим, а не общим для организации. В каталоге у навыка, уже установленного организацией, стоит пометка «Установлено в организации» — кнопка установки рядом ставит его лично вам.

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

Что видят участники организации

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

Накопленные сообщения групп при этом каждый участник копит свои: они начинают собираться с того момента, как он сам обратился к навыку. Полной истории у Bot API нет в принципе, поэтому окно и так объявлено неполным.

Личные диалоги — нет. Бот переписывается со многими людьми, и его личные переписки принадлежат каждому свои. По умолчанию такой диалог недоступен никому, включая того, кто подключил бота: он не попадает в общий список вовсе.

Деловая переписка Telegram Business — тоже нет. Диалоги бизнес-аккаунта видит только тот участник, который подтвердил владение этим аккаунтом Telegram одноразовым кодом. Остальным они не видны, и ответить в них от чужого имени нельзя, даже если бот общий.

Как подключить свой личный диалог с ботом

Попросите Искру подключить ваш личный диалог. Она покажет защищённую форму со ссылкой вида t.me/имя_бота?start=КОД:

откройте ссылку — Telegram сам отправит код боту;
если ссылка не открывается, отправьте тот же код обычным сообщением в личный чат с ботом;
вернитесь в форму и подтвердите.

Код действует 5 минут и никуда, кроме Telegram, отправляться не должен: на эти пять минут он равносилен доступу к диалогу. Не пересылайте его никому и не вставляйте в чат Искры.

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

Если понадобится отменить — попросите отвязать диалог. Накопленное окно сообщений при этом удалится, а сама переписка в Telegram сохранится. Повторная привязка того же диалога другим человеком отменяет прежнюю: диалог принадлежит одному владельцу.

Режим секретаря: Telegram Business

Бот может работать с личными диалогами вашего бизнес-аккаунта. Настройка выполняется на вашей стороне. Возможности Telegram Business — расписание, быстрые ответы, приветствия, бизнес-ссылки — входят в подписку Telegram Premium, но подключение чат-бота вынесено из-под неё и работает без подписки. К одному аккаунту подключается только один бот — прежний будет заменён. Если раздела «Telegram Business» в настройках нет, обновите приложение Telegram. Порядок:

у @BotFather: /mybots → нужный бот → Bot Settings → Secretary Mode (прежде назывался Business Mode) → включить;
в Telegram: Настройки → Telegram Business → Чат-боты → указать username бота и выдать права.

Business даёт доступ к личным диалогам бизнес-аккаунта, но не к группам и каналам: туда бота по-прежнему добавляют вручную. Деловая переписка видна только вам. Чтобы Искра отличила владельца аккаунта от остальных участников организации, привяжите свой Telegram к профилю одноразовым кодом — тем же способом, что и личный диалог с ботом. Привязка одна и общая: если вы уже подключали личный диалог, проходить код заново не нужно, а привязка, сделанная ради Business, заодно откроет вам личный диалог. Важно лишь, чтобы Business был подключён с того же аккаунта Telegram, который привязан к профилю. Пока привязки нет, диалоги этого подключения закрыты и на чтение, и на ответ. Ограничение не мешает команде: у одного бота может быть много подключений, и каждый участник подключает и привязывает свой аккаунт сам. Подключите бота в настройках Telegram Business и обратитесь к навыку: уведомление приходит в момент изменения и само по себе не повторяется. Если Искра пишет, что business-подключений не видит, подключите бота в настройках заново. Отвечать от имени владельца бот может только в диалогах, где собеседник написал за последние 24 часа, и в пределах выданных прав: окно открывает именно входящее сообщение, ваш собственный ответ его не продлевает. Если право ответа не выдано или подключение выключено, Искра скажет об этом прямо и не будет пытаться обойти ограничение.

Удаление проверяет отдельные права Telegram Business: удаление отправленных сообщений либо удаление всех сообщений. Право отвечать для удаления не требуется. Снять закрепление в Business можно с конкретного сообщения — укажите его идентификатор. После обновления навыка ранее сохранённому подключению может потребоваться новое событие о правах: измените разрешения или переподключите бота в Telegram Business, если Искра сообщает об отсутствии права удаления. Переключатель личного аккаунта tg-user на этот режим не влияет.

Что навык умеет и чего не умеет

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

Оформление сообщений — жирный шрифт, курсив, ссылки и код — Искра передаёт разметкой Telegram. Если в тексте остались служебные символы, которые получатель увидел бы как есть (теги вроде <b> без оформления, записи \n, \u003c или <), навык такое сообщение не отправляет и не меняет: Искра получает подсказку и переписывает текст сама, ещё до подтверждения. Свои сообщения бота в списке накопленных показаны так, как их видят участники чата: без разметки и без оформления. Поэтому, меняя оформленное сообщение, Искра задаёт его текст целиком заново вместе с оформлением.

Навык работает и с файлами. Если в сообщении есть документ или изображение, оно видно в списке сообщений: имя, тип и размер. Попросите Искру забрать вложение — файл появится в файлах текущего диалога, и его можно разбирать как любой другой документ. В обратную сторону: приложите файл к сообщению Искре (или возьмите файл, уже имеющийся в диалоге) и попросите отправить. Фотографию JPEG или PNG Искра опубликует обычным фото-постом: изображение в ленте, ваш текст — подписью под ним. Telegram при этом сжимает снимок и не хранит имя файла, поэтому, если нужен оригинал, попросите отправить «файлом» — тогда он уйдёт вложением с сохранёнными именем, типом и качеством, как любой другой документ. Слишком длинные или широкие картинки (стороны различаются больше чем в 20 раз или в сумме больше 10 000 пикселей) Telegram фото не принимает, и они уходят файлом. Заранее загружать файл в Telegram не нужно. Перед отправкой Искра покажет подтверждение с адресом, способом отправки, именем и размером файла.

Предел файла — 3,5 МБ в обе стороны. Это ограничение Искры, а не Telegram: файл больше отклоняется понятной ошибкой сразу, до скачивания или до подтверждения отправки, и обойти его нельзя.

Главное ограничение — у Bot API нет истории переписки. Искра видит только сообщения, полученные после подключения, и хранит ограниченное окно последних сообщений по каждому разговору. При чтении сообщения или подписи к вложению ссылка, скрытая под словами, показывается вместе с адресом рядом с её текстом. Пустой список сообщений означает, что событий не приходило, а не что чат пуст. Список чатов тоже строится из событий: Bot API не отдаёт перечень чатов бота, поэтому уже существующий чат появится после нового события либо после явного добавления его chat_id. Реестр ограничен 500 чатами и общим объёмом записи, поэтому при длинных названиях фактический предел ниже; при переполнении навык честно сообщает об усечении.

События не запускают Искру в фоне: они приходят сразу, но обрабатываются при следующем обращении к навыку.

Перед удалением установки попросите Искру отключить Telegram: тогда навык снимет адрес приёма событий у бота и удалит локальные данные — реестр разговоров, сохранённые сообщения и очередь событий. Сам бот у @BotFather сохраняется, и вы можете подключить его заново или к другому сервису. Если пропустить этот шаг, Telegram продолжит слать события на адрес, которого больше нет.

В установке организации сохранённые сообщения лежат отдельно у каждого участника, и отключение стирает их только у того, кто его выполнил. Остальным достаточно попросить Искру отключить Telegram у себя — навык увидит, что бот уже отключён, и удалит их копию. Если бота подключат заново, копия удалится сама при первом обращении к навыку. Читать её до этого всё равно нельзя.

Навыки со своим ключом

Отдельных карточек «… (свой ключ)» в каталоге больше нет. «Нейросети для медиа», «Внешняя модель», Reputation.ru и 2ГИС работают и по ключу Искры с оплатой в МТ, и по вашему личному ключу: выберите в настройках навыка способ подключения «Свой ключ» и введите ключ в защищённой форме. Возможности и лимиты при обоих способах одинаковы.

Если вы раньше устанавливали карточку «(свой ключ)», после обновления у обычного навыка уже выбран «Свой ключ» на том же уровне — лично или для организации. Ключ нужно один раз ввести заново: форма откроется при первом вызове. Модели и режим работы берутся из настроек обычного навыка.

У «Нейросетей для медиа» и «Внешней модели» запрос со своим ключом уходит по адресу, который задал администратор установки: это может быть зеркало OpenRouter или корпоративный прокси. Прямое соединение с openrouter.ai не гарантируется. Остановка запроса не гарантирует остановку работы у провайдера: перед повтором проверьте готовые файлы и расход в личном аккаунте OpenRouter.

Навык «Музыкальная нотация»

Установите «Музыкальную нотацию» из категории «Продуктивность», чтобы создавать и править партитуры MusicXML/MXL. В результате вы получаете нотный файл, изображение первой страницы в SVG и пояснение, что проверено: формат MusicXML, нотные события, длительности, начальные размер, тональность и ключ партий, согласованность тактов.

По запросу можно получить также MIDI или MEI вместе с проверенным MusicXML/MXL. Повторное чтение MIDI проверяет наличие нот; для MEI также проверяется отображение. Перенос всех свойств в эти форматы не гарантируется.

Точное снятие нот со звука, картинки, PDF или видео недоступно. Для такой задачи выберите отказ или явно обозначенное приближение. У приближения проверяется сохранение пометки в заголовке MusicXML/MXL; остальные метаданные нуждаются в отдельной проверке. Проверка нотного файла не доказывает точность исходной транскрипции или сохранность всех данных при импорте. Простое копирование исходника также не означает, что партитура проверена.

Навык UniSender

Навык помогает подготовить письмо, выбрать аудиторию и отправить или запланировать рассылку. Он доступен в категории «Интеграции», если включён оператором платформы. Подготовленный макет ещё не означает отправку.

Подключение UniSender и права

Установите UniSender и введите API-ключ в защищённой форме настройки навыка. Для личной установки используйте свой ключ; общий ключ организации задаёт её владелец или администратор. Если ключа нет, Искра предложит форму в чате. Собрать и посмотреть макет можно без ключа; обращения к UniSender требуют подключения.

Попросите «Проверь подключение и покажи мои списки». Доступны списки, метки, поля персонализации, шаблоны, письма, кампании и домены отправителя. Можно узнать число всех, активных и пригодных для отправки контактов. Тарифных лимитов API не сообщает: сравните эти числа с условиями своего аккаунта. Здесь «сегмент» означает список; метка — отдельный фильтр. Если название подходит обоим, уточните, что выбрать. Полная база и временная ссылка на её выгрузку в чат не передаются.

Собрать и проверить письмо

Опишите содержание, отправителя и тему. Можно использовать шаблон UniSender или приложить готовый .html: в шаблоне меняются тексты и ссылки с сохранением вёрстки, готовый HTML берётся как есть. Замечания к чужой вёрстке не блокируют отправку, но некорректные ссылки нужно исправить: пустые, небезопасные и неизвестные шаблоны ссылок не принимаются. Для ссылок-трекеров geteml.com/…/mail_link_tracker из старой рассылки навык помогает восстановить исходный адрес — с такими трекерами UniSender письмо не примет.

Откройте файл email-preview.html в файлах чата. Это просмотр макета без отправки и без подтверждающей формы. Внешние изображения скрыты до нажатия «Показать изображения», чтобы их сервер не получил сведения о просмотре и ваш IP. Правило действует и в полноэкранном просмотре; приложенные картинки видны сразу. Используйте файл в интерфейсе, а не вручную составленную ссылку на внутренний путь. Сырой HTML в переписку не выводится.

Для правки назовите блок или попросите добавить новый. Уже приложенные картинки сохраняются с письмом; заново прикладывать их не нужно.

Шаблоны и отправители

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

Неподтверждённому отправителю можно запросить письмо со ссылкой подтверждения. Сам запрос не подтверждает адрес: перейдите по ссылке, иначе UniSender отклонит отправку с него. Навык отдельно читает полный список подтверждённых адресов; до 20 пар имени и email из недавних кампаний — лишь история. Также доступны до 500 доменов отправителя по логину аккаунта; логин навык определяет сам. Выбирайте отправителя из доступных данных, а не предполагаемых адресов.

Списки, контакты, поля и метки

В подключённом аккаунте UniSender можно создать, переименовать или удалить список, поле персонализации или метку; добавить и обновить контакты, исключить из списка или отписать от всех рассылок. Назовите адреса в чате либо сначала найдите контакты и затем поручите действие над найденными.

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

Пределы одного вызова:

исключение из списков и отписка — до 50 адресов;
добавление и обновление — до 500 адресов; свыше 50 применяется массовый импорт, который только заменяет значения полей. При разных наборах полей разделите контакты на вызовы, чтобы не стереть неназванные данные;
массовый импорт меток только добавляет их к прежним. Замена набора идёт по одному контакту и ограничена 50 адресами. Целую базу загружайте импортом в кабинете UniSender.

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

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

Новый контакт добавляется без письма-подтверждения со статусом «новый». Подтвердить контакт через API нельзя: это делает сам получатель. Наличие согласия на рассылку проверяет владелец базы; фактические статусы можно запросить у Искры.

Посчитать аудиторию без изменения списков

В подключённом UniSender попросите сначала посчитать выборку для целевого списка, ничего не записывая. Можно объединить до 20 списков, исключить ещё до 20, отобрать по метке или статусу. Для всей базы нужен хотя бы один дополнительный отбор; целевой список не может быть источником. Если статус не задан, отбираются только адреса, которым UniSender станет писать.

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

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

Собрать список из выбранной аудитории

В подключённом UniSender укажите целевой список и отбор: до 20 списков-источников и 20 списков исключений, метку, статус либо реакцию на рассылку не старше 180 дней. Для всей базы нужен дополнительный фильтр; целевой список не может быть источником. Без указанного статуса выбираются адреса, пригодные для отправки.

Повторы удаляются. Предел по умолчанию и максимум — 20 000 адресов в итоговом списке: если в нём уже есть контакты, добавляется только остаток. Для отбора по спискам, метке и статусу уже состоящие в целевом списке адреса не записываются повторно, их число показано отдельно. Выгрузка по реакции не сообщает членство в списках: часть выбранных адресов могла уже там быть, точного числа нет.

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

Если выборка ещё готовится, продолжайте её по полученному результату. Частичный результат не означает завершённый список. При неизвестном исходе записи сначала проверьте целевой список и продолжение: повтор всей сборки вслепую не нужен. Убрать контакты по критерию обратно нельзя; исключение выполняется по адресам, до 50 за вызов.

Проверить тестовое письмо

Для теста нужен подключённый UniSender. Назовите 1–25 тестовых адресов явно. Существующий список нужен для создания письма, но адреса в него не импортируются и кампания по списку не запускается. По умолчанию форма показывает письмо, точных адресатов, ссылки и изображения. При выключенном «Спрашивать каждый раз» в настройках UniSender заполненный тест может отправиться без нового подтверждения.

Можно приложить PNG, JPEG или GIF из текущего чата: до 32 картинок, каждая до 300 КиБ. Предел полного закодированного запроса может потребовать дополнительно уменьшить картинки.

UniSender может отклонить неподтверждённый тестовый адрес. Успешный ответ означает принятие запроса, а не доставку: проверьте почтовый ящик. Статус кампании к тесту неприменим — API не сообщает доставку тестового письма. При потерянном ответе результат неизвестен; автоматического повтора нет. Сначала проверьте почту, затем решайте, нужна ли ещё одна отправка.

Отправить или запланировать рассылку

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

Выберите письмо и от 1 до 3 списков. Пустые, небезопасные и неизвестные шаблоны ссылок нужно исправить до отправки.
При необходимости приложите в текущем чате PNG, JPEG или GIF: до 32 картинок, каждая до 300 КиБ. Общий предел полного закодированного запроса может потребовать дополнительно уменьшить картинки. Навык не ищет их в интернете; внешние картинки уже выбранного шаблона сохраняются.
В обязательной форме проверьте отправителя, тему, списки, оценку аудитории, фактические ссылки и изображения. Выберите «Отправить сейчас» или «Запланировать» и время. Эта форма остаётся при выключенном «Спрашивать каждый раз». Адрес в нескольких списках может получить несколько писем. Список с оценкой свыше 50 000 получателей отправляйте отдельно; его обработка может занять больше времени.
Для немедленной отправки по умолчанию требуется ещё одно подтверждение «Да, отправить сейчас». Только этот второй шаг может выполняться по предварительному разрешению, если выключено «Спрашивать каждый раз». Недостающие данные всё равно потребуется заполнить.

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

В результате остаются отправитель, тема, ссылки и известные идентификаторы кампаний. Таймаут после отправки запроса не означает отказ UniSender. При частичном или неизвестном результате проверьте эти кампании и кабинет UniSender; новый вызов делайте только для подтверждённо неотправленных списков. Не повторяйте исходный пакет целиком. Навык не делает A/B-тесты и автоматические цепочки: рассылка уходит в запланированное вами время, а не по самостоятельному решению навыка.

На тарифе «Фри» UniSender добавляет логотип «Сделано в UniSender»; это не часть подготовленного HTML. На платных тарифах такого блока нет — см. описание тарифов UniSender.

Узнать статус и отменить запланированную рассылку

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

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

Разобрать результаты рассылок

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

Для сравнения назовите последние рассылки либо до 10 конкретных кампаний. Анализ использует агрегаты, тему, короткий фрагмент текстового письма и очищенные популярные ссылки. Свободных ответов получателей API не предоставляет, адреса и IP в анализ не попадают. Если часть содержания или ссылок недоступна, это отмечается отдельно от уже полученных показателей.

Если ответ UniSender потерялся

Ориентируйтесь на состояние каждого списка, а не на факт завершения ответа Искры:

Состояние	Значение
`accepted`	UniSender подтвердил принятие цели
`failed`	Известна неудача этой цели
`unknown`	Действие могло выполниться, но ответ не подтверждён
`not_attempted`	До этой цели выполнение не дошло

accepted=true означает принятие всех целей, partially_accepted=true — части. state_unknown=true не означает «ничего не создано». Таймаут не доказывает отказ или отсутствие внешнего эффекта. Сначала попросите проверить известные campaign_id и при необходимости сверьте кабинет UniSender. Повторять можно только подтверждённо неотправленную часть, а не весь исходный набор списков.

Навык «Контакты»

«Контакты» подключает вашу внешнюю адресную книгу CardDAV. Установите навык из каталога и откройте его настройки: укажите логин, пароль приложения и HTTPS-адрес сервера. Если провайдер поддерживает автоматическое обнаружение, достаточно полного логина с доменом и пароля. Проверенные подключения — Яндекс и Radicale 3.5.10, с обычной авторизацией по логину и паролю приложения. Совместимость с другими серверами требует отдельной проверки.

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

Попросите Искру найти человека по имени, организации, телефону или email. В карточке доступны имя, организация, должность, день рождения, заметка, несколько телефонов и адресов электронной почты. Если результатов много, Искра покажет краткий список; выбранную карточку можно открыть полностью. При сообщении о неполном поиске уточните запрос или адресную книгу. Неподдерживаемая, недоступная или удалённая во время поиска карточка пропускается; остальные совпадения остаются видны, а поиск отмечается как неполный. Ошибка доступа к адресной книге требует проверки подключения. Если на сервере очень много адресных книг, Искра покажет часть списка и предупредит о его неполноте — в этом случае удобнее назвать нужную книгу.

Чтобы создать, изменить или удалить контакт, проверьте данные в форме и подтвердите действие. Если доступно несколько адресных книг, сначала выберите нужную. Отмена формы оставляет адресную книгу без изменений. Если другой клиент успел изменить карточку, Искра предложит открыть её свежую версию и подтвердить правку заново.

У большой карточки длинные поля в форме могут показываться сокращённо; предупреждение над превью обозначает это явно. Подтверждение относится к полным данным контакта, сокращение касается отображения.

Контакт без отображаемого имени доступен наравне с остальными: некоторые сервисы хранят такие записи, и Искра покажет их по организации, телефону или адресу почты. Задать пустое имя при сохранении нельзя.

Навык сохраняет остальные поля карточки при точечном изменении. Поддерживаются карточки vCard 3.0/4.0 в UTF-8. Карточка с неподдерживаемым полем недоступна для чтения и изменения и пропускается при поиске с сообщением о неполном результате. Это касается vCard 2.1, другой кодировки, а также неподдерживаемого параметра или типа значения в имени, организации, должности, дне рождения, заметке, телефоне или email. Например, старая запись телефона TEL;WORK;VOICE вместо параметра TYPE=work,voice или email с типом VALUE=uri делает недоступной всю карточку. Пересохраните такой контакт в современном формате через своё приложение контактов. Группы контактов, массовый импорт и постоянная синхронизация в этот навык не входят.

Навык Plaud

Навык Plaud работает с записями диктофона Plaud: находит записи, читает конспект и расшифровку встречи, помогает разобрать встречу и сохраняет записи в Память. Это не системный навык: он не появляется у вас сам, его устанавливают только из каталога навыков, категория «Интеграции». Навык есть в каталоге, только если администратор вашей Искры включил подключение Plaud. Если администратор позже выключит подключение, навык пропадёт из каталога и чата, а установка сохранится до повторного включения. Если Plaud не примет настройки подключения Искры, навык попросит обратиться к администратору.

Из каталога навык устанавливают лично себе — он появится только у вас. Обновление навыка до новой версии сохраняет подключённый аккаунт. После удаления навыка из личных Искра удаляет сохранённый доступ к Plaud: если установить навык снова, аккаунт Plaud нужно будет подключить заново.

Подключение аккаунта Plaud

Попросите Искру: «Подключи Plaud».
В чате появится форма со ссылкой «Подключить Plaud». Откройте её, войдите в свой аккаунт Plaud и разрешите доступ.
Вернитесь в чат и нажмите «Готово».

Подключить Plaud можно и в настройках навыка: на вкладке «Настройки» нажмите «Подключить» в строке «Аккаунт Plaud» (см. «Подключение внешнего сервиса навыка»).

В десктоп-приложении для macOS ссылка открывается в браузере. Если там вы не вошли в Искру, после разрешения доступа нажмите «Открыть приложение Искра»: приложение откроется, завершит подключение и само продолжит работу в чате. Если такая страница появилась вне приложения для macOS, войдите в Искру в этом браузере и подключите Plaud заново.

Навык сам проверяет, что Plaud выдал доступ, и называет подключённый аккаунт. Если доступ в Plaud не был разрешён, Искра попросит открыть ссылку ещё раз. Узнать состояние в любой момент можно вопросом «Plaud подключён?» — Искра покажет, подключён ли аккаунт и готова ли Память к импорту.

Чтобы отключить Plaud, попросите «Отключи Plaud» или нажмите «Отключить» в строке «Аккаунт Plaud» на вкладке «Настройки» навыка. Искра удалит сохранённый доступ только в текущем профиле; файлы, уже сохранённые в Память, останутся на месте. Отключение в Искре не отзывает разрешение внутри аккаунта Plaud — его отзывают в настройках самого Plaud.

Установка в организацию делает навык доступным сотрудникам, но аккаунт Plaud не общий: каждый сотрудник подключает свою учётную запись Plaud сам, и навык работает с записями только этого аккаунта. Если организация удалит навык, прежний доступ перестанет действовать, и после новой установки каждому нужно подключить Plaud заново. Сохранённый доступ при этом не стирается сразу, а заменяется при новом подключении. Чтобы удалить его заранее, отключите Plaud до удаления навыка в организации: попросите «Отключи Plaud» или нажмите «Отключить» в настройках навыка.

Что умеет навык Plaud

Показать список записей и найти запись по названию или датам. Искра называет, какую часть записей охватил поиск: для старых записей список может оказаться неполным, и навык говорит об этом прямо, а не выдаёт неполный результат за полный. В таком случае сузьте период поиска.
Прочитать конспект Plaud или расшифровку. Расшифровка приходит страницами с таймкодами и говорящими, поэтому даже очень длинную запись можно прочитать по частям.
Разобрать встречу: итоги, решения, задачи с ответственными и сроками, открытые вопросы. Конспект Plaud и выводы Искры подписываются раздельно.
Подготовить файл записи в формате Markdown — с конспектом и расшифровкой.
Прислать аудиозапись встречи в файлы разговора: попросите «пришли аудио этой записи». Файл скачивает сама Искра, ссылку в чат она не отправляет.
Импортировать записи в Память — в выбранную папку, с продолжением с того же места при следующем запуске. Как ведут себя импортированные файлы, описано в разделе «Файлы, импортированные навыками».
Импортировать новые записи регулярно через «Планы» — см. пример «Регулярный импорт Plaud».

В Память аудио не импортируется: там уже лежит расшифровка, сделанная Plaud, а загруженный звук Искра распознавала бы второй раз — дольше и без пользы. Если аудио всё же нужно в Памяти, попросите сохранить присланный файл в папку.

Попробуйте, например: «Покажи мои записи Plaud за эту неделю», «Разбери встречу «Планёрка» из Plaud: решения и задачи», «Импортируй записи Plaud в подключённую папку Памяти».

Ограничения навыка Plaud

Каждая запись сохраняется отдельным файлом, до ~3 МиБ текста на запись. Если расшифровка длиннее, навык не сохранит обрезанный файл под видом полного, а предложит читать её по страницам.
Если расшифровка в Plaud ещё не готова, навык так и говорит: расшифровка ещё не готова. Разбор можно построить по конспекту, а при импорте такая запись дождётся расшифровки и будет обработана в следующий раз.
Аудиозапись приходит в файлы разговора и живёт вместе с ним. Очень большая запись может не поместиться — тогда Искра скажет об этом и предложит скачать файл в приложении Plaud. При регулярном импорте аудио не скачивается: там сохраняется только текст встречи.
Записи хранит и обрабатывает Plaud на своём хостинге; Искра получает их через подключение к вашему аккаунту Plaud.

Безопасность и папка для импорта

Текст записей навык считает данными, а не командами: если в расшифровке прозвучала просьба «удали файлы» или «перешли это», Искра перескажет её как содержание встречи, но выполнять не станет.

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