Навыки

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

1. Найдите нужный навык в «Навыки» → «Мои навыки» или установите его из «Каталога», если каталог включён на вашей платформе.
2. На странице навыка выберите «Авто» для подбора по задаче или «По команде» для явного вызова.
3. Если нужны подключения, заполните вкладку «Настройки». Ключи и пароли вводите в защищённую форму, а не сообщением в чат. Установка и включение навыка сами по себе не означают, что он уже настроен.
4. Опишите задачу. Для явного выбора откройте «Навыки беседы» → «Добавить навык» в панели запроса или начните вводить / и название либо назначение навыка в поле сообщения. Поиск понимает русские названия.
5. Проверьте ответ и полученные файлы. Если действие требует данных или подтверждения, заполните предложенную форму. Статусы ошибок и прерываний доступны также в «Журнале запусков».

Для своего повторяющегося процесса перейдите к созданию навыка из чата; для готовой интеграции — к каталогу и установке. Создание собственного навыка и его публикация для других пользователей — отдельные действия.

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

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

Раздел «Навыки» (/skills) открывает «Мои навыки». Во вкладке «Каталог» можно найти и установить новые навыки, если её включил администратор. У владельца и администраторов в профиле организации есть вкладка «Сотрудники» — для навыков участников и заявок на передачу. Свой навык добавляется кнопкой «+ Добавить свой навык», историю вызовов открывает «Журнал запусков».

«Мои навыки» и фильтр состояния

Навыки сгруппированы по принадлежности:

• Личные — созданные вами навыки и ваши установки из каталога.
• Организации — навыки и установки текущей организации.
• Системные — доступные встроенные и служебные навыки Искры.

Кнопки «Все / Включены / Выключены / На модерации» фильтруют список карточек. Можно выбрать несколько статусов: например, «Выключены» и «На модерации» покажут навыки с любым из этих состояний. Повторное нажатие снимает выбор, а «Все» очищает весь набор. «Включены» объединяет «Авто» и «По команде». Поиск работает внутри выбранных статусов по названию, техническому имени и описанию. Большие секции листаются независимо уголками ‹ › справа от заголовка секции, а «Показать все» раскрывает секцию целиком на месте; «Свернуть» возвращает её. Новый поиск или фильтр возвращает секции на первую страницу.

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

На карточке видно только то, что требует внимания: значок ⚠, если навык не работает (подсказка называет причину), часы проверки и отозванная версия. Выключенный навык показан приглушённым. У установки из каталога, для которой вышла новая версия, на карточке есть кнопка «Обновить». Названия встроенных навыков переводятся на язык интерфейса; у сторонних авторов сохраняется их текст.

Меню «⋯» на карточке открывает навык без перехода на его страницу. Вверху меню — откуда навык («Личный», «Из каталога», «Копия «…»», «Системный») и его версия, ниже — переключатель режима «Выкл / По команде / Авто», «Попробовать в чате», «Спросить Искру о навыке», у своего навыка — «Опубликовать…», и удаление. Недоступный пункт показан бледным, причина — в подсказке при наведении.

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

Если навык не готов к работе, на карточке значок ⚠ с одной из подсказок:

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

Избранные навыки

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

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

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

Отметка не меняет режим навыка. Для автоподбора нужен режим «Авто». Избранный навык «По команде» доступен для ручного выбора; выключенный навык отсутствует в автоподборе и меню «/», но сохраняет звезду. После включения отметка снова учитывается. Удаление навыка или личной установки удаляет и относящуюся к ней отметку.

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

Страница навыка

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

Действия зависят от ваших прав. Копия и удаление собраны в меню «⋯» справа от переключателя режима:

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

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

Обзор

Прочитайте описание навыка и условия подключения. Здесь также видны автор, принадлежность, версия, состояние сборки программного навыка и заявки, если она есть. У копии или установки из каталога указано, как она обновляется, у опубликованного вами навыка — статус каталога и действие «Снять».

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

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

Настройки

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

• Подключения и ключи — проверьте, кому доступно подключение и какое сейчас действует. Подробности — в «Ключи доступа (секреты)» и «Группы настроек (подключения)» ниже.
• «Способ подключения» — у платных навыков, которые работают и через Искру, и по вашему ключу: выбор между «Через Искру» и «Свой ключ». Подробности — в разделе «Способ подключения».
• «Работа навыка» — «Подтверждение» с настройкой «Спрашивать каждый раз», а у копии и установки из каталога — «Автообновление» и «Версия». Установка из каталога позволяет обновиться, дать нужное новой версии согласие или вернуться к одной из трёх последних установленных версий. Отозванные версии недоступны. Для своего навыка и копии есть «История версий». Версией и автообновлением установки организации управляют её владелец и администраторы; участник видит эти настройки только для чтения.
• «Доступность группам» — владелец или администратор выбирает группы и нажимает «Сохранить». Пустой выбор открывает навык всей организации. Блок доступен при включённом каталоге навыков.

Содержимое

В «Составе» можно выбрать:

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

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

У своего навыка или копии нажмите «Изменить» для нужного текстового файла. Можно править несколько файлов: «Сохранить» отправляет их одной новой версией на проверку, а до её одобрения работает прежняя. «Отменить» снимает правку выбранного файла. При уходе с несохранёнными изменениями Искра предложит остаться или отказаться от них. Если текущая версия успела измениться либо другая версия ещё проверяется, сохранение не пройдёт; введённый текст останется.

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

«Как устроен навык» даёт составленное ИИ объяснение по файлам версии: назначение, состав, подтверждаемые действия, внешние обращения и хранение. Оно сохраняется для всех, кому виден навык, и переводится на язык интерфейса. С вашего баланса МТ не списываются. Создать можно до 10 новых описаний в час; переводы лимит не расходуют. При ошибке перевода повтор доступен через несколько минут. Без исходников объяснение недоступно. Это пересказ, а не проверка безопасности: для важных данных изучите также исходный код.

Статус модерации

Если навык или его новая версия ещё проверяется, на карточке стоит значок «На модерации», а в его подсказке указаны версия и этап: версия на модерации или уже одобрена и публикуется. Клик по карточке новой, ещё не опубликованной заявки открывает «Мои заявки» нужного профиля — там виден подробный этап или причина отказа; у отклонённой заявки и у заявки, сборка которой не удалась, значка на карточке нет. У обновления уже опубликованного навыка прежняя версия продолжает работать до успешной публикации новой. Чтобы открыть статус такого обновления, нажмите значок «На модерации» на карточке или ссылку рядом со статусом на странице навыка; клик мимо значка по-прежнему открывает сам навык.

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

Переписка по заявке

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

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

Первым в переписке показан ваш комментарий к заявке, если вы его оставили. Вопрос проверяющего приходит уведомлением — оно открывает навык сразу на переписке — и появляется с подписью «Модератор» или «Владелец организации»: имя проверяющего не показывается. Ответ пишется в поле «Ответить проверяющему…»; проверяющий получает уведомление. Сообщение — до 2000 знаков, в одной заявке — до 50 сообщений.

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

Если навык удалили, пока заявка ждала решения, заявка закрывается сама с пометкой «навык удалён»; когда навык удалили не вы, об этом придёт уведомление.

Копия навыка

Чтобы изменить под себя навык, который править нельзя, — встроенный, из каталога, навык организации, — сделайте его копию. Копировать можно и свой навык, и другую копию.

1. На странице навыка нажмите кнопку-значок «Сделать копию» справа от переключателя режима.
2. В окне укажите «Название» и «Имя для чата» — строчными латинскими буквами и цифрами, можно с дефисом и подчёркиванием. Если имя занято, окно предложит свободное («Взять …»). Имя, которое уже было у вашего навыка, — даже удалённого, — повторно не выдаётся.
3. Владелец и администратор организации выбирают «Куда»: «Мои навыки» или «Организация «…»». У участника копия всегда личная.
4. Проверьте список «Что перенесётся» и нажмите «Сделать копию».

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

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

Копия — отдельный навык со своим именем, ключами и настройками; на её карточке значок «Копия навыка «…»» называет источник. Копия расходует лимит в 50 своих навыков (у личных — профиля, у копий организации — организации). Копия нашего навыка сохраняет его особые возможности, например навык почты прикладывает файлы из чата, — пока файлы копии правит только её хозяин; в окне такие возможности перечислены в «Что перенесётся». Ограничения оригинала действуют всегда. Служебные навыки и навыки на ключе платформы не копируются.

Версии своего навыка и копии

Каждое сохранение своего навыка или копии — новая версия. «История версий» в строке «Версия» вкладки «Настройки» раскрывает таблицу: версия, изменение («Создана копия», «Обновление из источника», «Правка: <файлы>», «Откат к версии N»), основа (у копии — версия источника), кто (вы, другой человек или «Автоматически»), когда и статус: «Текущая», «На проверке», «Отклонена ИИ» и «Отклонена модератором» с кнопкой «Причина», которая раскрывает причину отказа, «Отозвана» с той же кнопкой — она раскрывает причину отзыва, «Не создана» (сборка или запись версии не удались). У прежней опубликованной версии вместо статуса — кнопка «Откатить». На узком экране столбцы «Основа» и «Кто» скрыты, чтобы статус и кнопки строки помещались без прокрутки.

«Откатить» у опубликованной версии создаёт новую версию со старым содержимым — «Создана версия N с содержимым версии M»: история не теряется, проверка не нужна. Отклонённую, не созданную и отозванную версию выбрать нельзя. Параметры не версионируются: если старой версии нужны другие поля, навык покажет «Требует настройки».

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

Новая версия источника. Когда у навыка, из которого сделана копия, выходит новая версия, на вкладке «Содержимое» копии появляется баннер «Вышла <источник> <версия>»:

• «Что изменилось» показывает разницу версий источника по файлам: каждый отмечен «добавлен», «удалён» или «изменён»; двоичные файлы и файлы больше 256 КиБ не сравниваются;
• «Обновить» делает новую версию копии с содержимым новой версии источника (ваши правки остаются в истории);
• «Обновить с моими правками» открывает чат, где Искра переносит ваши правки на новую версию, — это обычная правка с проверкой. Кнопка есть, когда на платформе доступно управление навыками из чата.

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

Отзыв версии

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

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

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

Подсказка «Управляйте навыками из чата»

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

Создавая текстовый навык в чате или обновляя его — в чате либо в разделе Навыки, — описывайте нужную возможность обычными словами. Если в инструкции указано служебное имя инструмента другого навыка вида skill__имя-навыка__имя-инструмента, Искра остановит создание или обновление и попросит убрать такую ссылку. Опишите назначение нужной возможности словами и укажите, что во время работы следует найти подходящую возможность.

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

Окно появляется при каждом входе в раздел, пока вы не поставите галочку «Больше не показывать»; выбор запоминается в текущем браузере, поэтому на другом устройстве подсказка появится снова. Закрыть окно без галочки можно кнопкой «Понятно», крестиком или клавишей Esc.

Режимы работы

Режим меняется на странице навыка и применяется сразу. Он определяет, когда навык подключается к задаче; режим «Авто» сам по себе не снимает подтверждения записи или отправки:

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

Для фоновых навыков доступны только «Выкл» и «Авто»: фоновую работу нельзя включить только для ручного вызова. Иногда часть положений переключателя недоступна из-за политики администратора.

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

Навык, которому для работы не хватает настройки, всё равно виден в слэш-меню и окне добавления навыка с пометкой «не настроен»: он не скрывается из списка — просто при вызове Искра сама объяснит, какие данные нужны, и предложит их заполнить.

Явный вызов остаётся видимым и после отправки: в тексте сообщения сохраняется /название, а под сообщением показывается чип навыка. Скопированное сообщение переносит вызов и закрепляет навык при вставке в поле ввода, а удаление /токена при редактировании сообщения снимает навык (подробнее — «Выбор навыка или сценария» в описании чата).

Когда действует инструкция текстового навыка

В обычной беседе путь от установки до результата такой:

1. Установите навык или найдите уже доступный в «Моих навыках»; заполните нужные подключения в его «Настройках».
2. Выберите «Авто», чтобы Искра подбирала навык по задаче, либо добавьте его явно через «Навыки беседы» → «Добавить навык» или меню /. Для явного выбора подходит и режим «По команде».
3. Искра получает текст инструкции, когда вызывает текстовый навык, затем использует его при работе над запросом. Получение инструкции ещё не означает, что описанные в ней чтение, расчёт, запись или отправка уже выполнены: результат проверяйте по ответу, файлам и статусам действий.

Одна установка не добавляет инструкцию заранее во все разговоры. «Авто» выбирает навык для запроса; запуск по расписанию задаётся отдельно в «Планах».

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

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

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

Часть навыков перед действием показывает готовый черновик и ждёт вашего подтверждения: почта — письмо с адресатом, темой и текстом, MAX и Telegram — сообщение с точным чатом, календарь — собранную встречу, Google Drive — правку или удаление файла, CRM — готовую сделку или задачу, рассылки — подготовленную кампанию. Для навыков, где доступно предварительное разрешение, готовые подтверждающие формы можно выполнять без нового нажатия.

На странице навыка откройте вкладку «Настройки» — в блоке «Работа навыка» есть строка «Подтверждение» с переключателем «Спрашивать каждый раз»:

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

Выбор действует только для вашего профиля и только для этого навыка. Он распространяется и на запуски по расписанию: готовое подтверждаемое действие может выполниться без вас. Это отдельное разрешение от режима выбора «Авто».

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

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

Журнал запусков

Кнопка «Журнал запусков» над вкладками открывает журнал — историю вызовов ваших навыков со статусом (успех, ошибка, таймаут, отмена), временем и тем, какой навык вызывался. Список можно отфильтровать по статусу и по конкретному навыку; клик по строке разворачивает подробности запуска. Заголовок экрана — «Навыки › Журнал запусков»: нажмите «Навыки», чтобы вернуться к списку.

Ручной запуск

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

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

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

Встроенные навыки

Базовые встроенные навыки, например погода и перевод величин, обычно готовы без личных ключей и доступны в секции «Системные». Многие интеграции Искры устанавливаются из «Каталога», когда он включён. Если каталог отключён, часть интеграций может быть доступна как системные навыки в режиме «По команде». «Telegram — личный аккаунт» и Plaud требуют установки из каталога.

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

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

Способ подключения

У четырёх платных навыков — «Нейросети для медиа», «Внешняя модель», Reputation.ru и 2ГИС — два способа подключения. Выбор находится на странице навыка: «Настройки» → блок «Способ подключения».

По умолчанию выбран «Через Искру». Обычный расход МТ на работу самой Искры действует при любом способе.

• Личный ключ. При выборе «Свой ключ» под вариантом появляется поле: «Ваш ключ OpenRouter», «Ваш ключ Reputation.ru» или «Ваш ключ API 2ГИС». Выбор можно сохранить и без ключа — под полем будет написано «Ключ не задан: навык попросит его при первом вызове». Тогда при первом обращении навык откроет защищённую форму и продолжит после ввода ключа; ключ Искры вместо вашего он не использует. Ключ вводите только в форме, не сообщением в чат. Изменения сохраняет кнопка «Сохранить» внизу окна настроек.
• Способ выбираете вы. Переключить способ можно только в настройках навыка. Если навык попросил ключ, Искра предложит открыть форму ключа, а способ оставит прежним.
• Режим не меняет способ. «Выкл», «По команде» и «Авто» способ не затрагивают: после выключения и повторного включения навык работает с тем же способом.
• Организация. Владелец или администратор организации может выбрать способ для всех в строке «Кому доступно» → «Всей организации «…»». При «Своём ключе» для организации каждый участник вводит свой ключ: общего ключа нет. Участник видит выбор организации только для чтения и может задать свой способ кнопкой «Подключить своё»; поле своего ключа доступно ему всегда. Если организацию вернут на «Через Искру», вместе с ней перейдут все, кто не выбирал способ сам; сохранённые ключи участников остаются.
• Ключ Искры не настроен. При «Через Искру» навык ответит, что ключ Искры не задан: обратитесь к администратору или выберите «Свой ключ».
• Если вы пользовались навыком «… (свой ключ)». Отдельных карточек со своим ключом больше нет. Тем, у кого была такая установка, уже выбран «Свой ключ» на том же уровне — лично или для организации. Ключ нужно один раз ввести заново: форма откроется при первом вызове. Модели и режим работы берутся из настроек обычного навыка. Если навык оказался выключен, включите его — способ «Свой ключ» уже выбран.

Как выбрать навык под задачу

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

Погода

Текущая погода и прогноз на 1–7 дней по названию города.

Примеры запросов:

• «какая погода в Москве»
• «прогноз на 5 дней в Питере»
• «будет ли дождь завтра в Казани»

Валюты

Курсы валют по данным ЦБ РФ и конвертация суммы между валютами.

Примеры запросов:

• «курс юаня»
• «переведи 100 долларов в евро»
• «сколько сейчас стоит доллар»

Даты

Разница между датами в днях, сдвиг даты на N дней вперёд или назад, подсчёт рабочих, выходных и праздничных дней в диапазоне по производственному календарю РФ.

Примеры запросов:

• «сколько рабочих дней до конца месяца»
• «какой день недели через 90 дней»
• «сколько дней между 1 января и 9 мая»

Википедия

Поиск статей в Википедии и краткая сводка по заголовку статьи. Поддерживаются русский и английский языки.

Примеры запросов:

• «найди в Википедии Кватернион»
• «краткая сводка по статье Фотосинтез»
• «что Википедия пишет про Тьюринга»

Единицы измерения

Конвертер величин: длина, масса, температура, объём, площадь, скорость, объём данных и время. Категорию Искра определяет автоматически.

Примеры запросов:

• «переведи 5 км в мили»
• «сколько это 100 градусов по Фаренгейту в Цельсии»
• «100 мегабайт в гигабайтах»

Справочник DaData

Попросите проверить российский почтовый адрес, найти организацию или ИП по точному ИНН/ОГРН либо банк по БИК. Поиск компании по названию этот навык не выполняет. Для адреса он возвращает подходящие варианты; проверьте, что выбран именно нужный дом или помещение.

Ключ DaData задаёт администратор платформы. Адреса и идентификаторы из запроса передаются внешнему сервису DaData; доступность и квота зависят от этого подключения. Установка навыка сама по себе не создаёт ключ.

Аналитика организации

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

Чертежи и схемы

Навык создаёт редактируемые чертежи и схемы в HTML с векторной графикой и готовит PDF по запросу. Примеры задач и требования к исходным данным — в руководстве по чертежам.

Работа с PDF

Навык /pdf читает, создаёт и изменяет PDF: извлекает текст, таблицы и изображения, объединяет и разделяет страницы, поворачивает и обрезает их, заполняет интерактивные и плоские формы, распознаёт сканы на русском и английском языках, добавляет водяные знаки и защищает файл паролем. Для работы достаточно приложить документ и описать желаемый результат; отдельные ключи и настройки не нужны.

Искра сохраняет исходный файл и по умолчанию создаёт отдельный результат. Перед выдачей она повторно открывает готовый PDF и просматривает нужные страницы как изображения. Обычный просмотр страниц не добавляет PNG-файлы в черновики; изображения сохраняются отдельно, когда они нужны как результат. Просмотр отдельной страницы доступен и для большого PDF в пределах допустимого размера загрузки; вручную выделять страницу в другой файл для этого не требуется. Для таблицы можно попросить CSV или JSON, а если нужен XLSX — прямо указать это в запросе.

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

Примеры запросов:

• «извлеки таблицу из этого PDF и сохрани её в XLSX, не потеряй ведущие нули»
• «заполни поля формы и сохрани новый PDF»
• «распознай русский и английский текст на скане»
• «объедини эти PDF, поставь пароль и проверь готовый файл»

Сложный PDF может содержать нестандартные шрифты, повреждённые объекты или макет, который нельзя точно восстановить в редактируемом документе. В таком случае Искра сообщает, что удалось проверить, и не обещает точного PDF→Word-преобразования или сохранения произвольного чертежа. Прямой конвертации PDF → DOCX нет: Искра может извлечь текст и собрать новый DOCX без гарантии исходной вёрстки.

Схемы бизнес-процессов BPMN

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

Чтобы изменить готовую схему, назовите в сообщении BPMN или файл .bpmn, например: «В request.bpmn переименуй шаг „Проверить заявку“ в „Уточнить заявку“ и сохрани копию в папке processes». Просить сам навык не нужно. Исходный файл остаётся без изменений, исправленная копия приходит ссылкой.

Чтобы посмотреть схему, откройте Файлы в чате и нажмите на .bpmn или .bpmn20.xml; так же работает ссылка на файл в сообщении. Схему можно перетаскивать, увеличивать кнопками + / − и вписать в окно. Если в файле несколько диаграмм, выберите нужную в списке. Вкладка Исходник показывает XML, а скачивание сохраняет оригинальный файл. Просмотр не редактирует схему и не заменяет проверку её соответствия поручению. Для просмотра нужен файл до 2 МиБ с графическим представлением; при ошибке файл можно скачать.

Перед выдачей навык предусматривает проверку структуры файла, просмотр всех частей схемы и сверку с поручением; просьба, в которой названы BPMN или файл .bpmn, рассчитана на этот порядок. При неподдерживаемой конструкции или недоступной проверке Искра должна объяснить, какой результат не удалось подготовить, и оставить ваши файлы как есть. Для нескольких схем результат каждой указывается отдельно. DMN — другой формат; этот навык его не создаёт. Для вопроса о нотации можно попросить объяснение без создания файла.

Word, PowerPoint и Excel

Три встроенных навыка отвечают за редактируемые файлы Microsoft Office: Word — за DOCX и его шаблонные или macro-enabled варианты, PowerPoint — за PPTX и родственные варианты, Excel — за XLSX и родственные варианты. Обычно выбирать их вручную не нужно: Искра подключает нужный навык, когда формат назван в запросе или приложен соответствующий файл.

Каждый навык содержит готовые рецепты для создания и изменения своего формата. Работа идёт локально в изолированной среде: сначала создаётся кандидат, затем проверяется структура и содержимое. Word просматривается постранично, PowerPoint — по всем слайдам, Excel с формулами пересчитывается и проверяется на ошибки; ключевые листы также просматриваются. После проверки результат появляется как обычный файл чата или новая версия существующего файла.

Для правки Искра сохраняет точный тип и путь исходного файла. Macro-enabled и шаблонные варианты требуют донора того же типа, чтобы не потерять макросы, связи и назначение шаблона. Если такого донора нет, Искра предложит основной формат DOCX, PPTX или XLSX либо попросит приложить подходящий файл.

На on-prem-установке активный корпоративный DOCX- или PPTX-шаблон доступен только соответствующему навыку и только для чтения. Он служит основой нового файла, а не изменяется вместе с ним.

LibreOffice и старые форматы

Навык LibreOffice и старые форматы выбирает штатный маршрут для OpenDocument и прежних форматов Microsoft Office: ODT/ODS/ODP/ODG и их варианты, DOC/DOT/RTF, XLS/XLT, PPT/POT/PPS. Он создаёт, изменяет или преобразует файл через LibreOffice и проверяет результат средствами выбранного семейства. Если преобразование даёт DOCX, PPTX или XLSX, итог затем проверяет соответствующий навык современного формата.

Презентации

Для презентации с движением во времени выберите отдельный навык «Анимированные презентации» (/motion-slides). Он создаёт экранный HTML на Slidev. Движение раскрывает мысль во времени: например, задача проходит этапы работы агента, данные превращаются в результат или объекты меняются местами при сравнении. Движение показывает связанные действия и их последствия. В сценах процессов работа может продолжаться, пока слайд открыт: например, следующие запросы проходят через систему. Достаточно описать тему и цель: Искра сама выбирает визуальную идею, композиции и постановку движения. Можно указать аудиторию, стиль или приложить референс.

Подготовку и промежуточные версии Искра ведёт в Черновиках; в файлах беседы появляется готовая презентация. При доработке она обновляет тот же HTML. Результат — готовый HTML для показа и дальнейших правок. Искра проверяет готовый результат и исправляет видимые проблемы. В preview библиотеки загружаются с платформы; скачанный HTML использует CDN и требует доступа к ним. Для обновления в той же беседе достаточно описать правку; в новой беседе приложите тот же HTML. При необходимости можно попросить архив готовой презентации. PDF для этого навыка пока не входит в результат. Для обычной презентации или печатного PDF используйте «Презентации», для PowerPoint — /pptx.

Попросите /slides подготовить или обновить HTML-презентацию. Укажите цель, аудиторию, длительность или число слайдов и приложите исходные материалы. Стиль можно описать словами или показать образцом: Искра подберёт композицию, цвета, шрифты с кириллицей и китайским, навигацию. Без отдельного пожелания используется оформление Искры с контрастным фоном и тёплым акцентом. Выбирать шаблон заранее не нужно; недостающие для работы сведения Искра уточнит. Результат — редактируемый HTML, PDF готовится по явному запросу; PPTX этот навык не создаёт. Скачанному интерактивному HTML нужен интернет для библиотек.

Например:

• «Сделай презентацию для десятиминутного выступления по этому документу».
• «Переработай эту HTML-презентацию для самостоятельного чтения».
• «Подготовь интерактивную презентацию и отдельную версию для печати с PDF».

Выбрать формат презентации

Интерактивный HTML — основной результат, если вы не попросили печать или PDF. По умолчанию это широкоформатные слайды с кнопками и клавиатурной навигацией. Можно попросить вертикальные слайды, прокрутку, оглавление, другую панель переключения, фильтры, сравнение периодов или раскрытие подробностей. Анимации и интерактивность не обещают точного повторения в PDF.

HTML для PDF — отдельная статическая версия. Каждый слайд занимает страницу 16:9; значения, подписи, примечания и визуалы доступны без анимации и JavaScript. Большой материал делится на дополнительные страницы с читаемым текстом. Вы получаете исходный HTML и PDF, экспортированный из него. Оба варианта — интерактивный и печатный — создаются, если вы попросили оба. PDF, приложенный как источник, сам по себе не означает запрос печати. Навык не создаёт PPTX.

Каждый вариант сохраняется отдельным редактируемым HTML-файлом. Скачанной интерактивной презентации нужен интернет: шрифты, иконки, графики и навигация загружаются из CDN. В новых файлах используются Reveal.js и иконки Lucide; прежние файлы сохраняют своё оформление и навигацию. HTML можно снова приложить в Искру для правки.

Обновить презентацию и проверить результат

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

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

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

Диаграммы и дашборды (dashboard)

Навык /dashboard создаёт и обновляет интерактивные HTML-файлы. При создании он выбирает форму по задаче:

• одну визуализацию наблюдений, сравнений, временных рядов, распределений, иерархий или потоков — diagram.html;
• календарный план работ в форме диаграммы Ганта или сеть зависимостей «работы в узлах» (AoN) — planning-diagram.html;
• аналитическую панель из нескольких связанных представлений, KPI, таблиц и фильтров — dashboard.html.

Приложите данные и назовите вопрос, на который должен отвечать график. Обычная диаграмма сопровождается точной таблицей; дашборд объединяет показатели и фильтры. Структура и оформление подбираются по задаче — готовую тему выбирать не нужно. Указанный вами стиль сохраняется и при правках. Широкие таблицы прокручиваются внутри панели, связанные числа и единицы измерения сохраняются вместе.

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

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

В planning-режиме явно названная форма имеет приоритет. Без явного выбора Искра использует Гант для плана с календарными датами, фазами и вехами, а AoN — для порядка работ и направленных зависимостей без календарной шкалы. Если обе формы подходят одинаково или для Ганта не хватает дат либо длительностей, Искра задаёт один уточняющий вопрос до создания файла. В датированном Ганте она также сверяет календарные endpoints связей FS/SS/FF/SF; противоречивые даты или связь уточняются у пользователя без автоматического переноса работ.

Planning-диаграмма отображает предоставленные работы, вехи, иерархию и связи FS/SS/FF/SF с lag. Автоматический расчёт CPM, критического пути, резервов, рабочих календарей и праздников, выравнивание ресурсов и расчёт трудозатрат в этот результат не входят. Такие значения можно показать как факты из исходных данных с явной подписью. Это граница готового сценария диаграммы, а не вычислений вообще: CPM, критический путь и резервы можно отдельно поручить Искре рассчитать в Python по работам, длительностям и связям — попросите перечислить принятые допущения и проверить результат. Для AoA, циклограммы или точного календарного расчёта по месяцам и годам Искра сначала объяснит ограничение и предложит Гант или AoN.

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

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

Правки видны в том же файле ещё во время работы. Если файл изменился во время доработки, Искра учитывает его текущую версию. Если проверка или работа прервана, остаётся последняя записанная версия, прежние доступны в истории. Само наличие файла не означает завершённую проверку — учитывайте итоговый статус и замечания. Результат — интерактивный HTML, отдельный PDF автоматически не создаётся. При запросе PDF для Ганта или AoN Искра объяснит ограничение и предложит доступный интерактивный вариант для вашего решения.

Примеры запросов:

• «покажи одним графиком динамику выручки и маржи по месяцам»
• «построй диаграмму Ганта по этим работам, датам и зависимостям»
• «покажи сеть AoN: дизайн → разработка FS, разработка → тестирование SS+2 дня»
• «сделай дашборд продаж с фильтрами по региону и периоду, KPI и таблицей»
• «добавь в этот дашборд фильтр по менеджеру, сохрани оформление и имя файла»
• «обнови эту диаграмму: добавь август и сохрани остальные данные»

Оформление и шрифты (fonts) диаграмм и дашбордов

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

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

• Golos Text — нейтральный интерфейс, аналитика, основной текст;
• Exo 2 — научная и технологичная подача;
• Unbounded — короткий футуристический display-акцент;
• Jura — цифровая геометрия и приборные панели;
• JetBrains Mono — код, числа и технические значения;
• Pixelify Sans — игровая и пиксельная эстетика;
• Old Standard TT — историческая и архивная подача;
• Cormorant Garamond — редакционная, музейная и литературная подача;
• Poiret One — ар-деко и конструктивистские заголовки;
• Neucha — короткий рукописный акцент.

Шрифты и библиотеку графиков браузер загружает из CDN, когда файл открыт вне Искры, — для этого нужен доступ к Интернету. Внутри Искры те же известные ресурсы берутся из вашего контура. Ранее созданные файлы продолжают открываться с прежними шрифтами.

Генерация изображений

Создаёт от одного до четырёх отдельных растровых изображений по текстовому описанию; без указания количества — одно. Несколько вариантов одного задания получают одинаковое описание и могут быть похожи. Если нужны разные картинки, опишите отдельно, что должно быть в каждой: Искра выполнит самостоятельную генерацию для каждого задания. Два объекта на одной картинке и две отдельные картинки — разные запросы. Это же правило действует для разных правок, видеороликов и аудиофайлов: каждой работе соответствуют свои исходники и настройки. Готовность одного файла не отменяет остальные заказанные результаты; подходящие готовые файлы сохраняются при уточнении оставшихся. Для новой композиции можно приложить до пяти картинок и объяснить роль каждой: например, товар на первой, стиль на второй. Для изменения существующей картинки можно приложить PNG/JPEG/WebP/GIF либо сослаться на файл текущего чата: навык добавит, удалит или заменит объекты, изменит фон, детали или стиль и сохранит результат новой копией. К основе можно добавить до четырёх референсов; всего — до пяти изображений и до 10 МиБ суммарно. Картинки можно брать из рабочей папки и из Черновиков этого чата. Исходные файлы не меняются. Если часть вариантов не удалась, готовые остаются доступными: Искра покажет их и объяснит, что не завершено. Успешные варианты автоматически повторно не генерируются. Для локальной правки назовите область, нужное изменение и то, что сохранить вокруг. Если граница допускает разные результаты, Искра уточнит её. Редактирование выполняется без маски, поэтому точное пиксель-в-пиксель сохранение остальных областей не гарантируется. Результат сохраняется в файлы сессии и обязательно показывается в ответе.

Примеры запросов:

• «нарисуй минималистичный постер ночного города в синих тонах»
• «стилизуй приложенную фотографию под акварель, сохрани композицию»
• «создай квадратную иллюстрацию робота-садовника для обложки»
• «сделай три варианта афиши: товар возьми с первой картинки, стиль — со второй»

При способе «Через Искру» стоимость генерации списывается в МТ по фактической цене, при «Своём ключе» её оплачивает ваш аккаунт OpenRouter. Навык доступен, когда подключение к генерации настроено для вашей инсталляции. Описание и референсы получает внешний провайдер, в том числе при включённом Антониме.

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

Выбрать модель и параметры изображения

Назовите модель в запросе, чтобы применить её только к этой генерации или правке. Следующий запрос без указания модели использует сохранённую настройку. Искра подбирает варианты по назначению и возможностям: языкам, стилю, доступным параметрам и ограничениям. Для постоянной замены попросите сохранить модель либо откройте настройки навыка: раздел «Модель изображений» → «Выбрать модель». Форму сохраняете вы; эта настройка действует для следующих запросов, пока вы её не смените.

Готовые медиа сопровождаются коротким описанием. Параметры и фактический расход можно запросить отдельно; о необходимости проверки администратором Искра сообщит в ответе.

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

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

Если изображение не получено или готова только часть

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

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

Улучшение качества фото

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

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

Примеры запросов:

• «вырежи нижний ряд плат и сделай его чётче, чтобы маркировка читалась»
• «старое фото бабушки совсем зернистое — можно улучшить?»
• «улучши качество без изменения самого фото»

Генерация видео

Создаёт короткое видео по текстовому описанию. Можно задать первый кадр или пару «первый и последний кадр» из файлов текущего чата. Другой вариант — до трёх референсов объекта или стиля, если модель поддерживает этот режим. Кадры и обычные референсы используются в разных запросах; последний кадр задаётся вместе с первым. Суммарный размер входных изображений — до 10 МиБ. Готовое видео появляется ссылкой в ответе и воспроизводится встроенным плеером на панели артефактов.

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

Примеры запросов:

• «сделай короткое видео котёнка, играющего с клубком»
• «оживи приложенную фотографию: лёгкое движение облаков и воды»
• «сделай переход от первой картинки ко второй за пять секунд»

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

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

Озвучка текста

Генерирует речь по тексту и сохраняет её в файлах сессии: Gemini — в WAV, остальные модели — в MP3. В ответе появляется ссылка, которую можно проиграть встроенным плеером на панели артефактов. За один вызов Gemini принимает до 1000 символов, остальные модели — до 4000. Для длинного текста Искра предложит смысловые части; каждая часть будет отдельной платной генерацией.

Примеры запросов:

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

При способе «Через Искру» стоимость озвучки списывается в МТ по фактической цене провайдера. При ошибке после отправки он мог уже выполнить работу; повтор будет отдельной платной попыткой.

Настроить подачу и озвучить по образцу

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

• Gemini 3.1 Flash TTS, Fish S2 Pro и Fish S2.1 Pro (включая Free) принимают краткие пожелания к темпу, эмоции и интонации. Искра переведёт только пожелание в короткую английскую фразу — до 200 символов в одной строке. Сам текст останется на исходном языке. Это просьба к модели, поэтому точная интонация не гарантируется.
• MAI-Voice-2 поддерживает настройку скорости от 0,5 до 2: например, «начитай со скоростью 0,8». Отдельные стили и инструкции об эмоциях в этой интеграции пока не подтверждены.

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

Для озвучки по образцу приложите MP3, WAV, FLAC, OGG или M4A до 10 МиБ и укажите нужный файл. Можно добавить текст, произнесённый в образце. Образец используется в этом запросе и не создаёт постоянный голосовой профиль. Исходный файл сохраняется без изменений. Лимит текста остаётся прежним: до 1000 символов у Gemini и до 4000 у остальных моделей; длинный текст делится на отдельные платные генерации. При потерянном ответе провайдер мог уже выполнить работу — новая попытка требует отдельного решения.

Выбрать голос и модель озвучки

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

Если озвучка звучит не так, как нужно — неразборчиво, с акцентом или не на том языке, — скажите об этом ассистенту: он покажет другие модели озвучки из каталога и применит выбранную модель к одной озвучке. Чтобы изменить постоянную настройку, попросите сохранить модель: откроется форма, которую сохраняете вы сами. Она действует до следующей смены. Отдельного параметра языка у озвучки нет: язык определяет сама модель по тексту, поэтому для другого языка нужна мультиязычная модель — ориентируйтесь на её описание в каталоге. Голос принадлежит своей модели: при смене модели совместимый голос сохраняется. Если каталог исключает прежний голос или новая модель есть в каталоге, но не публикует список голосов, форма переключает прежний голос на «Автоматически». Сбой загрузки каталога сам по себе голос не стирает. Конкретный голос можно выбрать в той же форме. Если у этой же модели уже вручную записано имя голоса, которого нет в каталоге, форма сохраняет настройку для исправления, но навык отклонит её до генерации. Для модели без списка именованных голосов выберите «Автоматически»; для голоса по образцу используйте отдельный режим. Перед озвучкой Искра проверяет модель и голос по каталогу. Если каталог недоступен или голос несовместим, платная генерация не начинается: сначала нужно восстановить доступ к каталогу или выбрать подходящий голос. Исправление голоса сохраняет пожелания к подаче. Эти правила одинаковы при обоих способах подключения.

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

Генерация музыки

Попросите Искру создать инструментальную композицию или песню с вокалом. Опишите жанр, настроение, инструменты, темп и структуру: например, вступление, куплет, припев и завершение. Для песни можно передать свой текст; язык вокала задаётся текстом и пожеланиями. К музыкальному описанию можно приложить одно изображение как ориентир по настроению. Инструментальная композиция создаётся без текста песни. Описание и текст песни вместе — до 4000 символов.

Примеры запросов:

• «Создай спокойный инструментальный фрагмент: пианино, мягкие струнные, вечернее настроение, плавное завершение».
• «Сделай песню на русском по этому тексту, акустическая гитара и мягкий вокал; выдели куплет и припев: …».
• «Для этого раза используй Lyria 3 Clip; сохранённую модель оставь прежней».

Lyria 3 Clip рассчитана на 30-секундные фрагменты. Lyria 3 Pro подходит для песен со структурой; длительность передаётся как пожелание. Если нужен строго определённый хронометраж, укажите его отдельно: возможности выбранной модели нужно согласовать до генерации. Творческие пожелания к исполнению оцениваются по готовому результату.

Генерация доступна при настроенном подключении; при способе «Через Искру» она оплачивается в МТ по фактической стоимости провайдера. Запрос уходит внешнему сервису. Музыка появляется в обычном аудиоплеере чата, сохраняется в файлы и доступна для скачивания. Один вызов создаёт один сведённый аудиофайл. Навык запрашивает MP3, но провайдер может вернуть WAV или FLAC; фактический формат виден по расширению файла. Если нужен строго определённый формат для другого приложения, может потребоваться отдельное преобразование. Отдельные дорожки инструментов этот навык не выдаёт. Модель можно назвать для одной генерации; для постоянной замены попросите сохранить выбор или откройте «Модель музыки» в настройках навыка. Эти возможности доступны и при способе «Свой ключ». Сохранить через предложенную Искрой форму можно модель с подтверждённой поддержкой музыки. При ошибке после отправки запроса провайдер мог уже выполнить работу: сначала проверьте файлы текущего чата, а повторную генерацию запускайте отдельным решением. Это правило действует и при явном отказе сервиса или завершённом ответе без музыки. Проверки ожидающей музыкальной задачи, как у видео, у этого навыка нет.

Расшифровка аудио и видео

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

Примеры запросов:

• «расшифруй это аудио»
• «переведи голосовое в текст, язык русский»

Отдельной настройки распознавания в медиа-навыке больше нет. Лимит 10 МиБ для образца голоса не задаёт ограничений общего инструмента расшифровки.

Просьба расшифровать запись с таймкодами и говорящими выполняется платформенной транскрибацией — см. «Расшифровка аудио и видео».

Внешняя модель

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

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

Примеры запросов:

• «попроси Claude разобрать этот договор на риски, а сама сверь сроки и суммы»
• «какие модели Qwen есть в каталоге и какие из них принимают картинки»
• «дай второе мнение Gemini по приложенному отчёту, ответ — списком замечаний»

Ответ. Модель отвечает в рамках того же обращения: Искра получает полный текст ответа и сохраняет его файлом вида answer-<модель>_….md в «Файлах чата», в папке навыка. Ответ на одно задание Искра ждёт до 30 минут. Если модель оборвала ответ, например по пределу длины, Искра сообщит, что ответ неполный, и будет опираться на полученную часть. Если модель израсходовала предел длины на рассуждения и не вернула текста, Искра предложит увеличить предел, убрать его или снизить уровень рассуждений. Предел длины ответа и уровень рассуждений задаются, когда вы прямо об этом просите; уровень выбирается из поддерживаемых моделью. Без такой просьбы длину ответа ограничивает провайдер.

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

Материалы. Задание, пояснения к нему и текстовые файлы вместе — до 64 КиБ (около 32 тысяч русских символов); если материалов больше, Искра предложит оставить существенные выдержки или разделить задание на части. К заданию можно приложить до четырёх файлов чата: текст в UTF-8 (Markdown, JSON, YAML, XML, CSV, HTML, код), исходный PDF до 2 МиБ или изображение PNG, JPEG, WebP, GIF до 2 МиБ; крупное изображение уменьшается перед отправкой. Весь запрос вместе с PDF и изображениями — до 4 МиБ. Изображения передаются модели, которая их принимает. PDF передаётся в OpenRouter исходным файлом; OpenRouter выбирает нативную обработку или разбор PDF. Остальные документы, аудио и видео Искра сначала переводит в текст своими инструментами и передаёт текстом. Поиска в интернете у внешней модели нет: нужные сведения Искра может найти своим поиском и передать модели как материал.

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

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

Внешний провайдер. Задание и материалы получает внешний провайдер. При включённом приватном режиме «Антоним» способ «Через Искру» недоступен. «Свой ключ» этим режимом не останавливается: задание уходит провайдеру и при включённом Антониме.

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

• Обращение остановилось или Искра потеряла с ним связь: истекли 30 минут, обращение отменили, случился сбой внутри сервиса. Ответ мог успеть сохраниться до остановки, а если обращение ещё идёт — сохраниться позже, в пределах 30 минут от его начала. Поэтому Искра сначала смотрит «Файлы чата» — файл answer-<модель>_… в папке навыка — и, если ответ там есть, продолжает работу с ним. Если его нет, она проверит ещё раз, прежде чем предлагать новую попытку.
• Оборвалась связь с провайдером или он ответил ошибкой, по которой не понять, выполнена ли работа. Ответ этого обращения не сохранён, и Искра так и скажет.

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

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

Отмена обращения. Кнопка «отменить» (✕) на карточке работающего навыка прерывает обращение на стороне Искры: у провайдера запрос не отменяется, а новый ответ этого обращения уже не придёт. Если модель успела ответить до отмены, ответ может уже лежать в «Файлах чата» — Искра проверит это. МТ без подтверждённой провайдером стоимости не списываются.

Поиск судебной практики Reputation.ru

Навык ищет арбитражные дела, дела судов общей юрисдикции и решения Верховного Суда РФ, получает тексты найденных документов и запускает глубокий анализ практики. При способе «Через Искру» корпоративный API-ключ задаёт администратор, а стоимость внешних запросов переводится в МТ; при «Своём ключе» запросы оплачивает ваш аккаунт Reputation.ru. Запрос пользователя передаётся Reputation.ru. Возможности, тарификация и способы подключения описаны в отдельном разделе.

Карты и маршруты 2ГИС

Навык находит адреса и организации, ищет места рядом, строит маршруты с учётом пробок и зоны доступности по данным 2ГИС и прикладывает картинку карты. При способе «Через Искру» корпоративный ключ задаёт администратор, а стоимость запросов 2ГИС переводится в МТ; при «Своём ключе» запросы идут по вашему ключу 2ГИС. Адреса и поисковые запросы передаются 2ГИС. Возможности, стоимость и способы подключения описаны в отдельном разделе.

Датаньютон

Навык из категории «Интеграции» проверяет российских контрагентов через сервис DataNewton по вашему API-ключу: находит компанию или ИП по названию, ИНН или ОГРН, показывает карточку из ЕГРЮЛ/ЕГРИП, финансовую отчётность, риски и скоринг, арбитражные дела, госконтракты, связи, признаки банкротства и проверки. Только чтение — данные в DataNewton навык не меняет. Как получить ключ и что умеет навык, описано в отдельном разделе.

Яндекс.Метрика

Навык из категории «Данные» отвечает на вопросы о посещаемости вашего сайта по личному OAuth-токену Яндекса: счётчики, визиты и посетители за период, источники трафика, цели и конверсии. Только чтение — настройки Метрики навык не меняет. Как получить токен и что умеет навык, описано в отдельном разделе.

Яндекс Вебмастер

Навык из категории «Данные» отвечает на вопросы о сайте в поиске Яндекса по личному OAuth-токену: подтверждённые сайты, ИКС, страницы в поиске и исключённые, проблемы Вебмастера, популярные поисковые запросы с позициями и динамика показов, кликов и ИКС. Только чтение — сайты и их настройки навык не меняет. Как получить токен и что умеет навык, описано в отдельном разделе.

Wildberries Seller

Подключение работает только на чтение: получает карточки товаров, текущие остатки на складах WB и складах продавца, сборочные FBS-заказы и их текущие статусы, цены и скидки, а также предварительные оперативные продажи и возвраты за недавний период. Данные в кабинете Wildberries оно не изменяет.

Найдите Wildberries Seller в каталоге, установите и откройте навык. В форме «Wildberries — подключение только для чтения» заполните личное подключение:

1. В WB Партнёры откройте Профиль → Интеграции по API → Создать токен.
2. Выберите персональный или сервисный токен, категории Контент, Аналитика, Маркетплейс, Цены и скидки, Статистика и уровень доступа «Только чтение».
3. Вставьте значение в поле «Токен Wildberries». Если это Service token, заполните также «X-Client-Secret — только для Service token»; для персонального токена оставьте второе поле пустым.

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

Оперативные продажи и возвраты являются предварительными, доступны максимум за последние 90 дней и не заменяют бухгалтерскую сверку. Размер ответа и каждой страницы ограничен; если данных больше, попросите Искру продолжить со следующей страницы.

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

Если подключение не сработало:

• Токен не настроен — откройте защищённую форму и добавьте его.
• 401 — токен неверный, отозван или истёк; замените его.
• 402 — кабинет отклонил доступ аккаунта; проверьте доступ аккаунта и нужную категорию API.
• 403 — добавьте нужную категорию токена или проверьте права; для Service token проверьте введённый в той же форме X-Client-Secret.
• 413 — сузьте фильтр, страницу или период.
• 429 — подождите и повторите запрос.
• Временный сбой Wildberries — повторите запрос позже.

Ozon Seller

Навык подключает кабинет продавца Ozon и только читает данные: товары, остатки схем FBS, rFBS и FBP, цены, FBS- или FBO-заказы и базовые продажи за выбранный период. FBO-остатки в list_stocks не входят. Один запрос по заказам или продажам охватывает не более 31 дня; для более длинного периода попросите Искру последовательно обработать несколько окон. Страницы заказов продолжаются по курсору из предыдущего ответа. Свежие данные аналитики могут появляться в Ozon с задержкой, а дни без продаж Ozon не присылает вовсе — поэтому в ответе перечислены только те дни, по которым данные есть, а границы запрошенного периода видны отдельными полями.

Если на платформе включён каталог навыков, найдите Ozon Seller в категории «Интеграции» и установите его для личного профиля или организации. Без витрины навык остаётся доступен для явного вызова через /. В Ozon Seller откройте Настройки → API-ключи и создайте ключ с доступом к нужным данным. В форме «Ozon — подключение только для чтения» заполните два разных значения: «Client ID магазина Ozon» — числовой идентификатор рядом с ключом — и «API-ключ Ozon Seller» — само секретное значение ключа.

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

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

Если подключение не сработало:

• Ключ не настроен — откройте защищённую форму и заполните оба поля.
• ozon_auth_failed — проверьте Client ID и пересоздайте API key.
• ozon_scope_denied — выдайте ключу право на указанную операцию.
• ozon_rate_limited — подождите и повторите запрос.
• ozon_unavailable — повторите позже: API Ozon временно недоступен.
• ozon_timeout — Ozon не ответил вовремя: уменьшите размер страницы или сузьте период, повтор того же запроса обычно не помогает.
• ozon_response_too_large — ответ не помещается в безопасный размер: уменьшите размер страницы или сузьте фильтр.
• ozon_egress_blocked — запрос к Ozon запрещён настройками платформы; обратитесь к администратору, повторять запрос бесполезно.
• ozon_endpoint_missing — Ozon больше не обслуживает нужный адрес API; сообщите администратору, коннектор требует обновления.
• bad_input или ozon_bad_request — проверьте период, схему FBS/FBO, курсор и фильтры.
• ozon_provider_error — прочитайте безопасное сообщение Ozon и исправьте указанные параметры.
• ozon_response_invalid — повторите позже; если ошибка сохраняется, сообщите администратору о возможном изменении ответа Ozon.
• settings_backend_error — повторите попытку; если ошибка сохраняется, обратитесь к администратору платформы.

Если какой-то встроенный навык недоступен или его режим нельзя изменить — значит политику изменил администратор платформы.

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

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

Советник по задачам

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

Настраивать в нём нечего: ни ключей, ни параметров у навыка нет. В разделе Навыки (/skills) он показан в секции «Системные» отдельной строкой с одним переключателем. Привычного выбора «Выкл / По команде / Авто» у него нет — это не инструмент, вызвать его командой / нельзя.

Когда подсказка появляется

• Длительность автоматического периода настраивает администратор платформы — по числу ваших первых сообщений в аккаунте или по числу дней с момента регистрации. Пока администратор не менял эту настройку, действует значение по умолчанию — первые 20 ваших сообщений в аккаунте. Счёт общий на аккаунт: он не начинается заново в новом чате и не сбрасывается при переходе между личным профилем и организацией.
• Учитываются только обычные сообщения в личных чатах — и в личном профиле, и в организации. Сохранённые legacy group-chat сессии пространств (новые сообщения в них недоступны), запуск навыка кнопкой «Пуск», сценарные запуски и обращения к API без интерфейса в этот счёт не входят и подсказку не получают.
• После автоматического периода подсказка перестаёт добавляться сама. Если она нужна и дальше, включите её переключателем.

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

Созданный файл, таблица или документ подсказку не отменяют — блок остаётся обычным концом того же ответа.

Переключатель

Настройка действует на весь аккаунт — во всех ваших профилях, личном и организационных. Рядом с переключателем показана одна из трёх подписей:

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

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

Под переключателем бывают пояснения:

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

Создание навыка из чата

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

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

Как создать навык

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

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

Что рассказать при создании навыка

Начните с обычного описания своей работы. Искра поможет уточнить то, чего пока не хватает:

• Задача и получатель: «Что вы хотите делать каждый раз? Кто будет читать результат — вы, коллеги или клиент?»
• Готовый результат: «Нужен ответ в чате, документ Word или таблица Excel?»
• Материалы: «Где лежат актуальные цены и условия? Есть ли образец хорошего предложения?»
• Подключения: «Откуда брать сведения о сделке? Через какую почту отправлять согласованное письмо?»
• Проверка: «Что нужно сверить перед выдачей? Кто подтверждает отправку?»
• Кому доступен навык: «Он нужен лично вам или вашей команде?»

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

Например, можно сразу написать:

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

Структура инструкции текстового навыка

Полезную рабочую процедуру удобно описать шестью частями:

1. Когда применять: задача и признаки того, что навык подходит.
2. Что уточнить: недостающие данные, получатель и условия; известное из беседы или доступных документов Искра использует сразу.
3. Источники: подключённые сервисы и материалы, назначение каждого файла, порядок действий при недоступном или устаревшем источнике.
4. Порядок работы: шаги анализа, расчётов и подготовки результата.
5. Проверка: что сверить с исходными данными, когда привлечь отдельного помощника и как исправить его замечания.
6. Результат: формат, место сохранения и действия, которые пользователь подтверждает перед отправкой или записью во внешний сервис.

Например: «Каждый месяц сравнивай показатели сайта с предыдущим месяцем. Уточни сайт и период, получи данные из Метрики, сверь расчёты, подготовь отчёт с графиками и сохрани его в Файлы чата». Для регулярного выполнения задайте запуск в Планах; текстовый навык описывает саму работу.

Где хранить материалы навыка

Мастер из чата сохраняет текст инструкции. Короткий образец и задание проверяющему можно включить в этот текст; отдельные общие файлы передают в загруженном готовом комплекте. Материалы компании подключают из Памяти.

Папку Памяти привязывают на странице навыка: вкладка «Содержимое» → «Состав» → «Знания» → «Материалы» → «Привязать папку». Сложите нужные материалы в отдельную папку: при использовании навыка Искра сможет читать всё её содержимое. Привязка даёт чтение; для подготовки результата Искра работает с копиями документов. Для навыка организации папку привязывает владелец или администратор, а коллегам нужен доступ к её материалам.

Для каждого материала полезно объяснить назначение: «Цены бери из прайс-листа, сроки и скидки — из условий поставки, оформление — из шаблона». Если нужный документ недоступен, Искра сможет уточнить, где его взять.

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

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

Комплект с отдельными файлами загружают как готовый навык в разделе Навыки. Сохранение инструкции в мастере не привязывает папку Памяти и не добавляет такие файлы в комплект.

Как организовать проверку результата

Для важного документа можно попросить проверку отдельным помощником Искры. Дайте ему самостоятельное задание с понятными критериями. Например:

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

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

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

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

Примеры навыков и нужных материалов

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

Коммерческое предложение — amoCRM и Яндекс.Почта

• Задача: подготовить предложение по сделке «Оснащение офиса Север» на 20 рабочих мест и отправить его после согласования.
• Подключения: amoCRM для сделки и контактов; Яндекс.Почта через навык «Почта» для отправки письма.
• Материалы: папка Памяти «Продажи» с прайс-листом Excel, условиями поставки и шаблоном КП в Word; состав заказа — в сообщении пользователя.
• Результат и проверка: расчёт и первый вариант в Черновиках; отдельный помощник сверяет цены, состав заказа и условия. Готовый Word — в «Файлах чата». Перед отправкой пользователь подтверждает получателя, письмо и вложение.

Отчёт о сайте — Яндекс.Метрика

• Задача: сравнить два месяца по выбранному сайту и показать, как изменились посещаемость и доля заявок.
• Подключение: Яндекс.Метрика; в запросе нужно назвать сайт, месяцы и год.
• Материалы: папка Памяти «Аналитика сайта» с описанием того, что считать заявкой, календарём рекламных кампаний и прошлым отчётом как образцом.
• Результат и проверка: расчёты в Черновиках, готовый отчёт с графиками в «Файлах чата». Помощник сверяет периоды, числа и основания выводов.

Подготовка к встрече — Битрикс24

• Задача: подготовиться к встрече с компанией «Вектор» по продлению сервиса: вспомнить договорённости и собрать открытые вопросы.
• Подключение: Битрикс24 для сделки, контактов, комментариев и запланированных дел.
• Постоянные материалы: папка Памяти «Продления» с тарифами, правилами согласования условий и списком обязательных вопросов для встречи.
• Материалы этой беседы: действующий договор с «Вектором» и записи прошлой встречи — приложенные файлы или папка, подключённая через «@».
• Результат и проверка: краткая справка с договорённостями, открытыми вопросами и следующим шагом. Отдельный помощник сверяет договорённости с перепиской и записями, отделяет предложения от подтверждённых фактов. Искра исправляет замечания; пользователь просматривает справку перед встречей.

Ответ клиенту в стиле компании — Gmail

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

Сохранение навыка

Когда порядок работы понятен, Искра покажет готовую форму с уже заполненными полями:

• Имя — как будет называться навык.
• Когда применять — описание, по которому Искра решит, что навык подходит к запросу.
• Инструкция — текст, которому ассистент будет следовать.
• Описание навыка (README.md) — рассказ для людей: что делает навык, что он умеет и что нужно для подключения. Его видно на вкладке «Обзор» карточки навыка, а первый абзац становится описанием навыка в списке и в каталоге. Ассистент составит описание сам; поле можно оставить пустым, но отправить навык в каталог без описания нельзя.
• Куда добавить — личный навык или навык организации (вариант «Организация» действует для владельца или администратора организации). Ассистент заранее отметит уровень по вашему запросу, а если из запроса он не ясен — сначала уточнит у вас. Если у вас нет организаций, этого поля нет: выбирать не из чего, уровень называть не нужно, а форма сразу показывает «Личный навык · в личном профиле. Виден только вам».

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

Приложенные файлы

Если вы приложили к чату файл (чек-лист, регламент, справочник) и просите сделать из него навык, Искра покажет судьбу каждого файла и не проигнорирует его молча. Учитываются все активные файлы, которые вы приложили в текущем чате, в том числе в предыдущих сообщениях.

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

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

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

Личный навык или навык организации

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

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

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

Текстовые и программные навыки из чата

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

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

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

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

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

Более гибкие способы (визард с параметрами, загрузка готового навыка) по-прежнему доступны в разделе Навыки — см. «Подача своего навыка» ниже.

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

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

Статус программного навыка и проверка после публикации

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

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

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

Если сборка или публикация продолжается, Искра недолго проверяет статус с паузами. Когда время ожидания заканчивается, она сообщает текущий этап и предлагает подождать около полуминуты и проверить позже. Это предложение времени следующей проверки, а не обещание готовности. Позже можно спросить «какой статус навыка …». Вы можете изменить обычное поведение, например попросить «создай навык, но пока не проверяй» или «сообщи статус без ожидания».

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

MCP

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

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

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

Проверка внешнего API. Если нужно узнать, отвечает ли публичный API по HTTPS, пришлите адрес и попросите проверить его HTTP-статус. Искра может показать фактический статус и доступную часть ответа без ключа доступа. Например, ответ 401 или 422 означает, что сервер ответил, но для самого API-запроса нужна авторизация или другие параметры.

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

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

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

Проверьте, какие навыки и элементы управления фактически доступны в разделе Навыки (/skills). Дальше используйте только показанное там действие: оно определяет доступный способ добавления или настройки в конкретной инсталляции. Если подходящего навыка или действия там нет, обратитесь к администратору платформы.

Адрес (URL) внешнего MCP — один из параметров такого подключения. Сам по себе адрес — только параметр подключения, а не готовый навык: для работы нужен программный навык с описанными инструментами и соединением. Именно такой навык Искра и собирает по ссылке — поэтому подключение всегда видно в разделе Навыки, у него есть название, состав инструментов и, если нужно, своё поле для ключа.

Подключение к внешнему MCP-серверу — всегда сетевое. Типовая локальная установка MCP-сервера — отдельный процесс со stdio (так по умолчанию ставится, например, Playwright MCP) — недоступна из пользовательского навыка: навык не может запустить локальный процесс. Для такого сервера нужен готовый поддерживаемый навык либо отдельное сетевое подключение, разрешённое администратором платформы; сама поддержка MCP при этом в Искре есть.

Доступность конкретного навыка зависит от его установки, настроек, секретов и прав текущего профиля или организации.

Настройка параметров и секретов навыка из чата

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

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

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

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

Если навыку секреты не нужны, форма сообщит об этом.

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

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

Сценарии навыков

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

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

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

Как запустить сохранённый сценарий. Есть три равнозначных способа:

• фразой в чате — например, «запусти сценарий [ВПИШИ название]»;
• из слэш-меню: начните ввод с «/», в разделе «Сценарии» выберите нужный — его имя встанет в текст, выделенное цветом (например, /отчёт-за-неделю), и сценарий применится к следующему сообщению (см. «Выбор навыка или сценария» в описании чата);
• кнопкой «В чат со сценарием» на странице навыка (/skills → карточка навыка → вкладка «Содержимое» → «Состав» → сценарий в группе «Сценарии») — она сразу открывает чат с закреплённым сценарием.

Во время выполнения сценария над полем ввода показывается живой чек-лист его шагов — подробнее в описании работы агента.

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

Управление навыками из чата

Многое из раздела «Навыки» можно сделать, не открывая страницу, — прямо попросив Искру в диалоге:

• «покажи мои навыки» — список ваших навыков с режимом и уровнем, чтобы найти нужный;
• «какие ключи и доступы я отдал навыкам» — сводка подключений по всем вашим навыкам таблицей: навык, подключение, статус («Заполнено», «Подключено», «Не заполнено», «Ошибка входа») и кому подключение доступно («Только мне» или «Вся организация»). Искра показывает только статусы: значения ключей хранятся в защищённом хранилище, и она их не видит. Для строки «Не заполнено» или «Ошибка входа» Искра предложит открыть защищённую форму настроек навыка;
• «включи навык … по команде» / «выключи навык …» — смена режима;
• «обнови навык …» — новая заявка на модерацию версии текстового навыка-инструкции прямо из диалога: Искра сначала читает актуальный текст навыка и вносит только запрошенную правку, поэтому изменения из других диалогов не теряются (для код-навыков — см. «Текстовые и программные навыки из чата» выше);
• «составь описание навыка …» — Искра прочитает навык, напишет README.md по шаблону (абзац о том, что делает навык, разделы «Что умеет» и «Что нужно для подключения») и сохранит его новой версией навыка; новая версия текстового навыка проходит модерацию, как любое обновление;
• «удали навык …» — удаление личного навыка (или навыка организации, если вы владелец или администратор), с подтверждением;
• «поделись навыком … с коллегами» — передача своего личного навыка организации, с подтверждением (см. «Передача личного навыка организации» ниже);
• «какие у меня заявки на навыки» — статус заявок на сборку и модерацию, отмена заявки;
• «какой статус навыка …» — этап заявки программного навыка и что делать дальше.

Найти и установить готовый навык с витрины, а также подать свой навык на публикацию, отозвать заявку или снять навык с витрины тоже можно прямо в диалоге — подробнее в Каталог навыков.

Готовые фразы для всех этих действий собраны в подсказке, которая появляется при входе в раздел «Навыки» (см. выше): клик по фразе сразу открывает чат с подставленным текстом.

Карточка «навык установлен / настроен»

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

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

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

Подача своего навыка

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

Текстовый навык (без кода)

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

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

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

Импорт готового навыка (из GitHub, папки или архива)

Если у вас уже есть готовый навык в формате Agent Skills (файл SKILL.md с инструкцией) — например, из открытого репозитория на GitHub — его не нужно перенабирать вручную. Выберите на лендинге подачи карточку «Импорт готового навыка» и укажите источник:

• ссылку на публичный GitHub-репозиторий — вида https://github.com/владелец/репозиторий, можно с веткой и подпапкой (.../tree/ветка/папка). Прямая ссылка на файл (.../blob/.../SKILL.md) не поддерживается;
• папку навыка с вашего компьютера;
• ZIP-архив с содержимым навыка.

Искра сама найдёт SKILL.md (или AGENTS.md/CLAUDE.md, если его нет), построит черновик текстового навыка и покажет его вам на проверку вместе с отчётом:

• Источник — для GitHub Искра показывает адрес репозитория и зафиксированный сервером commit. Для загруженного архива показывается вычисленный сервером SHA-256; имя файла и выбор «папка/архив» считаются только указанием пользователя и не подтверждают происхождение файла.
• Замечания проверки — например, найденные секрет-паттерны (такие строки автоматически заменяются на [REDACTED:secret]) или упоминания внешних адресов.
• Не импортировано — файлы, которые Искра отбросила: скрипты и исполняемые файлы, файлы с секретами (.env, ключи), а также вспомогательные файлы, которые текстовый навык не использует.

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

Правила безопасности импорта фиксированы: код из источника никогда не исполняется, секреты никогда не импортируются, приватные репозитории не поддерживаются, а размер источника ограничен 10 МБ. Если в репозитории несколько SKILL.md, Искра предложит выбрать нужный.

Программный навык с помощью ИИ (визард)

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

Загрузка готового навыка

Путь для тех, у кого уже есть готовый комплект навыка: программного или текстового с общими ресурсами. Прикрепите файл-описание manifest.yaml или manifest.yml и архив исходников source.zip, затем отправьте их на проверку. Эта форма принимает только архив исходников; OCI-образ через неё подать нельзя. Если вам нужен контейнерный навык, обратитесь к администратору платформы — такая загрузка выполняется отдельно. Если у вас только инструкция без готового комплекта, выберите способ «Текстовый навык».

Имя навыка берётся только из поля верхнего уровня bundle в manifest.yaml: от 1 до 63 символов из a–z, 0–9, _ и -, первый символ — буква или цифра. Имя в поле name или поле bundle, вложенное в другой блок, не читается. Папка внутри source.zip на имя не влияет, а название на карточке задаёт необязательное поле title. Начало манифеста выглядит так:

schema_version: 1
bundle: nubes-presentations
version: "0.1.0"

Полный каркас манифеста и исходников создаёт команда skillgen init <имя> из Skill SDK — её использует задание мастера «Программный навык с помощью ИИ».

Имена секретов (slot) должны быть уникальными: 1–64 символа из a–z, 0–9, _. При отказе исправьте указанное поле манифеста и повторите загрузку.

Отдельно загружать иконку не нужно. Чтобы на карточке было изображение, положите необязательный icon.png в корень source.zip — имя и регистр важны. Поддерживается статичный PNG ровно 128×128 пикселей размером не больше 32 КиБ; SVG, WebP, JPEG и анимация не поддерживаются. Без иконки навык можно отправить как обычно. Если файл не подходит, вся подача будет отклонена: исправьте его и отправьте снова. Сообщение ошибки: «icon.png должен быть статичным PNG 128×128 размером не больше 32 КиБ.»

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

Что происходит после подачи

Любой поданный навык проходит модерацию, прежде чем стать доступным:

1. Заявка отправляется и попадает на автоматическую проверку.
2. Если всё в порядке — навык одобряется и собирается.
3. После успешной сборки навык публикуется и появляется в каталоге.

После первой публикации личный навык получает режим «Авто». На странице «Навыки» его можно перевести в «По команде» или «Выкл».

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

Управление своими навыками

Статусы заявок

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

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

Основной каталог объединяет эти этапы в короткие статусы. Полная цепочка, причина отклонения или ошибки и действие отмены всегда доступны в разделе «Мои заявки».

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

Изредка статус «Нужна доработка (отклонено)» появляется не из-за самого навыка, а потому что публикация несколько раз подряд не проходила по техническим причинам на нашей стороне. В этом случае повторная загрузка того же файла той же версии ничего не изменит — заявка останется отклонённой. Чтобы попробовать снова, увеличьте номер версии либо измените что-нибудь в файле навыка (например, описание) и загрузите заново — так заявка пройдёт проверку с начала.

Страница своего навыка

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

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

Навыком организации так же управляют владелец и администратор организации.

Описание навыка (README.md)

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

README.md пишется по шаблону:

Абзац о том, что делает навык, — одно-два предложения.

## Что умеет

- действие обычными словами

## Что нужно для подключения

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

Правила шаблона:

• первым идёт абзац длиной до 400 символов;

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

  Язык	Первый раздел	Второй раздел
  русский	Что умеет	Что нужно для подключения
  английский	What it can do	What you need to connect
  французский	Ce qu'il sait faire	Ce qu'il faut pour le connecter
  китайский	能做什么	连接需要什么

  Во французских заголовках подойдёт и типографский апостроф (’);

• в «Что умеет» — список хотя бы из одного пункта, в «Что нужно для подключения» — хотя бы одна строка текста;

• размер файла — не больше 16 КиБ.

Описание можно перевести: положите рядом с README.md файлы README.en.md, README.fr.md или README.zh.md — по тому же шаблону, с заголовками своего языка. «Обзор» показывает перевод на языке интерфейса читателя, а если перевода нет — README.md. Описание на карточке и проверка перед публикацией берутся из README.md.

Навык без README.md работает как обычно, на карточке тогда видно описание из манифеста. Но отправить навык в каталог без README.md по шаблону нельзя: окно «Опубликовать» покажет, что исправить, а заявку без него платформа не примет. Передать навык организации можно и без README.md.

Как получить README.md:

• при создании текстового навыка в чате Искра сама предложит описание в поле «Описание навыка (README.md)» (см. «Сохранение навыка» выше);
• для готового навыка попросите в чате «составь описание навыка …» или нажмите «Составить описание» в окне «Опубликовать»: откроется чат обсуждения навыка с уже подставленной просьбой — отправьте её. Искра прочитает навык, составит README.md по шаблону и сохранит его новой версией; у текстового навыка она пройдёт модерацию, как любое обновление;
• в навыке из готового комплекта положите README.md в корень архива исходников.

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

Обновление навыка (новая версия)

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

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

Отзыв опубликованного навыка

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

Ключи доступа (секреты)

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

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

У собственного личного навыка секрет нельзя объявлять с областью org: такая подача или новая версия будет отклонена. Уберите scope — Искра выберет личный профиль — либо укажите scope: profile; если нужен общий секрет, подайте навык от организации. Если ранее опубликованный личный навык показывает эту ошибку, выпустите исправленную версию (см. «Обновление навыка» выше) — обращаться к администратору организации не нужно.

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

Значения ключей вводятся только в окне настроек или на вкладке «Настройки»: в чат их не присылают — Искра не сохранит ключ из переписки и откроет ту же форму (см. «Настройка параметров и секретов навыка из чата» выше). Какие ключи и доступы вы уже отдали навыкам, Искра покажет сводкой по просьбе «какие ключи и доступы я отдал навыкам» (см. «Управление навыками из чата» выше).

Группы настроек (подключения)

Некоторым навыкам нужно не просто ключ, а целое подключение к внешнему сервису: адрес сервера, логин, пара переключателей вроде «разрешить запись» — вместе с паролем или токеном. Такой навык показывает в окне «Настройки навыка» не один скрытый ключ, а группу настроек с понятным названием (например, «Подключение к 1С»).

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

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

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

Поля. Показываются поля только выбранного уровня — не двух сразу:

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

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

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

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

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

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

Пример навыков с группами настроек — подключение к 1С и навык AmoCRM.

Карта знаний подключения

У навыков-интеграций, поддерживающих общую карту (например, навык AmoCRM, навык «Битрикс24») на странице навыка, на вкладке «Содержимое» в группе «Знания», есть «Карта знаний» — накопленные знания о вашей системе: какие объекты и поля в ней есть, что они означают, и проверенные примеры запросов к ним. Карта не статична — Искра пополняет её по ходу работы, в том числе запоминает найденный рабочий способ после ошибки, чтобы не повторять её снова.

Слева — дерево объектов подключения по категориям, справа — карточка выбранного объекта: «Назначение», «Поля» (что означает каждое поле), «Заметки» и «Примеры вызовов». Текстовые поля можно поправить вручную.

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

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

В обоих коннекторах 1С можно сохранить до 10 именованных баз на одном уровне настройки. Название — 1–100 символов после удаления пробелов по краям; в одном списке названия различаются без учёта регистра. Личный список, список другой организации и другой коннектор могут использовать те же имена. Старые совпадения не переименовываются автоматически: перед выбором базы задайте различающиеся имена в настройках. Личный список замещает организационный. В чате одна база выбирается автоматически, несколько — через форму при обращении к навыку; для другой базы создайте новый чат. Обычный и VPN-навык сохраняют выбор независимо. Вместо общей карты эти навыки автоматически накапливают только наблюдённую структуру в текущем чате. Новый чат начинает исследование заново. Само закрепление навыка и обычное обсуждение базу не выбирают.

Передача личного навыка организации

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

Откройте страницу навыка в разделе Навыки и нажмите «Опубликовать» в шапке. В окне выберите уровень «В организацию «…»» с названием вашей организации («Увидят участники организации. Проверка ИИ, решение владельца») и нажмите «Продолжить». Обычный сотрудник может оставить необязательный комментарий в поле «Владельцу организации» (до 1000 символов). Блок «Перед отправкой» проверяет описание навыка (README.md), но передачу не блокирует — без описания по шаблону навык не примут только в каталог.

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

• если вы владелец или администратор организации — «Передать организации»: навык перейдёт сразу;
• если вы обычный сотрудник — «Запросить передачу»: уйдёт заявка, её рассмотрит владелец или администратор организации. Пока заявку не одобрили, навык остаётся вашим.

Что происходит с навыком

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

Что НЕ переезжает

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

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

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

Когда передать не получится

Искра объяснит причину прямо в ответе. Чаще всего это:

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

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

Заявка: подача, статус, отзыв

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

Итог в последнем этапе:

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

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

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

О решении по заявке приходит уведомление; при отказе в нём видна причина, которую написал администратор.

Разбор заявок (владелец и администратор организации)

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

Кто видит заявку: владелец организации — любую; администратор — только заявку рядового участника. Свою заявку не разбирает никто: владелец и администратор передают свой навык сразу, без заявки.

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

• «Проверка ИИ» — «замечаний нет» или «есть замечания» со списком по группам: «Безопасность», «Утечка данных», «Несоответствие описанию», «Привязка к автору или организации»; у замечания — файл, место и пояснение;
• «Происхождение» — из какого навыка и какой версии сделана копия и через какие копии она прошла; у навыка, импортированного из GitHub или загруженного архивом либо папкой, — откуда. Ниже — «Особые права» копии нашего навыка: после одобрения они будут действовать у всех участников организации;
• «Что изменилось» — разница по файлам с основой: у копии — «с основой <навык> <версия>», то есть с версией навыка, из которого она сделана; у навыка без основы — «новый навык — показаны все файлы». Разница считается из файлов, без ИИ. Сравнение показывается с навыком из каталога, встроенным навыком, навыком вашей организации или личным навыком автора заявки. Если основа удалена, недоступна или это навык, содержимое которого вам не открыто, — «основа недоступна — показаны все файлы»;
• «Весь исходный код» — дерево файлов той версии, которую зафиксировала заявка; файл открывается по клику, значок и другие png показываются картинкой;
• «Переписка» — комментарий автора и ваши с ним сообщения. Сообщение пишется в поле «Написать автору…» под перепиской; автор получает уведомление и отвечает на странице своего навыка.

Решение — внизу карточки:

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

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

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

Передача из чата

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

Навыки сотрудников

Раздел для владельца и администраторов организации. В профиле организации в разделе Навыки у них есть вкладка «Сотрудники» — «Навыки участников «<организация>» в профиле организации»: личные навыки участников — те, что они создали, скопировали или установили себе из каталога, работая в этой организации.

Граница доступа:

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

Вкладка «Сотрудники» раздела «Навыки»

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

Карточка навыка сотрудника

Клик по карточке открывает страницу навыка сотрудника. Она устроена как обычная страница навыка — «Обзор», «Настройки», «Содержимое», — а в шапке стоит чип «Навык сотрудника: <имя>». Что доступно:

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

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

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

Навык сотрудника, у которого ещё нет ни одной опубликованной версии, на вкладке не показывается.

«Навыки организации»: управление навыками сотрудников из чата

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

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

Читать навыки организации и сотрудников может и внешняя программа — по API-ключу с правом «Навыки организации» (см. «Создание ключа»).

Что видит сотрудник

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

РСЯ — доход от рекламы на своих площадках

Для владельцев сайтов и приложений, размещающих рекламу РСЯ: доход, показы и клики по вашим площадкам, итоги и динамика по дням. Требуется личный токен API статистики зарегистрированного аккаунта РСЯ. Расходы рекламодателя и его кампании относятся к Яндекс Директу, индексация и поисковые запросы сайта — к навыку Яндекс Вебмастер. Подключение и различия сервисов: руководство РСЯ.

Директ — статистика кампаний рекламодателя

Для рекламодателей Яндекс Директа: кампании с их состоянием и ключевыми целями, расходы без НДС, показы, клики, CTR, средняя цена клика, конверсии по целям Метрики и стоимость заявки за период — итоги, динамика по дням и разбивка по кампаниям. Требуется токен собственного OAuth-приложения с одобренной заявкой на доступ к API Директа; навык только читает статистику. Подключение и различия сервисов: руководство Директа.