ИИ-трансформациявашего бизнесаИИ-трансформация вашего бизнеса

Обзор

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

Реестр российского программного обеспечения

Искра включена в Единый реестр российских программ для электронных вычислительных машин и баз данных — реестровая запись № 34144 от 4 июля 2026 года.

Обзор

Этот раздел поможет вам войти в систему, создать аккаунт и пройти первоначальную настройку платформы Искра.

Вход в систему

Для входа откройте ссылку на Искру, предоставленную вашим администратором. На экране входа вам потребуется ввести:

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

Пароль — ваш пароль от аккаунта.

Дополнительные опции на экране входа:

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

Забыли пароль? — ссылка для восстановления доступа (подробнее в разделе «Восстановление пароля» ниже).

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

После успешного входа вы попадёте на главный экран с чатом. Если ваш email ещё не подтверждён, система перенаправит вас на экран верификации.

Основной экран

После входа Искра открывается в общем рабочем интерфейсе:

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

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

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

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

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

Фон и отступы центральной области согласованы с боковыми панелями в светлой и тёмной теме. Переключить тему можно в настройках приложения.

Регистрация

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

Форма регистрации содержит следующие поля:

Имя (обязательное) — ваше настоящее имя.

Фамилия (необязательное) — ваша фамилия.

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

Email (обязательное) — адрес электронной почты, который будет использоваться для входа и восстановления пароля.

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

Подтверждение пароля (обязательное) — повторите пароль. Если пароли не совпадают, вы увидите предупреждение.

После заполнения всех полей нажмите кнопку «Зарегистрироваться». При успешной регистрации вы будете перенаправлены на экран подтверждения email.

Подтверждение email

После регистрации (или при попытке входа с неподтверждённым email) вы попадёте на экран верификации. На указанный при регистрации адрес электронной почты будет отправлен 6-значный код подтверждения. Срок действия кода — 24 часа.

Введите полученный код в поле на экране и нажмите «Подтвердить». После успешной верификации вы будете перенаправлены на страницу входа.

Если код не пришёл:

Проверьте папку «Спам» в вашем почтовом ящике.

Нажмите кнопку «Отправить повторно». После нажатия кнопка становится недоступной на 60 секунд – это защита от многократной отправки. По истечении таймера вы сможете запросить письмо ещё раз: пока прежний код действует, в новом письме придёт тот же код.

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

Восстановление пароля

Если вы забыли пароль, нажмите ссылку «Забыли пароль?» на экране входа.

Шаг 1. Запрос кода. Введите ваш email и нажмите «Отправить код». Если адрес зарегистрирован, на него придёт письмо с 6-значным кодом восстановления (срок действия — 24 часа). Из соображений безопасности экран не сообщает, существует ли аккаунт: сообщение об отправке одинаковое для любого адреса.

Если письмо не пришло:

Проверьте папку «Спам».

Через 60 секунд после запроса кнопка «Отправить код» снова станет доступной – повторный запрос пришлёт новое письмо; пока прежний код действует, в письме будет тот же код, а после трёх неверных попыток или по истечении срока – новый.

Если вы видите сообщение о слишком частых запросах или о временной недоступности сервиса, код не отправлялся – подождите минуту и повторите.

Шаг 2. Ввод кода и нового пароля. Перейдите на страницу сброса пароля (ссылка будет в письме или вы можете ввести код вручную). Заполните:

Email — адрес вашего аккаунта.

Код — 6-значный код из письма.

Новый пароль — придумайте новый надёжный пароль. Индикатор надёжности поможет оценить его качество.

Подтверждение пароля — повторите новый пароль.

Если код не подходит:

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

Рядом с сообщением об ошибке есть ссылка «Запросить новый код» – она вернёт вас на экран запроса кода.

Новый код можно запросить через 60 секунд после предыдущего запроса, как и на шаге 1.

После трёх неверных попыток ввода прежний код перестаёт приниматься – запросите новый.

После успешного сброса вы будете перенаправлены на страницу входа, где сможете войти с новым паролем.

Онбординг

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

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

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

Шаги мастера:

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

Рабочие задачи — выберите задачи, которые планируете решать с AI: анализ данных, написание текстов, код и автоматизация, презентации, исследования, планирование, перевод, отчёты и так далее. Отметьте хотя бы один вариант.

Опыт работы с AI — одиночный выбор: «Не пользовался», «Пробовал», «Активно использую».

Навигация по мастеру:

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

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

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

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

Способы доступа: веб, десктоп и мобильное приложение

Искра доступна в браузере — это основной способ работы. Десктоп-приложение добавляет локальную синхронизацию папок (см. раздел «Синхронизация папок»). Если в инсталляции опубликованы сборки, скачать его можно прямыми ссылками: macOS, Windows, Linux. Путь /api/desktop/download без параметра platform — не универсальная прямая ссылка: сервер угадывает платформу по браузеру и при неизвестной отвечает ошибкой. Если платформа пользователя неизвестна, дайте отдельные ссылки выше или сначала уточните её. Мобильное приложение «Искработ» для Android и iOS доступно через официальные магазины — ссылки и режимы работы приведены в справке о мобильном приложении. Совместимость с вашим корпоративным контуром и адрес подключения уточните у его администратора.

Имя продукта, имя модели и метка Anthill

Официальное имя продукта — Искра. Технический домен, имя модели в журналах или интерфейсе и служебные метки (например, Anthill — название агентного runtime) именем продукта не являются и историю бренда не подтверждают. Неизвестную историю названия нельзя достраивать догадкой.

Фактически используемая языковая модель зависит от инсталляции, тарифа и режима мощности ответа (см. «Автоматический выбор мощности» в разделе «Чат с ассистентом»):

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

Обзор

Чат — основной способ взаимодействия с Искрой. Здесь вы задаёте вопросы, получаете ответы, прикрепляете файлы и управляете историей бесед.

Создание и управление приложениями

Раздел управления приложениями доступен, когда включён модуль Apps ( APPS_ENABLED ). Если возможность создания выключена, уже существующие приложения по-прежнему можно просматривать и управлять ими в доступном разделе. Создание и публикация из чата дополнительно требуют включённого runtime Apps ( APPS_RUNTIME_ENABLED ) и связанных механизмов навыков и сценариев.

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

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

Ответ содержит идентификатор приложения, номер версии и состояние публикации. ready означает, что версия успешно проверена; стала ли она текущей, показывают

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

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

Для доработки удобнее вернуться в исходный чат: там сохранены авторские исходники. Если вы продолжаете в новом чате, сначала скачайте в исходном чате свежий архив исходников, а затем приложите ровно этот ZIP вместе с адресом карточки приложения. Ассистент проверит архив до распаковки и изменений. Опубликованная версия, которую запускает платформа, сама по себе не позволяет восстановить авторские исходники.

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

Версии и диагностика приложений

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

Не путайте два блока состояния:

Состояние приложения – включено ли оно для пользователей: «Активно» или «Остановлено».

Запуск – что происходит при запуске приложения: «Развёртывается», «Работает», «Нестабильно», «Остановлено» или «Ошибка запуска». Здесь также видны запущенная версия, число перезапусков и время последнего отчёта.

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

Открытие приложения и режимы доступа

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

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

Только владелец – приложение открывает только владелец приложения.

Организация – только для приложения организации; его открывают участники этой организации.

Все пользователи – публичный адрес доступен всем, включая людей, которые не вошли в Искру.

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

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

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

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

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

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

Остановка, запуск, удаление и уведомления

Владелец приложения, а в организации также Владелец или Администратор, может остановить и снова запустить приложение. Перед остановкой Искра предупреждает, что приложение будет недоступно пользователям до повторного запуска. Состояние в блоке «Запуск» может обновиться чуть позже общего состояния.

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

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

Интерфейс чата

После входа в систему вы попадаете на главный экран с полем ввода сообщения. Введите ваш вопрос или запрос и отправьте его ассистенту.

Поле ввода расположено в нижней части экрана. Оно автоматически увеличивается по высоте при вводе многострочного текста.

Отправка сообщения:

Enter — отправить сообщение.

Shift + Enter — перенос строки (новая строка без отправки).

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

Enter — сразу отправить показанную подсказку.

Tab, стрелка вправо или касание подсказки — перенести её в поле, чтобы отредактировать и затем отправить обычным способом.

Escape — скрыть подсказку. Можно сразу начать писать свой текст: подсказка исчезнет и не заменит набранное.

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

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

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

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

Вызовы API, задачи по расписанию и работа приложений сохраняют свои ограничения времени и расхода.

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

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

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

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

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

Единый черновик. Текст, прикреплённые файлы, выбранные навыки, сценарий и собранные цитаты относятся к одному черновику. Искра очищает его только после

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

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

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

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

Статусы сообщений. У каждого вашего сообщения отображается небольшой индикатор:

Отправлено — сообщение принято платформой, ответ либо уже пришёл, либо генерируется в данный момент.

Отправляется — идёт передача сообщения; обычные действия (форк, скрытие, оценка) временно недоступны.

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

Скрыто — сообщение убрано из ленты вручную, см. ниже «Действия с сообщениями».

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

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

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

Выбор мощности

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

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

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

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

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

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

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

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

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

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

Прикрепление файлов

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

Нажмите кнопку «+» слева от поля ввода. Откроется меню с выбором типа файла:

Документ — текстовые файлы и документы.

Изображение — графические файлы (доступно при использовании модели с поддержкой изображений).

Также вы можете перетащить файл в любое место области чата или вставить изображение из буфера обмена (Ctrl+V / Cmd+V).

Поддерживаемые форматы документов:

Текстовые и данные: TXT, MD/MARKDOWN, CSV/TSV, JSON, XML, YAML/YML, HTML/HTM

Офисные Writer: DOC, DOCX, DOCM, DOT, DOTX, ODT, FODT, OTT, RTF

Офисные Calc: XLS, XLSX, XLSM, XLT, XLTX, ODS, FODS, OTS

Офисные Impress: PPT, PPTX, PPTM, PPS, PPSX, POT, POTX, ODP, FODP, OTP

Офисные Draw: ODG, FODG, OTG

PDF, DJVU/DJV, EPUB, FB2 и ZIP

Остальные форматы Искра может попробовать разобрать инструментами агента — результат зависит от формата и задачи.

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

Поддерживаемые форматы изображений:

JPEG, PNG, WebP, AVIF, GIF, BMP, TIFF, HEIC

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

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

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

Нажмите на карточку файла в отправленном сообщении, чтобы открыть предпросмотр. PDF, DJVU, документы Word/Office, презентации, таблицы, Markdown, изображения и код отображаются прямо в окне предпросмотра. Ссылка на Markdown- или PDF-файл беседы в тексте ответа тоже открывает это окно, а не новую вкладку; кнопка «Назад» браузера закрывает его и возвращает в ту же беседу. Ссылки на файлы других форматов открываются, как прежде, в новой вкладке. DJVU, поддерживаемые документы и

презентации Искра показывает как серверную PDF-версию. Если конвертация или PDF-просмотр недоступны, интерфейс показывает диагностику и предлагает скачать оригинал.

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

Таблицы открываются не как PDF, а в отдельном режиме только для чтения. Он поддерживает XLSX, XLS, XLSM, шаблоны Excel, ODS/FODS/OTS, CSV и TSV. В просмотрщике доступны листы, выделение и копирование ячеек, объединённые ячейки, размеры и скрытие строк и столбцов, закреплённые области, оформление, ссылки и заметки. При выборе вычисленной ячейки над таблицей видна исходная формула, а в самой ячейке остаётся значение, рассчитанное LibreOffice. Выпадающие списки и флажки можно просмотреть без изменения документа. Диаграммы и изображения показываются как статические PNG.

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

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

Старые презентации IPF

.ipf — устаревший непрозрачный формат презентаций. Искра не открывает и не редактирует его напрямую: вместо предпросмотра показываются пояснение и кнопка скачивания оригинала. Для активного IPF в файлах текущего чата там же всегда доступно явное действие «Создать PPTX». Для конвертации размер исходного IPF не должен превышать 10 МиБ.

Преобразование создаёт постоянный соседний файл с тем же именем и расширением .pptx : например, plan.ipf становится plan.pptx . Исходный IPF, старое сообщение и ссылка в нём не меняются, новый PPTX в старое сообщение не добавляется. Искра никогда не перезаписывает уже существующий PPTX; при конфликте интерфейс предложит открыть ранее созданный файл. Если он находится в Корзине, появится кнопка «Восстановить PPTX» — после восстановления файл откроется в обычном предпросмотре. Новый PPTX появляется в рабочей папке чата и остаётся там как обычный файл.

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

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

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

Лимиты файлов

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

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

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

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

Для офисных документов Word, Excel и PowerPoint, а также поддерживаемых форматов OpenDocument действует дополнительный предел обработки — 50 МиБ (в интерфейсе — 50 MB). Он проверяется при выборе файла, до передачи его содержимого, даже если тариф разрешает больший размер. CSV и TSV под этот предел не подпадают. В окне отказа видны имя файла, его размер и допустимый предел. Сожмите или разделите файл; если нужно прочитать документ или презентацию, можно экспортировать его в PDF. Повышение тарифа этот предел не увеличивает, повторная загрузка исходного файла не поможет.

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

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

Панель запроса

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

Панель состоит из двух зон, которые видны всегда, и закреплённой нижней строки:

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

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

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

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

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

Автоматика и ручной режим

Режим набора навыков виден в окне «Навыки беседы»: под заголовком стоит пилюля режима и строка-подсказка.

«режим авто» — набор подбирает Искра; подсказка: «Навыки подбираются автоматически при общении».

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

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

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

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

Специалист: роль ответа, а не навык

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

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

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

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

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

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

Независимость настроек беседы

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

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

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

Когда панель видна

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

Пока панель свёрнута, над полем ввода стоит строка-сводка того, что в ней спрятано: «В чате: 3 файла · 5 навыков · контекст свободен на 58%». Она же и открывает панель по нажатию, после чего исчезает — дальше всё это видно в самой панели. Показывается сводка только тогда, когда есть о чём сказать: в пустой беседе без файлов и подобранных навыков её нет.

Во время ответа

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

продолжает выполняться так, как начался, — переключение его не прерывает и не переделывает.

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

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

Бывает и постоянный запрет: беседа в архиве, доступна только для чтения, подписка организации закончилась или исчерпан лимит сообщений. Тогда элементы управления недоступны сразу, не дожидаясь ответа, а причина («Диалог в архиве — настройки не изменить», «Лимит сообщений исчерпан» и подобные) стоит подсказкой у кнопки «+». У беседы в архиве — и у беседы из архивного проекта — подключённая память показывается для чтения: список папок виден целиком, но крестиков и переключателей «чтение/запись» на строках нет, потому что менять состав до восстановления всё равно нельзя. Круглые кнопки параметров ответа при этом остаются обычными на вид — они ничего не пишут, а раскрывают ряд: причина названа их подсказкой, а в раскрытом ряду стоит строкой под переключателем.

Зона «Подключённые папки»

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

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

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

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

Зона «Файлы чата»

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

Рабочая папка чата

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

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

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

Если сама рабочая папка отправлена в корзину, её связь с чатом сохраняется. Чтобы снова работать с ней или отменить выбор в пустом чате, сначала восстановите папку в Памяти.

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

Файлы-результаты, которые ассистент создаёт во время работы, показываются в зоне «Файлы чата» в виде дерева папок. Вложенные папки можно раскрывать и сворачивать по отдельности. У файлов, созданных ассистентом или навыком, рядом с именем стоит значок источника (подсказка называет, кто именно); у ваших собственных вложений значка нет — они и так ваши. Цветная точка перед значком отмечает файлы, добавленные или изменённые в этой сессии работы.

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

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

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

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

«Черновики» остаются приватной рабочей областью беседы: они не попадают в публичную ссылку и ZIP-выгрузку чата. Эта секция не связана с черновиком сообщения в поле ввода, который описан ниже отдельно.

Для повторяющейся работы выбор между материалами навыка, папкой Памяти, Черновиками и готовыми файлами разобран в руководстве по навыкам.

Если имя нового файла совпадает с файлом в «Корзине», Искра автоматически сохранит новый файл с номером: например, report.docx станет report (2).docx . В результате Искра и агент всегда показывают фактическое имя.

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

Просмотрщик файлов

Нажмите на файл в дереве зоны «Файлы чата», чтобы открыть его предпросмотр в отдельном окне. Прямо в окне отображаются: изображения, PDF, документы Word/Office, презентации, таблицы в Excel-подобном режиме только для чтения, Markdown, веб-страницы (HTML), код с подсветкой синтаксиса, а также аудио и видео со встроенным плеером. Для поддерживаемых документов и презентаций предпросмотр открывает PDF-версию; таблицы никогда не преобразуются в PDF. Если предпросмотр недоступен полностью, в окне есть кнопка скачивания.

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

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

История версий файла

Каждое сохранение файла рабочей папки создаёт новую версию, а прежние остаются. Открыть их можно двумя способами: открыть меню «⋯» у строки файла в зоне «Файлы чата» и выбрать «История версий» либо нажать ту же кнопку в верхней полосе окна

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

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

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

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

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

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

Зона «Доски разговора»

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

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

Что такое доски, какие у них бывают аудитории, чем «Следовать файлу» отличается от зафиксированной версии и что получает читатель — в разделе «Доски».

Окно «Навыки беседы»

Набор навыков следующего запроса показывает окно «Навыки беседы» — его открывает кнопка «Навыки» в нижней строке панели. Число в углу кнопки говорит, сколько навыков

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

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

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

Кнопка ▶ стоит у навыка, которому есть что запускать. У навыка со сценариями она открывает окно запуска: там перечислены ручной запуск (если он есть) и все сценарии навыка. У каждого сценария две кнопки:

«Запустить» — отправляет запрос сразу, ответ начнётся в этой же беседе;

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

У навыка без сценариев ▶ запускает его сразу, без окна. На стартовом экране запуск погашен: «Сначала отправьте сообщение в чат» — окно при этом открывается и показывает причину.

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

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

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

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

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

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

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

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

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

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

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

Если подборка не сработала или навык пропал, окно покажет это отдельной строкой — например, «Навык больше не доступен». Строка «Список навыков сейчас недоступен»

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

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

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

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

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

Окно «Закреплённые положения»

Закреплённое положение — короткая установка, которая действует до конца беседы: «пиши официальным тоном», «срок — 30 августа», «утверждённые факты — только в 01_Утверждённые_факты.md ». Искра получает такие установки с каждым запросом, поэтому повторять их в новых сообщениях не нужно.

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

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

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

Те же положения закрепляются и без окна: команда /pin срок — 30 августа из поля ввода и действие «Закрепить» в панели, которая появляется при выделении короткого фрагмента текста в сообщении (раздел «Действия с выделенным текстом и цитаты» ниже).

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

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

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

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

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

Футер: контекст и параметры ответа

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

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

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

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

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

Органы параметров — квадратные кнопки без контура; подсказка каждой называет текущее значение. Нажатие раскрывает карточку параметра над футером, закрыть её можно крестиком, клавишей Esc или щелчком мимо. Вся группа появляется, только когда панель загрузила настройки беседы: пока идёт загрузка или она не удалась, параметров в футере нет. С клавиатуры: Tab до органа, Enter раскрывает список и ставит курсор на отмеченную строку, ↑/↓ ходят по строкам, Enter выбирает.

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

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

Специалист — значок робота, с буквой «A» в углу, когда специалиста выбирает сама Искра. В списке — строка «Авто» и все специалисты; под списком одно описание — той строки, на которой стоит курсор или клавиатурный фокус, а без них — выбранной. На телефоне, где наведения нет, описание показывает кнопка «i» у строки. Что такое специалист и чем он отличается от навыка — в разделе «Специалист: роль ответа, а не навык» выше.

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

организации. Что покрывает режим и что остаётся вне него — в разделе Безопасность и приватность данных.

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

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

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

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

Отдельной кнопки «Вернуть автоматику» в футере нет: вернуть решение Искре — строка «Авто» в списке сложности или специалиста, для профиля — строка организации.

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

Рабочая папка и подключённая Память

В рабочую папку чата (служебную папку чата или выбранную папку Памяти — см. «Рабочая папка чата» выше) попадают вложения сообщений и файлы, созданные агентом; в панели запроса её содержимое показывает зона «Файлы чата». Помимо рабочей папки к чату можно подключить любую другую папку Памяти как контекст — это не делает её рабочей, чат в ней не работает, а файлы агента по-прежнему уходят в рабочую папку. Подключите её через «@ Папки» — набором «@» прямо в поле ввода — или кнопкой «+» в шапке зоны «Подключённые папки»; папку, уже выбранную рабочей для этого чата, подключить дополнительно как контекст нельзя. Можно подключить несколько папок и отдельно задать каждой режим доступа агента — «Только чтение» или «Разрешить изменения» (подробнее — в разделе «Память»). Навыки подключаются отдельно, в окне «Навыки беседы», и с подключёнными папками не смешиваются.

Веб-поиск

Искра может искать актуальную информацию в интернете и включать найденные данные в ответ.

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

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

Источники. Если ответ содержит данные из интернета, под сообщением ассистента отображается блок «Источники». Каждый источник содержит:

Значок сайта-источника.

Название страницы.

Ссылку, по которой можно перейти к оригиналу.

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

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

Отображение ответов

В браузерном чате ответы ассистента поддерживают:

Заголовки, списки, цитаты и таблицы — стандартное форматирование Markdown.

Акценты и ссылки — жирный и курсивный текст, зачёркивание, обычные ссылки.

Переносы строк — одиночный перевод строки отображается как перенос, без пустой строки между абзацами.

Блоки кода — отображаются с подсветкой синтаксиса для различных языков программирования. У каждого блока кода есть кнопка копирования.

Математические формулы — LaTeX через KaTeX: блочные $$...$$ или \[...\] , строчные \(...\) . Одиночный $...$ не используется (это знак валюты).

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

Сайты, телефоны и почта в ответах.

Адреса сайтов в ответах Искры кликабельны, в том числе без https:// и www. : например, example.com или сайт.рф . Сайт открывается в новой вкладке, а чат остаётся на месте. Перед переходом на внешний сайт Искра показывает его адрес и предлагает подтвердить открытие. Такое же предупреждение действует для ссылок в списке источников под ответом.

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

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

Ссылки на файлы Искры сохраняют встроенный просмотр или скачивание. Адреса и телефоны внутри блоков кода остаются обычным текстом.

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

Специальные расширения Obsidian не получают отдельного оформления в чате:

callout > [!NOTE] отображается как обычная цитата с видимым маркером [!NOTE] ;

подсветкой, ссылкой или встраиванием;

синтаксис сносок [^1] / [^1]: текст не поддерживается, результат его отображения не гарантируется.

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

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

Действия с выделенным текстом и цитаты

Выделите текст внутри одного сообщения — рядом с выделением появится панель действий. На телефоне то же самое делается долгим нажатием и системными ручками выделения. Обычное выделение ничего не создаёт само по себе: текст можно скопировать сочетанием Ctrl + C (Cmd + C на Mac) или кнопкой «Скопировать» в панели, и никакая форма при этом не открывается.

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

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

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

«Закрепить» сохраняет выделенную строку длиной до 1000 символов как положение беседы, используя тот же механизм, что команда /pin текст . Список и удаление положений доступны в окне «Закреплённые положения».

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

Отправка цитат

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

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

Если исходный ответ успел измениться, Искра не отправит запрос и предложит убрать устаревшую цитату и выделить фрагмент заново; текст сообщения и остальные цитаты останутся в поле. На один запрос можно добавить до 8 цитат; каждый фрагмент — до 4000 знаков, вместе — до 16 000 знаков.

Действия с сообщениями

При наведении на сообщение ассистента появляется панель действий:

Копировать — скопировать текст сообщения в буфер обмена.

Нравится / Не нравится — оценка ответа. Помогает системе улучшать качество ответов. Повторное нажатие снимает оценку. На некоторых установках Искры оценки выключены администратором — тогда этих кнопок в панели нет.

Скрыть — скрыть сообщение из истории беседы. Скрытые сообщения не отображаются, но сохраняются в системе.

Управление беседами

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

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

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

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

Удаление беседы. Удаление не безвозвратно: беседа архивируется и её можно восстановить. Как открыть архив и вернуть беседу — ниже в разделе «Архив чатов».

Архив чатов: архивация и восстановление

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

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

Публичная ссылка на беседу

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

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

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

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

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

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

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

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

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

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

Скачивание беседы. Кнопка скачивания в верхней панели чата собирает ZIP-архив со всей беседой:

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

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

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

Файлы из секции «Черновики» в этот архив не входят.

Черновики

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

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

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

Боковая панель

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

Единый список — обычные беседы сгруппированы по времени.

Проекты — чаты проектов вынесены в отдельный раздел; сначала показаны шесть уже загруженных чатов, остальные открывает кнопка «Показать ещё».

В едином списке используются группы по времени:

Сегодня — беседы текущего дня.

На этой неделе — беседы за последние 7 дней.

В этом месяце — беседы за последние 30 дней.

Ранее — все остальные беседы.

На широком экране боковую панель можно свернуть до узкой полосы с иконками — кнопкой в правом верхнем углу панели. Развернуть её обратно можно такой же кнопкой внизу узкой полосы, под аватаром. Кнопка «Чаты» в этой полосе открывает компактный список бесед; его можно закрыть клавишей Esc или нажатием за пределами списка.

Создание нового чата. Нажмите кнопку «Новый чат» в верхней части боковой панели или используйте сочетание клавиш Ctrl + Shift + O (Cmd + Shift + O на Mac).

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

Поиск по сообщениям и чатам

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

Статистика чата и контекст

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

То же окно открывает команда /usage (или /tokens ), отправленная из поля ввода уже созданной беседы, — без обращения к модели. О расходе текущей беседы можно спросить и саму Искру («сколько токенов потрачено в этой беседе?») — она прочитает ту же статистику и назовёт входные, выходные токены и сумму; если данные временно недоступны, так и скажет.

В окне «Статистика чата» показаны:

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

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

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

Сжатие и очистка контекста

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

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

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

Те же действия можно вызвать прямо из поля ввода: отправьте команду /compact (сжать) или /clear (очистить) как обычное сообщение; /clear тоже спросит подтверждение. Пока идёт генерация ответа, операции с контекстом недоступны. Закреплённые положения обе операции сохраняют: они описывают правила разговора, а не историю (см. «Окно „Закреплённые положения“»).

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

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

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

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

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

Когда вы начинаете ввод с «/», Искра показывает слэш-меню: в уже созданной беседе сверху идёт секция «Команды» с /compact , /clear , /pin («закреплённые положения»: без текста — показать и снять, с текстом — закрепить) и /usage (в запланированных сессиях из команд остаётся только /usage — операции с контекстом там недоступны), ниже — секция «Сценарии» (готовые сценарии ваших навыков, если они есть), а под ней — сами навыки, доступные для явного вызова (по одной строке на навык). Продолжайте набирать часть названия — Искра отфильтрует подходящие сценарии и навыки; искать можно и по названию инструмента внутри навыка. Перемещайтесь по списку стрелками ↑/ ↓; выделенный пункт подтверждается клавишей Enter или Tab (или кликом мышью), а Esc закрывает меню. Навык, которому не хватает настройки, тоже остаётся в списке — с пометкой «не настроен»: вызовите его как обычно, и Искра сама попросит недостающие данные.

Уведомления

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

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

Обзор

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

Что такое агент

Агент — это AI-ассистент, который не только отвечает на вопросы, но и выполняет действия. В отличие от обычного чата, агент может:

Выполнять код — писать и запускать программы на различных языках программирования.

Работать с файлами — создавать, читать и редактировать файлы.

Искать информацию — обращаться к поисковым системам и внешним ресурсам.

Использовать инструменты — вызывать специализированные инструменты для решения задач.

Агент работает в изолированной среде, что обеспечивает безопасность выполнения кода.

Как работает агентный режим

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

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

Подключённые папки агент видит и называет обычными именами — например, «Договоры 2026» — как в интерфейсе, а не техническими идентификаторами; то же имя показывается в заголовке вызова инструмента (например, read path=/Договоры 2026/ акт.pdf ). Если для документа извлечён текст (см. «Память» → «Извлечённый текст»), рядом с оригиналом инструменты поиска и чтения агента могут показывать вспомогательный файл с суффиксом .text.md — это техническое представление извлечённого текста для агента, оно не отображается в разделе «Память» и не является отдельным файлом; в ответе агент ссылается на исходный документ, а не на этот файл.

Пока к чату подключена хотя бы одна папка, агент в каждом ходе сначала просматривает подключённые папки ( ls , grep , read ) и только затем обращается к интернету ( web_search , fetch ) — за тем, чего в папках нет; ответ по вопросу, который покрывает документ из папки, строится на этом документе. Прямая просьба начать с интернета этот порядок меняет.

Чтение файлов

Файл из рабочей папки чата, подключённой папки Памяти или приложенный к сообщению Искра открывает инструментом read . Обычный текстовый файл читается как есть, независимо от расширения: .txt , .md , .csv , .json , а также файлы с редким расширением — например, .sql , .svg или .sh . Текстовый файл в другой кодировке Искра прочитает, если кодировка объявлена в самом файле; иначе она скажет об этом и предложит его перекодировать. Нетекстовый файл доступен, если платформа умеет его разбирать: документы Word, Excel и PowerPoint, PDF, EPUB, FB2, DjVu и архив ZIP. Двоичный файл неизвестного формата Искра прочитать не сможет и скажет об этом.

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

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

содержит; такой файл Искра открывает в исходном виде и работает с ним дальше как обычно.

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

Чтение больших материалов

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

Обычный текстовый файл (и HTML в исходном виде) Искра читает по диапазонам: инструмент read принимает номер первой строки и число строк, а нужный диапазон она находит поиском по файлу. Если для ответа нужна сводка по всему объёму, Искра сначала собирает её скриптом в файл поменьше и читает уже его.

Документ с извлечением — PDF, Word, Excel, PowerPoint, EPUB, DjVu, ZIP — устроен иначе: платформа отдаёт извлечённое содержимое целиком, и указание диапазона строк на него не влияет. Объёмный результат при этом обычно не обрушивается в ответ разом: платформа удерживает его и отдаёт Искре частями, которые она читает последовательно. Исключение — редкий случай, когда сам извлечённый текст превышает технический предел платформы: тогда чтение не разбивается на части, а завершается ошибкой с точным лимитом, и документ нужно уменьшить или разделить.

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

Отдельные обработчики и их лимиты. Размер, который Искра способна прочитать, задаётся не только общим лимитом загрузки. Офисные документы Word, Excel и PowerPoint обрабатывает отдельный конвертер со своим, заметно меньшим лимитом размера. Новое офисное вложение больше 50 МиБ отклоняется в чате до передачи содержимого. Ранее сохранённый файл также может оказаться слишком большим для чтения; Искра сообщает допустимый размер. Документ нужно сжать или разделить, а для чтения можно экспортировать в PDF — постраничное чтение здесь не спасает, потому что ограничение стоит на входе обработчика. У остальных поддерживаемых форматов предел на вход выше и совпадает с общим файловым лимитом платформы, но есть и второй предел — на объём извлечённого текста: файл может пройти по размеру и всё равно оказаться слишком объёмным после извлечения. Рекомендация в обоих случаях одна: уменьшить или разделить документ. Это ограничения конкретных обработчиков, а не отказ работать с большими документами.

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

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

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

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

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

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

Создание офисных документов

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

Если для презентации выбран встроенный навык «Презентации», Искра сама подберёт оформление под тему и аудиторию и подготовит интерактивный HTML. Печатную версию с PDF она создаст по запросу печати или PDF, а оба варианта — когда вы попросите их вместе. Загруженный PDF как источник содержания не меняет формат результата. Подробности — в разделе «Встроенные навыки». Если подходящего навыка нет и формат не указан, Искра создаст .pptx встроенным Office-инструментом. Если нужен именно файл PowerPoint, назовите формат явно: «PowerPoint», PPT или PPTX . Подходящий навык с поддержкой этого формата получит приоритет; при его отсутствии Искра создаст файл встроенным Office-инструментом. Аналогично обрабатываются документы Word и таблицы Excel. В ходе работы могут отображаться инструменты create_presentation ,

Word, Excel и PowerPoint Искра переводит в современные тем же export .

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

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

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

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

Когда нужен именно DOCX и выбран встроенный Office, Искра обычно пишет содержимое в Markdown и переводит его в .docx . В рабочей папке чата остаются оба файла: Markdown как исходник для правок и готовый документ Word. К поэтапной сборке через create_word_document Искра переходит там, где Markdown не хватает: объединённые ячейки, сложная геометрия таблиц, разрывы страниц в нужных местах, размещение изображений, особая титульная страница.

В этом Office-пути документ получает встроенное оформление: заголовки трёх уровней, подписи, цитаты, таблицы с выделенной шапкой, поля и номера страниц. Если администратор установки загрузил собственный шаблон Word, применяется он.

При экспорте офисного документа в PDF Искра сначала завершает редактируемый исходник .docx , .xlsx или .pptx , а затем экспортирует его через export . В рабочей папке чата остаются оба файла: исходник для дальнейших правок и готовый PDF. Для результата выбранного навыка состав файлов определяется его порядком работы.

Текстовый исходник – Markdown, HTML, обычный текст или CSV – Искра переводит в PDF напрямую тем же export , без промежуточного файла Word. Для такого PDF можно сразу задать печатный макет: ориентацию (книжную или альбомную), размер листа (A3, A4, A5, Letter, Legal) и поля в миллиметрах – например, «сделай этот PDF альбомным» или «A5 с полями 10 мм». Незаданные параметры берутся из встроенного или загруженного в организации PDF-шаблона, оформление текста и таблиц сохраняется. Для PDF из документов Word, Excel и PowerPoint геометрия страницы берётся из самого документа: чтобы её изменить, сначала поправьте параметры страницы в исходнике через

Приложенный DJVU или DJV Искра конвертирует в PDF тем же export . Конвертацию выполняет сервер платформы — тот же, что готовит PDF-версию для предпросмотра и меню скачивания, — а готовый .pdf появляется в рабочей папке чата рядом с исходником, и с ним можно продолжать работу.

Операции с готовыми PDF

Прикреплённый PDF можно разделить на отдельные страницы или диапазоны, объединить несколько PDF в один и сжать файл (например, тяжёлый скан).

Обратное преобразование PDF → DOCX не поддерживается. PDF является целевым форматом экспорта, а не исходником для офисного документа: офисные форматы конвертируются только внутри своего семейства, а Markdown, HTML и обычный текст — в .docx , .odt и .rtf и обратно. Если из PDF нужен редактируемый документ, Искра честно скажет, что такой конвертации нет, и предложит вместо неё извлечь текст и собрать новый документ — при этом исходная вёрстка не сохранится. Искра выполняет эти операции локальными инструментами в изолированной песочнице без доступа к сети: документ не отправляется во внешние онлайн-сервисы и не покидает платформу. Результат появляется в артефактах чата отдельными файлами. Сжатие уменьшает разрешение изображений внутри PDF, поэтому для сканов выигрыш заметный, а для «текстовых» PDF размер может почти не измениться — в этом случае Искра честно сообщит об этом.

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

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

Если администратор не настроил собственную PPTX-тему, можно попросить нейтральную светлую ( blank ), синюю ( blue ), коричневую ( brown ), тёмную ( dark ) или серую ( grey ) встроенную тему; без явного выбора используется blank . Все встроенные темы построены одинаково — отличается только палитра. В каждой шесть готовых макетов слайда: титульный, заголовок с содержимым, заголовок раздела, два объекта, только заголовок и пустой. Поэтому тему можно поменять уже после создания презентации, и оформление перестроится без переделки слайдов. Собственная тема администратора применяется автоматически вместо встроенной. Новая презентация получает её оформление, но демонстрационные слайды и содержимое темы в пользовательский файл не копируются.

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

Обработка таблиц Python-ом

Для массового анализа больших таблиц Искра использует тот же локальный Python в изолированной песочнице: читает и агрегирует данные из файлов xlsx, ODS и parquet, считает статистику и сводки по объёмам, которые неудобно разбирать вручную. Это путь для анализа, а не для готового документа — оформленную таблицу для пользователя Искра по-прежнему создаёт и редактирует штатными инструментами (см. «Создание таблиц XLSX» и «Редактирование офисных файлов» ниже). Результат анализа появляется в артефактах чата отдельным файлом, например CSV.

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

Создание таблиц XLSX

Попросите Искру создать электронную таблицу в формате XLSX. В запросе можно явно указать количество листов, их названия, порядок и назначение. Искра сохранит эту структуру при создании файла либо честно сообщит, если какое-либо требование пока не поддерживается.

Материалы навыка

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

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

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

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

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

Редактирование офисных файлов

Документы Writer (включая .doc , .docx , .dot , .dotx , .docm , .rtf и OpenDocument), таблицы Calc, презентации Impress и рисунки Draw изменяются через edit_office_document . Инструмент работает с файлами рабочей папки чата (служебной папки чата или выбранной папки Памяти) и с доступными для изменения подключёнными папками.

Искра сохраняет исходный путь и формат файла. Редактирование выполняется в изолированной среде без доступа к сети и остальным файлам рабочей папки.

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

После значимого создания или редактирования текстового (Writer) файла Искра проверяет итоговую вёрстку постранично через review_page : инструмент возвращает PNG каждой страницы для визуальной проверки, Искра исправляет заметные обрезания, наложения и другие дефекты, а перед завершением ещё раз просматривает все страницы актуальной версии. Эти изображения служат только для внутренней проверки и не появляются среди итоговых файлов. Структурированный post-edit snapshot для Writer агенту не возвращается.

Постраничная проверка показывает документ так, как его отображает LibreOffice. В Microsoft Word сложная вёрстка, нестандартные шрифты и отдельные элементы OOXML могут выглядеть немного иначе.

Старые документы .doc , .dot и .rtf можно править напрямую через edit_office_document . Чтобы получить современный формат, Искра использует тот же export и создаёт рядом соседний файл ( .docx / .dotx ), не меняя исходник; дальше можно работать с этим файлом через edit_office_document . Конвертация работает только в новый путь. Если соседний файл уже существует, это окончательный конфликт: используйте его, не удаляйте и не переименовывайте ради повторной конвертации. Если он находится в Корзине, сначала восстановите его через раздел файлов чата. Старый файл с макросами, встроенным объектом или другим активным содержимым может быть отклонён при конвертации: платформа не удаляет такое содержимое молча.

Старый формат .ipf нельзя открыть или отредактировать напрямую. Если вы попросите Искру поработать с таким файлом, единственный доступный ей способ получить содержимое — явная конвертация convert_legacy_presentation . Для IPF размером до 10 МиБ она создаёт постоянный соседний .pptx , не меняя исходный файл и не добавляя

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

Вызовы инструментов

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

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

показывает простой текстовый фрагмент генерируемого скрипта документа. То же представление используется для других Office create/edit-вызовов с программой. Когда вызов готов, карточка автоматически заменяется обычным блоком инструмента. Если подготовка оборвалась из-за ошибки или прерывания потока, незавершённый шаг остаётся в ходе выполнения с соответствующей отметкой.

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

Каждый вызов отображается компактным блоком из двух строк:

Заголовок — название инструмента и ключевые параметры (например, read

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

Превью результата — короткая сводка под заголовком (например, «1 line read» или «3 results found»).

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

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

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

Отмена и таймаут навыков

Навыки (инструменты из каталога навыков) могут выполняться заметно дольше обычных. Для таких вызовов карточка показывает дополнительную информацию:

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

Завершение по таймауту — если навык превысил отведённый лимит времени, карточка завершается отметкой таймаута, а не остаётся в бесконечном вращении. Отменённый навык помечается соответствующей отметкой.

Лимит рабочей папки

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

Продолжение длинной задачи

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

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

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

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

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

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

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

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

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

Форма ввода от навыка

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

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

Выполнение сценария навыка

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

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

▶ Продолжить — отправляет команду продолжить сценарий с прерванного места;

Завершить — принудительно завершает сценарий: ассистент подтверждает отмену и кратко подводит итог сделанного и несделанного.

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

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

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

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

Как Искра решает сложные инженерные задачи

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

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

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

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

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

На пограничных задачах, где не очевидно, нужен ли полный процесс, Искра сама спросит, применять ли его. Если процесс не нужен вовсе, его можно выключить на странице «Навыки», переведя режим навыка super-iskra в «Выкл».

Как уточнить размытый запрос: навык «Промпт»

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

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

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

Файлы-результаты

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

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

Действия с файлами-результатами:

Просмотр — нажмите на строку файла, чтобы открыть содержимое в модальном окне. Текстовые файлы отображаются с подсветкой синтаксиса, а таблицы — в Excel-подобном режиме только для чтения с листами, объединёнными ячейками, формулами, выпадающими списками и статическими PNG-диаграммами. Таблицы не преобразуются в PDF. Остальные действия собраны в меню «⋯» у строки файла (на устройствах с мышью кнопка появляется при наведении, на сенсорных видна всегда): скачать (с подменю форматов, если доступна PDF-версия), скопировать содержимое текстового файла в буфер обмена, история версий — список прежних версий с возможностью вернуть любую из них (см. «История версий файла» в разделе «Чат») — и удалить.

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

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

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

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

Искра получает адрес ячейки и исправляет формулу. Ошибки вычисления, например деление на ноль из-за пока пустых данных, не блокируют файл, но результат помечается как непроверенный ( unverified ) с перечнем ячеек.

Если чат открыт в контексте проекта, его файлы агент тоже использует как контекст — только для чтения. В панели запроса они не перечисляются: карточка проекта первой строкой зоны «Подключённые папки» открывает окно «Подключённые папки» на вкладке «Проект», где показаны папки проекта и «Файлы проекта».

Размещение результата на доске

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

Подготовку агент передаёт вам так же, как навык передаёт свою форму: подтвердить

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

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

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

Вопросы от агента

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

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

Блок вопроса содержит:

Заголовок и формулировку — краткое описание ситуации, которую агенту нужно прояснить.

Варианты ответа — готовые варианты с описаниями. Выберите подходящий; до отправки выбор можно изменить.

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

вариантами требует выбора или своего текста. Для отправки всей формы нажмите «Отправить ответ».

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

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

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

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

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

Формы навыков

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

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

Субагенты внутри одной задачи

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

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

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

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

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

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

Параллельные задачи в разных беседах

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

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

Обзор

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

Что происходит в рабочем чате

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

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

Мягкий режим (предупреждение). Сообщение помечается предупреждением, но всё равно уходит ассистенту — проверка лишь обращает ваше внимание на риск, не блокируя переписку.

Какой режим действует, определяет администратор платформы или вашей организации.

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

Что может вызвать предупреждение

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

реальные API-ключи, токены и пароли;

персональные данные;

внутренние URL или инфраструктурные адреса;

секретные или служебные маркировки.

Удалите чувствительные данные или замените их безопасными примерами, затем отправьте сообщение заново.

Рекомендации и обучение

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

Обзор

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

Что такое проекты

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

Каждый проект имеет:

Название — краткое описание темы.

Описание — подробное пояснение назначения проекта.

Иконку — визуальный маркер для быстрого распознавания.

Инструкции — инструкции для ассистента, определяющие контекст и его поведение в этом проекте.

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

Список проектов

Для перехода к проектам используйте соответствующий пункт навигации. Откроется страница со списком всех доступных вам проектов.

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

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

Создание проекта

Для создания нового проекта нажмите кнопку «Создать проект» на странице списка.

Заполните форму:

Название (обязательное) — название вашего проекта.

Описание — краткое пояснение темы или назначения.

Иконка — выберите подходящую иконку из набора. Доступны более 60 вариантов, сгруппированных по тематике: документы, инструменты, наука, природа, животные и другие. По умолчанию выбрана иконка папки.

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

Нажмите «Создать проект», и вы будете перенаправлены в новый проект.

Работа в проекте

Внутри проекта доступны:

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

Файлы проекта — каноническая папка проекта в Памяти. Она автоматически подключена к чатам проекта в пределах выданных прав.

Память — дополнительные папки, подключённые к проекту. Они наследуются его чатами; конкретный чат может только сузить режим доступа.

Участники — список людей, у которых есть доступ к проекту.

Инструкции — инструкции для ассистента в этом проекте.

Ассистент в проекте. Создайте или откройте чат в разделе «Мои чаты» и напишите сообщение. Ассистент будет отвечать с учётом инструкций проекта и загруженных файлов.

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

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

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

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

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

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

Участники. Список участников проекта отображается в разделе «Участники» на правой панели. Для добавления нового участника начните вводить его имя или email в поле поиска — система предложит подходящих пользователей.

Настройки проекта. Владелец проекта может редактировать название, описание, иконку и инструкции прямо на странице проекта. Для изменения названия или описания нажмите на соответствующее поле.

Проект также можно выбрать для записи в разделе «Планы». Подробнее — в разделе «Планы».

Совместный доступ к чатам внутри проекта

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

Закрытый чат (значок перечёркнутого глаза) — чат виден только автору.

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

Переключать режим может только автор чата. Если проект переведён в архив, переключение блокируется.

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

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

Совместный доступ к чату, описанный выше, открывает беседу участникам проекта внутри Искры. Доской он не является: у доски свой состав вкладок, свой владелец и своя

аудитория.

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

Навигация между чатами проекта

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

Клик по иконке и названию проекта возвращает вас на главную страницу проекта.

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

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

Контекстные файлы

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

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

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

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

Предпросмотр файлов проекта работает так же, как в чате: PDF, DJVU, изображения, Markdown, код, таблицы, документы Word/Office и презентации открываются прямо в окне. DJVU, поддерживаемые документы и презентации Искра показывает как серверную PDF-версию. В меню скачивания можно выбрать Оригинал или, для нетабличных форматов, если доступно, PDF.

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

XLSX, XLS, XLSM, шаблоны Excel, ODS/FODS/OTS, CSV и TSV открываются в табличном режиме только для чтения, без преобразования в PDF. В нём доступны листы, копирование, объединённые ячейки, формулы, оформление, закреплённые области, выпадающие списки и статические PNG-диаграммы. Редактирование, интерактивные диаграммы, сводные таблицы и спарклайны не поддерживаются. После 200 000 непустых ячеек просмотр становится частичным, и Искра показывает постоянную заметку; оригинал остаётся доступен для скачивания.

Рядом с заголовком «Файлы» показан расход файлового хранилища в формате «использовано / лимит» и небольшой круговой индикатор. Нажатие на него открывает окно перехода на тариф выше, если вам нужно больше места.

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

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

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

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

Архивация и восстановление

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

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

Обзор

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

Аккаунт и профили

Аккаунт — это ваша учётная запись в Искре: email, пароль, имя, аватар, язык интерфейса, тема оформления. Аккаунт у человека один, и через него вы входите в систему. Личные настройки безопасности (смена email, пароля, удаление аккаунта) живут именно на этом уровне.

Профиль — это рабочий контекст. У каждого аккаунта есть:

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

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

Все ваши данные — беседы, пространства, файлы, статистика и подписка — привязаны не к аккаунту в целом, а к активному профилю. Поэтому переключение контекста меняет то, что вы видите в чате, в боковой панели и в настройках.

Переключатель профиля

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

сокращается до 9 символов) стоит в шапке справа, рядом с уведомлениями, и открывает список снизу; в меню профиля пункт «Профиль» есть и там.

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

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

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

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

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

Что такое организация

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

единое управление участниками и их ролями;

внутренние группы для более тонкой структуризации (отделы, потоки обучения, направления);

общую подписку, по которой работают все участники организации.

Вы можете состоять в нескольких организациях одновременно — каждая из них появляется отдельным профилем в переключателе.

Страница организации

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

Информация. Основные сведения:

название и аватар (первая буква названия, если иконка не загружена);

описание (если задано);

идентификатор (короткое имя в адресе);

статистика: сколько участников и сколько групп.

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

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

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

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

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

Подписка. Тариф (пакет) организации: текущий план, лимиты и оплата. Вкладку видят все участники, но управление тарифом — выбор пакета, оплата, докупка токенов — доступно только владельцу и администратору. Подробнее — в разделе Настройки → Биллинг.

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

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

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

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

Обновление навыка — из окна с подробностями можно отправить новую версию навыка.

Отзыв навыка — из того же окна навык можно отозвать. После подтверждения он перестаёт быть доступным участникам организации; обновление списка происходит в течение короткого времени.

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

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

Роли в организации

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

Роль Возможности

Полный контроль: управление участниками, группами,

Владелец настройками организации, подпиской. Может назначать

администраторов.

Управление участниками на вкладке «Сотрудники» и

Администратор группами на вкладке «Группы»; доступ к настройкам

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

Просмотр информации об организации, списка

Участник сотрудников и групп. Работа в общих пространствах и

беседах.

Роль участника отображается цветной меткой рядом с именем в списке.

Внешний показ материалов организации

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

Доски: персональное право участника. Внешние аудитории доски — «Адресно» и «По ссылке» — открывает право «Разрешить выносить доски наружу». Владелец и администратор организации имеют его по роли, а участнику его выдают поимённо — переключателем в его строке на вкладке «Сотрудники»; по умолчанию права нет, и в окне доступа к доске написано, к кому за ним идти. Право спрашивается при каждом открытии доски, поэтому отзыв сразу закрывает читателям все внешние доски этого человека, а досок его коллег не касается. Личная доска права не требует: своим материалом человек распоряжается сам.

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

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

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

Приложения организации

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

Права зависят одновременно от владения конкретным приложением и роли профиля в этой организации:

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

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

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

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

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

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

Приглашение участников

Владелец или администратор организации добавляет нового участника одним из способов.

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

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

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

По ссылке-приглашению. Создайте ссылку (опционально привязанную к конкретной группе) и отправьте её любым способом.

При переходе по ссылке-приглашению пользователь видит:

название организации и её аватар;

название группы (если приглашение привязано к ней);

кнопку «Присоединиться».

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

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

Связь с подпиской

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

личные тарифы оплачиваются на личном профиле и действуют только в нём;

пакет организации оплачивается владельцем и распространяется на всех участников этой организации;

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

Пакет организации даёт общий месячный пул МТ, а количество участников не ограничивается числом мест. Рекомендуемое число пользователей в тарифе помогает выбрать размер пакета, но не блокирует приглашения.

Подробнее о тарифах и оплате — в разделе Настройки → Биллинг.

Обзор

Если у вас есть промокод на подписку организации, активировать его может только владелец организации (раздел Организация → Биллинг).

Три типа льготы:

Бонусные мегатокены — добавляют N МТ в общий пул организации на заданное число расчётных периодов.

Бесплатный период — даёт N дней или N расчётных периодов подписки без оплаты.

Скидка % — уменьшает цену пакета на ближайшие N оплат.

Как активировать:

При оформлении пакета — введите код в поле «Промокод» на странице оформления. Цена или условия пересчитаются автоматически.

На активном пакете — раздел биллинга организации, поле «Активировать промокод». Скидка применится к следующим оплатам, бонусные МТ добавятся в пул, бесплатный период продлит действие пакета.

Карточка активного промокода (видна только владельцу): тип льготы, остаток периодов, срок действия, кнопка «Отменить». Бесплатный период применяется единоразово и не отменяется через карточку. Бонусные МТ можно применять дополнительно, но один и тот же код всё равно погашается организацией только один раз.

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

Важно:

Скидка и бесплатный период эксклюзивны: если один из таких промокодов уже действует, второй активировать нельзя.

Бонусные МТ аддитивны, но повторно активировать тот же код нельзя.

Один и тот же код можно погасить только один раз — после отмены повторно активировать его нельзя.

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

Устаревшие промокоды на бесплатные или бонусные места не применяются к пакетным тарифам организации.

Возможные ошибки:

«Код не найден» — проверьте написание (личный промокод на подписке организации не работает).

«Промокод истёк» / «Лимит активаций исчерпан».

«У организации уже есть активный промокод» — отмените текущий.

«Вы уже активировали этот промокод».

«Тариф не подходит под промокод» — код выдан для других тарифов.

«Тип льготы не подходит для пакета» — промокод относится к прежней модели оплаты за места.

Обзор

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

Настройки разделены на вкладки: Профиль, Безопасность, Аудит, Статистика, Хранилище, Публичные ссылки, Приложение. Дополнительно, если соответствующие возможности включены на платформе, появляются вкладки Биллинг, Реферальная программа, API-ключи и Учебный профиль (последняя — только когда включена функция обучения).

Многие данные привязаны не к аккаунту в целом, а к активному профилю (см. раздел Аккаунт, профили и организации). Поэтому подписка, статистика, расход токенов и часть параметров профиля меняются при переключении контекста через переключатель профиля в боковой панели.

Пользователь

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

Аватар. Нажмите на изображение аватара, чтобы загрузить фотографию. Если аватар не загружен, система отображает сгенерированный аватар с вашими инициалами. Загруженный аватар можно удалить, вернувшись к сгенерированному.

Основные данные:

Имя — ваше отображаемое имя в системе. Видно другим пользователям в пространствах.

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

Должность — ваша должность или специализация (необязательное поле).

О себе — краткая информация о вас (необязательное поле).

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

Часовой пояс — ваш пояс: Екатеринбург, Владивосток, Москва или любой другой из списка. Подробнее — в разделе «Часовой пояс» ниже.

Для сохранения изменений нажмите кнопку «Сохранить». Кнопка становится активной только при наличии несохранённых изменений.

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

Часовой пояс

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

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

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

Пока пояс не задан, Искра его не угадывает: прежде чем поставить срок с местным временем («поставь на 21:00»), она спросит, в каком вы поясе, и назовёт его в ответе. «Напомни через десять минут» работает и без пояса — местные часы там не нужны. А вот

в разделе «Планы» время считается по UTC, пока пояс не задан, поэтому задать его всё равно стоит сразу: в Москве 21:00 UTC — это полночь, в Екатеринбурге два часа ночи, во Владивостоке семь утра следующего дня.

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

Показ имени в опубликованных беседах

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

Смена email и пароля

Смена email. Для изменения адреса электронной почты нажмите кнопку смены email. Процедура состоит из двух шагов:

1. Введите новый email.

2. Подтвердите его 6-значным кодом, отправленным на новый адрес.

Смена пароля. Для изменения пароля заполните три поля:

Текущий пароль — для подтверждения вашей личности.

Новый пароль — придумайте новый пароль. Индикатор надёжности подскажет качество пароля.

Подтверждение нового пароля — повторите новый пароль.

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

Персонализация ответов: что Искра помнит о вас и откуда знает ваши

предпочтения

Искра подстраивает ответы под вас, но беседы сами по себе не запоминает. Всё, что она учитывает в личной беседе, приходит из трёх источников; на вопрос «что ты обо мне знаешь?» она называет те из них, что есть в этой беседе, не пересказывая устройство ответа.

Сохранено по вашей просьбе. Факт, который вы попросили запомнить («запомни, что…»), сохраняет встроенный навык «Память», если он включён (раздел «Навыки»). Обычный факт действует во всех беседах, пока вы не попросите его забыть, — их Искра перечисляет по вопросу «что ты помнишь обо мне?» и показывает в memory.md на панели артефактов; заметка «на этот чат» — отдельный файл session-note-*.md в рабочей папке беседы, действует только в ней. Закреплённые положения ( /pin текст ; список и снятие — окно «Закреплённые положения», которое открывают кнопка в нижней строке панели запроса и голая команда /pin ) действуют до конца одной беседы.

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

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

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

Биллинг

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

Тарифы

В Искре есть личные тарифы и отдельные пакетные тарифы для организаций. Точные значения лимитов и доступные возможности видны на странице тарифов и на карточке текущего плана.

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

Пакеты для организаций действуют в контексте организации и дают общий месячный пул МТ всем участникам. Состав организации не ограничивается количеством мест, а подсказка «рекомендовано» помогает выбрать размер пакета.

Точные цены, лимиты МТ, объём хранилища, максимальный размер файла и список доступных возможностей берутся из текущей тарифной конфигурации. Смотрите их на публичной странице /pricing, в карточке текущего плана и на вкладке Организация → Подписка ( /org?tab=billing ) для организаций.

МТ — мегатокен, единица учёта расхода: 1 МТ = 1 000 000 токенов модели. И ваши вопросы, и ответы ассистента считаются в одной валюте. Подробнее о расходе — в разделе «Статистика» ниже.

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

Тариф «Старт» — стартовый и страховочный

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

Старт также служит «подушкой» при возврате с платных тарифов:

если вы отменили подписку — по окончании оплаченного периода профиль вернётся на Старт;

если повторные попытки автосписания подряд завершились ошибкой — подписка тоже даунгрейдится на Старт.

В обоих случаях работа в чате не прекращается — продолжаются только базовые лимиты Старта.

Состояния подписки

В карточке подписки рядом с названием тарифа показан текущий статус:

Активна — подписка действует, лимиты применяются. Для платных планов рядом видны даты текущего периода.

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

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

Отменена — вы запланировали возврат на Старт; подписка остаётся действующей до даты окончания текущего периода, после чего автоматически переключится.

Истекла — подписка завершена.

Что показано в карточке подписки

Название текущего тарифа и его статус.

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

Период действия: даты начала и конца текущего цикла. Для тарифа Старт — «Бессрочно».

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

Месячный лимит МТ действует в рамках оплаченного месяца и отсчитывается от даты покупки, а не от начала календарного месяца. Окно сдвигается на следующий месяц, когда начинается новый оплаченный период; расход внутри текущего окна сохраняется. Если вы продлеваете подписку заранее, лимит не обнуляется в момент оплаты — новый отсчёт начнётся с началом нового периода.

Баннер «Запланирован переход» — если вы выбрали другой тариф со следующего цикла.

Баннер «Подписка отменена» — если вы вернулись на Старт; в нём указано, до какой даты будет действовать текущий план.

Баннер «Незавершённая оплата» — если последний платёж ещё не подтвердился; кнопками можно завершить оплату или отменить заявку.

Смена тарифа

Кнопка «Сменить тариф» в карточке личной подписки или ссылка «Тарифы» в навигации ведут на страницу выбора личного плана. Там показано, во сколько раз увеличивается месячный лимит относительно Старта, и какие функции включены. Для организации владелец выбирает пакет на вкладке Организация → Подписка ( /org?tab=billing ): там отображаются пакетные тарифы с месячным пулом МТ, рекомендуемым числом пользователей и хранилищем.

Поведение при выборе зависит от соотношения цен:

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

например, при 70% оставшихся дней и 20% МТ зачтётся 20% оплаты. Бесплатно выданный период зачёта не даёт. Сначала применяется промокод на новый тариф, затем вычитается зачёт; он не может превышать стоимость нового тарифа. Если следующий период уже оплачен досрочно, повысить тариф можно после его начала. Если расход МТ временно недоступен, повторите расчёт позже.

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

Уже запланирован переход — если вы повторно выбрали тот же план, система покажет напоминание и не создаст второй платёж.

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

Сброс месячного лимита

Если платный месячный лимит исчерпан раньше конца периода, на тарифах от «Про» и выше есть способ вернуться к работе сразу, не дожидаясь автоматического обновления окна. Кнопка «Сбросить лимит» появляется в карточке подписки на вкладке «Биллинг», как только вы израсходовали не меньше 90% месячного лимита текущего периода, а на карточке исчерпанного лимита в чате та же возможность показана отдельной строкой под предложением сменить тариф (у тарифа Ultra, для которого апгрейда не существует, сброс — основное действие).

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

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

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

Оплата через YooKassa

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

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

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

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

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

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

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

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

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

Подписка на организацию

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

Пока пакета у организации нет, любая такая операция возвращает уведомление «Организация не активна» с кнопкой перехода к оплате. Пакет оформляется владельцем на вкладке Организация → Подписка ( /org?tab=billing ) и распространяется на всех её участников. Расход участников списывается из общего месячного пула организации; администратор организации может дополнительно назначать личные квоты участникам.

Оплата по счёту (для юридических лиц)

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

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

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

ИНН — при вводе система пытается автоматически подставить название организации, КПП и юридический адрес (если на платформе подключена база ЕГРЮЛ). Если компания не найдена или автоподстановка не настроена, заполните поля вручную.

Название юрлица и юридический адрес.

Email бухгалтерии (необязательно) — на него можно будет отправить ссылку на счёт.

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

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

Пока счёт не оплачен или не отменён, его карточка видна на вкладке биллинга организации: номер, срок действия и кнопки:

«Скачать PDF» — получить файл счёта для оплаты в банк-клиенте;

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

секунд, а его судьба («ожидает отправки», «отправлено», «доставлено», «ошибка доставки») видна строкой под кнопкой;

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

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

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

Если у продлеваемого пакета не включено автопродление, рекомендуем не откладывать оплату по счёту до последнего дня — банковский перевод обычно идёт 1-2 рабочих дня, и лучше выставить счёт заранее. Мы напомним об этом письмом примерно за неделю до окончания периода.

Учебный профиль

Эта вкладка доступна, только когда на платформе включена функция обучения. По умолчанию она скрыта.

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

Если вы прошли онбординг, на странице отображаются ваши данные:

Роли — ваша роль или специальность (например, разработчик, аналитик, менеджер).

Опыт — ваш уровень опыта работы с AI.

Рабочие задачи — типичные задачи, которые вы решаете.

Цели обучения — чему вы хотите научиться (если были указаны).

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

Если онбординг ещё не пройден, на странице будет предложено начать его.

Аудит

Вкладка «Аудит» содержит журнал нарушений безопасности, зафиксированных системой (например, попытки подменить инструкции ассистента).

Записи отображаются в виде таблицы со следующими колонками:

Дата — время фиксации нарушения.

Статус — уровень серьёзности инцидента.

Категория — тип нарушения.

Источник — откуда поступил запрос.

Текст сообщения — содержимое, вызвавшее срабатывание.

Статистика

Страница статистики показывает информацию о вашем использовании платформы в активном профиле.

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

странице. Пункт есть только у профилей с месячным лимитом.

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

использование за текущий месяц подписки;

месячный лимит текущего тарифа и дата, когда окно обновится;

полоса прогресса.

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

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

График входных и выходных токенов показывает фактический объём текста, а для сравнения с лимитами ориентируйтесь на значения в МТ.

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

График за 30 дней. Линейный график показывает динамику потребления токенов за последние 30 дней. На графике отображаются две линии:

входные токены (ваши сообщения и контекст);

выходные токены (ответы ассистента).

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

Суммарная статистика:

общее количество токенов за месяц (входные и выходные);

среднее количество токенов в день.

Топ бесед. Два списка наиболее «дорогих» бесед по потреблению токенов:

топ бесед за всё время;

топ бесед за сегодня.

Каждая запись содержит название беседы, количество входных и выходных токенов и общий расход. Нажмите на название, чтобы перейти к беседе.

Хранилище

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

Общий расход. Вверху — сколько места использовано относительно лимита тарифа и заполнение в процентах.

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

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

Если места не хватает, отсюда можно перейти к смене тарифа.

Публичные ссылки

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

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

Счётчик — сколько публичных ссылок сейчас действует в активном профиле.

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

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

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

Скопировать ссылку — адрес попадает в буфер обмена.

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

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

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

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

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

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

Вкладка «Доски»

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

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

Состав доски, её аудитория, фиксация версии, удаление и восстановление описаны в разделе «Доски».

Антоним — приватный режим

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

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

Что остаётся вне режима — обычным маршрутом платформы по-прежнему идут:

голосовой ввод (распознавание речи);

озвучка ответа модели — сейчас озвучка нигде не включена, поэтому фактически этот путь не используется; ограничение начнёт действовать, когда она вернётся;

письмо «задача выполнена» по расписанию, если у задачи включено Email-уведомление: в теле письма идёт полный текст результата;

отправка навыка на модерацию;

сводка для администратора платформы.

Мобильное push-уведомление сюда не относится: в приватном режиме оно приходит без предпросмотра текста ответа.

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

Как включить: откройте настройки → вкладка «Безопасность» → переключатель «Антоним — приватный режим». Изменение вступает в силу в течение ~1 минуты. Для отдельной беседы режим переключается в нижней строке панели запроса (кнопка со щитом).

Когда переключатель недоступен:

Режим не открыт на платформе — переключатель скрыт или заблокирован, если администратор не открыл приватный режим вашей организации.

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

Чем приватный режим отличается на практике:

отвечает другая модель, поэтому на сложных задачах ответ может отличаться, а уровни сложности сводятся к одному;

запасной модели у режима нет: если серверы Искры заняты, запрос не выполняется и появляется сообщение с кнопкой «Повторить». Запрос при этом не исполнялся — списания за него нет;

если нужной возможности на серверах Искры нет (например, распознавание сканов), Искра скажет об этом прямо: повтор здесь не поможет, вопрос решает администратор;

переключение во время идущего ответа применится со следующего сообщения.

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

Подробное техническое описание Антонима есть в документации для администраторов.

Реферальная программа

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

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

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

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

Статистика — сколько человек пришло по вашей ссылке и сколько из них оформили подписку, а также выручка с рефералов.

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

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

Приложение

Общие настройки приложения и техническая информация.

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

Язык интерфейса (interface language): русский, английский, французский, китайский

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

Язык ответов (response language)

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

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

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

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

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

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

Обзор

В Искре есть три типа промокодов:

1. Бесплатный план — выдаёт подписку на N дней без оплаты.

2. Скидка — даёт X% скидки на следующие N оплат.

3. Сброс расхода — обнуляет уже потраченный за текущий месяц объём токенов.

Все активируются из настроек тарифа: Настройки → Тарифы и оплата → Активировать промокод. Поле для ввода кода видно всегда, даже если у вас уже есть активная платная подписка.

Этот раздел — про личные промокоды. Промокоды для подписки организации (бонусные МТ, бесплатный период, скидка) активирует владелец организации — они описаны в разделе Организация.

Обзор

Введите код и нажмите «Активировать». Если промокод действителен — вы сразу получаете подписку на указанный план (Pro, Expert или другой) на N дней. После окончания срока подписка автоматически переходит на тариф «Старт».

Активировать можно, только когда у вас нет активной платной подписки. Если уже есть платная — дождитесь её окончания.

Обзор

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

Сценарии:

Если у вас ещё нет платной подписки — после ввода кода выберите тариф и нажмите «Подписаться»: цена пересчитается со скидкой автоматически.

Если у вас есть активная подписка — скидка применится при следующем списании (продление).

Скидка действует на ограниченное число оплат (например, 3 периода × 25% скидки). После исчерпания подписка продлевается по полной цене.

Ограничения тарифов. Скидка может быть привязана к конкретным тарифам (например, только Pro и Expert). На странице активной скидки в настройках видно, к каким тарифам она применима.

Обзор

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

Что стоит знать про такое предложение:

вводить ничего не нужно — скидка уже привязана к аккаунту;

она действует только на переход на «Про» и только на первый месяц, дальше подписка продлевается по полной цене;

предложение живёт ограниченное время (обычно неделю); если не воспользоваться, оно сгорает;

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

в следующем месяце, если лимит снова закончится, предложение может появиться заново.

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

Обзор

Когда у вас есть активный скидочный промокод, на странице Настройки → Тарифы и оплата появляется карточка «Активная скидка»:

Промокод и процент скидки (у скидки без промокода вместо кода написано, откуда она — например «Скидка за исчерпанный лимит»)

Прогресс «Осталось N из M периодов»

Срок действия (до какой даты можно использовать)

Применимые тарифы

Обзор

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

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

Обзор

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

Активировать его можно и при активной платной подписке — поле ввода промокода доступно всегда, именно для таких кодов.

Когда активировать выгоднее. Чем ближе расход к месячному лимиту, тем полезнее сброс. Если на момент ввода кода израсходовано меньше половины лимита, Искра переспросит: «Израсходовано X% лимита — сброс выгоднее ближе к лимиту. Активировать сейчас?». Можно подтвердить или отменить и сохранить код на потом — активировать его позже, когда расход будет ближе к пределу.

Если код не срабатывает:

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

«Сначала завершите или отмените начатую покупку сброса лимита» — если у вас есть незавершённая платная покупка сброса лимита, сначала оплатите её или отмените, а затем активируйте промокод.

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

Обзор

«Код не найден» — проверьте правильность написания.

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

«У вас уже есть активный промокод со скидкой» — отмените текущий в настройках, чтобы ввести новый.

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

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

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

«У профиля нет личной подписки» — относится к промокоду на сброс расхода; такое почти не встречается.

«Сначала завершите или отмените начатую покупку сброса лимита» — относится к промокоду на сброс расхода: на подписке есть незавершённая платная покупка сброса лимита.

«Слишком много попыток» — превышен предел числа попыток (5 в минуту). Подождите минуту.

Обзор

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

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

Обзор

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

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

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

Личные — навыки, которые вы создали или подали сами. Пока таких навыков нет, секция не показывается совсем: создать свой можно кнопкой «+ Добавить свой навык» над списком.

Организации — навыки, опубликованные в вашей организации, и установки каталога, сделанные для организации. Секция видна только когда вы работаете в контексте организации.

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

Из каталога — навыки, которые вы установили себе с витрины каталога.

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

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

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

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

Страница подробностей

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

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

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

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

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

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

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

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

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

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

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

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

Режим меняется на странице подробностей навыка (переключатель в правом верхнем углу) и применяется сразу:

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

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

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

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

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

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

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

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

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

На странице навыка откройте вкладку Настройки — там есть блок «Подтверждение действий» с двумя вариантами:

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

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

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

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

Блок появляется не у всех навыков: администратор платформы может выключить такую возможность для конкретного навыка.

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

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

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

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

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

Обзор

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

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

Погода

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

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

«какая погода в Москве»

«прогноз на 5 дней в Питере»

«будет ли дождь завтра в Казани»

Валюты

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

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

«курс юаня»

«переведи 100 долларов в евро»

«сколько сейчас стоит доллар»

Даты

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

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

«сколько рабочих дней до конца месяца»

«какой день недели через 90 дней»

«сколько дней между 1 января и 9 мая»

Википедия

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

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

«найди в Википедии Кватернион»

«краткая сводка по статье Фотосинтез»

«что Википедия пишет про Тьюринга»

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

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

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

«переведи 5 км в мили»

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

«100 мегабайт в гигабайтах»

Работа с PDF

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

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

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

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

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

«заполни поля формы и сохрани новый PDF»

«распознай русский и английский текст на скане»

«объедини эти PDF, поставь пароль и проверь готовый файл»

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

Презентации

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

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

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

Для новой презентации Искра определяет результат по запросу:

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

HTML для PDF — отдельная статическая версия: каждый слайд имеет печатную геометрию, а данные, значения, подписи, примечания и статические визуалы видны

без запуска анимации. Перед выдачей Искра экспортирует фактически созданный HTML штатным offline-конвертером и отдаёт исходный HTML вместе с полученным PDF. Так Искра отвечает на явный запрос печати или PDF.

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

Исходник каждого варианта — отдельный HTML-файл. Новые интерактивные версии работают и в Искре, и после скачивания: вне Искры браузер загружает те же шрифты, иконки, графики и средства навигации из CDN, поэтому нужен доступ к Интернету. Файл остаётся редактируемым; его можно снова загрузить в Искру. Новые слайды используют Reveal.js для навигации, шагов раскрытия и обзора презентации. Для предметных меток и кнопок доступны единые контурные иконки Lucide: их цвет, размер и толщину линий можно менять вместе с оформлением слайдов. Искра сначала определяет, какую информацию добавляет графика, затем выбирает её форму и согласует с общей композицией. Ранее созданные файлы продолжают открываться в превью с прежними шрифтами и навигацией. К печатному HTML добавляется проверочный PDF. Навык не создаёт PPTX.

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

В режиме HTML для PDF каждый слайд занимает отдельную страницу 16:9, а весь смысл сразу виден в статической разметке без поэтапного раскрытия и JavaScript. Если материал не помещается на один слайд, Искра разбивает его на дополнительные страницы, сохраняя смысл и читаемый размер текста.

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

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

«переработай эту HTML-презентацию для самостоятельного чтения»

«обнови цифры на третьем слайде, сохрани оформление и имя файла»

«подготовь интерактивную презентацию и отдельную версию для печати с PDF»

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

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

одну визуализацию наблюдений, сравнений, временных рядов, распределений, иерархий или потоков — diagram.html ;

календарный план работ в форме диаграммы Ганта или сеть зависимостей «работы в

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

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

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

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

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

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

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

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

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

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

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

«покажи одним графиком динамику выручки и маржи по месяцам»

«построй диаграмму Ганта по этим работам, датам и зависимостям» «покажи сеть 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 МиБ суммарно. Исходные файлы не меняются. Если часть вариантов не удалась, готовые остаются доступными: Искра покажет их и объяснит, что не завершено. Успешные варианты автоматически повторно не генерируются. При локальной правке Искра передаёт в инструкцию, что именно изменить и какое содержание вне выбранной области сохранить; если граница правки допускает существенно разные результаты, она может сначала уточнить её. Редактирование выполняется без маски, поэтому точное пиксель-в-пиксель сохранение остальных областей не гарантируется. Результат сохраняется в файлы сессии и обязательно показывается в ответе.

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

«нарисуй минималистичный постер ночного города в синих тонах»

«стилизуй приложенную фотографию под акварель, сохрани композицию»

«создай квадратную иллюстрацию робота-садовника для обложки»

«сделай три варианта афиши: товар возьми с первой картинки, стиль — со второй»

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

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

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

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

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

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

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

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

референсы используются в разных запросах; последний кадр задаётся вместе с первым. Суммарный размер входных изображений — до 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 МиБ и укажите нужный файл. Можно добавить текст, произнесённый в образце. Образец используется в этом запросе и не создаёт постоянный голосовой профиль. Исходный файл сохраняется без изменений.

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

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

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

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

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

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

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

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

«Сделай песню на русском по этому тексту, акустическая гитара и мягкий вокал; выдели куплет и припев: …».

«Для этого раза используй Lyria 3 Clip; сохранённую модель оставь прежней».

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

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

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

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

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

«расшифруй это аудио»

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

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

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

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

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

Датаньютон

Навык из категории «Интеграции» проверяет российских контрагентов через сервис 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 вашим сообщениям в аккаунте» — вы внутри автоматического периода. Это подпись для значения по умолчанию; если администратор платформы настроил период иначе, число будет другим, а в режиме «по дням» подпись вместо сообщений говорит о днях после регистрации аккаунта.

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

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

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

Обзор

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

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

«сделай навык, который …»

«запомни это как навык»

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

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

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

Задача и получатель: «Что вы хотите делать каждый раз? Кто будет читать результат — вы, коллеги или клиент?»

Готовый результат: «Нужен ответ в чате, документ Word или таблица Excel?»

Материалы: «Где лежат актуальные цены и условия? Есть ли образец хорошего предложения?»

Подключения: «Откуда брать сведения о сделке? Через какую почту отправлять согласованное письмо?»

Проверка: «Что нужно сверить перед выдачей? Кто подтверждает отправку?»

Кому доступен навык: «Он нужен лично вам или вашей команде?»

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

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

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

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

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

1. Когда применять: задача и признаки того, что навык подходит.

2. Что уточнить: недостающие данные, получатель и условия; известное из беседы или

доступных документов Искра использует сразу.

3. Источники: подключённые сервисы и материалы, назначение каждого файла, порядок

действий при недоступном или устаревшем источнике.

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

5. Проверка: что сверить с исходными данными, когда привлечь отдельного помощника и

как исправить его замечания.

6. Результат: формат, место сохранения и действия, которые пользователь

подтверждает перед отправкой или записью во внешний сервис.

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

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

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

Что нужно сохранить Где хранить Пример

Шаги подготовки отчёта,

Порядок работы Инструкция навыка правила проверки и формат

результата

Обезличенный образец

Общие файлы готового Комплект загруженного

отчёта, задание

навыка навыка

проверяющему

Действующий прайс-лист,

Материалы компании, Папка Памяти, привязанная

условия поставки,

нужные в разных беседах к навыку

фирменный шаблон Word

Приложения к сообщению

Документы для одного или отдельная папка, Договор клиента, состав клиента или одной задачи подключённая к беседе заказа, записи встречи

через «@»

Что нужно сохранить Где хранить Пример

Первый вариант

Промежуточные варианты Черновики предложения, расчёты и

замечания помощника

Готовый результат и Рабочая папка чата, раздел Проверенное предложение важные пояснения «Файлы чата» для отправки клиенту

Ключи и пароли Защищённая настройка Пароль приложения для подключения подключения почты, токен сервиса

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Задача: подготовить предложение по сделке «Оснащение офиса Север» на 20 рабочих мест и отправить его после согласования.

Подключения: amoCRM для сделки и контактов; Яндекс.Почта через навык «Почта» для отправки письма.

Материалы: папка Памяти «Продажи» с прайс-листом Excel, условиями поставки и шаблоном КП в Word; состав заказа — в сообщении пользователя.

Результат и проверка: расчёт и первый вариант в Черновиках; отдельный помощник сверяет цены, состав заказа и условия. Готовый Word — в «Файлах чата». Перед отправкой пользователь подтверждает получателя, письмо и вложение.

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

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

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

Материалы: папка Памяти «Аналитика сайта» с описанием того, что считать заявкой, календарём рекламных кампаний и прошлым отчётом как образцом.

Результат и проверка: расчёты в Черновиках, готовый отчёт с графиками в «Файлах чата». Помощник сверяет периоды, числа и основания выводов.

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

Задача: подготовиться к встрече с компанией «Вектор» по продлению сервиса: вспомнить договорённости и собрать открытые вопросы.

Подключение: Битрикс24 для сделки, контактов, комментариев и запланированных дел.

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

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

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

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

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

Подключение: Gmail через навык «Почта» — выбранное письмо и нужная переписка.

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

Результат и проверка: варианты и замечания — в Черновиках. Помощник сверяет ответ с вопросом клиента, правилами компании и текущими данными. Если новая дата поставки неизвестна, это прямо сказано. После исправлений готовый текст

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

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

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

Имя — как будет называться навык.

Когда применять — описание, по которому Искра решит, что навык подходит к запросу.

Инструкция — текст, которому ассистент будет следовать.

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

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

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

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

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

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

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

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

В личном профиле навык всегда создаётся личным — он виден только вам.

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

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

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

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

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

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

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

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

MCP

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Для критичных ключей всё же рекомендуется защищённая форма выше — в ней значение в переписку не попадает вовсе.

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

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

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

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

Обзор

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

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

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

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

фразой в чате — например, «запусти сценарий [ВПИШИ название]»;

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

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

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

Обзор

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

«покажи мои навыки» — список ваших навыков с режимом и уровнем, чтобы найти нужный;

«включи навык … по команде» / «выключи навык …» — смена режима;

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

«удали навык …» — удаление личного навыка (или навыка организации, если вы владелец или администратор), с подтверждением;

«поделись навыком … с коллегами» — передача своего личного навыка организации, с подтверждением (см. «Передача личного навыка организации» ниже);

«какие у меня заявки на навыки» — статус заявок на сборку и модерацию, отмена заявки.

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

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

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

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

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

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

Обзор

Кроме встроенных навыков вы можете добавить собственный. Нажмите кнопку «Добавить свой навык» над списком навыков — появится окно с выбором способа. Есть четыре способа — от самого простого к самому гибкому:

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

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

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

Описывайте нужные ассистенту возможности обычными словами («сгенерируй картинку по описанию»), а не служебными именами инструментов других навыков вида 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-образ через неё подать нельзя. Если вам нужен контейнерный навык, обратитесь к администратору платформы — такая загрузка выполняется отдельно. Если у вас только инструкция без готового комплекта, выберите способ «Текстовый навык».

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

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

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

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

1. Заявка отправляется и попадает на автоматическую проверку.

2. Если всё в порядке — навык одобряется и собирается.

3. После успешной сборки навык публикуется и появляется в каталоге.

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

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

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

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

Подана — заявка принята и ждёт проверки.

Проверка ИИ — навык автоматически проверяется.

Ждёт ручной проверки — автоматическая проверка передала заявку модератору (например, она не уверена в результате или проверка временно недоступна). Нужно подождать.

Одобрено — навык прошёл проверку.

Сборка — навык собирается перед публикацией.

Опубликовано — навык готов, появился в каталоге и при первой публикации получил режим «Авто».

Нужна доработка (отклонено) — навык не прошёл проверку. Под статусом показана причина; после исправления можно отправить ту же версию заново.

Сборка не удалась — навык не собрался. Увеличьте номер версии и загрузите снова.

Отменено — вы сами отменили заявку; версия освобождается, и её можно подать заново.

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

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

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

Подробности навыка

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Обзор

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

Кнопка находится на странице подробностей навыка (откройте её кнопкой «Подробнее» в разделе Навыки), в нижней панели действий:

если вы владелец или администратор организации — «Передать организации»: навык перейдёт сразу;

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

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

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

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

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

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

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

Освободившееся имя снова свободно: после передачи вы можете завести новый личный навык с тем же названием.

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

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

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

режимы включения («Выкл», «По команде», «Авто»), которые вы или коллеги выбирали для себя;

согласия на доступ навыка к данным;

карта знаний подключения — её придётся собрать заново;

сценарии, которые вы сохраняли поверх навыка. Сценарии, приложенные к навыку автором, переносятся вместе с ним;

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

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

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

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

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

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

навык выставлен на витрину или по нему подана заявка на публикацию — сначала снимите его с витрины;

по навыку идёт правка или проверка — дождитесь её окончания и повторите;

по этому навыку уже идёт незавершённая передача — дождитесь, пока она закроется (обычно несколько минут), и решите заявку снова;

манифест этой версии разошёлся с реестром — повторять бесполезно: опубликуйте новую версию навыка и передайте её;

вы не состоите в организации либо организация заблокирована.

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

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

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

В той же строке видны и два других состояния:

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

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

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

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

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

Заявки сотрудников разбираются только в разделе Навыки: над списком навыков появляется блок «Заявки на передачу навыков». Ссылка из уведомления открывает его сразу.

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

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

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

Дальше два действия:

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

«Отклонить» — причина обязательна: она уедет автору в уведомлении.

Если заявку уже решил другой администратор, Искра сообщит об этом и предложит обновить список.

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

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

Обзор

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

Обзор

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

Обзор

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

Память в веб-версии

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

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

Чтобы использовать папку в беседе, подключите её через «@ Папки» — рабочей папкой синхронизируемая папка стать не может (см. «Рабочая папка чата» в разделе «Чат»). У чата либо своя служебная папка, либо заранее выбранная папка Памяти — её содержимое показано в зоне «Файлы чата» на панели запроса: там лежат файлы, созданные в самой беседе, а не содержимое подключённой синхронизируемой папки.

Настроить или изменить саму синхронизацию в веб-версии нельзя — это делается в десктоп-приложении Искры. Веб-версия показывает содержимое синхронизируемых папок в Памяти.

Размещение файлов синхронизируемой папки на доске

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

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

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

Синхронизация через десктоп-приложение

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

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

Привязать папку — выбрать локальную папку и начать её синхронизацию.

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

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

Серверные папки — ранее синхронизированные папки можно скачать и синхронизировать на текущий компьютер. Обычные папки Памяти в этом списке не показываются.

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

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

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

С Диска в Память, чат или проект

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

1. В десктоп-приложении откройте «Память» → «Синхронизация с компьютером» и

нажмите имя привязанной папки. Откроется просмотр её содержимого на Диске.

2. Выберите «Открыть в Памяти», чтобы перейти к её файлам, или «Подключить к

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

3. Для уже начатой беседы откройте нужный чат и подключите папку через «@ Папки».

Так же можно добавить вторую папку.

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

Подключение даёт чату или проекту доступ к материалам. Оно не делает синхронизируемую папку рабочей папкой чата и не переносит в неё все файлы беседы автоматически.

Из Памяти на компьютер: что поддерживается

Ранее синхронизированную папку своего профиля можно скачать на этот компьютер, если она ещё не привязана на нём. Войдите в десктоп-приложение под тем же профилем, откройте «Память» → «Синхронизация с компьютером» и найдите её среди серверных папок. Нажмите «Синхронизировать на диск»: приложение создаст для неё локальную папку внутри ~/Iskra/Drive/ . Уже привязанные на этом компьютере папки находятся в верхнем списке привязок.

Обычную личную папку Памяти, служебную папку проекта или чата через этот экран сделать синхронизируемой пока нельзя. Также здесь нет операции связывания существующей папки Памяти с выбранной существующей папкой компьютера. «Привязать папку» создаёт отдельную синхронизируемую папку, а не объединяет её с одноимённой папкой Памяти.

Скачивание отдельного файла из Памяти сохраняет копию на компьютер; постоянную синхронизацию оно не включает.

Поддержка операционных систем

Синхронизация стабильно работает на macOS.

Бета: синхронизация на Windows и Linux находится в бета-режиме и может работать нестабильно. Поддержка этих систем активно дорабатывается. Если вы пользуетесь Windows или Linux, в десктоп-приложении на странице «Диск» появится соответствующее предупреждение.

Обзор

API-ключ даёт доступ к Искре из скриптов, ботов и внешних систем. Можно получить каталоги, выбрать навыки и специалистов, подключить папки и коллекции Памяти, подготовить разговор и выполнить задачу. Ключ создаётся в Настройки → API-ключи; окно «Документация API» показывает примеры с адресом вашего контура.

Все вызовы ниже используют Authorization: Bearer <токен> . Для JSON-тела добавьте

curl -F тип и границу формы устанавливает сам curl).

Возможность Метод Права ключа (scope)

Каталог специалистов и превью плана

Коллекции и их состав s , GET memory:read

Возможность Метод Права ключа (scope)

Создать постоянные папки, memory:read + загрузить файл memory:write

Скачать постоянный файл memory:read

Подготовить разговор без POST chat:run ; права Памяти по запуска задачи /api/v1/conversations выбранным целям

Прочитать и изменить выбор workspace и режим контекст write также требуют

Фоновая задача, опрос, /api/v1/runs/{run_id} , события, отмена GET

файлов разговора /api/v1/chat/{id}/files/{p соответственно

или модель tions , GET также llm:raw

Публикация приложений apps:publish

Для веб-поиска нужен web_search , для запуска навыков — skills:run , для передачи вложений — files:write ; контекст Памяти добавляет свои права к правам запуска и файлов.

Обычный порядок: каталоги → выбор доступного bundle → POST /api/v1/conversations

iskra_exec → скачивание результата. В memory_refs цель задаётся через locator:

secondary_specialist_id , profile_id (профиль модели, а не профиль пользователя), complexity ( simple , normal , hard ), antonym . Ручной набор навыков включает все

настройка запуска уже доступных навыков; установка и настройка навыка выполняются в интерфейсе.

Права memory:read и memory:write при создании ключа отмечают явно; запись требует оба. Права ключа ограничены текущим доступом вашего профиля. Рабочая папка — только личный корень Памяти с правом записи, выбранный до первого сообщения или upload. После снятия memory_refs разговор по-прежнему требует memory:read для продолжения, файлов и результатов: история могла сохранить прочитанные материалы. Файлы Памяти постоянные, срок ключа и TTL разговора задаются отдельно. Подробный исполнимый пример — «Полный сценарий API».

Обзор

1. Откройте Настройки → API-ключи.

2. Нажмите Создать ключ.

3. Укажите название — оно нужно только для того, чтобы отличать ключи в списке

(например, «CI-бот» или «Скрипт выгрузки»).

4. Выберите срок действия: 7, 30, 90, 180 или 365 дней. По умолчанию выбран срок 30

дней.

5. Нажмите Создать.

Дата окончания действия показана после создания и в списке ключей. Новый выбор срока не меняет даты у ранее созданных ключей. По истечении срока ключ перестаёт работать; для продолжения интеграции создайте новый. Если настройки создания временно недоступны, ключ можно создать с серверным сроком по умолчанию — 30 дней; выбор другого срока в этом состоянии недоступен.

Перед созданием окно показывает список областей доступа с флажками. Стандартные права уже отмечены: чат, веб-поиск, запуск навыков, запись и скачивание файлов разговора — можно снять лишние, если ключу они не нужны (например, оставить только чат). Чувствительные права по умолчанию не отмечены и выдаются только явно. Итоговый состав прав виден до создания ключа; относитесь к токену как к паролю.

Чувствительные права в списке:

«Чтение Памяти» ( memory:read ) — позволяет интеграции просматривать доступные вашему профилю папки, файлы и коллекции, подключать материалы для чтения и получать результаты работы с ними.

«Изменение Памяти» ( memory:write ) — позволяет создавать папки, загружать материалы и разрешать запись в подключённую Память. Выдаётся вместе с правом чтения; одно право записи не включает чтение автоматически.

«Прогоны от имени сотрудников организации» ( run:delegate ) — есть только у ключей профиля организации. Отмечайте, только если ключ должен выполнять запросы от имени других сотрудников (например, интеграция, которая обрабатывает документы за конкретного сотрудника): такой ключ сможет действовать от имени любого коллеги в организации.

«Сырой доступ к модели» ( llm:raw ) — открывает OpenAI-совместимый режим прямого обращения к модели с вашими собственными инструментами. Право добавляется к остальным отмеченным правам ключа; в самом режиме прямого обращения агентные функции Искры и навыки не применяются.

«Публикация приложений» ( apps:publish ) — нужно ключу, которым командная строка iskra-app создаёт приложение и публикует его версии. Право действует только в вашем профиле: опубликовать приложение в чужой профиль им нельзя, даже

если у ключа есть право прогонов от имени сотрудников. Как устроены сами приложения — в главе «Приложения».

Чтение досок ( boards:read ) — открывает интеграции материал досок, которыми управляет ваш профиль: список досок, состав показанной версии, её содержимое и скачивание.

Подготовка размещения на доске ( boards:publish ) — позволяет интеграции подготовить размещение файла на доске. Само размещение ключ не выполняет: подготовленное действие подтверждает человек.

Обе области — boards:read и boards:publish — выдаются только явно и в стандартный набор прав ключа не входят: доска показывает готовые документы людям за пределами чата, поэтому доступ к ней ключ получает отдельным решением. Подробности — в разделе «Доски по API-ключу» ниже.

Список показывает только области, разрешённые на вашей платформе: если какого-то права в окне нет, оно недоступно на этом контуре — обратитесь к администратору.

После создания токен показывается один раз. Скопируйте его немедленно — повторно увидеть токен невозможно, платформа хранит только его хэш. Если потеряли токен — отзовите ключ и создайте новый.

Обзор

setup_state . В iskra_exec.skills передаются bundle, а не имена инструментов. requires_setup показывает необходимость настройки; setup_state бывает ready , missing , invalid , unknown . Наличие строки в каталоге само по себе не означает готовность к запуску. Если выбранный или обязательный навык недоступен, сначала завершите его настройку в интерфейсе и снова получите каталог.

plan/defaults возвращает plan , pins , version и options , включая доступные уровни, mandatory_bundles и специалистов. Это превью до создания разговора, которое помогает составить запрос.

Поле iskra_exec Как выбрать

Разрешённый профиль модели из доступных вариантов; отличается от профиля пользователя, к которому привязан ключ

complexity выбирают явно, расход зависит от

фактической модели

Основной специалист: задаёт полный рабочий стиль

Дополнительная предметная экспертиза

secondary_specialist_id вместе с основным; максимум две разные

роли, «Общий» в паре не используется

Ручной массив bundle , включающий все

skills mandatory ; каждый выбранный навык

доступен и готов

Поле iskra_exec Как выбрать

true включает режим Антонима; явное false выключает его, если режим не закреплён политикой платформы или организации

Отсутствующее поле оставляет решение автоматике. Для навыков отсутствие поля или null сохраняет обычный подбор; skills: [] означает ручной пустой набор и допустим только при отсутствии обязательных навыков. Иначе — 403

один ответ с основной и дополнительной экспертизой. Все значения iskra_exec действуют на один запрос в native, async и OpenAI agent; передавайте их снова для следующего хода, если они нужны. Они не меняют постоянные настройки разговора. Без override разговор использует сохранённый автоматический выбор специалистов; сложность API без override — normal .

Обзор

Ключу явно выдаются memory:read для чтения и дополнительно memory:write для записи. Права files:read / files:write относятся к файлам разговора и сами по себе Память не открывают. Уже созданный ключ новые права автоматически не получает.

<uuid> для содержимого корня, &folder_id=<uuid> для подпапки. Доступны фильтры q ,

Используйте идентификаторы и locator из ответа каталога.

Запись или скачивание Памяти Тело / параметры

201 , корень с id

ответ — байты файла

Для upload path по умолчанию равен имени файла; conflict_policy: create отклоняет совпадение имени, rename выбирает свободное имя. Файлы и папки постоянные: TTL разговора их не удаляет. Сохраняются права доступа, квоты и ограничения загрузки.

Bearer API предоставляет чтение коллекций и их состава. Создание, редактирование состава и удаление коллекций выполняются в интерфейсе; маршрутов bearer CRUD коллекций нет. Операции записи ресурсов в таблице создают корни и подпапки или загружают файлы.

Обзор

POST /api/v1/conversations со scope chat:run создаёт разговор без сообщения и запуска задачи. Минимальное тело — {} ; настройка Памяти:

Каждая из максимум 100 ссылок задаёт ровно одну цель: locator с directory_id и

или write . Цели идут без дублей; рабочий корень уже подключён как workspace и

references . При ошибке контекст не создаётся частично; повторный POST создаёт новый разговор.

Workspace можно выбрать или снять только до первого сообщения или upload: это личный корень с правом записи, не подпапка, коллекция или корень организации. Замена уже выбранной папки возвращает 409 ; повтор того же выбора идемпотентен. Без выбора файлы хранятся во временной папке разговора. В выбранном корне результаты сохраняются в Памяти и переживают удаление разговора.

Контекст существующего

Тело Права сверх chat:run

разговора

Одна цель как в массиве memory:read , для write

для снятия ссылки write

Доступ к ресурсам проверяется на каждом запросе. Для подключения write нужны право записи и разрешение агенту изменять материал. У коллекции перед созданием разговора, добавлением ссылки или PATCH в write проверяется каждый текущий участник: его

право записи и разрешение агентской записи. Сохранённый режим write требует обоих прав Памяти при запуске, даже если коллекция пуста или доступ позднее сузился до чтения.

Разговор, которому хотя бы раз открыли Память, сохраняет требование memory:read после снятия всех ссылок и workspace. Оно действует на native, OpenAI agent, async, загрузку/скачивание файлов, опрос результата и SSE. Удаление самого разговора остаётся доступно владельцу со scope chat:run . При активном ходе контекст заблокирован ( 409 ). Если контекст изменился между постановкой async в очередь и стартом, прогон получит failed / context_changed : отправьте новый запрос с актуальным контекстом.

Обзор

Ключ привязан к активному профилю пользователя, выбранному при создании (личному или организации). Переключение профиля меняет список ключей. Сам ключ не подключает проект или базу знаний: материалы выбираются явно через контекст разговора. iskra_exec.profile_id — отдельный идентификатор профиля модели, который не меняет владельца ключа или разговора.

Ключ организации с явно выданным run:delegate может действовать от имени сотрудника этой организации: X-Iskra-Run-As: <profile_id сотрудника> . Расход и доступ к материалам относятся к выбранному сотруднику. Передавайте одинаковый заголовок по всей цепочке загрузки, запуска, опроса, SSE, скачивания и отмены; без него запрос обращается к профилю владельца ключа и может получить 404 . Публикация Apps выполняется только своим профилем и делегирование отклоняет.

Обзор

а при наличии результатов — files . Созданный через POST /api/v1/conversations разговор используется тем же образом.

Передайте conversation_id из предыдущего ответа и новое message . Это ID отдельного API-разговора, а не настройка подключения ключа к проекту или базе знаний. Один разговор используется последовательно в native, async и OpenAI agent. Одновременный ход получает 409 .

Заголовок Idempotency-Key в native и OpenAI agent дедуплицирует только создание разговора: повторный запрос способен выполнить ещё один ход. Для фонового POST /api/v1/runs повтор с тем же ключом возвращает прежний run_id и не запускает второе исполнение.

Поля запроса

Поле native / async Смысл

message Обязательный текст сообщения

Подготовленный или продолжаемый разговор; без него создаётся новый

instructions Дополнительные инструкции на этот ход

files {id} из multipart upload; async принимает

только {id}

Поле native / async Смысл

Срок разговора: по умолчанию 3600 секунд, максимум 86400

запрошенной формы

true добавляет доступные рассуждения в reasoning ; по умолчанию выключено

{...}} для структурированного вывода

Поля выбора модели, сложности, навыков,

iskra_exec двух специалистов и Антонима описаны

выше; действуют один запрос

usage показывает расход токенов ориентировочно и не служит расчётом оплаты. completed означает готовый ответ. При interaction_required покажите человеку

conversation_id и значениями в policy.inputs . В ответе также есть interaction.tool_call_id . Пустая форма подтверждения выполняется в интерфейсе: policy.inputs передаёт значения полей, а согласие за человека не выражает.

Обзор

ничего не передаёт: Искра получает файл содержимым или ссылкой на предварительную загрузку.

В files каждый элемент задаёт ровно один вариант:

{name, mime, content_base64} — байты в base64 для native sync;

{id} — ID версии из ответа POST /api/v1/chat/files . Это единственный источник входного ID. Массив files результата хода содержит лишь {name, download_url} и такого ID не даёт.

Upload требует files:write , принимает multipart-поля conversation_id , необязательное ttl_seconds и повторяемое поле file . Без conversation_id создаётся новый разговор.

workspace также нужны оба права Памяти; после любого обращения разговора к Памяти

ID действует только в этом разговоре и один раз: повторная привязка к другому сообщению, чужая или несуществующая версия дают 404 invalid_file . Загрузите файл снова для нового использования. Оба варианта одновременно или ни одного — 400 invalid_request ; async с inline — 400 use_file_upload . Отдельный лимит обработки Office может отклонить уже загруженный файл перед ходом ( 413 file_size_limit ): уменьшите или разделите его.

Вложение передаёт конкретный файл в ход. Для работы с папкой Памяти или коллекцией подключите её через memory_refs .

Как скачать созданный файл через API

Созданные агентом файлы перечислены в files: [{name, download_url}] . Скачайте фактический download_url с Bearer-ключом и files:read , например GET /api/v1/chat/{id}/files/report.md . Для разговора с Памятью требуется также memory:read и текущий доступ к выбранной рабочей папке. Через Memory API постоянный файл скачивается по file.id из каталога, а не upload version ID.

Обзор

POST /api/v1/runs принимает поля native (вложения только по id ) и сразу возвращает

фиксированный дедлайн прогона, а не TTL разговора.

next_after . Пока статус queued или running , продолжайте опрос; в следующий запрос передавайте next_after, а не число прочитанных событий. Итоговые состояния: completed ,

машинный код отказа — в error.code .

же ленту через SSE. Bearer-заголовок сохраняется: браузерный EventSource сам его установить не умеет — используйте клиент с поддержкой заголовков, например streaming

сообщают прогресс: content содержит длину текста, tool — имя инструмента; сам ответ забирается опросом результата. Терминальное событие закрывает поток.

DELETE /api/v1/runs/{run_id} отменяет ожидающий или активный прогон; для завершённого возвращается 409 already_finished . После перезапуска сервиса прерванный прогон может оставаться running до проверки дедлайна, затем завершится failed / interrupted ; повторяйте по терминальному исходу.

Обзор

модель агента — iskra или iskra-agent . Доступные имена возвращает GET /api/openai/v1/models ; поверхность включается администратором, иначе 404 .

В агентном режиме работают навыки, специалисты и подключённая Память. Передавайте

дополнительных полей есть extra_body . С conversation_id сервер хранит историю, из нового messages использует последнее сообщение user и инструкции system / developer . Без ID каждый запрос самостоятельный. Поддерживается stream: true ; ответ содержит

агентном режиме отклоняются: Искра использует свои инструменты.

powerful и требует одновременно chat:run + явно выданное llm:raw . Он доступен, когда включён администратором. Это обращение к модели с историей и инструментами клиента: навыки, специалисты, контекст Памяти и серверный разговор Искры здесь не применяются; conversation_id , policy , iskra_exec относятся к агентному режиму. Модель возвращает tool_calls , исполняет их клиент. Raw поддерживает

response_format со значением text или json_object ; для JSON Schema используйте native или async.

Обзор

answer , объект по схеме приходит в output . Невалидная схема отклоняется до запуска ( 400 invalid_schema ). Если ответ не удалось привести к схеме, native возвращает 422

interaction_required и ошибок приведение к схеме не выполняется. В OpenAI agent

Обзор

Срок ключа относится к авторизации: по умолчанию 30 дней, максимум 365 дней. TTL API-разговора — отдельно: ttl_seconds , по умолчанию 1 час (3600 секунд), максимум 24 часа (86400 секунд); ход или upload продлевает срок. Эти разговоры отделены от обычных чатов интерфейса. Удаление или истечение разговора закрывает его URL файлов; постоянные файлы в выбранной папке и подключённые материалы остаются доступны через Память.

Синхронный ход ограничен 90 секундами, фоновый прогон — 15 минутами от создания. При повторении запроса учитывайте правила Idempotency-Key выше.

HTTP Как действовать

Исправьте тело, поля, ID или схему по машинному коду ошибки

Ключ невалиден, истёк или отозван: создайте действующий ключ

Проверьте scope, доступ и политику: недостающий scope бывает

маршрута

Ресурс отсутствует, чужой, недоступен для

404 чтения или разговор истёк; также

возможен выключенный API

Разговор занят, выбранный контекст менять поздно либо прогон уже завершён

410 Ресурс запечатан и операция недоступна

Превышен лимит загрузки или обработки файла

исходный ответ и проверьте схему

Ограничена частота запросов или исчерпана квота

HTTP Как действовать

Внутренняя ошибка, empty_response либо

перед повтором

Временно недоступна зависимость/каталог/

503 блокировка или идёт обслуживание; при

504 Истёк тайм-аут хода

Формат ошибки зависит от маршрута: native возвращает error.code и error.message , операции контекста могут возвращать problem JSON с code , detail , params . Проверяйте HTTP-статус и машинный код, а не точный текст. В OpenAI SSE ошибка после начала потока приходит кадром error при уже отданном HTTP 200; async ошибки читаются из терминального результата.

Обзор

Пример для Bash, curl и jq : каталог → выбранный готовый навык → исходники и рабочая папка Памяти → разговор → задача → постоянный результат. Создайте ключ с

адрес своего контура и токен через окружение.

Выберите подходящие задаче bundle и id из напечатанных каталогов. Следующий блок запросит их явно и проверит доступность выбранного и всех обязательных навыков. Если проверка упала, завершите настройку в интерфейсе и получите каталог заново. Установка навыка через эти маршруты не выполняется.

Если нужен фоновый прогон, вместо последнего вызова отправьте turn.json в POST /api/v1/runs , дождитесь терминального статуса через GET и сохраните его .result в result.json . Для OpenAI agent преобразуйте запрос: jq

/api/openai/v1/chat/completions . Каждый отправленный вариант создаёт отдельный ход.

Скачивайте ссылку из фактического ответа: модель может выбрать другое имя или запросить уточнение. Если files нет, сначала разберите status , answer и interaction ; само задание не гарантирует создание артефакта.

Для интеграции только с чтением выдайте memory:read без memory:write , подключите

незаданным. Результаты будут временными файлами разговора.

Обзор

В списке видны все ключи текущего профиля: название, префикс ( isk_… ), права, дата создания, дата последнего использования и срок действия. Сам токен не виден.

Чтобы отключить ключ, нажмите Отозвать и подтвердите. Действие необратимо — ключ перестаёт работать сразу. Отзывайте ключ при утечке токена или когда интеграция больше не нужна.

Обзор

/api/v1/keys/scopes требуют пользовательскую сессию. Создание, список, каталог прав и отзыв ключей выполняются через интерфейс; Bearer-ключ ими не управляет. Токен показывается только один раз.

С явно выданным apps:publish CLI iskra-app создаёт приложение через POST

свою принятую публикацию через GET /api/v1/apps/{id}?version={version} . Публикация относится только к профилю владельца ключа. Доступ приложения от имени его зрителя устроен отдельно: см. «Приложения».

Обзор

С явно выданным boards:read ключ читает доски профиля, которому он принадлежит: GET /api/v1/boards — список досок под управлением этого профиля, GET /api/v1/boards/{id} — состав доски и показанная версия, GET

файл показанной версии. Доску, где профиль лишь получатель, ключ читает по её идентификатору, но в списке она не появляется. Аудиторию, секретную ссылку, приглашения, копию и передачу владения ключ не меняет — это действия человека в интерфейсе.

Адрес скачивания вкладки — не та ссылка, которую получает читатель доски: он работает только с вашим ключом и областью boards:read . Читателю доска открывается своей аудиторией — организацией, группой организации, адресным приглашением или

секретной ссылкой, — и адрес API ему отдавать бессмысленно: без ключа он не открывается.

С явно выданным boards:publish ключ только готовит размещение: POST /api/v1/board-publication-intents возвращает точную форму будущего действия — доску, её

показывает состояние подготовки и сохранённый результат. Подтверждения по ключу нет: подготовленное действие человек открывает в Искре на странице /boards/publication-intents/{id} и подтверждает своей сессией; подготовка ждёт его ограниченное время. Область boards:read подготовку не создаёт, а boards:publish не открывает чтение досок: это разные права одного ключа.

Обзор

Токен хранится в виде хэша — платформа не может его восстановить.

Храните токен в секрете (переменные окружения, секрет-менеджер), не коммитьте в репозиторий.

При утечке немедленно отзовите ключ и создайте новый.

Ключ действует строго в рамках своего профиля и выданных прав.

Обзор

Для интеграции можно использовать API SDK Искры. Он поддерживает чат, фоновые задачи, файлы, навыки, специалистов и Память; Python-клиент доступен в синхронном и асинхронном вариантах. Инструкции установки из публичного исходника и примеры находятся в README соответствующего пакета. Передайте ключ и адрес своей установки явно. Для фотографий и длительных заданий используйте загрузку файла и асинхронный прогон.

Обзор

Если действие не удалось, Искра показывает короткое сообщение и подсказку, что делать дальше. Технические подробности внутренней ошибки не выводятся на экран: они сохраняются в диагностике платформы, чтобы поддержка могла найти причину без раскрытия лишних деталей пользователю.

Что может предложить система

Подсказка Что делать

Исправьте поля формы, выбранный файл,

Проверьте введённые данные ссылку или другой ввод и отправьте

действие снова.

Повторите то же действие сразу. Такая

Попробуйте ещё раз ошибка обычно связана с временным сбоем

запроса.

Подождите несколько минут и повторите действие. Это может быть временная

Попробуйте позже

перегрузка или недоступность внешнего сервиса.

Подсказка Что делать

Сессия истекла или действие требует

Войдите в аккаунт авторизации. Войдите заново и повторите

действие.

Действие ограничено настройками

Обратитесь к администратору организации, правами доступа или

настройками платформы.

Повтор того же запроса ничего не изменит: нужно сначала сделать что-то другое —

Не повторяйте действие без изменений

например, снять навык с витрины или подать новую заявку.

Запрос охватывает слишком много данных:

Сузьте запрос

добавьте фильтр, период или уточнение.

Искре нужно ваше решение: подтвердите

Уточните действие действие или выберите один из

предложенных вариантов.

Достигнут лимит тарифа или функция

Перейдите на подходящий тариф

недоступна на текущем плане.

Ошибка требует диагностики со стороны

Обратитесь в поддержку

команды поддержки.

Если на экране показан идентификатор запроса ( request_id ), сохраните его. При обращении в поддержку или к администратору укажите:

что вы делали перед ошибкой;

примерное время ошибки;

идентификатор запроса, если он показан;

страницу или раздел, где возникла ошибка.

Как сообщить об ошибке в чате

Если ответ в чате завершился ошибкой, в карточке ошибки есть кнопка «Сообщить об ошибке». Она открывает обычную форму обратной связи — ту же, что и оценка ответа, — и отправляет сообщение команде.

Копировать диагностику вручную не нужно: тип ошибки, идентификатор запроса и ссылка на беседу прикладываются автоматически. Комментарий необязателен, но пара слов о том, что вы делали перед ошибкой, ускоряет разбор. После отправки появится подтверждение, что сообщение принято.

Та же кнопка есть внутри окна «Информация об ошибке», если вы уже открыли подробности. Текст запроса, содержимое файлов и ответ модели в отчёт не попадают.

Когда можно просто повторить

Повторите действие, если подсказка явно предлагает «Попробуйте ещё раз» или «Попробуйте позже». Для загрузки файлов, платежей, изменения прав доступа и других чувствительных операций сначала проверьте результат на странице: иногда операция могла завершиться, даже если интерфейс не успел получить ответ.

Сообщение «AI-сервис отклонил запрос» означает, что сервис ответов не принял обращение. Оно не указывает на ошибку в вашем тексте. Можно попробовать ещё раз;

если отказ повторится, нажмите «Сообщить об ошибке» в карточке. Тип отказа сохраняется в истории беседы, чтобы команда могла найти причину.

Если сообщение в чате не принято

Если сервер отклонил сообщение до начала ответа, Искра сохранит его над полем ввода с пометкой «Сообщение не принято». Такая пилюля не отправляется повторно сама и остаётся в этой вкладке после перезагрузки страницы. Следующие сообщения ждут, чтобы не нарушить их порядок.

Проверьте подсказку ошибки, затем выберите действие на пилюле:

Править — изменить текст перед новой попыткой;

Повторить отправку — явно отправить сообщение ещё раз;

Убрать из очереди — удалить сообщение и перейти к следующим.

Если ошибка требует другого действия — например, войти заново, изменить файл, тариф или права доступа, — сначала выполните его и только потом повторяйте отправку. Когда Искра предлагает войти заново, сообщение дождётся возвращения: после входа в тот же профиль оно снова будет над полем ввода с прежней пометкой.

Отдельный случай — вложение, которое не прошло проверку размера: такое сообщение остаётся в самом поле ввода вместе с прикреплённым файлом, а не превращается в пилюлю. Замените файл уменьшенной версией и отправьте снова. Смена тарифа помогает только при тарифном ограничении; технический предел обработки она не увеличивает. При выборе нового слишком большого Office-файла Искра показывает причину заранее, до добавления вложения и передачи содержимого.

Если ответ заблокирован во время выполнения

Для заблокированного ответа Искра может предложить кнопку «Повторить с чистого шага». Она один раз повторяет тот же запрос без незавершённого ответа. Предыдущая история и рабочая папка остаются доступны.

Перед нажатием проверьте результат: новый прогон может повторить изменения файлов в рабочей папке и действия в подключённых сервисах. Он не отменяет и не откатывает их.

Если Искра успела выполнить часть шагов, рядом остаётся «Продолжить»: оно достраивает начатый ответ, а «Повторить с чистого шага» начинает запрос заново.

Кнопка доступна только в текущей карточке ошибки и после обновления страницы не восстанавливается. Сама попытка «с чистого шага» одна: если ответ заблокируют снова, стоит отправить новое сообщение или переформулировать запрос. Если новый прогон прервётся по технической причине — например, сервис ответов временно недоступен, — обычный повтор запроса остаётся доступен.

После восстановления соединения

Обновления, которые могли не прийти за время разрыва, Искра после восстановления перечитывает сама: список бесед, уведомления, открытый чат и показатели использования. Страница при этом не перезагружается, несохранённый ввод остаётся на экране.

Единственный случай, когда Искра перезагружает страницу сама, — за время разрыва вышла новая версия приложения. Появится баннер с отсчётом: страница перезагрузится через несколько секунд. Нажмите «Отложить», чтобы сначала завершить действие, — баннер останется поверх верхнего края экрана, не сдвигая интерфейс и не перекрывая поле ввода (при обрыве связи его на время сменяет баннер переподключения), а обновиться можно будет кнопкой «Обновить сейчас». Набранный текст, собранные цитаты и выбранный контекст — рабочая папка, папки памяти, сценарий и инструменты — сохраняются перед обновлением и восстанавливаются после него. Если браузер не смог

сохранить ввод или к сообщению ещё прикреплены локальные файлы, перезагрузка отменяется и баннер показывает причину: сначала завершите отправку либо удалите вложения. Отсчёт идёт только пока вкладка открыта и соединение восстановлено — в фоне страница не перезагрузится.

Если Искра не смогла загрузить часть интерфейса, новая версия не подтверждена и дело не в браузере, появится отдельное нейтральное сообщение. Оно не означает, что обновление обязательно вышло: сначала проверьте соединение, затем повторите действие или нажмите «Перезагрузить». Автоматически страница в этом случае не перезагружается. Перед ручной перезагрузкой Искра применяет те же правила сохранения ввода и не продолжает, если локальные вложения могут потеряться.

Отдельный случай — когда часть приложения не открывается из-за версии браузера. Тогда сообщение так и говорит: эта версия браузера не поддерживает приложение. Кнопки перезагрузки рядом нет намеренно — обновление страницы приведёт ровно к тому же, потому что дело не в загрузке. Помогает обновление браузера или операционной системы: на Mac это «Обновление ПО» в системных настройках, в Windows и на Android — обновление самого браузера. Настольное приложение Искры использует браузерный движок системы, поэтому обновление системы лечит и его. После этого приложение открывается как обычно.

Медленное соединение: серые заготовки вместо пустого экрана

Когда связь медленная, интерфейс не успевает откликнуться мгновенно: браузеру нужно догрузить часть приложения. Чтобы это не выглядело зависанием, Искра показывает серые заготовки — прямоугольники на месте будущего содержимого. Нажатый пункт меню или выбранный чат подсвечиваются сразу, ещё до того, как раздел успел открыться, поэтому по подсветке видно, что нажатие сработало. Заготовки появляются только там, где ожидание действительно заметно; на быстром соединении вы их не увидите.

То же самое при первом открытии Искры: пока приложение загружается, на месте боковой панели и содержимого видны заготовки, а их форма зависит от того, что откроется — чат или раздел. На медленном соединении первый запуск занимает десятки секунд, и это нормально. Если загрузка затянулась совсем надолго, вместо заготовок появляется строка «Загрузка идёт дольше обычного» с кнопкой «Обновить».

Мобильное приложение: «Не удалось открыть Искру»

После входа в мобильном приложении основной экран открывается под фирменной заставкой с логотипом: она держится, пока интерфейс не подтвердит, что готов принимать ввод. Если за отведённое время этого не произошло (нет сети, сервер недоступен, сбой встроенного браузера), приложение один раз попробует восстановиться само, а затем покажет экран «Не удалось открыть Искру» с двумя кнопками:

Повторить — заново проверить сессию и открыть интерфейс; подходит после восстановления связи.

Войти заново — очистить сохранённую сессию и вернуться к экрану входа; используйте, если «Повторить» не помогает.

Под кнопками показан короткий код вида стадия/причина (например, initializingWeb/webInitTimeout ). Он не содержит личных данных — укажите его при обращении в поддержку вместе с моделью телефона и временем ошибки.

Иногда встроенный браузер не удаётся безопасно восстановить внутри запущенного приложения. Тогда вместо обычных кнопок появится экран «Перезапустите Искру» с просьбой полностью закрыть приложение и открыть его снова. Кнопок «Повторить» и «Войти заново» на этом экране намеренно нет: продолжать работу можно после нового запуска приложения.

Плановое обновление платформы

Перед обновлением Искра предупреждает заранее: сверху появляется полоса с текстом от администратора — например, «Искра переходит в режим обновления, вы сможете продолжить примерно через 20 минут». Она видна на любом экране, а не только в чате, и появляется сама, перезагружать страницу не нужно.

Пока идёт обновление, новые сообщения не принимаются: вместо поля ввода показывается то же объяснение, а попытка отправить сообщение возвращает его текстом, а не ошибкой. Это не сбой — платформа сознательно перестала брать новые задачи, чтобы не оборвать чужие на середине. Набранный ранее текст не теряется и вернётся в поле ввода.

Вместе с полем ввода перестают работать и кнопки, которые запускают Искру заново: «Повторить» и «Продолжить» у оборванного ответа, «Продолжить» и «Завершить» у сценария, «Пуск» в чате навыка, сохранение отредактированного сообщения. У каждой написано, почему она сейчас недоступна. Подготовить следующий запрос при этом можно как обычно — набрать текст, приложить файлы, выбрать сценарий: обновления это не касается.

Личный чат проекта подчиняется тому же правилу: во время обновления поле ввода не принимает новый запрос, а набранный текст сохраняется до возобновления работы платформы.

Сам режим обновления не прерывает выполняющуюся задачу. Кнопка «Стоп» продолжает работать, если вы решите остановить ответ. При неполадках текущий ответ также может остановить администратор; сохранённая история чата останется доступной. Новый запрос можно отправить после обновления.

Полоса и блокировка снимаются сами, как только платформа снова готова принимать запросы, — тоже без перезагрузки страницы.

Когда нужно менять свои действия

Если ошибка связана с вводом, тарифом или правами, повтор без изменений обычно не поможет. Исправьте данные, выберите другой файл, войдите заново, смените тариф или обратитесь к администратору организации.

Обзор

Каталог навыков — витрина готовых навыков внутри вашей Искры. Навыки в него публикуют другие пользователи платформы и сама Искра. В отличие от системных навыков, которые видны всем сразу, навык из каталога появляется у вас только после того, как вы его установите, — поэтому ваш список навыков не засоряется чужими.

Раздел доступен, если каталог навыков включён администратором платформы. Витрина живёт внутри раздела «Навыки» ( /skills ) — вкладка «Каталог»; туда же ведут старые ссылки на отдельную страницу каталога. Ваши личные установки видны на странице «Мои навыки» в секции «Из каталога», а установки организации — в секции «Организации».

Всё то же самое можно делать прямо в диалоге с Искрой, не заходя на страницы «Навыки» или «Каталог навыков»: попросите «найди навык для работы с …» — Искра поищет по витрине и покажет подходящие варианты с описанием; «установи навык …» — установит выбранный (в организацию — если вы владелец или администратор); «обнови навык … до последней версии» — перенесёт установку на новую версию; «опубликуй мой навык … в каталоге» — подаст заявку на публикацию, а «сними навык … с витрины» или «отмени заявку на публикацию …» — уберёт его или отзовёт заявку. Каждое такое действие Искра подтверждает у вас перед выполнением.

Обзор

На витрине — карточки навыков с понятным названием и кратким описанием. Если техническое имя навыка отличается от названия, оно показывается отдельной строкой через / — так же, как в списке «Мои навыки». Слева на карточке отображается иконка, если она есть; иначе — цветная заглушка с первой буквой названия. Автор, версия и категория в компактной карточке не показываются. Найти нужное помогают:

Поиск — по названию, техническому имени и описанию навыка.

Категории — заголовки секций витрины («Продуктивность», «Интеграции», «Данные» и т.д.); категории без навыков не показываются.

Название и краткое описание встроенных навыков Искры показываются на языке интерфейса — русском, английском, французском или китайском; смена языка в настройках сразу обновляет карточки, витрину, подсказки при вводе «/» в чате и вкладку «Запуски». Навыки, опубликованные другими пользователями и организациями, сохраняют текст автора как есть: в интерфейсе на любом языке, кроме русского, перед таким описанием стоит пометка «текст автора» (подсказка: «Текст автора навыка, без перевода»). Названия авторских навыков пометку не получают. Описания инструментов на странице навыка остаются текстом из манифеста.

Клик по карточке открывает детали: автор, актуальная версия и список инструментов — что именно навык умеет делать. Автор «Искра» означает, что навык опубликован самой платформой. Если навыку для работы понадобятся ключи или параметры, Искра предложит настроить их после установки; настройку можно отложить и вернуться к ней позже (см. «Навыки с секретами» ниже).

Обзор

На карточке нажмите иконочную кнопку «+» справа — она устанавливает навык сразу; в деталях навыка то же действие подписано «Установить». Если Искра спросит, куда установить навык, выберите «Лично себе». Навык появится в секции «Из каталога» списка навыков и получит режим «Авто». Режим можно сразу сменить на «По команде» или «Выкл» на странице подробностей навыка.

Важно понимать: установка фиксирует версию навыка. Вы работаете именно с той версией, которую установили, — даже если автор потом опубликует новую. Обновления не приходят автоматически: когда и на какую версию переходить, решаете вы (см. «Обновления» ниже).

Навыки с секретами

Если навыку нужны ключи доступа (секреты), это не мешает установке — она проходит сразу. После неё, если ключи ещё не заданы, Искра откроет окно «Настройки навыка»: заполните значения и нажмите «Сохранить» внизу окна — одна кнопка записывает всё окно сразу. Заполнять прямо сейчас не обязательно: «Настрою позже» оставляет навык установленным, настроить его можно потом из его карточки. А вот «Отмена» и крестик, пока ничего не сохранено, отменяют и саму установку — навык не останется подключённым «наполовину». Настроенные секреты принадлежат вам и другим пользователям не видны.

Если в настройках появилась ошибка объявления секретов, остальные поля остаются доступны. Поля с пустыми или повторяющимися именами недоступны для ввода. Попросите Искру исправить описание настроек вашего навыка и выпустить новую версию; для навыка из каталога обратитесь к его автору, затем обновите установку. Уже сохранённые ключи и параметры при показе ошибки не удаляются.

Если навык запросил настройку прямо во время задачи в чате, у поля ввода остаётся карточка «Настроить» — она открывает то же окно настроек нужного навыка и не исчезает после завершения ответа Искры. Сохраните значения, и Искра проверит

подключение и продолжит прерванную задачу без повторного запроса. Карточка хранится 30 дней; крестик отменяет ожидание. Подробнее — в разделе «Режим агента».

У одного и того же навыка могут быть разные подключения: личная установка использует ваш личный ключ, а установка организации — общий ключ организации. Общий ключ задаёт владелец или администратор; его значение не показывается участникам. Если навык разрешён только выбранным группам, общий ключ доступен навыку во время работы только для участников этих групп. Сам ключ никогда не отправляйте в чат.

Исключение явно указывается в карточке навыка. Например, у Reputation.ru — личный ключ даже организационная установка использует отдельный ключ каждого профиля, а не общий ключ организации. Установленный вариант с личным ключом заменяет системный Reputation.ru и не переключается на него при ошибке настройки. Подробнее — в разделе «Reputation.ru: поиск судебной практики». Так же устроены Wildberries Seller и Ozon Seller: установка организации делает навык доступным участникам, но каждый профиль подключает собственный кабинет продавца и хранит свои реквизиты отдельно.

Согласие на запись

Некоторые навыки просят право самостоятельно записывать значения в свои секреты (например, сохранить полученный токен). Перед установкой такого навыка Искра покажет диалог согласия со списком слотов — отметьте каждый и подтвердите. Без вашего согласия навык писать в секреты не сможет.

Обзор

Когда на витрине появляется версия новее вашей, на карточке установленного навыка появляется бейдж «Доступно обновление» и кнопка «Обновить» — она переносит вашу установку на актуальную версию. Автоматически ничего не обновляется.

Если у новой версии изменился набор секретов, в которые навык имеет право писать, карточка покажет «Требуется повторное согласие» с кнопкой «Дать согласие». До подтверждения запись в секреты для навыка заблокирована — это защита, а не поломка.

Обзор

На вкладке «Мои навыки» в секции «Из каталога» откройте карточку навыка → внизу «Обзора» раздел «Управление навыком» → «Удалить навык» и подтвердите действие. После этого навык исчезнет из вашего каталога. Настроенные секреты не стираются: если позже установить навык снова, они подхватятся. Исключение — аккаунты внешних сервисов, подключённые через браузер, например Plaud: при удалении навыка из личных навыков доступ к ним удаляется, и после новой установки аккаунт нужно подключить заново.

Обзор

Свой работающий навык (личный или навык организации — для организации это может сделать владелец или администратор) можно предложить в общий каталог.

1. Откройте страницу «Навыки» и нажмите на карточку своего навыка. 2. Внизу вкладки «Обзор» откройте «Управление навыком» → «Каталог навыков» и

нажмите «Опубликовать в каталог». Этот раздел показывается, только когда каталог включён, а ваши права автора или администратора организации позволяют управлять публикацией.

3. Выберите категорию, напишите краткое описание для карточки на витрине и

нажмите «Отправить заявку».

Каждую публикацию — и каждое последующее обновление — проверяет администратор платформы вручную. Пока заявка рассматривается, в разделе виден статус «Заявка на модерации» и кнопка «Отменить заявку». Если заявку отклонили, вы увидите статус «Заявка отклонена» и причину.

На странице «Навыки» и в чате с Искрой завершённую заявку со статусом «отклонена», «сборка не удалась» или «отменена» можно убрать из списка текущего профиля. Это не удаляет заявку и историю модерации и не скрывает их от других пользователей, которым они доступны.

После одобрения раздел покажет «В каталоге: v…». На витрину попадает именно та версия, которая была у навыка в момент подачи заявки, — более поздние ваши правки на неё не влияют.

Что ещё полезно знать:

Публикация — это независимая копия. Ваш навык остаётся вашим: вы можете менять его и даже удалить — у тех, кто установил навык с витрины, ничего не сломается.

Материалы и подключения. Общие файлы комплекта входят в опубликованную версию. Привязки к папкам Памяти автора и его настройки подключений не передаются. Папки Памяти пользователь привязывает в текущем профиле; подключения настраивает в пределах своих прав. Руководство по навыкам поможет выбрать место для шаблонов, прайса и материалов одной задачи.

Обновление публикации. Развивайте навык как обычно — изменения не попадают на витрину сами. Когда ваша версия станет новее опубликованной («В каталоге: v1.2 · У вас: v1.5»), нажмите «Отправить обновление» — это новая заявка с той же модерацией. Версия обязана быть новее опубликованной; установившие увидят бейдж «Доступно обновление» и перейдут на неё, когда захотят.

Лимит — не больше 20 опубликованных навыков на одного автора.

Фоновые навыки (работающие по расписанию) в каталог пока не принимаются.

Снять с витрины можно самому. Пока навык опубликован, в разделе «Каталог навыков» есть кнопка «Снять с витрины» — после подтверждения навык исчезнет из каталога, но у всех, кто его установил, продолжит работать. Вернуть его на витрину можно новой заявкой на публикацию (той же версии, модерация проводится заново).

Если навык сняли с витрины, раздел «Каталог навыков» покажет статус «Снят с витрины» (можно подать заявку заново) или «Заблокирован модерацией».

Обзор

Если вы работаете в профиле организации с ролью владельца или администратора и навык ещё не установлен ни лично, ни в организацию, после нажатия «Установить» Искра спросит, куда установить: «Лично себе» или «В организацию». Перед установкой в организацию выберите группы, которым будет доступен навык; пустой выбор означает всю организацию. Ограничение сохраняется до настройки общего секрета, поэтому ключ не открывается участникам на время установки. Если личная установка уже есть, кнопка подписана «Установить в организацию»; если навык уже установлен в организацию, кнопка остаётся «Установить» и создаёт личную установку. Установить навык в организацию из личного профиля нельзя — переключитесь в профиль организации. Установленный в организацию навык появляется у разрешённых участников в секции «Организации» списка навыков в режиме «Авто»; каждый участник может выбрать у себя «По команде» или «Выкл».

Управление орг-установками — там же, в секции «Организации» раздела «Навыки» (со страницы организации вкладка «Навыки» сразу открывает /skills ): клик по карточке открывает страницу, где видны версия, бейдж «Доступно обновление» с кнопкой

«Обновить» (переносит версию сразу для всей организации) и кнопка удаления — после неё навык пропадает у всех участников.

Если один и тот же навык установлен и лично вам, и в организацию, действует ваша личная установка — в том числе её версия.

Кому виден навык: группы

По умолчанию навык организации виден всем её участникам. Если нужно ограничить круг — например, дать навык только бухгалтерии, — используйте группы:

1. На странице организации на карточке навыка найдите строку «Доступность»: «вся

организация» или «групп: N».

2. Нажмите «Настроить» — откроется диалог «Доступность навыка» со списком групп

организации.

3. Отметьте группы, которым навык должен быть доступен, и сохраните. Пустой выбор

означает «вся организация».

Так настраивается доступность и собственных навыков организации, и установок из каталога. Если выбранная группа была удалена, она показывается с пометкой «(удалённая группа)» — её бывшие участники навык не видят; когда все выбранные группы удалены, навык не видит никто, поэтому мёртвые группы стоит убирать из выбора.

Отдельный блок «Навыки, скрытые от вас групповым доступом» показывает администратору навыки, чей групповой доступ прячет их из его собственного каталога, — оттуда ограничение можно изменить или снять.

Обзор

Официальный навык Искры Google Drive находится в категории «Интеграции», если оператор платформы настроил и включил подключение Google. Навык умеет искать файлы и смотреть содержимое папки, читать текстовые файлы и Google-документы, скачивать файл в разговор и загружать файл разговора на Диск, создавать папки и текстовые файлы, переименовывать и перемещать файлы, отправлять их в корзину и выдавать доступ конкретному пользователю. Также он создаёт документы Google Docs и меняет выбранный текст в существующих документах, читает, создаёт и правит Google Таблицы и собирает и правит презентации Google.

После установки попросите Искру, например: «найди на Google Диске отчёт за июнь». При первом вызове Искра предложит подключить ваш Google-аккаунт. Пока приложение Искры не прошло проверку Google, сначала появится отдельное предупреждение, а затем Google может показать экран «приложение не проверено». Продолжайте, только если доверяете своему экземпляру Искры и согласны дать ему доступ к файлам. В тестовом режиме Google подключиться могут только аккаунты, которые оператор добавил в список тестовых пользователей.

Токен и пароль не отправляйте сообщением в чат. Если на уже установленном навыке браузерное подключение недоступно, он может предложить резервную защищённую форму для access token или OAuth-данных; используйте её только по инструкции администратора вашего экземпляра. Эта форма закрывает только работу с файлами Диска: документы, таблицы и презентации Google через неё не работают — если браузерное подключение на вашем экземпляре не настроено, Искра об этом скажет и предложит обратиться к администратору. Подключённого Google Диска для них при этом достаточно: отдельное подключение к документам Искра предложит, только если не подключено ничего.

Поиск и содержимое папки

Искать можно по части имени, а можно попросить показать, что лежит в конкретной папке: «покажи файлы в папке Клиенты» — и уточнить внутри неё: «найди там договор». В

ответе видно дату изменения, размер и ссылку на файл, поэтому свежий документ отличим от прошлогоднего сразу, без отдельного вопроса про каждый.

Как скачать файл в разговор

Чтение показывает Искре только текст, поэтому договор в PDF, таблицу или картинку лучше сразу скачать: попросите, например, «скачай карточку компании с Диска». Файл появится среди файлов разговора, и Искра назовёт его имя и размер. Дальше с ним можно работать как с любым файлом, который вы принесли сами, — например, попросить распознать документ или приложить его к сделке в amoCRM.

Документы, таблицы, презентации и рисунки Google сохраняются в привычных форматах: Word, Excel, PowerPoint и PDF соответственно. Если нужен другой формат, скажите об этом — например, «сохрани таблицу в PDF». Остальные файлы скачиваются как есть.

Как загрузить файл на Диск

Обратное тоже работает: «сохрани этот договор на Диск в папку Клиенты» — Искра возьмёт файл разговора, ваш или созданный ею самой, и положит его на Диск. Подходят PDF, офисные документы, изображения и архивы; предел здесь меньше, чем у скачивания, — 3 МБ.

Размер файла ограничен 20 МБ. Файл крупнее и папку целиком удобнее забрать в самом Google Диске — Искра об этом скажет, а не оставит вас без ответа.

Переименование выполняется сразу. Перед перемещением в другую папку Искра показывает, какой файл и куда будет перенесён; для старого файла, который одновременно находится в нескольких папках, потребуется явно выбрать прежнюю папку. Отправка в корзину и выдача доступа другому пользователю тоже выполняются только после вашего подтверждения. Закрытие формы или таймаут считается отказом: изменений на Google Диске не будет.

Создание и правка Google Docs

Попросите, например: «Создай Google-документ с планом встречи, заголовками и маркированным списком» или «В этом документе на вкладке “План” замени второй абзац и добавь итоги в конец». Искра умеет создавать пустые документы, добавлять абзацы и менять или удалять выбранный фрагмент. Поддерживаются заголовки и маркированные списки; таблицы, изображения и остальные вкладки вне изменяемого фрагмента сохраняются. Создание таблиц, изображений и вкладок в эти операции не входит. За один вызов можно передать до 100 абзацев и 32 КиБ текста, название нового документа — до 200 символов. Полный предпросмотр также должен помещаться в форму подтверждения. Если текст содержит много специальных символов или названия слишком длинные, Искра попросит уменьшить объём правки или длину названий. До этого запись не выполняется, содержимое предпросмотра не обрезается. Точечная замена текста работает внутри одного абзаца. Для изменения нескольких абзацев Искра предлагает заменить абзацы целиком.

При первом обращении к этим операциям Google отдельно запросит доступ к документам. Перед каждой записью Искра показывает подготовленное содержимое; для правки — также документ, вкладку и выбранный диапазон. Изменение выполняется после нажатия кнопки владельцем подключённого профиля. Это подтверждение нужно и в режиме «Разрешить и больше не спрашивать»; другой участник общего чата не может подтвердить запись за владельца. Без подтверждения изменений не будет.

Перед правкой Искра проверяет версию документа. Если кто-то успел изменить его, нужно заново прочитать документ и проверить новое предложение. Если документ создан, но его начальное заполнение не удалось, Искра сообщает об этом и возвращает адрес созданного документа. При потере ответа Google результат может быть неизвестен:

сначала проверьте документ в Google Docs, затем решайте, нужен ли новый запрос. Повторная запись и создание ещё одного документа автоматически не запускаются.

Google Таблицы

Попросите, например: «покажи, что в книге со сметой», «собери таблицу с выручкой по месяцам» или «допиши эти три строки в лист Данные». Искра читает книгу окном: показывает листы, их размеры и значения выбранного фрагмента — например, «Данные!A1:D50», — и сама продолжает с того места, где остановилась, если фрагмент не поместился. Она отличает «показано не всё» от «дальше пусто» и говорит об этом прямо.

Новая книга собирается из листов и строк, при желании сразу в нужную папку. В существующей книге за один раз выполняется одно действие: дописать строки, вставить строки или добавить лист — без отдельного вопроса; записать значения в диапазон, очистить диапазон, удалить строки или удалить лист — только после вашего подтверждения, потому что эти действия стирают то, что там было. Тип значения Искра сохраняет: текст остаётся текстом, число — числом, а формулу Таблицы считают сами.

Презентации Google

Попросите собрать колоду по плану — «сделай презентацию на пять слайдов про итоги квартала» — или по вашему шаблону: Искра скопирует его и подставит значения вместо тегов, сохранив оформление. В готовой колоде она добавляет и переставляет слайды, заменяет текст выбранного блока, ячейки таблицы и заметки докладчика и удаляет слайды. Замена текста, замена заметок и удаление слайдов выполняются после вашего подтверждения. Если кто-то изменит презентацию, пока вы смотрите предложение, Искра сообщит об этом и предложит перечитать колоду, а не перезапишет чужую правку.

Что видно в подтверждении

Перед записью в таблицу или презентацию Искра показывает форму с фрагментом содержимого файла: адресами, значениями ячеек, строками удаляемого листа или текстом слайда. Эта форма публикуется в текущий разговор, поэтому в общем чате её увидят остальные участники, а в истории и выгрузке разговора она останется и после того, как доступ к файлу в Google будет закрыт. Показывается только след правки: длинные значения ячеек сокращаются, у удаляемого листа видно несколько первых строк.

Нажать кнопку может только тот, кто позвал инструмент, и только владелец подключённого Google-аккаунта: другой участник общего чата подтвердить запись за вас не может, и в режиме «Разрешить и больше не спрашивать» это подтверждение тоже остаётся.

Таблицы и презентации работают на том же подключении Google Диска — отдельное согласие для них не нужно. Если администратор вашего экземпляра ещё не включил доступ к Google Таблицам или Google Презентациям, Искра скажет об этом прямо и предложит обратиться к нему: доступ вашего аккаунта к файлу здесь ни при чём.

Обзор

Официальный навык Искры MAX находится в категории «Интеграции», если его включил оператор платформы. Он подключает не личный аккаунт, а созданного вами чат-бота MAX. Отдельный запуск или сценарий не нужен: установите навык и напишите в обычном чате, например «Помоги создать бота MAX» или «Подключи моего бота MAX». Искра выяснит, на каком этапе вы находитесь, объяснит следующий шаг и вызовет нужные инструменты навыка. Одна ссылка-приглашение в чат сама по себе ничего не подключает: нужен подключённый бот, добавленный в чат с нужными правами.

Создание и модерация бота

Искра объясняет действия, но не создаёт профиль или бота и не влияет на решение модерации. Эти шаги вы выполняете на платформе MAX для партнёров.

По официальной документации MAX, проверенной 3 августа 2026 года:

создать бота может организация, ИП или самозанятый — резидент РФ — с верифицированным профилем;

организация или ИП может создать до 5 ботов, самозанятый — до 2; путь создания: нужный профиль → «Чат-боты» → «Создать»;

для карточки обязательны логотип, название и описание; актуальные размеры, форматы и ограничения Искра предложит сверить перед отправкой;

каждый бот проходит модерацию, заявленный срок — до 48 часов по рабочим дням;

статус «на модерации» означает ожидание, «создан» — успешную проверку, «требует исправлений» — необходимость открыть замечание в карточке, исправить данные и отправить их повторно.

Если лимит ботов достигнут или профиль не соответствует условиям, Искра скажет об этом прямо и не будет предлагать обход. Если проверка идёт дольше заявленного срока, проверьте уведомления и статус на платформе и обратитесь в официальную поддержку MAX. Изменение данных уже созданного бота запускает повторную модерацию.

Актуальные требования и правила:

создание и модерация бота;

управление ботом и получение токена;

FAQ по чат-ботам;

правила размещения.

Токен и подключение к Искре

После успешной модерации откройте «Чат-боты» → «Перейти» → «Расширенные настройки» → «Настроить». Там находится токен и переключатель, разрешающий добавлять бота в групповые чаты; по умолчанию такое добавление запрещено.

Область хранения токена выбирается при установке навыка: личная или общая для организации. Общее подключение организации подключает и отключает владелец или администратор — остальным участникам Искра прямо об этом скажет и предложит установить навык лично, если бот нужен им одним. В каталоге у навыка, уже установленного организацией, стоит пометка «Установлено в организации» — кнопка установки рядом ставит его лично вам.

Токен нельзя вставлять в обычное сообщение Искре. Попросите её подключить MAX: если токен ещё не задан, Искра покажет под ответом карточку «Навыку нужны секреты» с кнопкой «Настроить». Карточка видна и тогда, когда ход выполнения свёрнут, — в самом ходе выполнения та же форма открывается кнопкой «Настроить секреты навыка» со значком замка. По нажатию откроется защищённая форма установленного навыка. При личной установке токен сохраняется для вашего профиля, при организационной — в общей форме организации. Если токен всё же попал в чат, он останется в истории чата, поэтому считайте его скомпрометированным: обновите токен в расширенных настройках MAX и сохраните новый через защищённую форму. Если новый токен относится к другому боту, при следующем обращении навык очистит подключение и список чатов прежнего бота, а затем подключит нового. Данные двух ботов не смешиваются.

Когда вы задаёте настройки навыка впервые, после успешного сохранения формы, открытой из чата, исходный чат автоматически продолжит предыдущую задачу: Искра подключит или проверит бота в соответствии с вашим запросом. Плановая замена уже сохранённого токена ничего в чат не отправляет — как и сохранение токена на отдельной

странице настроек; после неё попросите Искру подключить или проверить MAX. Затем можно добавить бота в нужную группу или канал. Личный диалог подключается отдельно для каждого профиля Искры — это защищает участников организации от доступа к перепискам друг друга.

После подключения Искра работает только с групповыми чатами и каналами, куда добавлен этот бот и где его права разрешают нужное действие. При организационной установке эти группы и каналы видят все участники организации, которым доступен навык. Личные диалоги с ботом по умолчанию не показываются. Личный аккаунт владельца бота и его переписки с другими пользователями или ботами навыку недоступны. Если бот не является участником или администратором нужного чата, навык не обходит это ограничение.

Личный диалог с ботом

Чтобы работать из Искры со своим личным диалогом:

1. Откройте личный чат с подключённым ботом в MAX.

2. Напишите Искре: «Подключи мой личный диалог MAX».

3. Искра покажет защищённую форму с одноразовым кодом. Отправьте этот код

отдельным сообщением в личный чат именно с указанным ботом MAX.

4. Вернитесь в Искру и нажмите «Проверить привязку». Код действует 5 минут.

Имя и числовой MAX ID вводить не нужно: владение диалогом подтверждает только сообщение с одноразовым кодом. После привязки текущий профиль Искры увидит историю и сможет писать в этот личный диалог от имени бота. Другие участники организации его не увидят. Если тот же диалог привязать к другому профилю Искры, прежняя привязка перестанет действовать. Команда «Отключи мой личный диалог MAX» удаляет только вашу привязку и не отключает общего бота, группы или каналы.

Чтобы подключить группу или канал:

1. В расширенных настройках бота разрешите его добавление в групповые чаты.

2. В MAX добавьте бота в нужный чат как участника — найти его можно по нику или

публичной ссылке из карточки бота.

3. Назначьте бота администратором и дайте право read_all_messages . Без него бот не

получает новые сообщения группы или канала, поэтому чат может не появиться в Искре, а доступная история будет неполной.

4. Выдайте только права, нужные для ваших задач: write — изменение и удаление

сообщений в группе и публикация в канале; edit и delete — изменение и удаление постов канала; pin_message — закрепление; change_chat_info — изменение чата; add_remove_members и add_admins — управление участниками и администраторами.

MAX не предоставляет общий список всех чатов бота, поэтому список Искры пополняется по мере новой активности. После добавления бота отправьте в группу или канал любое сообщение, затем попросите Искру показать доступные чаты. Если известен chat_id , попросите Искру добавить по нему группу или канал; сначала она безопасно проверит, что чат доступен боту. У групп и каналов идентификатор может быть отрицательным. Искра хранит до 500 последних известных групп и каналов; если их больше, общий список может быть неполным, но нужный чат можно проверить и добавить по chat_id . В списке показываются только чаты, где бот сейчас активен. Чтение сообщений и действия в известном чате выполняются напрямую через MAX.

Навык позволяет читать известные чаты и сообщения, отправлять, редактировать и удалять сообщения, работать с участниками, названием и закреплённым сообщением в пределах Bot API MAX. При чтении истории 50 сообщений — значение по умолчанию, а не максимальный лимит: за один запрос можно получить до 100 сообщений. Для более глубокой истории Искра может выполнить следующие запросы с временными границами. Навык показывает ту доступную историю, которую возвращает MAX для этого бота и чата;

она не обязательно начинается с момента подключения Искры. Перед изменением сообщения, чата, участника или закрепления Искра показывает отдельное подтверждение с точной целью. При неопределённом ответе изменение автоматически не повторяется. Перед удалением навык также сверяет получателя самого сообщения: chat_id для группы или канала и recipient.user_id для личного диалога с ботом.

Перед удалением установки лучше попросить Искру отключить MAX: навык удалит данные подключения. Если токен прежнего бота уже недоступен, при необходимости отзовите его в расширенных настройках MAX.

Файлы и вложения MAX

Если в сообщении MAX есть файл или изображение, оно видно в списке сообщений с номером, именем и размером. Попросите Искру забрать вложение — файл появится в файлах текущего чата. Ссылки и превью вложениями не считаются: файла у них нет, и в списке они не появляются.

Отправить файл тоже можно: приложите его к сообщению Искре (или возьмите файл, который уже есть в этом диалоге) и попросите отправить — он уйдёт вложением с сохранёнными именем и типом. Речь именно о файлах вашего диалога с Искрой, а не о файлах чата MAX: загружать что-либо в MAX заранее не нужно. Перед отправкой Искра покажет подтверждение с точным чатом, именем и размером файла; сообщение уходит только после того, как файл полностью загрузился, — незавершённая загрузка не превращается в отправленное сообщение.

Предел файла — 3,5 МБ в обе стороны; файл больше отклоняется понятной ошибкой заранее.

Обзор

Официальный навык Искры Telegram находится в категории «Интеграции», если его включил оператор платформы. Он подключает не ваш личный аккаунт, а созданного вами чат-бота. Отдельный запуск или сценарий не нужен: установите навык и напишите в обычном чате, например «Помоги создать бота Telegram» или «Подключи моего бота». Искра выяснит, на каком этапе вы находитесь, объяснит следующий шаг и вызовет нужные инструменты навыка.

Создание бота и токен

Бота создаёт пользователь у @BotFather; Искра объясняет шаги, но не делает это за вас. По официальной документации Telegram, проверенной 30 июля 2026 года:

откройте @BotFather и отправьте команду /newbot ;

задайте отображаемое имя, затем username — он обязан заканчиваться на «bot»;

в ответ придёт токен вида <цифры>:<буквы и цифры> .

Если токен потерян, его перевыпускают командой /token или /revoke — обе выдают новый и обесценивают прежний, посмотреть старый нельзя. После любой из них сохраните новое значение через защищённую форму, иначе подключение перестанет работать.

Токен нельзя вставлять в обычное сообщение Искре. Попросите её подключить Telegram: если токен ещё не задан, Искра покажет кнопку «Настроить секреты навыка» со значком замка, и по нажатию откроется защищённая форма. Область хранения токена выбирается при установке навыка — личная или общая для организации. Если токен всё же попал в чат, считайте его скомпрометированным: сделайте /revoke у @BotFather и сохраните новый через форму. Если новый токен относится к другому боту, навык очистит реестр разговоров, сохранённые сообщения и очередь событий прежнего бота и попросит подключиться заново — данные двух ботов не смешиваются.

Как Искра получает события

При подключении Искра выдаёт боту собственный защищённый адрес и просит Telegram слать события туда. Дальше события приходят сразу, как только что-то происходит, и складываются в очередь вашей установки. Разбирает очередь навык — в тот момент, когда вы к нему обращаетесь. Ваше присутствие нужно для разбора, но не для получения.

У этого есть важное следствие: у бота может быть только один такой адрес. Если у вашего бота уже настроен приём событий другим сервисом — своим сервером, n8n и подобным, — подключение к Искре его заменит. Молча этого не произойдёт: Искра покажет текущий адрес и предупредит, что интеграция по нему перестанет получать события. Без вашего согласия ничего не меняется. Обратное тоже верно: если после подключения к Искре бота настроят на другой сервис, события перестанут доходить, и проверка состояния бота об этом скажет.

Неразобранные события хранятся неделю. Если очередь установки переполнится, Telegram временно не сможет доставлять новые — он будет повторять попытки, а непринятое пропадёт через сутки. Проверка состояния бота показывает, сколько событий Telegram не смог доставить, и сообщает об ошибках доставки.

Группы, каналы и privacy mode

Чтобы работать с группой или каналом, добавьте в него бота. Одна ссылка-приглашение в группу или канал сама по себе чат к Искре не подключает: бот должен стать участником чата и получить нужные права. По умолчанию бот видит в группе только команды и обращения к себе. Чтобы он читал все сообщения:

1. у @BotFather выполните /setprivacy и выберите Disable, либо назначьте бота

администратором группы;

2. после смены режима приватности удалите бота из группы и добавьте заново —

иначе настройка не применится.

Проверить текущее состояние можно, попросив Искру показать состояние бота: в ответе есть признак того, читает ли бот все сообщения группы.

Один бот — одна установка

Область хранения токена выбирается при установке навыка: личная или общая для организации. Общее подключение организации подключает и отключает владелец или администратор. Если у вас нет таких прав, Искра так и ответит и предложит установить навык лично: тогда бот будет вашим, а не общим для организации. В каталоге у навыка, уже установленного организацией, стоит пометка «Установлено в организации» — кнопка установки рядом ставит его лично вам.

Чего делать нельзя — подключать одного и того же бота к двум установкам. Адрес приёма событий у бота один, поэтому вторая установка перехватит события первой, и первая замолчит. Разным установкам нужны разные боты.

Что видят участники организации

Группы и каналы — общие. Как только администратор добавил бота в чат, этот чат появляется у всех, кому доступна установка. Переподключаться никому не нужно, своего токена никто не вводит.

Накопленные сообщения групп при этом каждый участник копит свои: они начинают собираться с того момента, как он сам обратился к навыку. Полной истории у Bot API нет в принципе, поэтому окно и так объявлено неполным.

Личные диалоги — нет. Бот переписывается со многими людьми, и его личные переписки принадлежат каждому свои. По умолчанию такой диалог недоступен никому, включая того, кто подключил бота: он не попадает в общий список вовсе.

Деловая переписка Telegram Business — тоже нет. Диалоги бизнес-аккаунта видит только тот участник, который подтвердил владение этим аккаунтом Telegram одноразовым кодом. Остальным они не видны, и ответить в них от чужого имени нельзя, даже если бот общий.

Как подключить свой личный диалог с ботом

Попросите Искру подключить ваш личный диалог. Она покажет защищённую форму со

1. откройте ссылку — Telegram сам отправит код боту;

2. если ссылка не открывается, отправьте тот же код обычным сообщением в личный чат

с ботом;

3. вернитесь в форму и подтвердите.

Код действует 5 минут и никуда, кроме Telegram, отправляться не должен: на эти пять минут он равносилен доступу к диалогу. Не пересылайте его никому и не вставляйте в чат Искры.

После этого диалог появится в списке и будет работать как обычный разговор. Виден он останется только вам: коллеги по организации его не увидят, даже если у них есть доступ к тому же боту.

Если понадобится отменить — попросите отвязать диалог. Накопленное окно сообщений при этом удалится, а сама переписка в Telegram сохранится. Повторная привязка того же диалога другим человеком отменяет прежнюю: диалог принадлежит одному владельцу.

Режим секретаря: Telegram Business

Бот может работать с личными диалогами вашего бизнес-аккаунта. Настройка выполняется на вашей стороне. Возможности Telegram Business — расписание, быстрые ответы, приветствия, бизнес-ссылки — входят в подписку Telegram Premium, но подключение чат-бота вынесено из-под неё и работает без подписки. К одному аккаунту подключается только один бот — прежний будет заменён. Если раздела «Telegram Business» в настройках нет, обновите приложение Telegram. Порядок:

1. у @BotFather: /mybots → нужный бот → Bot Settings → Secretary Mode (прежде

назывался Business Mode) → включить;

2. в Telegram: Настройки → Telegram Business → Чат-боты → указать username бота и

выдать права.

Business даёт доступ к личным диалогам бизнес-аккаунта, но не к группам и каналам: туда бота по-прежнему добавляют вручную. Деловая переписка видна только вам. Чтобы Искра отличила владельца аккаунта от остальных участников организации, привяжите свой Telegram к профилю одноразовым кодом — тем же способом, что и личный диалог с ботом. Привязка одна и общая: если вы уже подключали личный диалог, проходить код заново не нужно, а привязка, сделанная ради Business, заодно откроет вам личный диалог. Важно лишь, чтобы Business был подключён с того же аккаунта Telegram, который привязан к профилю. Пока привязки нет, диалоги этого подключения закрыты и на чтение, и на ответ. Ограничение не мешает команде: у одного бота может быть много подключений, и каждый участник подключает и привязывает свой аккаунт сам. Подключите бота в настройках Telegram Business и обратитесь к навыку: уведомление приходит в момент изменения и само по себе не повторяется. Если Искра пишет, что business-подключений не видит, подключите бота в настройках заново. Отвечать от имени владельца бот может только в диалогах, где собеседник написал за последние 24 часа, и в пределах выданных прав: окно открывает именно входящее сообщение, ваш собственный ответ его не продлевает. Если право ответа не выдано или подключение выключено, Искра скажет об этом прямо и не будет пытаться обойти ограничение.

Что навык умеет и чего не умеет

Навык читает известные чаты и накопленные сообщения, отправляет, редактирует, удаляет и закрепляет сообщения, показывает администраторов и число участников, блокирует и разблокирует участников, меняет название чата. Перед любым изменением Искра показывает отдельное подтверждение с точной целью и полным текстом. При неопределённом ответе операция автоматически не повторяется.

Навык работает и с файлами. Если в сообщении есть документ или изображение, оно видно в списке сообщений: имя, тип и размер. Попросите Искру забрать вложение — файл появится в файлах текущего диалога, и его можно разбирать как любой другой документ. В обратную сторону: приложите файл к сообщению Искре (или возьмите файл, уже имеющийся в диалоге) и попросите отправить — он уйдёт в разговор вложением с сохранёнными именем и типом. Заранее загружать файл в Telegram не нужно. Перед отправкой Искра покажет подтверждение с адресом, именем и размером файла.

Предел файла — 3,5 МБ в обе стороны. Это ограничение Искры, а не Telegram: файл больше отклоняется понятной ошибкой сразу, до скачивания или до подтверждения отправки, и обойти его нельзя.

Главное ограничение — у Bot API нет истории переписки. Искра видит только сообщения, полученные после подключения, и хранит ограниченное окно последних сообщений по каждому разговору. Пустой список сообщений означает, что событий не приходило, а не что чат пуст. Список чатов тоже строится из событий: Bot API не отдаёт перечень чатов бота, поэтому уже существующий чат появится после нового события либо после явного добавления его chat_id . Реестр ограничен 500 чатами и общим объёмом записи, поэтому при длинных названиях фактический предел ниже; при переполнении навык честно сообщает об усечении.

События не запускают Искру в фоне: они приходят сразу, но обрабатываются при следующем обращении к навыку.

Перед удалением установки попросите Искру отключить Telegram: тогда навык снимет адрес приёма событий у бота и удалит локальные данные — реестр разговоров, сохранённые сообщения и очередь событий. Сам бот у @BotFather сохраняется, и вы можете подключить его заново или к другому сервису. Если пропустить этот шаг, Telegram продолжит слать события на адрес, которого больше нет.

В установке организации сохранённые сообщения лежат отдельно у каждого участника, и отключение стирает их только у того, кто его выполнил. Остальным достаточно попросить Искру отключить Telegram у себя — навык увидит, что бот уже отключён, и удалит их копию. Если бота подключат заново, копия удалится сама при первом обращении к навыку. Читать её до этого всё равно нельзя.

Обзор

First-party навык «Нейросети для медиа (свой ключ)» находится в категории «Продуктивность». Это тот же навык генерации картинок, видео и озвучки, что работает у всех, но по вашему личному ключу OpenRouter: МТ Искры за генерацию не списываются — провайдер берёт оплату с вашего аккаунта. Ключ запрашивается при установке; если его не задать, навык сам откроет защищённую форму в чате. Запросы с вашим ключом уходят на адрес провайдера, заданный администратором инсталляции: это может быть зеркало OpenRouter или корпоративный прокси, а не напрямую openrouter.ai — прямое соединение не гарантируется. Адрес виден администратору в настройках навыка. Пока BYOK-навык установлен, обычный системный вариант у вас в списке навыков не показывается — чтобы вернуться к нему, удалите BYOK-навык: автоматического переключения назад нет, в том числе если ключ перестал работать.

Возможности и лимиты совпадают с системным медиа-навыком: до четырёх отдельных изображений за запрос, до пяти входных картинок суммарно для композиции или

редактирования, видео по первому/последнему кадру либо по референсам, озвучка с пожеланием к подаче и по образцу голоса. Входные файлы текущего чата сохраняются. Расшифровка записи выполняется общим инструментом Искры, если он доступен в чате.

Для озвучки действуют те же настройки выбранной модели: Gemini и Fish принимают пожелания к подаче, MAI-Voice-2 — скорость от 0,5 до 2. Gemini сохраняет WAV и принимает до 1000 символов за вызов; остальные модели сохраняют MP3 и принимают до 4000. Каталог показывает доступные настройки, а неподдержанное пожелание требует выбора совместимой модели.

При частичном результате готовые файлы остаются доступными; успешные варианты автоматически не повторяются. Остановка запроса не гарантирует остановку генерации у провайдера: он мог списать деньги и за вариант с неизвестным исходом. Перед повтором проверьте готовые файлы и расход в личном аккаунте OpenRouter.

Обзор

First-party навык «Музыкальная нотация» находится в категории «Продуктивность». После установки Искра создаёт и правит нотные партитуры в форматах MusicXML/MXL через структурную модель, а перед выдачей проверяет файл: валидация по официальной схеме W3C MusicXML, повторное чтение и сравнение нотных событий, длительностей и начальных размера, тональности и ключа каждой партии с подготовленной моделью до записи, согласованность тактов и графический рендер первой страницы в SVG — его можно открыть прямо в чате. В отчёте Искра называет, что именно проверено; совпадение с подготовленной моделью не доказывает точность исходной транскрипции или сохранность всех данных при импорте. По запросу навык дополнительно экспортирует MIDI (проверяет повторное чтение и наличие нот) или MEI (повторное чтение и рендер Verovio) вместе с проверенным MusicXML/MXL; сохранность всех свойств в этих форматах не гарантируется. Точное снятие нот со звука, картинки, PDF или видео недоступно ни с навыком, ни без него: на такую просьбу Искра прямо сообщает ограничение и предлагает выбор — отказ или приближение, явно помеченное как приближение. Перед выдачей MusicXML/MXL навык проверяет, что пометка сохранилась в заголовке при экспорте; остальные метаданные требуют отдельной проверки. Побайтное копирование исходника само по себе не означает, что партитура проверена.

Обзор

Официальный навык Искры UniSender находится в категории «Интеграции», если его включил оператор платформы. Для подключения нужен API-ключ UniSender: при личной установке задайте свой ключ, при установке в организацию владелец или администратор задаёт общий ключ. Если ключа ещё нет, Искра сама откроет форму настроек навыка в чате — искать её в меню не нужно. Собрать и посмотреть письмо можно и без ключа: он требуется только там, где навык обращается к UniSender.

Навык умеет проверить подключение и ответить почти на любой вопрос о ваших данных в UniSender: списки, метки, поля персонализации, шаблоны, кампании и их показатели, созданные письма, домены отправителя. Он покажет, сколько всего контактов в базе, сколько активных и по скольким адресам вообще можно отправлять. Тарифных лимитов в API UniSender нет, поэтому сопоставить эти цифры с вашим тарифом придётся самостоятельно. В этом навыке слово «сегмент» означает список UniSender; метка остаётся отдельным необязательным фильтром. Если название можно понять как список и как метку, Искра должна уточнить выбор. Большая выгрузка обрабатывается внутри навыка: временная ссылка и полный файл контактов в чат не передаются.

Письмо собирает сам навык, а не Искра: вы описываете, что должно быть в письме, и получаете готовую вёрстку. Для письма по вашему шаблону UniSender навык меняет только тексты и адреса ссылок, а саму вёрстку оставляет нетронутой. Готовый макет от дизайнера тоже подойдёт: приложите .html -файл к чату, и навык возьмёт его как есть —

о замеченных дефектах чужой вёрстки он предупредит, но отправить не помешает. Отдельно навык предупреждает о ссылках-трекерах UniSender ( geteml.com/…/mail_link_tracker ), которые попадают в шаблон из уже отправленного письма: такое письмо UniSender не примет, поэтому навык расшифровывает исходный адрес и подсказывает Искре, на что заменить ссылку. Если UniSender всё же отклонил письмо, тестовую отправку или другое изменение, Искра видит причину словами провайдера, а не только код ошибки. Код письма в чат не выводится. Готовое письмо появляется файлом email-preview.html в боковой панели файлов чата — там его можно открыть и посмотреть; отдельного окна подтверждения для этого не нужно. Внешние изображения в предпросмотре по умолчанию не загружаются, чтобы отправитель письма не узнал о просмотре и не получил ваш IP: показать их можно кнопкой «Показать изображения». Так же ведут себя предпросмотр файла и полноэкранный просмотр HTML-артефакта — кнопка есть на всех трёх экранах. Приложенные вами картинки видны сразу. Не открывайте HTML по вручную составленной ссылке на внутренний путь. При тестовой или массовой отправке отдельное окно подтверждения сохраняется и показывает фактически отправляемое письмо, адресатов или списки, ссылки и изображения. То, что вы увидели и подтвердили, и уходит в UniSender.

Шаблоны и отправители

Собранное письмо можно вернуть в UniSender шаблоном — тогда оно откроется в редакторе UniSender и переиспользуется в следующий раз. Новый шаблон создаётся без лишних вопросов; перезапись существующего затирает прежнюю вёрстку и потому проходит через окно подтверждения.

Если нужного адреса отправителя нет среди подтверждённых, навык попросит UniSender прислать на него письмо со ссылкой подтверждения — идти в кабинет для этого больше не нужно. Пока вы не перейдёте по ссылке, отправка с этого адреса будет отклоняться.

Правка уже собранного письма не требует пересобирать его целиком: Искра меняет только названный блок или дописывает новые в конец. Прикладывать картинки заново для этого не нужно — они хранятся вместе с письмом; новое изображение прикладывается, только если вы добавляете новый блок с картинкой.

Списки, контакты, поля и метки

Навык не только читает справочники UniSender, но и меняет их. Списки можно создать, переименовать и удалить. Контакты — добавить в списки, обновить у них значения полей и метки, убрать из отдельных списков или отписать от всех рассылок сразу. Поля персонализации и метки создаются, переименовываются и удаляются.

Метки и значения полей можно задать сразу всем контактам вызова. Значение поля у отдельного контакта заменяет общее, а метки складываются. При обновлении меняются только перечисленные поля — остальные поля и списки контакта остаются как были. А вот метки при обновлении заменяются целиком: у контакта останутся ровно те, что вы назвали. Поэтому чтобы снять одну метку, перечислите те, которые должны остаться, а чтобы снять все — так и скажите: навык отправит пустой набор. Если метки в просьбе не упомянуты вовсе, они остаются как были. Какие метки есть сейчас, видно в списке контактов.

Адреса для таких операций Искра берёт из разговора: их можно назвать самому или сначала попросить найти нужные контакты, а потом сказать «добавь их в список». За один раз навык исключает из списков и отписывает не больше 50 адресов, а добавляет и обновляет — до 500. Свыше 50 адресов добавление и обновление идут через массовый импорт UniSender. Он значения полей только заменяет, поэтому при разном наборе полей у контактов навык попросит разбить вызов, чтобы не стереть данные, которых просьба не касалась. Метки массовый импорт умеет только добавлять к уже имеющимся: проставить метку сотням адресов можно добавлением, а замена набора меток идёт по одному контакту и поэтому ограничена полусотней адресов за раз. Загрузка целой базы по-прежнему делается импортом в кабинете UniSender.

Если UniSender не ответил на изменение — создание списка, переименование, удаление, перезапись шаблона или загрузку контактов, — навык не повторяет вызов вслепую и не выдаёт обычное «попробуйте позже». Он прямо говорит, что неизвестно, применилось изменение или нет, и просит сначала проверить состояние: сам он угадывать не берётся, потому что одноимённый список мог существовать и раньше. Иначе в базе появились бы два списка с одним названием, а по такому названию отправлять уже нельзя. При массовом добавлении навык называет число, которое учёл сам UniSender: если он принял не все адреса, это будет сказано прямо.

Окно подтверждения появляется там, где отменить последствие нельзя или где затронуты многие: удаление списка, поля или метки, отписка, исключение из списка и правка десяти и более контактов сразу. Замена меток подтверждается всегда, даже у одного контакта: прежний набор меток навык не хранит и вернуть его не сможет. В окне видно не только адреса и списки, но и что именно применяется — какие поля с какими значениями и какие метки; если у контактов значения разные, так и написано. Это важно при обновлении: прежние значения указанных полей заменяются, и подтверждать замену вслепую не придётся. Создание списка, переименование и правка пары контактов проходят без окна. Если часть адресов не удалось изменить, навык честно назовёт и обработанные, и сорвавшиеся. Отдельно он назовёт адреса, по которым UniSender не ответил: там изменение могло примениться, и повторять вслепую не стоит — сначала проверьте их состояние.

Отдельно навык умеет собрать список рассылки, когда адресов больше, чем можно перечислить руками: объединить несколько списков, вычесть один-два, отобрать по метке или статусу либо взять тех, кто определённым образом отреагировал на прошлую рассылку — открыл, перешёл по ссылке, открыл, но не перешёл, получил, но не открыл. Адреса при этом не выходят наружу: Искра называет только числа, а сама выборка становится содержимым выбранного списка. Повторы навык убирает сам, и собрать в один список несколько источников можно подряд — дубли не появятся. Если статус не задан, в список попадают только адреса, которым UniSender станет писать. Можно сначала попросить просто посчитать, сколько получится, ничего не записывая. Источников-списков можно назвать до двадцати и столько же вычесть, а можно взять всю базу — тогда нужен хотя бы один другой отбор; целевой список источником быть не может. Предел по умолчанию и максимум — 20 000 адресов, и относится он к итоговому размеру списка, а не к одной выборке: если в списке уже что-то лежит, навык доберёт только остаток — это и есть прямой ответ на месячный лимит тарифа, который считается по размеру списка. Адреса, которые уже состоят в этом списке, повторно не записываются, и Искра скажет, сколько их было, — но только когда источник — списки, метка или статус. Выгрузка по реакции на рассылку членства в списках не содержит, поэтому там навык честно предупредит, что часть отобранных могла состоять в списке и раньше, а точного числа не назовёт. Перед записью появляется окно подтверждения с источником, числом адресов и текущим размером списка. Если UniSender не ответил, сколько контактов в списке, навык прямо предупредит, что предел он в этот раз не гарантирует. А если после записи провайдер сообщит, что контактов в аккаунте стало больше, чем позволяет тариф, вы об этом узнаете, а не обнаружите на следующей рассылке. Отчёт о доставке UniSender хранит 180 дней, поэтому по более старой рассылке выборку по реакции собрать нельзя.

Обратной операции нет: собрать список по критерию можно, а убрать по критерию — нет. Исключение из списка идёт по одному адресу и не больше пятидесяти за вызов, потому что массового удаления из списка UniSender не даёт. Из того же ряда: навык не делает A/B-тестов и автоматических цепочек писем и не просыпается по расписанию сам — рассылка уходит тогда, когда вы её запланировали.

Новый контакт добавляется без письма-подтверждения и получает в UniSender статус «новый». Подтверждённым он через API не становится ни при каких настройках — это делает сам контакт своим действием. Ответственность за наличие согласия на рассылку остаётся на владельце базы, а фактические статусы всегда видно, если попросить Искру показать контакты списка.

После тестовой отправки навык подтверждает только то, что UniSender принял запрос. Legacy API не сообщает статус доставки тестового письма, поэтому итог проверяется в почтовом ящике; статус кампании к тестовой отправке не применяется.

История рассылок доступна отдельно: что и когда отправлялось, по каким спискам и с какими статусами. Одно письмо, ушедшее по нескольким спискам, показывается одной рассылкой, а не тремя записями. Показатели — доставки, открытия, клики, отписки, жалобы — считаются по рассылке целиком; для идущей рассылки цифры помечаются как неполные, а не скрываются.

Навык также может получить по логину до 500 доменов отправителя и показать до 20 пар имени и email из недавних кампаний. Эта история не является полным списком текущих подтверждённых адресов, но полный список навык прочитает отдельно — логин аккаунта он тоже узнаёт сам. Искра не должна придумывать варианты адресов.

Рассылка проходит защитный сценарий:

1. Выберите от одного до трёх списков и письмо — готовый шаблон либо новый текст.

Пустые ссылки, неизвестные шаблоны ссылок и небезопасные адреса навык отклонит. В подтверждении видны именно ссылки и внешние изображения из итогового письма.

2. К письму можно добавить PNG, JPEG или GIF — до тридцати двух штук, каждая не

больше 300 КиБ: приложите файл в текущий чат. Отдельно действует общий лимит полного закодированного запроса, поэтому несколько крупных картинок может потребоваться уменьшить или сжать. Искра покажет изображения перед отправкой. Навык не ищет и не скачивает изображения в интернете, потому что не может проверить лицензию и права использования. Внешние изображения, уже находящиеся в выбранном шаблоне, сохраняются.

3. Искра показывает отправителя, тему, названия списков, фактические ссылки и

изображения, а также краткую оценку аудитории. Выберите «Отправить сейчас» или «Запланировать»; поля режима и времени расположены перед визуальным HTML-превью. Если один адрес входит в несколько списков, он может получить письмо несколько раз. Список с оценкой больше 50 000 получателей нужно отправлять отдельно; форма предупредит, что обработка может занять больше времени. Немедленная отправка требует ещё одного явного ответа «Да, отправить сейчас».

4. Крестик или Escape только сворачивает полноэкранное окно: нажмите «Вернуться к

форме» в карточке инструмента, чтобы открыть то же превью. Кнопка «Отменить» завершает вызов без создания писем и кампаний.

5. После финального подтверждения навык сначала создаёт отдельное письмо для

каждого списка, затем отдельные кампании. Для «сейчас» UniSender запускает их без отложенного времени; для планирования все кампании получают выбранное время.

Для проверки письма можно отдельно отправить тест на 1–25 явно указанных адресов. Существующий список UniSender нужен только технически для создания письма: адреса в него не импортируются, кампания по списку не запускается. Искра покажет одно подтверждение с точным письмом, адресатами, ссылками и изображениями. UniSender может отклонить неподтверждённый тестовый адрес. При потерянном или неоднозначном ответе навык честно сообщит, что результат неизвестен, и не станет повторять отправку автоматически.

Результат содержит короткое текстовое сообщение с отправителем, темой, фактическими ссылками и известными идентификаторами кампаний, поэтому эти сведения остаются в контексте чата без вывода сырого HTML. По вопросу «Какой статус письма?» агент заново читает актуальное состояние известных кампаний в UniSender. Запланированную рассылку можно отменить по её названию, месту в контексте или идентификатору кампании: агент покажет отдельное подтверждение и отменит все связанные кампании, которые ещё допускают отмену. При неизвестном результате он проверит свежий статус и не станет повторять отмену вслепую. Уже начавшуюся или завершённую отправку UniSender отменить не позволяет.

По просьбе проанализировать последние рассылки или до десяти конкретных кампаний навык сравнит агрегированные показатели UniSender: доставки, открытия, клики, отписки и жалобы на спам. Для объяснения результата он может использовать тему, короткий фрагмент текстовой версии письма и популярные безопасно очищенные ссылки. Это не чтение свободных ответов получателей: UniSender Legacy API их не предоставляет. Адреса и IP получателей в результат анализа не попадают; если часть содержания или ссылок недоступна, Искра должна явно это указать и сохранить уже полученные показатели.

accepted=true означает, что UniSender определённо принял все цели;

«ничего не создано». Авторитетное поле каждой цели — state : accepted , failed , unknown или not_attempted . При частичном/неизвестном результате не повторяйте весь исходный набор списков: сначала попросите агента проверить возвращённые campaign_id и при необходимости сверьте их в кабинете UniSender, затем запускайте новый вызов только для неотправленных списков.

На тарифе UniSender «Фри» сам сервис добавляет внизу каждого письма логотип «Сделано в UniSender»; это не часть HTML, собранного Искрой. В платных тарифах UniSender этот блок не добавляет — подробнее в описании тарифов UniSender.

Обзор

«Контакты» подключает вашу внешнюю адресную книгу CardDAV. Установите навык из каталога и откройте его настройки: укажите логин, пароль приложения и HTTPS-адрес сервера. Если провайдер поддерживает автоматическое обнаружение, достаточно полного логина с доменом и пароля. Проверенные подключения — Яндекс и Radicale 3.5.10, с обычной авторизацией по логину и паролю приложения. Совместимость с другими серверами требует отдельной проверки.

Подключение настраивается отдельно от почты, календаря и WebDAV-диска. Можно использовать личные настройки или подключение организации. Перед записью форма показывает учётную запись и выбранную адресную книгу.

Попросите Искру найти человека по имени, организации, телефону или email. В карточке доступны имя, организация, должность, день рождения, заметка, несколько телефонов и адресов электронной почты. Если результатов много, Искра покажет краткий список; выбранную карточку можно открыть полностью. При сообщении о неполном поиске уточните запрос или адресную книгу. Неподдерживаемая, недоступная или удалённая во время поиска карточка пропускается; остальные совпадения остаются видны, а поиск отмечается как неполный. Ошибка доступа к адресной книге требует проверки подключения. Если на сервере очень много адресных книг, Искра покажет часть списка и предупредит о его неполноте — в этом случае удобнее назвать нужную книгу.

Чтобы создать, изменить или удалить контакт, проверьте данные в форме и подтвердите действие. Если доступно несколько адресных книг, сначала выберите нужную. Отмена формы оставляет адресную книгу без изменений. Если другой клиент успел изменить карточку, Искра предложит открыть её свежую версию и подтвердить правку заново.

У большой карточки длинные поля в форме могут показываться сокращённо; предупреждение над превью обозначает это явно. Подтверждение относится к полным данным контакта, сокращение касается отображения.

Контакт без отображаемого имени доступен наравне с остальными: некоторые сервисы хранят такие записи, и Искра покажет их по организации, телефону или адресу почты. Задать пустое имя при сохранении нельзя.

Навык сохраняет остальные поля карточки при точечном изменении. Поддерживаются карточки vCard 3.0/4.0 в UTF-8. Карточка с неподдерживаемым полем недоступна для чтения и изменения и пропускается при поиске с сообщением о неполном результате. Это касается vCard 2.1, другой кодировки, а также неподдерживаемого параметра или типа

значения в имени, организации, должности, дне рождения, заметке, телефоне или email. Например, старая запись телефона TEL;WORK;VOICE вместо параметра TYPE=work,voice или email с типом VALUE=uri делает недоступной всю карточку. Пересохраните такой контакт в современном формате через своё приложение контактов. Группы контактов, массовый импорт и постоянная синхронизация в этот навык не входят.

Обзор

Навык Plaud работает с записями диктофона Plaud: находит записи, читает конспект и расшифровку встречи, помогает разобрать встречу и сохраняет записи в Память. Это не системный навык: он не появляется у вас сам, его устанавливают только из каталога навыков, категория «Интеграции». Навык есть в каталоге, только если администратор вашей Искры включил подключение Plaud. Если администратор позже выключит подключение, навык пропадёт из каталога и чата, а установка сохранится до повторного включения. Если Plaud не примет настройки подключения Искры, навык попросит обратиться к администратору.

Из каталога навык устанавливают лично себе — он появится только у вас. Обновление навыка до новой версии сохраняет подключённый аккаунт. После удаления навыка из личных Искра удаляет сохранённый доступ к Plaud: если установить навык снова, аккаунт Plaud нужно будет подключить заново.

Подключение аккаунта Plaud

1. Попросите Искру: «Подключи Plaud».

2. В чате появится форма со ссылкой «Подключить Plaud». Откройте её, войдите в свой

аккаунт Plaud и разрешите доступ.

3. Вернитесь в чат, отметьте «Я разрешил доступ в Plaud» и нажмите «Готово».

Навык сам проверяет, что Plaud выдал доступ, и называет подключённый аккаунт. Если доступ в Plaud не был разрешён, Искра попросит открыть ссылку ещё раз. Узнать состояние в любой момент можно вопросом «Plaud подключён?» — Искра покажет, подключён ли аккаунт и готова ли Память к импорту.

Чтобы отключить Plaud, попросите «Отключи Plaud». Искра удалит сохранённый доступ только в текущем профиле; файлы, уже сохранённые в Память, останутся на месте. Отключение в Искре не отзывает разрешение внутри аккаунта Plaud — его отзывают в настройках самого Plaud.

Установка в организацию делает навык доступным сотрудникам, но аккаунт Plaud не общий: каждый сотрудник подключает свою учётную запись Plaud сам, и навык работает с записями только этого аккаунта. Если организация удалит навык, прежний доступ перестанет действовать, и после новой установки каждому нужно подключить Plaud заново. Сохранённый доступ при этом не стирается сразу, а заменяется при новом подключении; чтобы удалить его заранее, попросите «Отключи Plaud» до удаления навыка в организации.

Что умеет навык Plaud

Показать список записей и найти запись по названию или датам. Искра называет, какую часть записей охватил поиск: для старых записей список может оказаться неполным, и навык говорит об этом прямо, а не выдаёт неполный результат за полный. В таком случае сузьте период поиска.

Прочитать конспект Plaud или расшифровку. Расшифровка приходит страницами с таймкодами и говорящими, поэтому даже очень длинную запись можно прочитать по частям.

Разобрать встречу: итоги, решения, задачи с ответственными и сроками, открытые вопросы. Конспект Plaud и выводы Искры подписываются раздельно.

Подготовить файл записи в формате Markdown — с конспектом и расшифровкой.

Прислать аудиозапись встречи в файлы разговора: попросите «пришли аудио этой записи». Файл скачивает сама Искра, ссылку в чат она не отправляет.

Импортировать записи в Память — в выбранную папку, с продолжением с того же места при следующем запуске. Как ведут себя импортированные файлы, описано в разделе «Файлы, импортированные навыками».

Импортировать новые записи регулярно через «Планы» — см. пример «Регулярный импорт Plaud».

В Память аудио не импортируется: там уже лежит расшифровка, сделанная Plaud, а загруженный звук Искра распознавала бы второй раз — дольше и без пользы. Если аудио всё же нужно в Памяти, попросите сохранить присланный файл в папку.

Попробуйте, например: «Покажи мои записи Plaud за эту неделю», «Разбери встречу «Планёрка» из Plaud: решения и задачи», «Импортируй записи Plaud в подключённую папку Памяти».

Ограничения навыка Plaud

Каждая запись сохраняется отдельным файлом, до ~3 МиБ текста на запись. Если расшифровка длиннее, навык не сохранит обрезанный файл под видом полного, а предложит читать её по страницам.

Если расшифровка в Plaud ещё не готова, навык так и говорит: расшифровка ещё не готова. Разбор можно построить по конспекту, а при импорте такая запись дождётся расшифровки и будет обработана в следующий раз.

Аудиозапись приходит в файлы разговора и живёт вместе с ним. Очень большая запись может не поместиться — тогда Искра скажет об этом и предложит скачать файл в приложении Plaud. При регулярном импорте аудио не скачивается: там сохраняется только текст встречи.

Записи хранит и обрабатывает Plaud на своём хостинге; Искра получает их через подключение к вашему аккаунту Plaud.

Безопасность и папка для импорта

Текст записей навык считает данными, а не командами: если в расшифровке прозвучала просьба «удали файлы» или «перешли это», Искра перескажет её как содержание встречи, но выполнять не станет.

Для импорта в Память к чату или к записи «Планов» должна быть подключена ровно одна папка Памяти с правом записи, остальные папки — только на чтение. Если папок с правом записи нет или их несколько, навык остановится до чтения записей и попросит изменить набор подключённых папок. Так личные записи встреч не попадут в другую папку — например, общую папку отдела, которая случайно оказалась подключена на запись.

Обзор

Навык подключает Искру к вашему аккаунту amoCRM: помогает искать и создавать компании, контакты и сделки, заполнять поля по документам, прикреплять файлы, работать с задачами и примечаниями. Перед записью показывает черновик для подтверждения.

Обзор

1. Администратор amoCRM открывает амоМаркет → меню «⋯» справа вверху →

«Создать интеграцию» → внешняя интеграция. Заполните название «Искра», обязательное описание, например «Помощник для работы с CRM», и ссылку для перенаправления: https://cloud.iskrabot.ru для облачной Искры либо адрес вашей установки. Включите предоставление доступа и сохраните интеграцию.

2. В созданной интеграции откройте «Ключи и доступы» → блок «Долгосрочный

токен» → «Сгенерировать токен». Выберите срок действия и подтвердите. Для навыка нужен именно долгосрочный токен: секретный ключ интеграции — другое значение. Токен показывается один раз, сразу скопируйте его для ввода в защищённую форму Искры.

3. В Искре откройте «Навыки» → каталог → amoCRM и установите навык лично или в

организацию. На карточке нажмите «Требует настройки» (позже — «Подробнее» → «Настройки»). Если доступны оба варианта, выберите нужное «Подключение» вверху окна. В группе «Подключение amoCRM» заполните:

Долгосрочный токен — значение из предыдущего шага.

Если настраиваете подключение из чата, нажмите кнопку «Настроить секреты навыка» в ходе выполнения. Она открывает окно; сама подготовка кнопки ещё не означает, что подключение сохранено. Уже указанные поддомен, домен и уровень подключения подставляются в форму.

4. Попросите Искру показать воронки, чтобы проверить подключение.

Общее подключение организации один раз настраивает владелец или администратор. Оно доступно сотрудникам, которым предоставлен этот навык. Личное подключение доступно только вам: другие участники организации не видят его настройки и не могут его использовать. Оно полностью замещает организационное; окно настройки предупреждает о таком выборе и показывает, какое подключение действует. Подробнее — Группы настроек.

Сохранённый токен скрыт: его можно заменить, но нельзя посмотреть. Отозвать доступ можно в amoCRM. API работает с правами пользователя, выдавшего доступ; выбор сотрудника в Искре задаёт атрибуцию записей, а не дополнительные права. Для вложений интеграции также требуется доступ к файлам amoCRM.

Обзор

При первом изменении данных навык предложит выбрать себя из списка сотрудников. Этот выбор запоминается для действующего подключения и задаёт автора поддерживающих это записей и ответственного по умолчанию. Другого ответственного можно назначить отдельно. Выбор «От чьего имени» можно сменить в форме подтверждения. При смене подключения или токена навык предложит выбрать сотрудника снова.

Обзор

Примеры поручений:

«Найди компанию по ИНН из этой карточки и создай, если её ещё нет».

«Заполни реквизиты компании из приложенного PDF».

«Найди сведения об этой компании по ИНН в интернете и покажи источники».

«Оформи сделку по договору, свяжи с компанией и приложи договор».

«Свяжи существующую сделку с этой компанией».

«Покажи мои просроченные задачи» или «Сводка по основной воронке».

Искра читает текст документа, а для сканов использует доступное распознавание. Неразборчивые и противоречивые реквизиты требуют уточнения. Поиск компаний проверяет также варианты кириллицы, латиницы и сокращения. Если подходят несколько карточек, выберите нужную по названию и реквизитам. Поиск можно продолжить на следующих страницах.

Если первая проверка названия ничего не нашла, а варианты в другом алфавите ещё не проверены, навык направляет Искру повторить поиск с написанием по произношению. Изменение регистра или сокращение в том же алфавите такой проверкой не считается. Для поиска по ИНН, телефону и email она не требуется.

Повторное создание с теми же данными проверяется по сохранённому результату операции и существующим карточкам. Совпадения по названию, телефону, email и ИНН в структурированных реквизитах помогают избежать дублей. Если нужен отдельный объект с совпадающими данными, явно поручите создать его отдельно и проверьте это действие в подтверждении. При потере ответа amoCRM Искра сначала проверяет результат предыдущей записи.

Бюджет сделки можно изменить на ноль. После создания или изменения карточки Искра перечитывает её и сообщает, если не удалось подтвердить сохранение.

Списки и типы полей загружаются из вашего amoCRM. Недостающие значения можно собрать одной формой, затем проверить в черновике. Сотрудники показываются по именам, когда доступен справочник пользователей amoCRM (для него нужны права администратора). Если справочник недоступен, чтение карточек продолжается с предупреждением и идентификаторами. Карточка компании содержит связанные сделки. При замене компании в сделке черновик показывает, какая связь меняется.

Обзор

Владелец или администратор задаёт правила один раз в настройках amoCRM:

1. В профиле организации откройте «Навыки» → amoCRM → настройки.

2. Выберите «Организация», затем блок «Правила продаж команды».

3. Укажите продукты через ; , шаблон названия, например {client} — {product} , и

названия обязательных полей через ; . Названия полей должны совпадать с существующими полями сделок в amoCRM. При необходимости укажите поля вида продаж и даты подписания.

4. Сохраните настройки. Изменения действуют при следующей записи сделки.

Адрес CRM повторно вводить не нужно: новые правила автоматически привязываются к подключению организации. Если задано только личное подключение, используется его адрес. Поддомен и домен можно заполнить вместе с правилами в том же окне. При редактировании существующих правил их привязка сохраняется.

Искра определяет продукт по содержанию сделки, а название составляет из имени связанной компании и продукта. Перед созданием и изменением сделки проверяются компания, продукт и обязательные поля. Уже заполненные значения учитываются при обновлении; очистка обязательного поля остановит запись. Вид продаж выбирается по контексту из вариантов CRM, дата подписания — из документа или подтверждённого ответа пользователя.

Правила действуют для указанного аккаунта CRM в этой организации, в том числе через личное подключение к нему. Они не открывают другим сотрудникам доступ к личному токену. Для другого аккаунта CRM эти правила не применяются. Если правила не настроены, сделка использует название и поля из запроса. Отдельный навык и PDF с регламентом для работы не требуются.

Обзор

Навык заполняет существующие поля amoCRM. Если в списке полей компании нет ИНН, КПП или ОГРН, администратор amoCRM должен добавить их: открыть любую карточку компании → «Настроить» → «Добавить поле». Для отдельных идентификаторов подойдёт тип «Текст», сохраняющий ведущие нули. Поля создаются для компаний аккаунта, а не для одной карточки. Инструкция amoCRM по созданию полей.

После сохранения попросите Искру перечитать поля компании и заполнить реквизиты. Переключатель в админке Искры для этого не нужен. Запись реквизитов в примечание — отдельный вариант, который Искра согласует с вами.

Обзор

Попросите прикрепить загруженный в чат файл к конкретной сделке. Поддерживаются разные форматы, в том числе PDF, изображения и офисные документы, размером до 20 МБ (20 000 000 байт) на файл. Перед прикреплением навык показывает сделку, имя файла и размер. Ограничения самого amoCRM также применяются.

Результат записи сделки и результат вложения сообщаются отдельно. Если файл успел загрузиться, но привязка не подтверждена, Искра сообщает об этом и может повторить привязку по сохранённому результату. Неопределённый ответ сервера требует проверки карточки перед повторным созданием записи.

Можно также попросить показать вложения сделки, скачать выбранный документ в текущий чат для чтения или распознавания, убрать вложение из сделки либо загрузить новую версию. Скачивание и загрузка поддерживают тот же предел 20 МБ; для сохранения в чат должно хватать свободного места в рабочей папке.

Удаление вложения убирает связь с выбранной сделкой. Сам файл в amoCRM и его связи с другими карточками сохраняются. Новая версия заменяет содержимое общего файла: перед подтверждением Искра показывает связанные карточки, которые увидят обновление. Повтор прикрепления того же содержимого к той же сделке проверяет версию сохранённого файла. Если содержимое уже заменили, Искра сообщает о расхождении; неизменённый файл можно использовать повторно.

Если новая версия загрузилась, но Искра не смогла сохранить подтверждение операции, повторный запрос проверяет уже загруженную версию. Повторная отправка содержимого для этого не нужна.

Обзор

У существующей задачи можно изменить текст, срок и ответственного, завершить её с результатом или вернуть в работу. В обычном примечании можно исправить текст: перед сохранением показаны прежний и новый варианты. Системные записи истории этим действием не редактируются.

К существующей сделке можно прикрепить контакт, убрать его связь со сделкой или назначить уже прикреплённый контакт основным. Остальные связи сохраняются; сама карточка контакта при отвязке остаётся в CRM.

Обзор

Во вкладке «Карта» в деталях навыка накапливаются знания о воронках и полях amoCRM. Построить или обновить её можно кнопкой «Исследовать» / «Обновить карту». Подробнее — Карта знаний подключения.

Обзор

Искра подключается к вашей 1С по стандартному интерфейсу OData — он есть в любой типовой конфигурации на управляемых формах (ERP, УТ, КА, БП, УНФ) и включается штатными средствами, без доработок.

На витрине навыков два варианта:

1С Коннектор ( 1c-connector ) — база опубликована в интернете (HTTPS-адрес). Подходит, если веб-клиент 1С открывается по публичному адресу.

1С Коннектор через VPN ( 1c-connector-vpn ) — база доступна только внутри сети организации. Искра подключается через ваш OpenVPN-сервер. Вариант для организаций: VPN-профиль задаёт администратор.

Обзор

1. Откройте «Навыки» → каталог витрины, найдите карточку «1С Коннектор» (или «1С

Коннектор (VPN)») и установите — себе или в организацию.

2. На карточке навыка нажмите «Требует настройки» (позже те же поля открывает

«Подробнее» → вкладка «Настройки»). Откроется окно «Настройки навыка»; если вам доступны оба варианта — личный профиль и организация, — выберите нужный в строке «Подключение» вверху окна. Ниже — группа настроек «Подключение к 1С»:

Адрес публикации — https://host/база , адрес стандартного OData-интерфейса, включая имя базы.

Логин — учётная запись интеграции в 1С.

Пароль — write-only, как и обычные ключи: видно только, задан ли пароль, посмотреть его нельзя; чтобы заменить, введите новый.

Разрешить запись — разрешает создавать, изменять записи и проводить документы.

Разрешить удаление — разрешает физическое удаление. Оба флажка по умолчанию выключены — навык только читает.

3. Подключение можно завести дважды: лично для себя и, если вы владелец или

администратор организации, на уровне организации — тогда оно действует для всех сотрудников. Если заполнены оба, личное подключение полностью замещает организационное — при выборе личного поверх уже настроенного подключения организации Искра предупредит об этом; рядом с группой видно, какое подключение сейчас действует. Подробнее о выборе, куда настраивать — в «Навыки» → «Группы настроек (подключения)».

Для VPN-варианта администратор организации дополнительно заполняет секрет vpn_conn (там же, в списке секретов под группой настроек):

Обзор

Если что-то не работает, попросите Искру «проверь подключение к 1С» — она сама разберётся, в чём дело: неверный адрес публикации (например, лишний «хвост» в конце адреса — Искра предложит исправленный вариант), неверный логин или пароль, у пользователя интеграции не хватает прав, либо сервис 1С сейчас недоступен. При любой проблеме — и даже если подключение вовсе не настроено — откроется форма настройки, чтобы сразу поправить нужное поле.

Обзор

1. Опубликуйте базу на веб-сервере (Конфигуратор → Администрирование →

Публикация на веб-сервере), включив «Публиковать стандартный интерфейс OData».

2. Создайте отдельного пользователя интеграции (например, «ИскраБот») и дайте ему

роль «Удалённый доступ OData» плюс права чтения (и записи, если нужна запись) на нужные объекты.

3. Включите объекты в состав OData: Администрирование → Настройка стандартного

интерфейса OData → отметьте нужные справочники, документы и регистры. Без этого шага навык подключится, но список объектов будет пуст.

4. После изменения состава сохраните и перезапустите публикацию.

Обзор

Попросите Искру: «покажи остатки на складах из 1С», «найди номенклатуру по названию …», «создай элемент справочника …» (при включённой записи). Первым вызовом навык получает список доступных объектов — если он пуст, Искра подскажет, что состав OData не наполнен (см. шаг 3 выше).

Оба навыка читают списки постранично: по умолчанию одна страница содержит до 100 записей. Если нужен весь список, явно попросите выгрузить его полностью — Искра должна продолжать чтение следующих страниц. Если чтение прервалось из-за ошибки или лимита, ответ должен обозначать выгрузку как частичную, указывать число полученных записей, причину остановки и доступное продолжение.

На карточке навыка есть готовый сценарий «Подключить 1С и изучить структуру данных» (вкладка «Сценарии») — он проведёт вас через настройку подключения, проверку и исследование объектов базы и сохранит результат в карту знаний.

Обзор

В окне деталей навыка есть вкладка «Карта» — накопленные знания об объектах вашей базы: что означает объект и его поля, проверенные примеры запросов. Искра пополняет карту по ходу работы, в том числе запоминает найденный рабочий способ после ошибки. Построить карту заново или обновить можно кнопкой «Исследовать» / «Обновить карту» — подробнее в «Навыки» → «Карта знаний подключения».

Обзор

Память — единое место для личных файлов, проектов, чатов и папок, синхронизируемых с компьютером. Отдельного раздела «База знаний» больше нет: его файлы после обновления автоматически появляются в Памяти, переносить их вручную не нужно. В десктоп-приложении над списком есть действие «Синхронизация с компьютером» — оно открывает страницу «Диск», где привязываются локальные папки. Привязанная папка уже видна в Памяти; отдельный перенос не нужен. Подключение такой папки к чату или проекту и ограничения обратной синхронизации описаны в разделе «Синхронизация папок».

Бывшие папки «Базы знаний» лежат в общем списке вкладки «Файлы» вместе с остальными — отдельной вкладки или группы для них нет. Найти их помогают фильтры над списком: свои папки отбирает чип «Мои папки», папки, которыми с вами поделились, — чип «Доступные мне»; конкретную папку или файл по названию быстрее найти поиском. Загружать эти материалы заново не нужно — никаких действий от вас перенос не требует. Об этом же напоминает подсказка в начале списка папок: «Подробнее в справке» открывает этот раздел справки, а «Понятно» убирает подсказку насовсем.

Файлы и папки

В Памяти можно:

создавать обычные и вложенные папки;

загружать сразу несколько файлов через кнопку или перетаскиванием в открытую папку и видеть ход каждой загрузки;

открывать, скачивать, переименовывать и перемещать файлы;

выбирать несколько элементов и отправлять их в корзину;

восстанавливать удалённые элементы из общей вкладки «Корзина» в течение 30 дней, если позволяют права.

У собственной папки верхнего уровня в меню «Ещё» есть действие «Переименовать»: введите новое имя и нажмите «Сохранить». Файлы, доступ и подключения к чатам, проектам и коллекциям сохраняются. Это работает и для закреплённой папки или папки, выбранной рабочей для чата.

Чужую папку верхнего уровня переименовывает и отправляет в корзину её владелец; право «Управление доступом» само по себе этого не разрешает. У служебных папок чатов и проектов, синхронизируемых папок и папок только для чтения эти действия недоступны. Пояснение видно рядом с действием.

Для вложенных папок и файлов действие «Переименовать или переместить» разделяет имя элемента и папку назначения. Выберите папку в списке, переходя по хлебным крошкам, при необходимости измените имя и подтвердите операцию. Перемещение выполняется внутри того же источника Памяти. Если закрыть уже изменённую форму, Искра сначала попросит подтвердить потерю введённых данных.

Название папки открывает её содержимое. Остальные действия строки собраны в меню «Ещё»: «Управление» открывает права агента и состояние обработки, там же — закрепление, подключение к проекту и коллекции, перемещение и удаление. У файла рядом с меню остаётся быстрый предпросмотр.

В списке рядом с каждым файлом и папкой указаны дата и время создания. При первом открытии Памяти без сохранённых настроек выбраны «Мои папки» и сортировка «Создано»: новые элементы показаны сверху. Ваш выбор фильтра и сортировки сохраняется в этом браузере при возвращении и перезагрузке, включая фильтр «Все». Ранее сохранённые настройки продолжают действовать. Нажмите «Название», чтобы сортировать по имени, или «Создано» — по дате; повторное нажатие меняет направление. Если личных папок пока нет, кнопка «Показать все» открывает остальные доступные папки.

Пока файл загружается, можно открывать другие папки Памяти — загрузка продолжится в исходную папку. Под именем загружаемого файла показан полный путь назначения; нажмите на него, чтобы открыть эту папку, не прерывая загрузку.

Старые и новые офисные форматы, включая DOC, XLS и DOCX, загружаются как оригиналы; извлечение текста выполняется отдельно после загрузки. Если один файл из пакета не принят, в его строке появится конкретная причина, а загрузка остальных продолжится. После устранения причины можно повторить только этот файл.

При новой загрузке, если в папке уже есть файл с таким именем, Искра сохранит новый рядом и добавит к имени номер: например, video (1).mp4 , затем video (2).mp4 . Существующий файл не заменяется. Одинаковые имена в разных папках друг другу не мешают.

При обновлении или закрытии страницы и при уходе из раздела браузер предупредит, что текущая загрузка прервётся. Если всё же уйти, при возвращении появится строка «Загрузка прервана»: нажмите «Выбрать файл» и укажите тот же локальный файл. Загрузка начнётся заново с нуля и сохранится в папку, выбранную при первом запуске.

В строке каждого файла показано состояние обработки. Оригинал доступен сразу после загрузки, даже если Искра ещё извлекает текст, распознаёт скан или расшифровывает запись. Для ошибки обработки доступно действие «Повторить обработку» — повторно загружать оригинал не требуется.

Автоматически Искра обрабатывает файлы ваших папок Памяти и файлы проектов. Файлы рабочей папки чата автоматически не обрабатываются: у них показан статус «Не обработан». Это относится и к служебной папке чата, и к папке Памяти, выбранной рабочей: как только папка стала рабочей, новые файлы в ней — в том числе загруженные вами через раздел «Память» — ждут кнопки «Обработать». Это не ошибка — оригинал доступен как обычно, но содержимое такого файла не участвует в поиске по содержимому и недоступно агенту как текст. Кнопка «Обработать» рядом со статусом запускает обработку вручную; для этого нужен доступ на запись к файлу. Тот же статус может встретиться у файлов, загруженных до одного из обновлений, — кнопка работает для них так же.

Если большой или сложный офисный документ не удаётся обработать полностью, Искра автоматически попробует извлечь его текст в упрощённом виде. В нём могут отсутствовать оформление, изображения, диаграммы и встроенные объекты, но оригинал останется без изменений и будет доступен для просмотра и скачивания. Если извлечь текст не получится, в Памяти сохранятся файл и основные сведения о нём, однако поиск по содержимому и агент не смогут использовать текст документа.

Для обработанного файла можно открыть «Извлечённый текст». Это безопасное представление текущей версии: оно доступно только для чтения, не скачивается как отдельный файл и не показывает служебные данные хранилища. Обычные Markdown-файлы, созданные вами или агентом, остаются самостоятельными редактируемыми файлами.

Папка как база знаний

Отдельно создавать или настраивать базу знаний не нужно — и тем более не нужно поднимать для этого RAG или другой поисковый индекс. Обычная папка Памяти уже работает как база знаний: загрузите в неё документы и подключите папку к чату. Дальше Искра сама просматривает структуру папки, ищет по файлам и читает нужные фрагменты, а при большом объёме поручает чтение субагентам (см. «Субагенты внутри одной задачи» в разделе «Режим агента»).

Файлы папок Памяти и файлы проектов обрабатываются автоматически, поэтому содержимое участвует в поиске сразу после обработки. Исключение — рабочая папка чата: её файлы ждут кнопки «Обработать» (см. «Файлы и папки» выше).

Папку агент видит и называет обычным именем — например, «Договоры 2026», — как и вы в интерфейсе.

Извлечённый текст и скрытое зеркало

Для обработанного нетекстового файла Искре доступно скрытое представление с извлечённым текстом: рядом с оригиналом оно называется <оригинал>.text.md — например, акт.pdf.text.md . Это техническое представление только для чтения: оно не показывается в разделе «Память», не является отдельным файлом и не редактируется. Пользователь продолжает работать с оригиналом, и в ответе Искра ссылается на исходный документ, а не на зеркало.

Зеркало содержит текст, но не заменяет оригинал: вёрстка, изображения, диаграммы и другие визуальные связи документа в нём не воспроизводятся. Когда важно оформление или содержимое картинки, нужен именно оригинал.

Списки: фильтры и закреплённые папки

Общий список Памяти (когда не открыта конкретная папка) можно сузить фильтрами над списком: «Все», «Мои папки», «Проекты», «Чаты», «Подключённые», «Доступные мне» — они соответствуют категории папки. Внутри открытой папки фильтры не показываются.

Чип «Мои папки» отбирает только ваши собственные папки. Папки, которыми с вами поделились — владелец напрямую, ваша группа или организация, — собраны в отдельной категории «Доступные мне», а в списке помечены бейджем «Общий доступ». Так своя папка и чужая, открытая вам, больше не выглядят одинаково.

Выбранные сортировка и фильтр запоминаются: вернувшись в Память в этом же браузере, вы увидите список в том виде, в каком оставили его. Если под выбранный фильтр не попала ни одна папка, вместо пустого экрана появится «По фильтру ничего не найдено» с кнопкой «Показать все» — она возвращает фильтр к «Все».

Пустые служебные папки чатов, в которых ещё нет ни одного файла, в списке не показываются — как только в такой папке появляется первый файл, она возникает в списке автоматически. Личные папки, папки проектов и подключённые папки показываются всегда, даже пустые: вы создали или подключили их явно.

Любую папку верхнего уровня можно закрепить: выберите «Закрепить» в меню «Ещё». Закреплённые папки собраны в отдельной группе «Закреплённые» над остальным списком независимо от применённого фильтра происхождения — в том числе пустая служебная папка чата, если её закрепили явно. Открепить можно тем же действием. Число закреплённых папок ограничено 50 на профиль.

Строки списка компактны: путь под именем не показывается (он остаётся только у результатов поиска), категория обозначена небольшим значком рядом с именем, а дата создания и статус обработки файлов — как раньше.

Отметка о размещении на доске

У файла, размещённого на доске, в Памяти стоит отметка размещения: в строке списка — короткая, с подробностями в подсказке, а в карточке файла и в окне правки — подробная, с состоянием вкладки, моментом показанной версии и переходом к доске. В карточке файла размещения собраны в блоке «Размещение на досках»; тому, кто вправе менять исходник и кому сервер назвал саму доску, там же предлагается «Доработать в чате».

Отметку видит и тот, кто правит общий исходник, но доской не владеет. Название чужой доски, её получатели и секрет ссылки в отметку не попадают — остаётся факт размещения и категория аудитории. Сама отметка доступа к доске не даёт: доску по-прежнему открывают по её аудитории.

Доступ к папке и доступ к доске — разное. Участник папки работает с её файлами, а читатель доски получает выбранные версии выбранных файлов, а не папку и её остальное содержимое. У файла в корзине отметки нет: вкладку удалённого исходника читатели не открывают.

Как разместить файл, какие бывают аудитории и чем «Следовать файлу» отличается от зафиксированной версии — в разделе «Доски».

Корзина

На странице «Память» вкладка «Корзина» общая для всех доступных вам источников: личной папки, проектов, чатов и подключённых папок. Для каждого удалённого элемента показаны исходный путь и источник, дата удаления и срок до автоматического окончательного удаления. При каждом открытии вкладки список перечитывается, поэтому новые удалённые элементы появляются без обновления страницы. Файлы из секций «Черновики» помечены отдельным источником; при необходимости список можно оставить только по этому источнику фильтром «Черновики».

По умолчанию недавно удалённые элементы показаны первыми. Нажмите заголовок «Название» или «Удалено», чтобы отсортировать всю корзину по имени или дате удаления; повторное нажатие меняет направление. На узком экране те же варианты находятся над списком.

После перемещения в корзину файл или папка сразу исчезает с вкладки «Файлы», из результатов поиска и содержимого, доступного агенту через подключённые папки. Сразу после удаления можно нажать «Отменить»; позднее элемент можно восстановить из корзины.

Собственную папку верхнего уровня можно отправить в корзину целиком, включая пустую. Перед подтверждением Искра предупредит, что папка с содержимым хранится 30 дней, а её подключения временно станут недоступны. Восстановление возвращает ту же папку с прежним именем, содержимым, доступом и подключениями. Файлы и вложенные папки, удалённые раньше отдельной операцией, остаются в корзине. Удалённую папку верхнего уровня видит и восстанавливает только её владелец.

Для обычного файла или папки восстановление доступно в течение 30 дней с момента каждой операции удаления. Если восстановить такой элемент и затем снова отправить его в корзину, отсчёт начнётся заново.

Для файла из «Черновиков» действует другой порядок: его общий срок хранения составляет 30 дней с момента последнего изменения содержимого. Просмотр, скачивание, переименование, перемещение, удаление и восстановление этот срок не продлевают. Например, если черновик удалить через 10 дней после последнего изменения, восстановить его из общей Корзины можно только в оставшиеся 20 дней. После восстановления файл возвращается в «Черновики» с прежним сроком; новая содержательная версия начинает новый 30-дневный отсчёт.

По истечении применимого срока Искра автоматически запускает окончательное удаление. С этого момента восстановление недоступно. До завершения окончательной очистки данные продолжают занимать место в хранилище.

В корзине могут одновременно находиться несколько отдельно удалённых элементов с одинаковыми именем и исходным путём. Они показаны разными строками с собственными датами удаления. В отличие от новой загрузки, при восстановлении Искра не заменяет существующий объект и не добавляет к имени номер. Если исходный путь уже занят, удалите или переименуйте находящийся там файл или папку и повторите восстановление. Конфликт вложенного пути блокирует восстановление всей удалённой папки.

Удалённая папка показана одной строкой. Раскройте её, чтобы посмотреть содержимое только для чтения. Вложенные файлы можно открыть и скачать, но восстановить или удалить окончательно отдельный элемент внутри папки нельзя: действия применяются ко всей удалённой папке.

Корзина показывает только элементы из источников, к которым у вас сохранился доступ на чтение. Для восстановления нужно право изменять источник, а для действий «Удалить окончательно» и «Очистить корзину» — права владельца или администратора. Если доступ к источнику отозван, его элементы перестают показываться в вашей корзине.

Чтобы удалить данные раньше срока, выберите один или несколько элементов и нажмите «Удалить окончательно» либо используйте «Очистить корзину». Перед необратимым действием Искра покажет подтверждение. При очистке элементы, которые вы не вправе удалить окончательно, останутся в корзине. Окончательная очистка может занять некоторое время; во время неё показан статус «Удаляется окончательно».

Если окончательное удаление завершилось ошибкой, строка получит статус «Не удалось удалить». При наличии прав нажмите «Повторить удаление». В этом состоянии восстановление уже недоступно, поскольку часть данных могла быть очищена. Во время восстановления, удаления и подгрузки содержимого кнопка показывает выполняемое действие и индикатор прогресса.

Поиск

Поиск на вкладке «Файлы» запускается кнопкой «Найти» или клавишей Enter и работает по всем доступным вам файлам и папкам вне корзины в трёх режимах:

Имя и путь — ищет названия файлов, папок и части пути;

Содержимое — просматривает извлечённый текст актуальных обработанных версий;

Везде — сразу показывает совпадения по имени и пути, затем добавляет найденное в содержимом.

Пока вы редактируете запрос, текущие результаты остаются на экране до нового запуска. Очистка поля сразу возвращает обычный список. Применённый запрос и область поиска сохраняются в адресе страницы, поэтому ссылку на выдачу можно скопировать; при её открытии поиск запустится автоматически. Смена области при применённом запросе сразу повторяет поиск.

Результаты режимов «Везде» и «Содержимое» отсортированы по релевантности, поэтому сортировка колонок для них недоступна. Результаты «Имя и путь» можно сортировать. Действие «Показать в папке» у найденного элемента завершает поиск и открывает его расположение.

Постоянного поискового индекса содержимого нет. Поэтому поиск по содержимому может занять больше времени; его можно остановить, а уже найденные результаты останутся на экране. Если часть доступных папок временно не удалось просмотреть, Искра явно покажет, что результат неполный, и предложит повторить поиск.

В окнах выбора папки для чата, проекта или коллекции поиск начинается автоматически после короткой паузы и учитывает одну опечатку. Точные совпадения показываются первыми. Нечёткий поиск выполняется по ограниченному набору доступных папок, поэтому для папки, которая не нашлась по неточному запросу, уточните или исправьте название.

Рабочая папка чата

По умолчанию Искра создаёт служебную папку для файлов чата. В новом личном чате вместо неё можно выбрать рабочей папкой существующую папку Памяти верхнего уровня, пока в чате нет сообщений и собственных файлов. В рабочую папку попадают вложения сообщений и файлы, созданные агентом. В панели запроса её содержимое показано зоной «Файлы чата»; когда в папке есть файлы, значок Памяти в шапке зоны открывает ту же папку в разделе «Память».

До первого сообщения или файла, загруженного либо созданного этим чатом, нажмите крестик «Отменить выбор рабочей папки» рядом с её именем, чтобы вернуться к выбору. Сама папка и все её файлы остаются на месте. Одна папка может быть рабочей для нескольких чатов: прежние файлы и файлы соседних чатов не мешают отмене выбора в пустом чате.

Если сама рабочая папка отправлена в корзину, её связь с чатом сохраняется. Сначала восстановите папку в Памяти: после этого с ней можно снова работать или отменить её выбор в пустом чате.

После первого сообщения или собственного файла рабочая папка закреплена: для другой папки начните новый чат. Удаление сообщений или перенос файлов в корзину не возвращает возможность выбора. Если доступ к выбранной папке отозван, в пустом чате можно отменить выбор; для продолжения начатой беседы нужно восстановить доступ либо начать новый чат с другой рабочей папкой.

Контекстные подключения управляются отдельно и сохраняются при отмене выбора рабочей папки. Если нужен контекст из другого места, подключите папку через «@ Папки» рядом с полем ввода. Можно подключить несколько папок; отдельный файл

добавляется к сообщению как вложение и не даёт доступа к соседним файлам исходной папки.

Пилюля папок в строке ввода показывает имя подключённой папки, а если их несколько — имя первой и счётчик остальных, например «Договоры 2026 +2». Полный список видно в подсказке при наведении; в зоне «Подключённые папки» панели запроса перечислены подключения самой беседы, а папки, унаследованные от проекта, считает карточка проекта первой строкой зоны — их состав открывает окно «Подключённые папки» на вкладке «Проект».

Чтобы перенести файл из чата в свою папку Памяти, попросите об этом прямо в разговоре: «сохрани этот файл в папку ИИ-ЛАБЫ». Папка должна быть подключена к чату и открыта на запись — если она ещё не подключена, Искра подскажет это сделать. Переносится сам файл, а не его пересказ, поэтому документы, таблицы и презентации сохраняются в исходном формате.

Если материалы нужны вашему навыку в разных беседах, выберите отдельную папку Памяти и привяжите её в карточке навыка. Общие ресурсы комплекта, материалы компании и файлы одной задачи различаются в руководстве по навыкам.

Файлы, импортированные навыками

Некоторые навыки умеют сами сохранять подготовленные файлы в Память — например, навык Plaud сохраняет записи встреч. Файл копируется в папку Памяти целиком, его текст не проходит через модель, поэтому он не искажается пересказом. Действуют те же ограничения размера и места в хранилище, что и при обычной загрузке. Папка назначения должна быть подключена к чату или к записи «Планов» с правом записи.

Навык не перезаписывает ваши файлы молча:

Повторный импорт обновляет тот же файл, только если его никто не менял с прошлого импорта. Если содержимое записи не изменилось, файл остаётся прежним.

Файл, изменённый вручную. Если вы отредактировали импортированный файл, навык сообщит о конфликте и оставит вашу версию.

Перемещённый или удалённый файл. Автоматический импорт не создаёт его заново, а отмечает это в отчёте.

Навык Plaud складывает записи в папку Plaud/<ключ аккаунта> внутри выбранной папки Памяти, у каждого аккаунта Plaud своя вложенная папка. Там же лежит файл import-state.json : в нём сохраняется ход импорта, чтобы следующий запуск продолжил с того же места. Редактировать этот файл не нужно. Если прежний импорт прервался, перед обновлением файла в Памяти навык проверяет, что это его собственный неизменённый экспорт; файлы, которые вы правили, остаются как есть.

Коллекции

Вторая вкладка раздела — «Коллекции», между «Файлы» и «Корзина». Коллекция — личный набор из нескольких папок Памяти, который подключается к чату или проекту одним движением, как обычная папка.

На вкладке показан список ваших коллекций с числом папок в каждой. Кнопка «Создать коллекцию» открывает форму с названием; коллекцию можно переименовать и удалить (без возможности восстановления — отдельной корзины для коллекций пока нет). Удаление коллекции отключает её как контекст: чаты, к которым она была подключена, перестают её видеть, а папки внутри неё не удаляются. В списке «Подключено» проекта строка при этом сама не исчезает — она остаётся с именем «Недоступная коллекция», как и удалённая папка, и владелец проекта отключает её вручную.

Откройте коллекцию, чтобы увидеть её состав: список папок с возможностью убрать любую и кнопкой «Добавить папку», которая открывает тот же выбор папок, что и «@ Папки» в чате. Папку можно добавить в коллекцию и прямо со вкладки «Файлы» — в

меню папки есть действие «Добавить в коллекцию →». Если папка в составе принадлежит не вам, а её открыли вам — например, в рамках организации, — рядом с её строкой стоит пометка «Общий доступ»: это только индикация происхождения, а фактический доступ по-прежнему проверяется отдельно (см. ниже).

Коллекция не расширяет права: доступ к каждой папке внутри по-прежнему определяет её собственный доступ, и Искра проверяет его заново при каждом подключении коллекции к чату или проекту — не только в момент, когда папку добавили в коллекцию. Поэтому у папки внутри коллекции может не быть доступа не только из-за того, что его отозвали позже (переместили, удалили или сняли право), но и потому, что у того, кто смотрит, его никогда не было — например, у участника проекта, которому владелец коллекции доступ к части папок не открывал. В обоих случаях Искра просто не подключает эту папку и не показывает её агенту — отдельной пометки вроде «Недоступная папка» для этого нет. Остальные папки коллекции остаются доступны как обычно.

Подключить коллекцию к чату можно через «@ Папки», к проекту — через блок «Память» на странице проекта: в обоих местах рядом со списком папок появляется отдельный раздел «Коллекции». Подключённая коллекция ведёт себя как папка: режим можно сузить до «Только чтение» или отключить совсем. В списке подключённого коллекция всегда показана одной строкой с её названием, без раскрытия состава. Состав коллекции меняет только её владелец — изменения сразу видят все, к чьим чатам или проекту она подключена.

Автоматические коллекции

Раз в час, если в Памяти появились новые папки или файлы, Искра сама просматривает их названия и может собрать из них тематическую коллекцию. Это дополнение к ручным коллекциям, а не замена: обе разновидности живут в одном списке вкладки и подключаются к чату или проекту одинаково.

В анализ попадают не только ваши папки, но и папки, которыми с вами поделились, — в том числе в рамках организации. Такая папка в составе коллекции отмечена той же пометкой «Общий доступ», что и при ручном добавлении.

Коллекцию, которую собрала Искра, отличает значок «ИИ» рядом с названием. Такую коллекцию Искра может пополнять новыми подходящими папками; убрать из неё она может только папки, которые сама туда добавила, — папку, которую добавили вы, она не тронет. Переименовать или удалить коллекцию Искра не может. Вместо этого, если коллекция опустела или потеряла смысл, она появляется в блоке «Рекомендации» над списком коллекций — карточка с причиной и двумя действиями: «Принять» удаляет коллекцию после обычного подтверждения, «Отклонить» оставляет её без изменений. О новых рекомендациях сообщает уведомление. Рекомендации Искра создаёт только для коллекций, которые собрала сама: коллекцию, собранную вами вручную, она не предложит удалить, даже если та опустела, — удалить её можно только самостоятельно.

В карточке любой коллекции, включая собранную вами вручную, есть переключатель режима пополнения: «Автоматическое пополнение» или «Ручное пополнение». В ручном режиме Искра состав коллекции не меняет, даже если сама её создала. Одна и та же папка может входить сразу в несколько коллекций.

Действие, которое вы отменяете сами — отклоняете рекомендацию, убираете папку, добавленную Искрой, или удаляете автоматическую коллекцию целиком, — Искра не повторяет: 30 дней после этого она не предложит заново ту же папку, коллекцию или рекомендацию.

Отключить формирование коллекций можно переключателем «Автоматические коллекции» в шапке вкладки: уже собранные коллекции останутся на месте, но пополняться перестанут. Отдельную папку верхнего уровня можно вывести из анализа — в её меню «Ещё» есть пункт «Не анализировать автоматически».

Ниже, в свёрнутой подсекции «Журнал», перечислены уже выполненные действия: какая коллекция создана, какая папка добавлена или убрана, какая рекомендация появилась и как её обработали. Кнопка «Показать ещё» подгружает более старые записи.

Доступ к папке

Для личной и подключённой (синхронизируемой) папки верхнего уровня в меню «Ещё» доступно действие «Права и доступ». Управлять доступом может владелец папки либо администратор.

Модальное окно показывает, кому уже открыт доступ, и позволяет добавить новое правило: вся организация, конкретная группа или отдельный человек (поиском по имени или email) — с уровнем «Только чтение», «Запись» или «Управление доступом». Правило можно удалить в любой момент; сама папка при этом никуда не пропадает.

Если у выбранного субъекта доступ уже есть, форма это показывает: под выбором появляется строка «Доступ уже выдан» с действующим уровнем, уровень в списке подставлен текущим, а кнопка называется «Изменить уровень» и остаётся неактивной, пока уровень не изменён. Так выданную ранее «Запись» нельзя случайно понизить повторным нажатием кнопки.

Уровень доступа меняется только из того состояния, которое вы видите на экране. Если в этот момент правило успел изменить кто-то другой — например, вы открыли окно в двух вкладках или настраиваете доступ вдвоём, — Искра не применит правку поверх чужой: она покажет сообщение и обновит список, чтобы вы приняли решение по фактическому уровню.

Со стороны получателя картина другая: папкой, которой с вами поделились, по-прежнему управляет её владелец. Если права «Управление доступом» у вас нет, окно настройки не открывается — в карточке папки вместо него показано пояснение «Папкой поделились с вами — доступом управляет её владелец». Когда такое право вам выдали, действие «Права и доступ» работает как обычно.

Для служебной папки чата и папки проекта такого окна нет — их доступ определяется, соответственно, доступом к самому чату и участием в проекте, о чём вместо окна показывается пояснение. Папка Памяти, выбранная рабочей для чата, остаётся вашей обычной папкой: окно управления доступом у неё есть, и доступ к ней задаётся правилами этой папки, а не доступом к чату.

Доступ агента

Для файла или папки инспектор «Права агента» предлагает два режима:

Разрешить изменения снимает локальный запрет;

Только чтение запрещает агенту изменять этот ресурс и, для папки, применяется к её содержимому.

Само разрешение не подключает ресурс ко всем чатам и не расширяет ваши права. Агент получает доступ только в чате, где папка подключена, и может изменять её лишь тогда, когда одновременно разрешают ваши права, режим подключения и настройка ресурса. Если у вас нет права менять настройку, переключатель будет недоступен с пояснением причины.

Если права не удалось загрузить, в инспекторе можно повторить запрос. Ошибка сохранения не сбрасывает выбранный режим: исправьте причину и нажмите «Повторить сохранение». После успешной операции инспектор показывает подтверждение.

Если папка подключена в режиме «Только чтение», Искра не будет обещать создать, переименовать или удалить в ней файл. Для изменения используйте раздел «Память» либо переключите подключение на «Разрешить изменения», если это допускают ваши

права и настройка ресурса. Файл, созданный в рабочей папке чата, не считается сохранённым в подключённой папке Памяти.

Удаление через чат

Если попросить Искру удалить файлы или вложенную папку внутри подключённой папки Памяти, она переносит их в корзину. Сама подключённая папка остаётся. Назовите папку и нужные файлы. Перед удалением нескольких файлов Искра указывает путь папки и состав удаления. Продолжение вроде «их тоже удали» относится к ранее выбранной папке и файлам; если смысл неоднозначен, Искра уточняет цель. При удалении только файлов вложенные каталоги сохраняются.

В течение 30 дней элемент можно вернуть из вкладки «Корзина» или попросить Искру восстановить его. Если папка подключена только для чтения, Искра объясняет ограничение и ничего не меняет. Если операция недоступна или завершилась ошибкой, Искра сохраняет выбранную цель и сообщает, что удалось удалить, а что осталось. Уже удалённые элементы можно восстановить.

Инструкция для агента

Если в переписке о папке складывается устойчивое правило работы с её содержимым — например, «сюда кладём только подписанные документы» или «файлы называем по номеру договора», — Искра предложит записать его в файл iskra-agent.md в корне этой папки. Файл создаёт и правит сама Искра со слов пользователя; писать его руками не нужно.

Такая инструкция общая для всех, кому папка доступна: как только Искра работает с этой папкой — в личном чате, личном чате проекта, запланированной задаче или в любом другом месте, где папка подключена, — она читает правило и следует ему. Написать или изменить iskra-agent.md может любой, у кого есть право записи в папку, — не только её владелец. Сама инструкция при этом не даёт никаких дополнительных прав: она лишь описывает, как работать с содержимым папки. Если её текст всё же потребует отправить данные за пределы папки, расширить чей-либо доступ или обойти обычные подтверждения, Искре предписано отказаться от такого требования и предупредить вас об этом в ответе — это правило, которому следует модель, а не техническая защита платформы.

Текст инструкции целиком уходит модели вместе с каждым запросом, в котором подключена эта папка. Приватный режим «Антоним» на неё распространяется наравне с остальным запросом: при включённом Антониме инструкция обрабатывается на серверах Искры. Но файл читает любой, кому открыта папка, поэтому в iskra-agent.md не должно быть паролей, ключей доступа и других секретов — только правило работы с папкой.

Открыть и изменить файл можно и напрямую, без участия Искры: в разделе «Память» в строке iskra-agent.md он помечен значком «Инструкция для агента», а в меню «Ещё» доступно действие «Изменить текст» — открывается редактор, изменения сохраняются как новая версия файла. Такой же значок виден у файла и в дереве файлов чата на боковой панели. Рядом показано, когда файл изменён в последний раз.

В панели запроса зона «Подключённые папки» показывает подключённые папки и их режимы: пилюля «Чтение» / «Запись» на строке подключения переключает режим одним нажатием. Подключение можно сузить до «Чтение» или удалить крестиком; удаление подключения не удаляет саму папку. Режим строки — это ваши права на папку в пересечении с вашим выбором для этой беседы, поэтому расширить подключение до записи можно только там, где право записи в саму папку у вас есть; сузить до «Только чтение» можно всегда. Если владелец расширит вам доступ позже, подключённая папка станет доступна на запись сама — переподключать её не нужно, а сужение, сделанное вами вручную, сохраняется. Папки, подключённые до этого обновления, могут остаться в прежнем режиме: переключите их один раз на строке подключения. Составом навыков

беседы управляет окно «Навыки беседы» — его открывает кнопка «Навыки» в нижней строке панели, а кнопка «/ Навыки» доступна в новом чате.

Обзор

Навык подключает Искру к вашему порталу Битрикс24: поиск лидов, сделок, контактов и компаний, сводка по воронке продаж, таймлайн и дела CRM, задачи Битрикс24 — с созданием и изменением записей всегда через подтверждение перед записью. Подключение — через входящий вебхук вашего портала, без пароля и без OAuth-приложения.

Обзор

1. На портале Битрикс24 (из-под администратора): Разработчикам → Другое →

Входящий вебхук → выбрать права crm, user, task → создать. Битрикс покажет код вебхука один раз — сразу скопируйте его или весь URL вебхука.

2. В Искре: Витрина навыков → «Битрикс24» → добавить в организацию (или личный

профиль) → на карточке навыка нажмите «Требует настройки» (позже те же поля открывает «Подробнее» → вкладка «Настройки»). Откроется окно «Настройки навыка»; если вам доступны оба варианта — личный профиль и организация, — выберите нужный в строке «Подключение» вверху окна. Ниже — группа настроек «Подключение к Битрикс24»:

Адрес портала — например mycompany.bitrix24.ru (или адрес коробочной установки/CNAME-домена клиента, если он доступен по HTTPS из интернета);

Входящий вебхук — можно вставить и короткий код вида 1/abc123xyz (часть URL после /rest/ ), и полный URL вебхука целиком; поле write-only, как и обычные ключи — посмотреть сохранённое значение нельзя, только заменить.

3. Для организации подключение заполняет владелец или администратор один раз —

работать смогут все сотрудники. Личное подключение (если заполнено) полностью замещает организационное — при выборе личного поверх уже настроенного подключения организации Искра предупредит об этом; рядом с группой видно, какое сейчас действует. Подробнее о выборе, куда настраивать — в «Навыки» → «Группы настроек (подключения)».

В окне деталей навыка есть вкладка «Карта» — накопленные знания о кастомных полях и стадиях воронок вашего портала. Искра пополняет её по ходу работы; построить или обновить карту можно кнопкой «Исследовать» / «Обновить карту». Подробнее — в «Навыки» → «Карта знаний подключения».

Обзор

При первом действии, которое требует авторства (создание лида, задачи и т. п.), навык покажет список активных сотрудников портала и спросит, кто вы. Выбор запоминается: дальнейшие записи выполняются от вашего имени без повторных вопросов. Для задач этот выбор задаёт начальные значения исполнителя и постановщика: перед созданием каждой задачи обе роли можно проверить и изменить. Уволенные сотрудники в список не попадают.

Обзор

Чтение:

найти лид, сделку, контакт или компанию по названию, телефону или email;

показать карточку сущности со всеми полями, включая пользовательские;

воронки сделок со стадиями и статусы лидов, режим CRM портала (классический или упрощённый);

сводка открытых сделок по воронке: количество и сумма на каждой стадии;

выгрузка сделок выбранной стадии, включая выигранные и проигранные, с идентификаторами, суммами, валютами, ответственными и датами;

дела CRM (звонки, встречи, дела-задачи) — незавершённые по сущности или по сотруднику;

последние комментарии таймлайна сущности;

список активных сотрудников портала;

описания полей сущности CRM, включая пользовательские;

задачи Битрикс24 — свои или по конкретному сотруднику.

Запись (всегда с подтверждением):

создать лид или сделку, создать контакт;

изменить поля сущности CRM, включая перенос сделки по стадии и смену ответственного;

добавить комментарий в таймлайн сущности;

запланировать дело CRM с дедлайном;

поставить задачу Битрикс24 с отдельным выбором исполнителя и постановщика.

Обзор

Например: «Выгрузи все сделки стадии „Сделка успешна“ воронки „Исполнение отделка“ и подготовь дашборд». Искра определит воронку и стадию, затем прочитает сделки страницами по 50 записей. Названия конкретных сделок для такой выгрузки не требуются. При совпадающих названиях воронок или стадий нужно уточнить выбор.

Для отчёта доступны идентификаторы и названия сделок, суммы и валюты, ответственные, даты создания, изменения и закрытия, связанные контакт и компания. Дополнительные поля отдельной сделки можно получить из её карточки. Суммы в разных валютах показываются отдельно.

Если запрос остановлен или портал вернул ошибку, полученная часть списка не означает полную выгрузку: в отчёте нужно учитывать число прочитанных сделок и причину остановки. Продолжение идёт по ID последней прочитанной сделки, поэтому удаление ранее прочитанных записей не сдвигает следующую страницу. Выгрузка всё же не является снимком: сделки, перешедшие в стадию с уже пройденными ID, в неё не попадут. Для итоговой сверки выгружайте данные в период, когда состав стадии не меняется.

Обзор

Любая запись в Битрикс24 сначала показывает черновик — название, поля, ответственного — и выполняется только после вашего подтверждения. В форме можно поправить значения перед отправкой, а поле «От чьего имени» позволяет сменить привязанного сотрудника прямо там.

Для задачи форма отдельно показывает исполнителя и постановщика. Оба значения можно изменить перед подтверждением. После создания навык повторно читает задачу в Битрикс24 и сообщает, если портал сохранил другие роли или не дал их проверить. Сама задача при этом уже создана — повторять команду не нужно.

Обзор

Готовые сценарии навыка видны на вкладке «Сценарии» в карточке навыка с пометкой «от автора» и запускаются кнопкой «В чат со сценарием» без повторной настройки:

Подключить Битрикс24 — настройка входящего вебхука и проверка подключения;

Утренняя сводка по продажам — состояние воронки, суммы по стадиям, ближайшие дела и задачи;

Квалификация нового обращения — проверка дублей по телефону/email и создание лида или сделки с контактом;

Подготовка к встрече по сделке — карточка сделки, история общения, открытые дела и контакты одним брифом;

Разбор зависших сделок — сводка по воронке, комментарий и следующий шаг по сделкам без движения;

Выгрузка сделок стадии — список сделок выбранной стадии для отчёта или дашборда, включая выигранные;

Итоги звонка в CRM — комментарий в таймлайн, следующее дело и, если прозвучало продвижение, смена стадии.

Готовые сценарии нельзя переименовать, отредактировать или удалить — это общий для всех, кто установил навык, комплект от автора. Свой сценарий на основе похожей задачи можно сохранить отдельно прямо из чата.

Обзор

REST API Битрикс24 доступен только на коммерческих тарифах портала — на бесплатном тарифе навык подключиться не сможет.

Битрикс24 ограничивает частоту запросов к REST API; при кратковременном всплеске навык сам повторяет один раз, при более строгом лимите — ответит «попробуйте позже».

Сводка по воронке охватывает до 1000 открытых сделок; если сделок больше, ответ явно помечает неполный охват.

Список активных сотрудников ограничен 250: если сотрудников на портале больше и вас нет в списке при выборе «кто вы», обратитесь к администратору портала.

Выгрузка выбранной стадии идёт страницами по 50 сделок; лимит сводки в 1000 открытых сделок к ней не относится. Частично прочитанный список при остановке или ошибке остаётся неполным.

Коробочные установки Битрикс24 без публичного DNS-имени или с адресом только во внутренней сети (приватный IP) навык подключить не может: он обращается к порталу по HTTPS через сетевую политику платформы, которая не пропускает внутренние адреса ни при каких настройках.

Обзор

Ошибка Что означает Что делать

Пересоздать входящий

Вебхук удалён на портале

webhook_invalid вебхук на портале и

или код указан неверно

обновить настройки навыка

В настройках вебхука на

У вебхука не хватает прав портале добавить для вызванного метода недостающее право доступа

(crm, user, task)

Ошибка Что означает Что делать

REST API недоступен на Перейти на коммерческий текущем тарифе портала тариф Битрикс24

Заполнить группу «Подключение к

not_configured Навык не подключён

Битрикс24» в настройках навыка

Битрикс24 ограничил Повторить действие через частоту запросов некоторое время

Обзор

Вебхук хранится в защищённом хранилище платформы и не показывается никому, включая агента. Права вебхука равны правам сотрудника, который его создал, — создавайте вебхук под учётной записью с минимально достаточными правами и отзывайте его на портале при увольнении этого сотрудника. Навык обращается только к адресу портала, указанному в настройках.

Обзор

«Планы» — раздел вашего личного календаря и списка задач в Искре: обычные дела и встречи наравне с задачами, которые по вашей команде выполняет сама Искра. Раздел заменил прежнее «Расписание» — регулярные прогоны агента никуда не делись, но теперь живут рядом с обычным ежедневником, а не отдельно от него.

В разделе три вкладки: Пульс, Задачи и Календарь.

Обзор

Легко перепутать по смыслу, но это разные вещи:

«Планы» (этот раздел) — ваш собственный календарь и список задач внутри Искры, включая регулярные и разовые прогоны агента. Живёт в самой платформе, ничего никуда не подключать не нужно.

Навык «Календарь» — разовая работа с вашим внешним календарём (Яндекс, Mail.ru, iCloud, Nextcloud, корпоративный CalDAV-сервер) или быстрое создание события в Google Calendar: агент сходил, посмотрел, записал. Подробнее — в разделе «Навык «Календарь»».

Синхронизация календарей и задач — постоянный обмен: события и задачи ходят между «Планами» и внешним календарём в обе стороны сами, без запроса в чате. Настраивается один раз в Настройки → «Календари и задачи»; подробнее — в разделе «Синхронизация календарей и задач».

Если у вас настроен внешний календарь, «спланируй встречу» может уйти в него, а «поставь задачу» — в «Планы»; при неоднозначной формулировке Искра уточнит, куда именно записать.

Обзор

Пульс — открывается первой и показывает, что произошло и что предстоит:

Произошло — карточки уже случившихся событий: напоминание (с кнопками «Выполнено» / «Отложить» / «Открыть чат»), пробуждение Искры (ссылка на чат с результатом), пропуски с честной причиной (например, «Пропущено из-за простоя» — если платформа долго не получала от вас никакой активности, «Пропущено: напоминание устарело» — если оно не успело дойти вовремя, или «Собиралась вернуться, но чат был занят» — см. «Что происходит при срабатывании»). Предстоящее — ближайшие задачи и события на несколько дней вперёд, вида «📅 Завтра: встреча 15:00».

Кнопка «Отложить» у напоминания предлагает готовые варианты: +15 минут, +1 час и завтра в это же время. Откладывается конкретное срабатывание, а не вся запись: у повторяющейся задачи следующие разы остаются на своих местах. Карточка после этого помечается словом «Отложено», а сама запись на вкладке «Задачи» показывает строку «Отложено до …» и кнопку «Не откладывать» — она снимает отсрочку и возвращает исходное время.

Если в выбранном промежутке слишком много повторов, лента показывает не все и честно предупреждает об этом строкой «Показаны не все вхождения периода» — сузьте период, чтобы увидеть остальные.

Пульс — общая история срабатываний: у отдельной записи собственного списка запусков нет, все её прогоны и напоминания видны именно здесь.

Самозадачи, которые Искра ставит себе сама (см. ниже), в Пульсе видны всегда, когда срабатывают, — независимо от тумблера «Внутренний план Искры» на вкладке «Задачи».

Обзор

Список ваших задач и событий со сроком и без. Кнопка «Создать запись» в верхней части раздела открывает форму (см. «Создание записи» ниже).

Фильтры периода идут в том порядке, в каком о списке обычно и спрашивают: Предстоящие, Сегодня, Просроченные, Без срока, Выполненные и общий вид Все. Вкладка открывается на Предстоящих — том, что ещё нужно сделать. Задача без срока живёт в корзине Без срока, а не среди предстоящих.

Отдельно — фильтры по роли: Поручено мне и Мои поручения (см. «Поручения коллегам»).

Переключатель «Внутренний план Искры» показывает записи, которые Искра ставит себе сама, — например, обещание «вернусь к этому через 5 минут» из чата. По умолчанию они скрыты, чтобы список оставался вашим собственным планом, а не вперемешку с внутренней бухгалтерией агента. Скрытость касается только предстоящих записей: каждое сработавшее пробуждение видно в Пульсе всегда, а его расход попадает в общую статистику профиля — каждый прогон работает в собственной беседе и виден в «Топе бесед» на вкладке «Статистика» наравне с обычными. Отдельной строки «расход самозадач» в статистике нет.

У каждой записи в списке — тумблер «Поставить на паузу» / «Вернуть в работу» (приостанавливает срабатывания без удаления самой записи), а также «Редактировать» и «Удалить». Для уже сработавшей задачи доступно «Выполнено» и «Отменить»; у повторяющейся записи оба действия сначала спрашивают охват — только это вхождение или вся серия.

Кнопка «Удалить» есть и в самой открытой записи, слева внизу формы, — в том числе когда вы открыли её из календаря. Она спрашивает подтверждение: вместе с записью уходят её напоминания и прогоны.

Обзор

Форма записи одна для задач и событий:

Вид записи — Задача (срок в одном поле «Срок») или Событие («Начало» и «Конец»). Конец нового события подставляется через час после начала и едет следом за ним; более поздний конец, поставленный вручную, остаётся вашим. Событие без конца допустимо — очистите поле. У задачи, кроме срока, есть отдельное необязательное поле «Начало работы» — когда вы планируете взяться за дело, а не когда оно должно быть готово. Начало не может быть позже срока (равенство — задача, начатая ровно в срок, — законно); напоминание и срабатывание по-прежнему привязаны к сроку, и задача без срока не сработает, даже если начало указано.

Название и Заметка — короткий текст и, при необходимости, более длинное описание.

Проект — можно связать запись с одним из ваших проектов; каждый прогон агента тогда использует актуальные инструкции и файлы этого проекта на момент срабатывания.

Весь день — отмечает запись как не привязанную к конкретному времени суток.

Часовой пояс — по умолчанию берётся из вашего профиля, а если он там не задан — из настроек вашего устройства; можно указать другой прямо в форме. Этот пояс определяет, когда запись сработает. Показываются же время и дата везде — в списке, Пульсе и календаре — поясом вашего профиля, тем же, что форма подставляет новой записи: открыв Планы с другого устройства или из поездки, вы увидите привычные часы, а не местные.

Свой пояс задаётся один раз в Настройках → Профиль → Часовой пояс (как это сделать); обычно он уже заполнен поясом устройства, с которого вы зарегистрировались или вошли. В нём же Искра понимает «завтра в 9» и «через час», когда вы просите её о задаче словами в чате. Пока пояс не задан, Искра спросит его, прежде чем поставить срок с местным временем, а время записей до этого показывается по UTC — для Урала и Дальнего Востока это расхождение в несколько часов, поэтому задайте пояс до первой задачи со временем.

Записи, поручённые вам коллегой, и встречи, куда вас пригласили, редактируете не вы: у них доступны действия исполнителя и участника, а не правка чужого плана.

Обзор

Остальные поля той же формы:

Повторение — «Только вручную» (без повтора) либо один из пресетов: Ежедневно, По будням, Еженедельно (с выбором дня недели), Ежемесячно (с выбором числа месяца). Записи, перенесённые из старого «Расписания» или заведённые агентом по более сложному правилу, могут нести правило, которое не сводится ни к одному пресету, — форма покажет его человеческим описанием, не заставляя переводить в ближайший пресет.

Напоминания — можно включить одно или несколько: за 15 минут, за 1 час, за 1 день, за 1 неделю до срока.

Действие — что происходит в момент срабатывания (см. следующий раздел).

Push-уведомление и Email-уведомление — отдельные переключатели, какими каналами доставлять напоминание или отчёт о прогоне.

Исполнитель (у задачи) и Участники (у события) — поручить дело коллеге или позвать людей на встречу можно прямо здесь, не только в разговоре с Искрой. Оба выбора видны владельцу и администратору организации: у личного профиля и у рядового участника организации этих полей в форме нет (см. «Поручения коллегам»).

Обзор

Ещё поля той же формы. Место и ссылка на созвон — общие для задачи и события; внешние участники бывают только у события.

Место — где происходит дело: адрес, переговорная, название площадки. Показывается в самой карточке записи.

Ссылка на созвон — адрес видеовстречи; в карточке она открывается прямым кликом. Принимается только полный адрес вида https://… .

Внешние участники (только у события) — гости без профиля Искры, приглашённые по e-mail: назовите адрес и, если знаете, — имя. Коллегу по своей организации приглашайте не сюда, а полем «Участники» выше — тогда он увидит встречу в своих «Планах» и получит её напоминания. Внешнего гостя можно отметить необязательным — его участие желательно, но не обязательно. Ответ на приглашение — «Ждёт ответа», «Принял», «Под вопросом» или «Отклонил» — виден на карточке гостя, но назначить его самим нельзя: он приходит из календаря участника, а не задаётся в самой Искре. Сколько внешних участников помещается в одну встречу, задаёт администратор платформы.

Обзор

Ещё четыре поля лежат в свёрнутой по умолчанию секции формы «Ещё» — вместе с уже знакомым «Проектом» (см. «Создание записи» выше) и способом уведомления. Секция раскрывается кнопкой «Показать ещё»; как только в ней заполнено хоть одно поле, кнопка называет и счёт — «Показать ещё · N».

Важность — три уровня: Низкая, Обычная и Высокая. Обычная стоит почти на каждой записи и в списке ничем не выделяется; высокая отмечена знаком «!» рядом с названием — в списке «Задач» и во всех видах календаря (месяц, неделя, день). У низкой важности своего значка нет.

Теги — свои ярлыки записи, до 10 штук на одну запись и до 32 знаков в каждом. Лишние пробелы обрезаются, а два написания одного тега без учёта регистра («Работа» и «работа») схлопываются в одно — остаётся то, что набрали первым. Тег завершается запятой или клавишей Enter, поэтому список «работа, отчёты, дом» можно вставить целиком. Поле подсказывает теги из общего словаря вашего профиля — тех, что уже стоят на других ваших записях, — по мере набора.

Занятость — переключатель «Не занимает время»: отметьте его, если запись не должна считаться занятым временем.

Приватность — переключатель «Скрыть подробности во внешнем календаре»: помечает запись приватной.

Фильтр, которым те же теги отбирают записи всего раздела, — в разделе «Фильтр по тегам» ниже.

Обзор

Поле «Действие» в форме выбирает одно из трёх:

Без действия — обычный пункт списка дел или календаря, ничего не присылается;

Напоминание — push-уведомление и/или письмо в момент срока, без участия LLM;

Прогон Искры — Искра сама выполняет работу в этот момент (см. «Что происходит при срабатывании»). Для этого варианта появляется поле «Что должна сделать Искра» — опишите задачу так же, как объяснили бы её коллеге, а также блоки «Папки Памяти» и «Навыки»: подключения, которые Искра будет видеть именно в этом прогоне, независимо от того, что подключено в чате на момент срабатывания.

Вид действия решает и то, что стоит денег: прогоны расходуют токены и зависят от тарифа, а напоминания и пункты без действия — нет.

Обзор

Прогоны Искры по расписанию — часть платного функционала: доступность регулярных и отложенных прогонов агента зависит от тарифа. Обычные напоминания и задачи без действия работают на любом тарифе, включая бесплатный.

Слишком частый повтор форма не примет: минимальный интервал у прогона Искры и у простого напоминания разный — прогон реже, напоминание чаще. Это защита от случайного шторма уведомлений и запросов, а не тарифное ограничение.

Кроме интервала есть счётные потолки: сколько записей может быть у одного профиля, сколько из них с прогоном Искры, сколько самозадач она заводит себе, сколько напоминаний доставляется за сутки, сколько поручений вы выдаёте за день. Точные значения задаёт администратор вашей платформы — они разные на разных инсталляциях.

Число внутренних коллег в одной встрече не имеет фиксированного потолка. Приглашать по-прежнему можно только доступных участников своей организации, если у вас есть права организатора. Ограничение внешних гостей, приглашённых по e-mail, задаётся отдельно и сохраняется.

Упёршись в потолок, форма не отказывает молча: над полями появляется строка с причиной — какой именно предел исчерпан и что с этим делать. Например, «Достигнут предел записей с прогоном Искры: отключите ненужные или перейдите на старший тариф», «Суточный предел поручений исчерпан: продолжите завтра», «У исполнителя слишком много поручений: дождитесь, пока он их закроет». Записи при этом не теряются — форма остаётся открытой с вашими данными, и её можно поправить и сохранить снова.

Обзор

Форма — не единственный путь. Достаточно попросить Искру в разговоре: «напомни завтра в 10 позвонить в банк», «вернись к этому через 5 минут», «каждый понедельник собирай сводку по почте». Искра заводит запись сама и показывает её в чате карточкой: что именно запланировано и на когда, с кнопкой «Отменить» — передумать можно сразу, не открывая раздел. Отменённая карточка так и остаётся в переписке с пометкой «Отменено».

Те же поля, что и в форме раздела, — место, ссылка на созвон, внешние участники по e-mail, теги, важность, занятость, приватность, а у задачи ещё и отдельное начало работы — можно назвать прямо в разговоре: Искра передаст их тем же действием, каким заводит запись из формы. Карточка постановки в чате называет то, чем встреча отличается от обычной строки ежедневника: место, число приглашённых (сами адреса остаются в самой записи, а не в переписке), теги и важность, если она выше обычной.

Поручение коллеге ставится так же — назовите человека по имени или по адресу почты («поручи Ивану Петрову подготовить отчёт к пятнице»), Искра сама найдёт его среди коллег по организации. Если совпадений несколько или человек не найден, она переспросит, а не выберет наугад.

Обзор

У действия «Прогон Искры» есть два пути в зависимости от того, где родилась задача:

Пробуждение в исходном чате — если задача возникла из разговора (например, вы попросили «вернись к этому через 5 минут» или «пришли это письмо завтра утром»), Искра просыпается в том же чате и продолжает работу с тем контекстом, который там уже был. Если чат в этот момент занят — например, идёт другой ваш запрос, — Искра

подождёт и попробует снова позже. Если чат остаётся занятым слишком долго, Искра не станет переносить работу в новый чат без вашего ведома: вместо этого придёт напоминание вида «Собиралась вернуться к „…“, но чат был занят» со ссылкой на этот чат, и вы сможете продолжить сами. Ответ проснувшейся Искры отбит в переписке чертой с подписью «Искра вернулась по плану в 22:47» и ссылкой на саму запись: с этого места идёт работа по плану, а не продолжение вашего разговора, и видно, во сколько Искра за неё взялась. У прогонов, прошедших до появления подписи, времени в ней нет.

Новая сессия — если задача создана в разделе «Планы» либо перенесена из старого «Расписания», срабатывание открывает новый чат и выполняет работу там же, с папками Памяти и навыками, выбранными в форме записи. Ссылка на результат приходит уведомлением и, если включено, — письмом.

Где в «Планах» доступно действие «Прогон Искры», в обоих случаях срабатывание идёт без вашего участия: если формулировка задачи допускает разное толкование («убери неважные письма»), Искра выбирает разумный вариант и называет его в отчёте, а необратимые или спорные действия не выполняет молча — предлагает их отдельным пунктом, который достаточно подтвердить ответом в том же чате.

Отдельно — кнопка «Выполнить сейчас» у записи с прогоном: запускает его немедленно, вы видите ответ в реальном времени, как в обычном чате.

Обзор

Если у вас установлен навык Plaud, новые записи встреч можно сохранять в Память по расписанию.

1. Подключите Plaud заранее в чате — попросите «Подключи Plaud». Автоматический

прогон не показывает форм, поэтому войти в Plaud посреди прогона нельзя. Первый импорт удобно сделать там же, в чате: так сразу видно, какая папка выбрана и как выглядит отчёт.

2. Создайте запись в «Планах» и в поле «Действие» выберите «Прогон Искры».

3. В поле «Что должна сделать Искра» напишите, например: «Импортируй новые записи

Plaud в Память и пришли отчёт».

4. В блоке «Навыки» выберите Plaud.

5. В блоке «Папки Памяти» подключите ровно одну папку для записей и оставьте её в

режиме «Чтение и запись». Остальные подключённые папки переключите на «Только чтение» — иначе навык остановится и попросит изменить набор папок.

6. Задайте «Повторение», например ежедневно, и сохраните запись.

Прогон выполняется от имени владельца записи и использует его подключение Plaud. Отчёт прогона называет новые, обновлённые и ожидающие расшифровки записи. Если доступа к Plaud нет — например, вы отключили Plaud, — отчёт закончится пометкой «Требуется подключение». Подключите Plaud заново в чате: ход импорта сохранён, и следующий прогон продолжит с того же места. Пропущенный прогон догоняет следующий — записи за пропущенное время не теряются.

Регулярный прогон проверяет свежие записи. Если в Plaud исправили старую запись, попросите в чате полный повторный импорт: «Перечитай все записи Plaud и обнови их в Памяти».

Обзор

Ваши события и задачи со сроком в трёх видах: Месяц, Неделя и День. Переключатель видов и стрелки листания периода — сверху, кнопка «Сегодня» возвращает к текущей дате.

Месяц — сетка клеток: в клетке дня видны первые записи, остальные сворачиваются в «ещё N». Клик по клетке открывает форму создания записи на этот день.

Неделя и день — часовая шкала: запись стоит на своём часе и занимает высоту своей длительности, а записи «весь день» собраны в строке над шкалой. Совпавшие по времени записи делят ширину дня, поэтому ни одна не прячется за другой. Красная черта показывает текущее время. Клик по свободному месту заводит запись на тот час, куда вы указали (с точностью до получаса), — так время не приходится вводить руками.

Обзор

Если вы подключили календарь на странице Настройки → «Календари и задачи», в «Планах» появятся записи оттуда, а ваши уедут туда. Подключение и всё, что с ним связано, описано в разделе «Синхронизация календарей и задач»; в самих «Планах» это видно так:

на вкладке «Календарь» над переключателем видов отдельной строкой стоит кнопка «Подключить календарь» с иконкой календаря — она ведёт на страницу подключений. Пока список подключений ещё не загружен и при наличии подключений ссылка называется «Календари и задачи». При наличии подключений рядом показана пилюля общего состояния обмена — «Синхронизируется», «На паузе», «Ошибка» или «Нужно войти заново»;

у записи, приехавшей из календаря, в карточке написано «из календаря „…“», а у приглашения — кто организатор и ваш ответ на приглашение;

запись, приехавшая из календаря только для чтения (такой календарь не даёт Искре в него писать; в списке календарей подключения у него стоит пометка «только чтение»), правится в нём самом: время, название, место, напоминания и внешние участники меняются там, а в Искре у неё остаются проект, теги, внутренние участники, уведомления и работа Искры. Записи из обычного календаря правятся в Искре как свои, и правка уезжает наружу;

форма записи показывает, куда она уедет («Появится в: …») или с чем уже синхронизируется; ссылка «не синхронизировать» отвязывает одну запись — она останется в Искре, а объект во внешнем календаре не пропадёт;

если обмен сломался, об этом скажет карточка в «Пульсе» со ссылкой на настройки — например, «нужно войти заново».

Записи из календаря не расходуют вашу квоту записей профиля.

Обзор

Каждая вкладка — Пульс, Задачи и Календарь — показывает над своим списком, лентой или календарём чипы тегов: нажмите тег, чтобы оставить только записи с ним, и ещё раз, чтобы снять отбор. Можно выбрать сразу несколько — тогда остаются записи хотя бы с одним из выбранных. По умолчанию видны до восьми самых частых тегов вашего словаря; кнопка «Показать ещё · N» открывает остальные, а «Сбросить теги» (виден, пока выбран хоть один тег) снимает отбор целиком.

Выбор — свой на каждой вкладке: отфильтровав «Задачи» тегом «Работа», вы не увидите тот же отбор на «Календаре» — там он свой. Выбор переживает перезагрузку страницы и живёт в адресе, поэтому ссылку на отфильтрованный вид можно сохранить или переслать.

Тег в фильтре — то же написание, что и на самой записи: регистр значим, и «Работа» с «работой» в словаре и в чипах — два разных тега (в отличие от одной записи, где такие дубли схлопываются при вводе — см. «Важность, теги, занятость и приватность» выше).

Обзор

Владелец или администратор организации может поручить задачу коллеге по той же организации — двумя путями. Первый: полем «Исполнитель» в форме записи (у события — «Участники»). Второй: попросив Искру в чате «раскидать» пункты протокола совещания по исполнителям — она готовит черновик, кому какая задача, и заводит все поручения одним подтверждением. У остальных участников организации и в личном профиле этих полей в форме нет.

Похожим образом назначается встреча нескольким коллегам: они становятся участниками события (это не поручение — исполнитель у события не назначается) и получают уведомление о самой встрече и о её напоминаниях. Сколько человек помещается в одну встречу, задаёт администратор платформы.

В первой версии поручения — только одноразовые, без повторения: регулярное поручение коллеге пока не заводится.

Обзор

Исполнитель видит поручение на вкладке «Задачи» под меткой «Поручено мне»: название, заметку, срок, имя постановщика, а если они заданы — ещё место, теги и важность выше обычной. В самой карточке — ещё и напоминания по этой задаче и отсрочку, если ближайшее напоминание отложено. Участник встречи видит те же поля своей карточки. Чат, в котором родилось поручение, его настройки и состав прогона исполнителю не видны — он получает только то, что относится к самой задаче. Участнику встречи чат организатора не виден так же.

Исполнитель может отклонить поручение и при желании коротко объяснить почему. Причина необязательна — право отказаться не зависит от готовности его объяснить, — но названная уходит постановщику вместе с уведомлением об отказе и остаётся в самой записи: в строке отклонённого поручения её видят обе стороны.

Обзор

Напоминания и отчёты о прогоне приходят несколькими каналами сразу — в самой Искре, push-уведомлением на телефон и, если включено в форме, письмом.

Уведомление ведёт прямо к делу: нажатие открывает «Планы» на нужной карточке Пульса или на самой записи, а если она относится к другому вашему профилю — Искра сначала переключит рабочий контекст, чтобы запись было видно.

Мобильный push сейчас доставляется через сервис уведомлений Google (FCM). Если на вашем устройстве нет сервисов Google — например, на телефоне, где приложение установлено через RuStore без Google Play Services, — push может не дойти; сама запись, лента «Пульс» и, при включённом email-уведомлении, письмо при этом работают как обычно. Мы честно называем это ограничение, а не скрываем его.

Обзор

Раздел «Расписание» перестал существовать: все ранее созданные регулярные задачи автоматически перенесены в «Планы» и продолжают работать по тому же графику — их видно на вкладке «Задачи» точно так же, как заведённые заново. Старые ссылки на раздел «Расписание» открывают «Планы».

История прошлых запусков тоже перенесена, но живёт теперь в общей ленте: отдельного списка запусков у записи, каким он был в «Расписании», нет — прогоны видно в Пульсе, а результат каждого открывается ссылкой на его беседу.

Редкие задачи с необычным расписанием могли переехать на паузу: их правило повтора не сводится к пресетам формы, поэтому решение осталось за вами. Такая задача видна в списке со своим временем — выберите ей подходящее повторение и снимите с паузы, и она снова заработает.

Обзор

Навык помогает добавить готовое событие в Google Calendar коротким действием, а также подключает Искру к личному календарю по протоколу CalDAV: показывает план на день или неделю, ищет встречи и свободные окна, создаёт, переносит и отменяет встречи. Полное подключение работает с Яндекс Календарём, Mail.ru, iCloud, Nextcloud и корпоративными CalDAV-серверами. Учётные данные не покидают платформу: весь обмен с подключённым сервером календаря ведёт Искра, агент пароля не видит.

Навык — про разовые действия по просьбе: «покажи план на завтра», «перенеси встречу». Если вы хотите, чтобы события и задачи ходили между Искрой и календарём постоянно и сами, это отдельная настройка — «Календари и задачи» в настройках; см. раздел «Синхронизация календарей и задач». Одно другому не мешает: навык можно оставить, а можно и не устанавливать вовсе.

Подключения у них тоже разные, и это важно при первой настройке. В мастере «Календарей и задач» вы выбираете карточку своей службы, и адрес сервера она знает сама — поля адреса там нет. У навыка карточек нет: адрес сервера здесь обычное поле формы, которое для почты на домене организации заполняется вручную. Подробности — ниже.

Обзор

Назовите событие, дату, время и длительность, например: «Добавь в Google Calendar силовую тренировку 18 августа в 15:00 на час». Искра сразу подготовит ссылку на заполненную форму события. Откройте её, проверьте данные и нажмите «Сохранить» в Google Calendar.

Можно назвать длительность («на час») или точное время окончания: Искра сама рассчитает конец события и корректно учтёт переход на следующие сутки.

Для этого действия не нужен пароль приложения и не требуется подключать календарь. Событие ещё не создано, пока вы не сохраните его в открывшейся форме Google. Если вы явно назвали часовой пояс, Искра передаст его в форму; без указанной зоны время интерпретируется в часовом поясе вашего аккаунта Google. Если вы не назвали целевой календарь, Искра одним коротким вопросом предложит выбрать Google Calendar или уже подключённый календарь.

Установка навыка ради быстрого Google-события не открывает форму подключения. Настройки CalDAV понадобятся позже только для чтения календаря, поиска свободных окон или изменения встреч через Искру.

Короткий Google-маршрут готовит разовые события со временем или на весь день. Для запроса с повторением Искра объяснит эту границу и не станет превращать серию в один экземпляр. Ссылка будет подготовлена только после вашего явного решения перейти к полностью заданному разовому событию; recurrence/RRULE в неё не добавляются.

Обзор

Полное подключение нужно, когда вы хотите читать календарь, искать свободные окна или менять встречи прямо через Искру. Оно выполняется паролем приложения —

отдельным паролем, который вы создаёте у провайдера специально для внешних программ (не основной пароль от почты).

Пароль приложения: Яндекс, Mail.ru, iCloud, Nextcloud

Шаг 1. Создайте пароль приложения у своего провайдера.

Яндекс — Яндекс ID → «Безопасность» → «Пароли приложений». Пароли у Яндекса раздельные по типу доступа — для календаря нужна именно категория «CalDAV для Календаря». Пароль от почты календарь не откроет: это отдельный пароль, создайте новый в нужной категории. Для ящика Яндекс 360 на домене организации всё то же самое: тот же Яндекс ID и та же категория пароля. Mail.ru — Настройки почты → «Безопасность» → «Пароли для внешних приложений». iCloud — appleid.apple.com → «Безопасность» → пароль для приложения (нужна включённая двухфакторная аутентификация Apple ID).

Nextcloud / корпоративный сервер — обычный пароль или пароль приложения (если администратор их включил); адрес CalDAV-сервера узнайте у администратора.

Адрес сервера, часовой пояс и рабочие часы

Шаг 2. Заполните настройки навыка в Искре. Витрина навыков → «Календарь» → добавить в личный профиль → на карточке навыка нажмите «Требует настройки» (позже те же поля открывает «Подробнее» → вкладка «Настройки»). В окне «Настройки навыка» откроется группа настроек «Подключение к календарю»:

Логин (адрес почты) — полный адрес, например ivan@yandex.ru . Для почты Яндекс 360 на домене организации — вместе с этим доменом, например ivan@corp.ru ; у iCloud логином остаётся Apple ID, даже если почта приходит на адрес собственного домена;

Адрес сервера — если почта на публичном домене службы ( @yandex.ru , @ya.ru ,

оставить пустым: Искра определит сервер сама по адресу почты. Если почта на домене организации (Яндекс 360, Mail.ru для бизнеса, iCloud+ с собственным доменом),

или https://caldav.icloud.com : по домену компании сервер календаря обычно не находится. Для Nextcloud или корпоративного сервера впишите его явно, например cloud.company.ru — указывать точный путь CalDAV не обязательно, Искра сама перебирает стандартные варианты ( /.well-known/caldav , /caldav/ , /dav/ ) на введённом адресе. Если вписать http://… , Искра сама заменит его на https:// — по незащищённому протоколу подключение не пойдёт;

Часовой пояс — можно оставить пустым: обычно он уже известен из вашего профиля (браузер сообщает его при входе). Заполните вручную, только если Искра попросит;

Рабочие часы — используются при поиске свободных окон; по умолчанию 09:00–18:00, будни;

Пароль приложения — вставьте пароль, созданный на шаге 1. Поле write-only, как и обычные ключи: посмотреть сохранённое значение нельзя, только заменить.

Шаг 3. Подключение личное: календарь настраивается на ваш профиль, а не на всю организацию — агент работает с вашим личным календарём.

Данные подключения вводите только через форму настроек навыка. Не вставляйте пароль приложения в переписку с агентом.

Обзор

Быстрое событие в Google Calendar — предзаполненная форма с названием, временем, местом и описанием без настройки подключения; сохранение завершает пользователь в Google Calendar.

План на день или неделю в подключённом CalDAV-календаре — события за период по всем вашим календарям сразу, с пометкой накладок (пересекающихся по времени встреч) и событий «на весь день». Искра называет, из каких календарей собран ответ.

Поиск встречи в подключённом CalDAV-календаре — найти встречу по названию за период; регистр букв не важен, включая кириллицу («Планёрка» и «планёрка» совпадают).

Свободные окна в подключённом CalDAV-календаре — свободное время нужной длительности в ваши рабочие часы с учётом занятости по всем календарям.

Создание встречи в подключённом CalDAV-календаре — с местом, участниками, описанием, напоминанием («напомнить за» — от 10 минут до 1 дня) и повторением (ежедневно, по будням, еженедельно, ежемесячно, ежегодно) с окончанием по дате.

Перенос и изменение CalDAV-встречи — время, название, место, напоминание, описание.

Отмена CalDAV-встречи.

Для повторяющейся встречи при переносе, изменении и отмене Искра спрашивает охват: только этот экземпляр или вся серия.

Обзор

В подключённом CalDAV-календаре создание, перенос и изменение встречи проходят через форму-черновик: Искра показывает все поля будущей встречи, вы можете поправить их и подтвердить кнопкой формы («Создать встречу» / «Сохранить»). Отдельного подтверждения в переписке не требуется — само нажатие кнопки в форме и есть подтверждение. Отмену встречи Искра выполняет только после вашего явного согласия текстом в чате.

Для Google Calendar Искра открывает форму самого Google. Событие появляется в календаре только после сохранения в этой форме.

Обзор

Участников встречи можно вписать — они попадут в событие, — но приглашения им не отправляются: письмо с приглашением никто не получит. Искра предупреждает об этом при создании встречи. Разослать приглашения можно отдельно, например письмом через навык «Почта».

Ответить на чужое приглашение (принять или отклонить встречу, куда позвали вас) через навык тоже нельзя — это делается в самом календаре провайдера.

Обзор

Это два разных механизма, их легко перепутать по названию:

«Планы» (раздел Искры) — это ваш собственный календарь и список задач внутри платформы, включая регулярные прогоны агента: задачи, которые Искра выполняет по времени сама. С вашим внешним личным календарём встреч этот раздел не связан. Подробнее — в разделе «Раздел «Планы»».

«Календарь» (этот навык) — это события в вашем внешнем личном календаре: короткое предзаполненное действие для Google Calendar либо чтение и правка встреч на подключённом сервере (Яндекс, Mail.ru, iCloud, Nextcloud). Он не запускает агента по расписанию.

Обзор

Приглашения не рассылаются, ответить на чужое приглашение нельзя (см. выше).

Охват «этот и последующие» для повторяющихся встреч не поддерживается — только отдельный экземпляр или вся серия целиком.

Период чтения по умолчанию — 7 дней, максимум 90 дней и до 200 встреч в одном ответе; если встреч больше, Искра честно помечает, что показала часть, и предлагает сузить период.

Для Google Calendar доступно добавление нового события через предзаполненную форму. Искра не читает и не синхронизирует Google-календарь, не переносит и не удаляет уже созданные там события.

Microsoft 365 и Outlook.com CalDAV не поддерживают — для корпоративной почты и календаря на собственном сервере Exchange (не Microsoft 365/Exchange Online) есть навык «Microsoft Exchange: почта и календарь».

Корпоративный сервер, доступный только во внутренней сети организации, навык подключить не сможет без разрешения администратора контура.

Обзор

Ошибка Что означает Что делать

Заполнить группу «Подключение к

Не настроено Подключение не заполнено

календарю» через кнопку настроек

У Яндекса пересоздать

Пароль не той категории пароль именно в категории

Неверный логин или пароль

или скопирован с ошибкой «CalDAV для Календаря»;

проверить логин

Уточнить у администратора,

Требуется корпоративный Сервер требует SSO,

разрешён ли доступ по

вход доступ по паролю отключён

паролю приложения

Вписать адрес сервера явно

на домене организации это

Адрес сервера не удалось

Сервер не найден адрес самой службы:

определить

Подключить навык

Это сервер Microsoft CalDAV на Exchange

«Microsoft Exchange» —

Exchange отсутствует

почта и календарь в нём

Обратиться к

Адрес недоступен из

Сервер во внутренней сети администратору контура;

платформы

повторять бесполезно

Повторить действие позже

Сервер ограничил частоту Провайдер временно

(навык не повторяет

запросов ограничил обращения

автоматически)

Встреча поменялась в

Встречу изменили Обновить список и

другом клиенте, пока вы её

параллельно повторить

редактировали

Обзор

Пароль приложения хранится в защищённом хранилище платформы и не показывается никому, включая агента; в переписку и служебные журналы он не попадает. Искра обращается только к серверу вашего провайдера. Пароль приложения можно в любой момент отозвать в личном кабинете провайдера — тогда навык перестанет подключаться, пока вы не создадите и не впишете новый.

Обзор

Навык подключает Искру к корпоративной почте и календарю на сервере Microsoft Exchange: проверить входящие и папки, найти и прочитать письмо, скачать вложение, отправить письмо или ответ (с вашим подтверждением), пометить прочитанным, переместить или удалить письмо; в календаре — план на день или неделю, детали встречи с участниками, создание встречи с автоматической рассылкой приглашений, перенос, изменение и отмена. Учётные данные не покидают платформу: весь обмен с сервером Exchange ведёт Искра, агент пароля не видит.

Навык предназначен только для Microsoft Exchange — конкретно для серверов, где включён протокол EWS (Exchange Web Services). Для другой почты в Искре есть отдельные навыки:

«Почта» — Mail.ru, Яндекс, Gmail по паролю приложения, любой сервер с протоколом IMAP;

Gmail — аккаунт Google по OAuth-входу (без пароля).

Если вы не уверены, что у вас за почта, Искра сама спросит перед настройкой: корпоративный Exchange, Gmail или другая почта по IMAP. Отвечать наугад не нужно — три навыка настроены на разные протоколы и не подменяют друг друга.

Навык работает по просьбе, разово. Постоянная синхронизация календаря и задач с «Планами» настраивается отдельно — в разделе «Календари и задачи» настроек (см. «Синхронизация календарей и задач»). Календарь и список задач Exchange там тоже подключаются — карточкой «Exchange Server», по тому же адресу EWS и тому же доменному паролю, что и здесь (в мастере подключения адрес вводится целиком, с https:// ). Навык остаётся для почты, которой у синхронизации нет вовсе, и для разовых вопросов к календарю.

Обзор

Подключение работает вашим обычным доменным паролем от учётной записи — отдельного «пароля приложения», как для Mail.ru или Яндекса, Exchange не требует.

1. Узнайте у системного администратора адрес EWS вашего сервера: полный вид —

mail.company.ru — путь Искра подставит сама. Автоматического определения адреса нет: без администратора его не подобрать.

2. В Искре: Витрина навыков → «Microsoft Exchange: почта и календарь» → добавить в

личный профиль → на карточке навыка нажмите «Требует настройки» (позже те же поля открывает «Подробнее» → вкладка «Настройки»). В окне «Настройки навыка» откроется группа настроек «Подключение к Exchange»:

Адрес EWS — значение с шага 1;

Логин — работает в двух форматах: DOMAIN\ivanov (обычно надёжнее для корпоративных серверов) или ivanov@company.ru . Если один формат не подошёл, попробуйте второй;

Пароль — обычный доменный пароль от вашей учётной записи. Поле write-only, как и обычные ключи: посмотреть сохранённое значение нельзя, только заменить.

3. Попросите Искру проверить подключение. Диагноз при ошибке подскажет, что

поправить: неверный логин/пароль, неверный адрес сервера или сервер недоступен.

Данные подключения вводите только через форму настроек навыка. Не вставляйте пароль в переписку с агентом.

Обзор

Проверить папки — список папок ящика: имя, роль (входящие, отправленные, корзина, спам, черновики), число непрочитанных и всего писем.

Показать письма — по умолчанию из «Входящих», с возможностью указать другую папку и отфильтровать только непрочитанные. Письма приходят страницами: за раз Искра показывает до 50 (обычно 20) и говорит, сколько всего писем в папке. Если показаны не все, попросите «покажи дальше» — Искра продолжит с того места, где остановилась, и так до конца папки. Кроме обычных писем в списке видны приглашения на встречи, ответы на них и уведомления об отменах — всё, что вы видите в этой папке в Outlook.

Найти письмо — поиском на стороне сервера: по отправителю, теме, тексту письма, диапазону дат. Результаты тоже приходят страницами.

Прочитать письмо — текст письма и список вложений с номерами.

Скачать вложение в файлы чата (до 3 МБ).

Отправить письмо и ответить на письмо — оба действия показывают редактируемый черновик в форме подтверждения; письмо уходит только после вашего явного нажатия «Отправить» в форме. У ответа тему и цепочку письма строит сам сервер по исходному письму.

Приложить файлы к письму — попросите приложить файл, который есть в этом чате (например, скачанное вложение или подготовленный документ). Имена вложений перечислены в форме подтверждения — проверьте их перед отправкой. До 10 файлов, каждый до 3 МБ, все вместе до 10 МБ; имя и тип файла у получателя сохранятся.

Пометить письма прочитанными или непрочитанными, переместить в другую папку, удалить (перенос в «Корзину», не безвозвратно) — все три действия Искра выполняет только после вашего явного согласия текстом в чате.

Календарь

План на день или неделю — события календаря Exchange за период (по умолчанию ближайшие 7 дней); повторяющиеся встречи уже развёрнуты в отдельные события.

Детали встречи — время, место, организатор, участники, описание.

Создание встречи — с местом, участниками и описанием; показывает форму подтверждения перед созданием, участникам автоматически уходят приглашения. Повторяющиеся встречи создавать пока нельзя.

Перенос и изменение встречи — время, название, место, описание; участникам уходит обновление.

Отмена встречи — перенос в «Удалённые», участникам уходит отмена встречи.

Обзор

Когда Искра показывает вам текст письма — в списке или по прямому запросу — письмо остаётся непрочитанным на сервере, как если бы вы никогда его не открывали в почтовом клиенте. Это касается и просмотра вложений. Пометить письмо прочитанным можно только отдельным явным действием, и Искра сначала спросит согласия.

Если письмо запрашивает уведомление о прочтении (отправитель включил такую опцию — «отчёт о прочтении»), то пометка письма прочитанным через навык может отправить это уведомление отправителю, точно так же, как если бы вы открыли письмо в Outlook и согласились отправить отчёт. Навык эту отправку не подавляет и не спрашивает отдельно — учитывайте это, прежде чем соглашаться пометить такое письмо прочитанным.

Обзор

Все три навыка решают одну задачу — работу с почтой из чата, — но по разным протоколам, и настройки одного не подходят другому:

«Microsoft Exchange: почта и календарь» (этот навык) — только для Microsoft Exchange с включённым EWS; подключение — адрес EWS, логин и обычный доменный пароль.

«Почта» — Mail.ru, Яндекс, Gmail по паролю приложения, любой сервер с протоколом IMAP; для Exchange без включённого IMAP не подойдёт.

Gmail — только аккаунт Google, вход через OAuth без ввода пароля.

Если у вас корпоративная почта и вы не знаете, работает ли она по Exchange или по обычному IMAP — уточните у системного администратора.

Обзор

Работает только с почтой Exchange, доступной с адреса, который дал администратор: внутреннюю сеть организации (VPN, приватный адрес) навык не видит.

Microsoft 365 / Exchange Online, вход через Microsoft-аккаунт — не поддерживаются в этой версии.

Автоопределение адреса сервера не поддерживается: адрес EWS всегда узнаётся у администратора.

Контакты Exchange навык не показывает. Ответы на чужие приглашения (принять/ отклонить) и просмотр занятости коллег пока не поддерживаются.

К письму можно приложить только файлы из текущего чата: ссылку в интернете или файл на вашем компьютере навык сам не скачает — сначала приложите файл в чат.

Период чтения календаря по умолчанию — ближайшие 7 дней, максимум 62 дня и до 50 событий за раз. Повторяющиеся встречи создавать пока нельзя — только читать, они приходят уже развёрнутыми в отдельные события.

Обзор

Ошибка Что означает Что делать

Заполнить группу

Не настроено Подключение не заполнено «Подключение к Exchange»

через кнопку настроек

Проверить пароль;

Логин, пароль или формат попробовать другой формат

Неверный логин или пароль

логина указаны неверно логина ( DOMAIN\user или

Адрес EWS неверный или Уточнить адрес EWS у

Сервер недоступен

сервер не отвечает администратора

Ошибка Что означает Что делать

Указанной папки нет на

Папка не найдена Свериться со списком папок

сервере

Письмо удалено или Обновить список писем и

Письмо не найдено

устарел его идентификатор повторить

Вложение слишком Вложение больше лимита 3 Скачать вложение другим большое МБ способом

Сервер отклонил

Проверить адрес

Отправка не удалась получателя, отправителя

получателя и повторить

или тело письма

Событие изменилось или

Встреча не найдена Обновить список событий

удалено

Обзор

Пароль хранится в защищённом хранилище платформы и не показывается никому, включая агента: ни в переписку, ни в служебные журналы он не попадает. С текстом писем иначе: команда «прочитать письмо» для того и нужна, чтобы принести этот текст в переписку с агентом, — в этом смысл навыка. В служебные журналы текст письма при этом не пишется. Искра обращается только к серверу вашего провайдера по адресу, который вы указали в настройках. Пароль можно сменить в любой момент через ИТ-службу организации — тогда навык перестанет подключаться, пока вы не впишете новый.

Обзор

Интеграция с Reputation.ru помогает искать российские судебные дела, читать найденные судебные акты и заказывать глубокий анализ практики прямо из чата Искры.

Обзор

В Искре могут быть доступны два варианта с одинаковыми возможностями:

Вариант Откуда берётся ключ Кто оплачивает запросы Reputation.ru

Reputatio Корпоративный ключ n.ru настраивает Искра переводит стоимость внешнего запроса в ( reputati администратор МТ и списывает её с профиля on ) платформы

Reputatio n.ru —

Вы вводите свой API- Стоимость списывает Reputation.ru с вашего

личный

ключ в защищённой аккаунта; Искра не добавляет стоимость

ключ

форме навыка провайдера в МТ

Обычный расход МТ на сам диалог с Искрой действует в обоих вариантах. У BYOK не списывается только дополнительная стоимость запроса к Reputation.ru.

Системный вариант доступен автоматически, если администратор включил его и настроил корпоративный ключ. BYOK находится в категории «Данные» каталога навыков. При

включённом маркетплейсе установите его; если маркетплейс на вашем контуре выключен — включите режим BYOK в каталоге навыков. Затем откройте карточку и задайте личный API-ключ через защищённую форму. Не отправляйте ключ сообщением в чат.

Даже при установке BYOK в организацию каждый участник задаёт свой личный ключ профиля: общего ключа организации у этого навыка нет. Установленный или явно включённый BYOK заменяет системный вариант для тех пользователей, которым он доступен. Если личный ключ отсутствует или перестал работать, Искра не переключится молча на корпоративный доступ. При попытке запроса без ключа Искра откроет защищённую форму и остановит выполнение до настройки. Если форма не появилась, откройте карточку «Reputation.ru — личный ключ» вручную. Внешний запрос в этот момент не отправляется. Чтобы вернуться к корпоративному доступу, удалите установку BYOK либо выключите его в каталоге, если маркетплейс на контуре отключён.

Обзор

Инструмент Что делает

Ищет арбитражные дела по смысловому запросу

search_general_court_cases Ищет дела судов общей юрисдикции

Ищет решения и обзоры Верховного Суда РФ

Запускает глубокий анализ судебной практики

Проверяет состояние ранее запущенного анализа

Получает готовый Markdown-отчёт и идентификаторы дел

Получает текст арбитражного документа из результата поиска

Получает текст документа суда общей юрисдикции из результата поиска

Например, можно попросить: «Найди арбитражные дела о досрочном расторжении договора аренды», «Покажи решения Верховного суда о субсидиарной ответственности» или «Проведи глубокий анализ практики по этому вопросу».

Поиск возвращает не более 10 компактных результатов за один запрос. Пустой результат тоже считается выполненным запросом Reputation.ru и может быть платным. Для чтения документа используйте только идентификатор, который этот же вариант навыка ранее показал вам в результате поиска: произвольный или чужой идентификатор будет отклонён до внешнего запроса.

Если после отправки любой платной операции её исход остался неизвестен, навык не повторяет внешний запрос автоматически: повтор мог бы привести к двойной оплате.

Дополнительные МТ системного варианта списываются только после подтверждённого успеха Reputation.ru. Ответ провайдера с ошибкой и неопределённый сетевой исход не тарифицируются в Искре. Если провайдер уже вернул результат, но списание МТ не подтвердилось, навык сохраняет доступный результат или request_id , помечает его как неоплаченный и запрещает автоматический повтор.

Обзор

Глубокий анализ запускается отдельно от обычного поиска и всегда требует подтверждения:

системный вариант показывает цену провайдера в рублях и рассчитанное списание в МТ; показанное значение — верхняя граница списания;

BYOK предупреждает, что платный запрос будет выполнен с вашего аккаунта Reputation.ru, без обещания фиксированной цены.

После подтверждения Искра отправляет запрос один раз и возвращает request_id . Состояние можно проверять не чаще одного раза в 10 секунд, а готовый результат получать через deep_result . Проверять можно только анализ, который ранее запустили вы через тот же вариант навыка.

Если связь оборвалась после отправки и Искра не может установить исход, платный запрос не повторяется автоматически. Сначала проверьте состояние по уже полученному request_id или расходы в аккаунте Reputation.ru; новый запуск выполняйте только осознанно.

Обзор

Перед внешним запросом Искра получает действующий тариф Reputation.ru, проверяет доступный лимит и рассчитывает списание по цене провайдера, коэффициенту платформы и цене МТ вашего тарифа. Если тариф нельзя надёжно проверить или исходная стоимость провайдера выше установленного администратором потолка, запрос не отправляется. Потолок проверяется до применения коэффициента платформы. Проверка статуса и получение результата глубокого анализа выполняются без дополнительной стоимости провайдера, пока действующий тариф Reputation.ru подтверждает нулевую цену этих операций.

У BYOK Искра не получает тариф вашего аккаунта и не начисляет МТ за запросы к провайдеру. Баланс, квоты и фактическую цену проверяйте в личном кабинете Reputation.ru.

Обзор

Текст поискового запроса или запроса на анализ передаётся во внешний сервис Reputation.ru. Не включайте сведения, которые не нужны для поиска. API-ключ берётся из защищённого хранилища и в текст чата не добавляется.

Приватный режим «Антоним» покрывает LLM-запросы Искры, но не обращение навыка к Reputation.ru: текст запроса уходит во внешний сервис и под включённым Антонимом. Поиск при этом работает по реальным ФИО и ИНН — запрос ничем не подменяется.

Навык хранит только ограниченный список идентификаторов, нужных для последующих безопасных вызовов:

до 100 незавершённых анализов; незавершённая запись истекает через 24 часа;

до 100 завершённых и истёкших записей — не более 30 дней, с удалением давно не использовавшихся;

последние 100 идентификаторов арбитражных документов и последние 100 идентификаторов документов судов общей юрисдикции.

Длинный текст документа или отчёта сокращается до 60 000 байт, не разрывая символы. Это ограничение ответа навыка, а не изменение документа у провайдера.

Официальная документация провайдера:

AI-поиск по судебной практике;

глубокий AI-анализ;

документы арбитражных судов;

суды общей юрисдикции.

Обзор

Навык подключает Искру к вашему почтовому ящику по обычным почтовым протоколам IMAP и SMTP: проверить входящие и папки, найти и прочитать письмо, скачать вложение, отправить письмо или ответ (с вашим подтверждением, при необходимости с файлами из чата во вложении), пометить прочитанным, переместить или удалить письмо. Учётные данные не покидают платформу: весь обмен с почтовым сервером ведёт Искра, агент пароля не видит.

Навык подходит для Mail.ru, Яндекс.Почты, Gmail по паролю приложения и любого сервера с включённым IMAP, в том числе корпоративного. Для корпоративной почты Microsoft Exchange, где администратор выключил IMAP, есть отдельный навык «Microsoft Exchange: почта и календарь» — см. раздел «Чем «Почта» отличается от Exchange и Gmail» ниже.

Обзор

Mail.ru, Яндекс и Gmail всегда отклоняют вход по основному паролю от почты: почтовой программе нужен отдельный пароль приложения. У Яндекса, кроме того, доступ по IMAP и по паролям приложений включается отдельным переключателем в самой Почте — без него даже правильный пароль приложения сервер отклонит.

1. Включите доступ и создайте пароль приложения у своего провайдера:

Яндекс. В Почте откройте Настройки → Почтовые программы и включите «С сервера imap.yandex.ru по протоколу IMAP» и «Пароли приложений и OAuth-токены». Затем в Яндекс ID → Безопасность → Пароли приложений создайте пароль типа «Почта» (справка Яндекса). Mail.ru. Настройки почты → Безопасность → «Пароли для внешних приложений». IMAP включён по умолчанию; логин — полный адрес почты,

Gmail. В аккаунте Google включите двухэтапную аутентификацию — без неё пароли приложений недоступны, — затем Безопасность → Пароли приложений. В Google Workspace администратор может закрыть этот доступ: тогда подключите навык «Gmail», который входит через OAuth.

Корпоративная почта. Обычно подходит обычный пароль; включён ли IMAP для вашего ящика и какие у сервера адреса, подскажет системный администратор.

2. Узнайте адреса серверов своего провайдера. Для популярных это imap.mail.ru и

Порт указывать не обязательно — по умолчанию используются 993 для IMAP и 465 для SMTP, оба по защищённому соединению; если у вашего сервера порты другие, впишите их через двоеточие, например imap.company.ru:143 .

3. В Искре: Витрина навыков → «Почта» → добавить в личный профиль → на карточке

навыка нажмите «Требует настройки» (позже те же поля открывает «Подробнее» → вкладка «Настройки»). В окне «Настройки навыка» откроется группа настроек «Подключение к почте»:

IMAP-сервер и SMTP-сервер — адреса с шага 2;

Логин — полный адрес вашей почты;

Пароль — пароль приложения с шага 1, целиком и без пробелов. Поле write-only, как и обычные ключи: посмотреть сохранённое значение нельзя, только заменить.

4. Попросите Искру проверить подключение. Проверяются оба канала — чтение (IMAP) и

отправка (SMTP). Если вход отклонён, Искра покажет ответ почтового сервера и чек-лист вашего провайдера — что включить и какой пароль вставить; если адрес сервера неверный или сервер недоступен, диагноз скажет и это.

Обзор

Один установленный навык подключает до десяти равноправных ящиков: например, личную рабочую почту и общий адрес для обращений клиентов. Ящики равны между собой — «главного» ящика, ролей и ящика по умолчанию нет.

В форме настроек навыка каждый ящик — отдельная карточка с логином и IMAP-сервером; кнопка «Добавить подключение» доступна, пока не набрано десять. Каждую карточку можно изменить или удалить отдельно: остальные ящики продолжают работать, и ни один из них не становится «главным» вместо удалённого.

Когда ящик один, Искра работает с ним без уточнений.

Когда ящиков несколько, а из просьбы не ясно, о каком речь, Искра покажет список подключённых ящиков и попросит выбрать. Молча она не выбирает: письмо не должно уйти не с того адреса. Можно сразу сказать, с каким ящиком работать: «проверь почту на mail@iskrabot.ru».

«Проверь всю почту» Искра выполняет по ящикам подряд и говорит, где что нашла.

Форма подтверждения отправки и ответа всегда показывает точный адрес отправителя — проверьте его перед отправкой.

Идентификаторы писем привязаны к ящику: письмо одного ящика нельзя прочитать, переслать или удалить «из-под» другого, даже если у писем совпали папка и номер. Идентификаторы, полученные до подключения второго ящика, перестают действовать — просто попросите показать письма заново.

Личные и организационные подключения не складываются. Если у организации настроены общие ящики, а вы завели личное подключение, для вас начинает действовать только личная коллекция — все организационные ящики перестают использоваться, пока личная коллекция существует. Предел в десять ящиков тоже считается по действующей коллекции, а не суммарно. Форма настроек предупреждает об этом перед созданием первого личного подключения.

Данные подключения вводите только через форму настроек навыка. Не вставляйте пароль в переписку с агентом.

Обзор

Проверить папки — список папок ящика: имя, роль (входящие, отправленные, корзина, спам, черновики, архив), число непрочитанных и всего писем.

Показать письма — по умолчанию из «Входящих», с возможностью указать другую папку и отфильтровать только непрочитанные. Письма приходят страницами: за раз Искра показывает до 50 (обычно 20) и говорит, сколько всего писем в папке. Если показаны не все, попросите «покажи дальше» — Искра продолжит с того места, где остановилась, и так до конца папки.

Найти письмо — поиском на стороне почтового сервера: по отправителю, теме, тексту письма, диапазону дат. Результаты тоже приходят страницами.

Прочитать письмо — текст письма и список вложений с номерами.

Скачать вложение в файлы чата (до 3 МБ).

Отправить письмо и ответить на письмо — оба действия показывают редактируемый черновик в форме подтверждения; письмо уходит только после вашего явного нажатия

«Отправить» в форме. У ответа тему и цепочку письма Искра строит по исходному письму.

Приложить файлы к письму — попросите приложить файл, который есть в этом чате (например, скачанное вложение или подготовленный документ). Имена вложений перечислены в форме подтверждения — проверьте их перед отправкой. До 10 файлов, каждый до 3 МБ, все вместе до 10 МБ; имя и тип файла у получателя сохранятся.

Пометить письма прочитанными или непрочитанными, переместить в другую папку, удалить (перенос в «Корзину», не безвозвратно) — все три действия Искра выполняет только после вашего явного согласия текстом в чате.

Обзор

Когда Искра показывает вам текст письма — в списке или по прямому запросу — письмо остаётся непрочитанным на сервере, как если бы вы никогда его не открывали в почтовой программе. Это касается и просмотра вложений. Пометить письмо прочитанным можно только отдельным явным действием, и Искра сначала спросит согласия.

Обзор

Все три навыка решают одну задачу — работу с почтой из чата, — но по разным протоколам, и настройки одного не подходят другому:

«Почта» (этот навык) — Mail.ru, Яндекс, Gmail по паролю приложения, любой сервер с протоколом IMAP; подключение — адреса IMAP и SMTP, логин и пароль приложения.

«Microsoft Exchange: почта и календарь» — только для Microsoft Exchange с включённым EWS; подключение — адрес EWS, логин и обычный доменный пароль. Этот навык умеет ещё и календарь Exchange.

Gmail — только аккаунт Google, вход через OAuth без ввода пароля.

Если у вас корпоративная почта и вы не знаете, работает ли она по обычному IMAP или по Exchange — уточните у системного администратора.

Обзор

Нужен сервер, доступный из интернета: почтовый сервер во внутренней сети организации (VPN, приватный адрес) навык не увидит.

Соединение всегда защищённое; незашифрованные подключения навык не устанавливает.

Отправка возможна только с адреса того ящика, из которого идёт письмо; выбрать «чужой» адрес отправителя нельзя.

Личная коллекция ящиков полностью заменяет организационную: подключения из двух коллекций не объединяются.

К письму можно приложить только файлы из текущего чата: ссылку в интернете или файл на вашем компьютере навык сам не скачает — сначала приложите файл в чат.

Календаря и контактов у этого навыка нет — только почта.

Очень длинные письма Искра показывает с обрезкой текста.

Обзор

Ошибка Что означает Что делать

Заполнить группу

Не настроено Подключение не заполнено «Подключение к почте»

через кнопку настроек

Ошибка Что означает Что делать

Чек-лист: логин — полный адрес почты; Яндекс — в Почте включены «С сервера imap.yandex.ru по протоколу IMAP» и «Пароли приложений и OAuth-

Сервер отклонил логин и токены», пароль

Вход отклонён (неверный

пароль; в ответе Искра приложения типа «Почта»;

логин или пароль)

цитирует текст сервера Mail.ru — пароль для

внешних приложений; Gmail — пароль приложения при включённой двухэтапной аутентификации; пароль вставлен целиком, без пробелов

Проверить адреса серверов,

Адрес IMAP или SMTP

при необходимости

Сервер недоступен неверный, либо сервер не

уточнить у провайдера или

отвечает

администратора

Указанной папки нет на

Папка не найдена Свериться со списком папок

сервере

Письмо удалено или

Обновить список писем и

Письмо не найдено содержимое папки

повторить

изменилось

Файл больше 3 МБ, либо Отправить файл отдельным

Вложение слишком

все вложения письма — письмом или другим

большое

больше 10 МБ способом

Файл не найден среди Файла с таким именем в Приложить файл в чат и файлов чата этом чате нет назвать его точное имя

Сервер отклонил

Проверить адрес

Отправка не удалась получателя, отправителя

получателя и повторить

или тело письма

Подключено несколько Из просьбы не ясно, о каком Назвать нужный ящик из ящиков ящике речь показанного списка

Идентификатор письма

Показать письма нужного

Письмо из другого ящика выдан другим

ящика заново

подключением

Ссылка на письмо выдана

Идентификатор устарел до подключения второго Показать письма заново

ящика

Обзор

Пароль хранится в защищённом хранилище платформы и не показывается никому, включая агента: ни в переписку, ни в служебные журналы он не попадает. С текстом писем иначе: команда «прочитать письмо» для того и нужна, чтобы принести этот текст в переписку с агентом, — в этом смысл навыка. В служебные журналы текст письма при этом не пишется. Искра обращается только к серверам вашего провайдера по адресам,

которые вы указали в настройках. Пароль приложения можно отозвать в любой момент в настройках безопасности почты — тогда навык перестанет подключаться, пока вы не впишете новый.

Обзор

Искра — AI-платформа. «Искра» — официальное имя продукта; Anthill и имя модели — технические метки. Чат с агентом: приложите материалы и попросите сравнить продажи за два месяца.

Что умеет Искра

Документы и аналитика: читать PDF/DOCX/XLSX, сравнивать договоры, считать показатели, создавать и редактировать DOCX/XLSX/PPTX, работать с PDF. DOCX экспортируется в PDF; PDF → DOCX не поддерживается.

Тексты и презентации: письма, инструкции и слайды; укажите формат и стиль.

Веб-поиск: актуальные сведения и проверка источников; назовите тему и период.

Визуализации: схемы, диаграммы, графики и интерактивные дашборды — например, продажи с фильтрами по таблице.

Изображения и видео: генерация и редактирование доступны, когда системный навык настроен для вашей инсталляции. Опишите изображение.

Записи: где включён платформенный инструмент, Искра расшифровывает аудио и видео; длинная запись может обрабатываться асинхронно.

Подключения: amoCRM, Битрикс24, 1С, почта, календари, Метрика, Вебмастер, WebDAV-диск, GitHub. Настройте навык с нужными правами. Telegram/MAX включает оператор; подключите бота с правами чата.

Планы: разовые и регулярные запуски без вашего участия — где в «Планах» доступно действие «Прогон Искры». Задайте время и задание, например отчёт каждый понедельник; результат остаётся в чате и приходит уведомление. Режим «Авто» выбирает навыки запроса, расписание задаётся в «Планах».

Код и собственные навыки: объяснение кода, расчёты, повторение процедур. Для анализа, документов и многошаговых процессов начните с текстового навыка: опишите шаги. Регулярность не требует программного навыка.

Действие зависит от контура, плана, настроек, инструментов и прав. Выполнение подтверждает результат; неизвестная деталь остаётся неподтверждённой.

Материалы и рабочий контекст

Чтобы открыть произвольный файл с вашего устройства, приложите его или подключите папку Памяти. Один путь к файлу доступа не даёт.

Большие материалы — заранее делить документ на части не нужно: Искра читает по частям; точные ограничения зависят от типа файла и настроек.

Субагенты — Искра может поручать им независимые части одного задания и проверку результата.

Папка как база знаний — подключённая папка Памяти используется без отдельной настройки RAG.

Длинная беседа — в личной беседе Искра сама сжимает ранние ходы в резюме при нехватке контекста; вручную — «Сжать» или /compact .

Что Искра знает о вас

Искра учитывает доступные источники; беседы в другие чаты сами не переносятся.

Сохранено по вашей просьбе: факты навыка «Память» (когда он включён; надолго — во всех ваших беседах, «на этот чат» — только здесь) и /pin до конца беседы.

Дано из настроек и рабочего контекста: поля профиля, учебный профиль, инструкции пространства, подключённые папки. В общей беседе пространства «О себе», инструкции и учебный профиль не используются.

Текущая беседа: сообщения и приложения, включая «запомни» без сохранения в навык.

Куда смотреть в справке

Выберите документ по теме и нужный раздел в его оглавлении.

Начало работы, мобильное приложение.

Чат: «Публичная ссылка на беседу», «Файлы чата»; работа агента.

Навыки: «Создание навыка из чата», «Где хранить материалы навыка», «Как организовать проверку результата»; установка и публикация.

Память и Синхронизация папок.

API-ключи: «Как скачать созданный файл через API».

Планы, Календарь, синхронизация календарей.

amoCRM, Битрикс24, 1С.

Почта/Gmail, Exchange.

Метрика, Вебмастер, Датаньютон, WebDAV-диск.

Проекты, организации.

Настройки: «Язык интерфейса», «Язык ответов»; промокоды.

Обучение, Репутация, приложения.

Безопасность, контуры, GPU, разработчик и лицензии.

Ошибки и поддержка.

Языки интерфейса и ответов — разные настройки; список языков интерфейса не ограничивает языки общения. Совместимость мобильного приложения с контуром подтверждает администратор.

Приватность и актуальные условия

Маршрут данных определяют контур и конфигурация. On-premise сам по себе не гарантирует, что данные не покидают периметр: возможны внешние модели и интеграции. Нужна проверка конфигурации конкретной инсталляции с её администратором. Приватный режим «Антоним», хранение бесед, административный доступ и журналы — в разделе о безопасности. Контакт по on-premise и партнёрству: mail@iskrabot.ru.

Текущий план и лимиты — Настройки → «Подписка» (/settings/billing); тарифы — /pricing, если биллинг включён. Актуальные цены и текущая подписка берутся из live-биллинга, а не из этого обзора. Помощь.

Обзор

Этот раздел отвечает на вопросы о том, как Искра обращается с вашими данными: приватный режим обработки, хранение диалогов, административный доступ, аналитика и журналы.

Как работает Антоним: приватный режим обработки

«Антоним» — режим приватности. Когда он включён, запросы обрабатывает языковая модель на серверах Искры, и внешнему провайдеру модели они не передаются. Текст запроса при этом не меняется: меняется место обработки, а не содержимое. Именно поэтому режим годится не только для персональных данных, но и для коммерческой тайны и документов для служебного пользования — там ценность составляет сам текст, и искажать его ради приватности бессмысленно.

Что покрывает режим:

текст вашего запроса;

работу агента — результаты инструментов, промежуточные шаги, подбор навыков, системный промпт, инструкции подключённых папок Памяти;

текстовый ответ модели.

Что остаётся вне режима. Эти пять поверхностей идут обычным маршрутом платформы, и на облаке это внешний провайдер:

голосовой ввод — записанное аудио уходит сервису распознавания речи;

озвучка ответа — в сервис синтеза речи уходит текст ответа модели дословно. Сейчас озвучка ни в одном интерфейсе Искры не включена, поэтому фактически этот путь не используется; ограничение начнёт действовать, когда она вернётся;

письмо «задача выполнена» — если у задачи по расписанию включено Email-уведомление, полный текст результата уходит в теле письма через сервис доставки почты;

отправка навыка на модерацию — уходит манифест и полный исходный текст навыка;

сводка для администратора платформы — заголовки чатов, первые реплики и имена файлов по всей установке.

Сюда же относится обращение навыков к своим внешним сервисам: Антоним покрывает LLM-запросы Искры, а не сторонние API, которые вызывает навык.

Что в приватном режиме не работает вовсе. Нейросетевые генерации — изображения, озвучка, распознавание аудио — под включённым режимом не выполняются, а честно отказывают: их исполняет внешний провайдер, и тихо отправить туда запрос режим не может. Чтобы ими воспользоваться, режим нужно выключить.

Мобильное push-уведомление в этот список не входит: в приватном режиме оно приходит без предпросмотра текста ответа — только сообщение о том, что ответ готов.

Как режим ведёт себя при сбое. Запасного маршрута у Антонима нет намеренно: если серверы Искры заняты, запрос не выполняется и Искра предложит повторить. Внешнему провайдеру модели он при этом не передаётся — ни при перегрузке, ни при любом другом сбое: подмены маршрута на внешнюю модель у режима не предусмотрено. Если нужной возможности на серверах Искры нет, Искра скажет об этом прямо, и повтор не поможет.

Чем приходится платить. В приватном режиме отвечает другая модель, поэтому на сложных задачах ответ может отличаться, а уровни сложности сводятся к одному. Объём рабочего контекста при этом не меняется.

Включение режима описано в разделе «Настройки» → «Антоним — приватный режим».

Хранение диалогов и доступ администратора

Диалоги — данные продукта: они хранятся в базе данных инсталляции, чтобы вы могли вернуться к беседе с любого устройства. Административный просмотр диалогов возможен только в режиме чтения, и каждый такой просмотр журналируется — администратор не может незаметно читать переписку.

Секретная ссылка, отзыв доступа и уже скачанные копии

Материал доски выходит за пределы Искры только через её внешние аудитории — адресное приглашение и секретную ссылку. Приглашение открывает доску после входа с тем же подтверждённым адресом, поэтому за ним стоит проверенный профиль. Секретная ссылка открывается без входа: она сама и есть ключ, и обращаться с ней нужно как с паролем. В базе хранится не сам секрет, а его отпечаток, поэтому показать выданную ссылку повторно Искра не может — потерянную ссылку перевыпускают. Полный список аудиторий доски и порядок выдачи ссылки описаны в разделе «Доски».

Отзыв закрывает доступ, но не отменяет уже выданное. Отозванная или перевыпущенная ссылка перестаёт открываться сразу, в том числе у читателя с открытой страницей — при ближайшей проверке. А файл, который читатель успел скачать или скопировать себе, остаётся у него: такую копию вернуть нельзя. Поэтому решение о внешнем показе принимают до выдачи ссылки.

Искра не ведёт именных списков читателей секретной ссылки: кто именно открыл доску и прочитал ли он материал, продукт не показывает. Отпечатки браузера и длительная история сетевых адресов для этого не собираются.

В организации внешние аудитории доски открывает персональное право участника: его выдают владелец и администратор организации, и спрашивается оно при каждом открытии доски — отзыв права закрывает читателям всё, что человек успел выпустить (см. раздел «Аккаунт, профили и организации»). Отзыв и перевыпуск ссылки, как и изменения политики внешнего доступа организации, попадают в журнал организации; секреты и содержимое документов в записи не входят.

Продуктовая аналитика и тела диалогов

Базовая продуктовая аналитика собирает метаданные: токены, использованную модель, задержки, ошибки и события биллинга — тела диалогов в неё не входят. Также учитываются используемый клиент (приложение Android / iOS, desktop или браузер), операционная система, режим мобильного приложения и время использования. Администратор платформы видит эти сведения по аккаунту; один аккаунт может использовать несколько клиентов. Сигналы открытого интерфейса отправляются при возвращении в него и периодически, пока он видим.

Исключение одно и условное: если администратор инсталляции включил еженедельную сводку активности (weekly summary), первые пользовательские сообщения обычных рабочих чатов за неделю используются для построения этой сводки; временные чаты в неё не попадают. В инсталляциях без включённой сводки тела диалогов в аналитике не используются. Полные тексты LLM-запросов и ответов доступны только в отладочном trace, который в production выключен.

SIEM, DLP и экспорт журналов

Готовых SIEM- и DLP-коннекторов у Искры нет. Экспорт журналов (например, через syslog или Kafka) добавляется в рамках проекта внедрения — обсудите требования с командой Искры: mail@iskrabot.ru.

Обзор

Этот раздел отвечает на вопросы о вариантах развёртывания Искры, сертификатах и требованиях регуляторов, а также о лицензировании on-premise-установки.

Контуры развёртывания: облако, российский контур и on-premise

У Искры три контура развёртывания:

Облако — управляемая инсталляция команды Искры. Отвечая на вопросы о размещении данных, учитывайте: основной LLM-путь и вспомогательные провайдерские вызовы зависят от конфигурации инсталляции; отдельные навыки с внешними провайдерами включаются администратором явно.

Российский контур — размещение полностью на российской инфраструктуре; коммерческий коэффициент к облачным ценам ×1,3.

On-premise — развёртывание в инфраструктуре вашей организации. Есть два варианта: полная автономия на GPU заказчика (актуальный ориентир полной автономии — площадка в Казани, 8 × NVIDIA B200) или использование безопасного LLM API/gateway заказчика — тогда собственный GPU-контур не требуется.

Сам по себе on-premise-контур не гарантирует, что данные не покидают периметр организации: размещение данных и отсутствие внешних провайдеров зависят от выбранной и проверенной конфигурации конкретной инсталляции. В конфигурации могут присутствовать внешние LLM, внешний LLM-gateway и провайдерские интеграции. Отвечая на вопросы о локальности данных, предлагайте проверить конфигурацию конкретной инсталляции, а не обещайте полный периметр только на основании on-premise-развёртывания. Контакт по запросам on-premise и партнёрству: mail@iskrabot.ru.

GPU и локальная LLM для полной автономии

Вариант полной автономии on-premise выполняет языковые модели на GPU заказчика: нужен выделенный GPU-контур. Актуальный ориентир такой конфигурации — серверная платформа с 8 × NVIDIA B200 (пример действующей площадки — Казань). Если вместо локальных моделей используется безопасный LLM API или gateway заказчика, собственный GPU-контур не требуется.

Точный sizing — состав серверов, конфигурация GPU, выбор модели и допустимая нагрузка по числу пользователей — рассчитывается и проверяется в проекте внедрения под конкретную организацию; универсальной таблицы требований в справке нет. Запрос расчёта: mail@iskrabot.ru.

Разработчик и участники внедрения

Разработчика продукта и исполнителей конкретного внедрения подтверждают по реквизитам и документации этой установки. В этой справке Казань приведена как пример площадки с локальными моделями; название города, конфигурация GPU и имя языковой модели сами по себе не определяют организацию-разработчика. Если доступные материалы её не называют, название остаётся неподтверждённым. Сведения о своём контуре можно уточнить у администратора или команды Искры по адресу mail@iskrabot.ru.

Комплаенс: реестр ПО, сертификаты ФСТЭК и ФСБ, 152-ФЗ

Искра включена в реестр российского ПО: запись № 34144 от 04.07.2026.

Сертификата ФСТЭК у продукта сейчас нет; сертификация ФСТЭК планируется. Отвечая о ФСТЭК, сообщайте подтверждённый статус: сертификата пока нет, сертификация запланирована, а сроки, класс и охват станут известны позже.

Сертификатов ФСБ и ГОСТ-криптографии у продукта нет, отдельная продуктовая сертификация по этим направлениям не заявлена.

Соответствие требованиям 152-ФЗ определяется для конкретного сценария и выбранного контура. Архитектура контура, минимизация собираемых данных и приватный режим «Антоним» применяются как меры снижения рисков, но сами по себе не подтверждают соответствие (см. раздел «Безопасность и приватность данных»).

Требования КИИ и ЦБ закрываются проектно, в рамках конкретного внедрения; срок хранения журналов настраивается до 5–7 лет.

Лицензии on-premise: цена и что входит

On-premise Искры — годовая лицензия на развёртывание в контуре клиента:

Простая лицензия — 2 400 000 ₽ в год, до 1 000 пользователей; включает ПО, обновления и брендирование. Подходит малому и среднему on-premise-контуру. Расширенная лицензия — 12 000 000 ₽ в год, без ограничения пользователей; основной enterprise-вариант для production-запуска. Максимальная лицензия — 36 000 000 ₽ в год, без ограничения пользователей; для ИБ-heavy и стратегических заказчиков с отдельным сопровождением. «Раскрытие исходного кода» на этом уровне означает доступ специалистов ИБ заказчика к аудиту исходников под NDA — без передачи прав и без публикации в open source.

Серверы, GPU, LLM и токены, gateway, внедрение, интеграции, кастомизация, эксплуатация и повышенный SLA в лицензию не входят и идут отдельными строками договора. Месячный эквивалент — только пояснение к годовому контракту, а не отдельный тариф. Запрос коммерческого предложения: mail@iskrabot.ru.

Обзор

Мобильное приложение Искры (Android и iOS) запрашивает системные разрешения только тогда, когда вы включаете связанную функцию. Без любого из разрешений вход, чтение и текстовый чат работают полностью — недоступной становится только зависимая возможность.

Где установить мобильное приложение

Приложение «Искработ» опубликовано в официальных магазинах:

Android — RuStore.

iPhone и iPad — App Store.

Для корпоративного контура администратор подтверждает совместимость приложения и адрес сервера. Наличие приложения в магазине само по себе не подтверждает доступность конкретной корпоративной установки.

Сохранение входа

После входа по паролю или через подключённый сервис приложение запоминает аккаунт на срок до 30 дней. При использовании Искры срок продлевается — после паузы в две– три недели можно вернуться без повторного входа.

Если вход уже завершился, войдите снова в прежний аккаунт и выберите тот же рабочий профиль. Завершение входа само по себе не удаляет сохранённые чаты и документы.

Полная версия Искры

Приложение открывает полную версию Искры: проекты, Память, навыки и остальные разделы работают так же, как в вебе. Облегчённый режим Лайт временно отключён, поэтому выбирать режим при входе не нужно.

Голос и приватный режим. Приватный режим «Антоним» меняет место обработки самого запроса, но на распознавание речи не распространяется. Записанное аудио уходит сервису распознавания обычным маршрутом платформы, а на облаке это внешний провайдер. Если содержимое нельзя отдавать наружу даже в виде записи, вводите вопрос текстом. Полный список поверхностей вне режима — в разделе Безопасность и приватность данных.

Подсказка после скриншота

Если в Полной версии вы сделали системный скриншот открытого разговора, приложение покажет небольшое облачко «Постоянная ссылка на чат — здесь» к кнопке «⋮» (три точки) у правого края шапки. Получатель ссылки откроет разговор, а доступ можно закрыть. Пока облачко видно, нажатие на него или на пункт «Поделиться чатом» в шторке трёх точек сразу создаёт отсутствующую публичную ссылку либо показывает существующую. В открывшемся окне можно скопировать адрес, обновить опубликованное содержимое или закрыть доступ. Если ответ ещё генерируется, окно предупреждает, что текущий ответ пока не входит в опубликованную часть разговора.

Подсказка появляется только в сохранённом разговоре, который вы можете опубликовать: не архивном и не доступном вам только для чтения. В новом чате до первого сообщения она недоступна. За один сеанс Полной версии подсказка появляется не чаще одного раза на разговор и не более трёх раз; при смене профиля счётчик сбрасывается. После перезапуска приложения напоминание может появиться снова. Облачко плавно исчезает через восемь секунд; его также можно убрать нажатием за его пределами или клавишей Escape. При переходе в другой разговор подсказка исчезает.

Подсказка работает на iPhone и Android 14 и новее. Искра получает только факт системного скриншота, содержимое экрана не читает и не анализирует. На Android 14+ система сообщает, что приложение обнаружило скриншот. Искра один раз поясняет это при первом открытии подходящего чата. Определение скриншота включается только пока подсказка ещё может появиться: в настройках, на экране входа, при открытом окне ссылки и после уже показанной подсказки оно выключено. Разрешение Android выдаётся при установке без отдельного запроса. На Android 13 и старше подсказки нет.

Шаг «Возможности приложения»

После первого входа приложение показывает необязательный шаг «Возможности приложения»: список используемых возможностей, текущее состояние каждого разрешения и кнопку «Настроить». Шаг можно пропустить — ничего не блокируется.

Вернуться к этому экрану можно в любой момент: откройте в приложении Настройки → Настройки приложения → Разрешения приложения.

Какие разрешения использует приложение

Уведомления — ответ Искры в обычном чате приходит push-сообщением, даже когда приложение закрыто. Обычно в уведомлении виден и сам ответ; если беседа шла в приватном режиме, вместо текста стоит короткая строка о том, что предпросмотр не показывается, — ответ нужно открыть в чате. Ответы на программные запросы по API-ключу push не создают. После выхода из аккаунта приложение перестаёт получать его уведомления. Разрешение запрашивается только по кнопке «Настроить» на экране разрешений.

Микрофон — голосовой ввод сообщений и звук при записи видео для вложений. Запрос появляется при первом нажатии на кнопку голосового ввода в чате: сначала приложение объяснит, зачем нужен микрофон, затем система спросит разрешение. После согласия запись продолжится сама — повторно нажимать не нужно. В Полной версии на Android микрофон доступен страницам выбранного сервера Искры. Системное разрешение не даёт доступа к нему сторонним страницам, в том числе встроенным в открытую страницу.

Камера (iOS) — пункт «Снять фото или видео» при прикреплении вложения. Системный запрос показывает сама iOS в момент первого использования; текст запроса объясняет назначение. При записи видео система дополнительно спросит доступ к микрофону.

Сохранение в Фото (iOS) — сохранение изображений из чата в галерею. Запрос также показывает система при первом сохранении.

Файлы и вложения — прикрепление файлов идёт через системное окно выбора, отдельное разрешение не требуется.

На Android 9 и старше система дополнительно один раз спросит доступ к хранилищу при первом скачивании файла в «Загрузки». Экран разрешений это разрешение не показывает — управляйте им через настройки Android.

Если вы отказали в разрешении

Обычный отказ ничего не блокирует: недоступна только зависимая функция. При повторной попытке использовать функцию приложение объяснит, что именно не работает, и предложит разрешить снова (Android) или открыть настройки (iOS — система не показывает повторный запрос).

Если разрешение запрещено в настройках

Когда система больше не показывает запрос («Больше не спрашивать» на Android, любой отказ на iOS или запрет администратором), на карточке появляется состояние «Запрещено в настройках» и кнопка «Открыть настройки» — она ведёт прямо в настройки приложения:

iOS: Настройки → Искработ → включите нужный переключатель (Уведомления, Микрофон, Камера или Фото). Android: Настройки → Приложения → Искработ → Разрешения → выберите разрешение и «Разрешить» (для уведомлений: Настройки → Приложения → Искработ → Уведомления).

После возврата в приложение состояние обновится автоматически. Отозвать выданное разрешение можно там же — приложение продолжит работать, недоступной станет только связанная функция.

Обзор

Приложение — отдельный веб-сервис, который живёт в Искре: у него собственный адрес, собственные версии и собственный режим доступа. Открывается оно в браузере как обычный сайт, а интеллект Искры доступен ему изнутри: приложение обращается к платформе от имени того, кто его открыл, и расход идёт этому человеку.

Приложение — не навык и не сценарий. Навык расширяет возможности агента в чате, сценарий — сохранённый ход работы с навыком, а приложение — самостоятельный сервис со своим адресом.

Раздел «Приложения» появляется в левой панели, только если приложения включены на вашей платформе. Если раздела нет — спросите администратора вашей организации.

Пока приложений меньше четырёх, над списком показывается короткая панель «Что такое приложения»: что это, как создать приложение из чата, как собрать его во внешней среде и на чём приложение работает. Кнопка «Скрыть» убирает панель, ссылка «Как это работает» в шапке раздела возвращает её обратно. Ссылка «Подробнее» в панели открывает эту главу справки.

Как создать приложение

Нажмите «Создать приложение» в шапке раздела (при пустом списке та же кнопка есть в панели «Что такое приложения»). Откроется окно с двумя полями:

Название — как приложение называется для людей. От 1 до 80 символов, любой язык. Название видно в списке, в карточке приложения и на странице входа.

Приложения, собранные Искрой, показывают его и в заголовке вкладки браузера у зрителя.

Адрес — часть ссылки, по которой приложение открывают. Строчные латинские буквы, цифры и дефис (не по краям), до 63 символов. Адрес предлагается автоматически из названия транслитерацией, но его можно поправить вручную.

После нажатия «Создать» приложение появляется в разделе со статусом «Черновик», и вы попадаете в его карточку. Черновик — это уже настоящее приложение: адрес закреплён за ним, оно занимает место в лимите числа приложений, но версий у него ещё нет, поэтому открыть его нельзя.

Чем наполнить черновик

В карточке черновика есть блок «Как наполнить приложение». Оба пути ведут в эту же карточку:

«Создать в чате» — открывает чат со сценарием создания приложения; название, адрес и само приложение уже подставлены в заготовку запроса, поэтому Искра не будет спрашивать их заново. Она уточнит идею, соберёт приложение, проверит его и опубликует первую версию сюда, а исходники оставит вам. Кнопка есть, только если создание приложений из чата включено на платформе.

«Загрузить архив» — принимает zip-архив, собранный командой iskra-app pack . Номер версии платформа возьмёт из app.json ; версия станет текущей после успешной проверки.

Третий путь — собрать приложение во внешней среде. Понадобятся пакет @iskra/apps , команды iskra-app init → check → publish , адрес платформы и API-ключ с правом публикации приложений. Это право не входит в набор по умолчанию и в окне создания ключа не предлагается — за таким ключом обращайтесь к администратору вашей платформы. Про ключи в целом — в главе «API-ключи».

Когда первая версия проходит проверку, черновик сам становится обычным приложением: статус меняется на «Активно», а в истории изменений появляется запись о том, что черновик стал приложением.

Черновик живёт, пока вы его не удалите: он создан намеренно, и платформа его не убирает. Пока версий нет, приложение нельзя ни открыть, ни остановить — останавливать у него нечего.

Название и адрес

Это две разные вещи, и путать их не стоит.

Название — только для людей. Оно ни на что не влияет технически: его можно менять сколько угодно, ссылки от этого не ломаются и приложение не перезапускается. Правится прямо в шапке карточки кнопкой «Изменить название»; менять его вправе владелец приложения и администратор организации. Новое название появляется у зрителей при следующем открытии страницы, но не дольше чем через минуту.

Адрес — часть ссылки. Он же определяет, куда попадает человек, перешедший по вашей ссылке. Адрес меняется отдельным действием и не бесплатно по последствиям — см. «Как изменить адрес» ниже.

Каждый адрес, который когда-либо был занят, навсегда закрепляется за приложением, которое его занимало, — в том числе после переименования и после удаления приложения. Освободить адрес нельзя, и другому приложению он не достанется. Это защита от подмены: ссылка, которую вы кому-то дали, не может однажды открыть чужое содержимое.

Что показывает карточка приложения

Шапка — название, под ним адрес и полная ссылка на приложение, статус («Черновик», «Активно», «Остановлено») и режим доступа. Здесь же кнопки «Открыть приложение», «Остановить» / «Запустить» и «Изменить адрес».

«Состояние приложения» — статус, текущая версия, даты создания и обновления.

«Запуск» — как чувствует себя работающее приложение: состояние («Развёртывается», «Работает», «Нестабильно», «Остановлено», «Ошибка запуска»), версия, число перезапусков, первый запуск и последний отчёт.

«Доступ» — кто может открывать приложение (см. «Как поделиться» ниже).

«Версии» — список опубликованных версий, отметка текущей, кнопка активации другой версии и загрузка нового архива. Хранятся последние десять версий.

«Ожидающие версии» — версии, которые сейчас проверяются, и причина отказа, если проверка не прошла.

«Личные секреты» — ваши собственные ключи и токены для этого приложения, если оно их запрашивает. Значения видите только вы: платформа не показывает их ни владельцу приложения, ни другим пользователям.

«Лимиты» — платформенные ограничения приложения. Менять их вправе только администратор организации.

«Последние сообщения приложения» — свежие строки журнала приложения.

«История изменений» — кто и что делал с приложением: создание, публикация версий, смена названия и адреса, смена режима доступа, работа с секретами.

Как поделиться приложением

Кому приложение открывается, задаёт блок «Доступ»:

«Только владелец» — приложение видите и открываете только вы.

«Организация» — приложение доступно участникам вашей организации. Этот режим доступен только приложению, созданному в организации.

«Все пользователи» — приложение доступно всем, включая тех, кто не входит в вашу организацию. Переход в этот режим всегда требует явного подтверждения в диалоге, а у рядового участника организации — ещё и одобрения администратора организации. Одобрение выдаётся не на адрес, а на конкретную версию: чтобы опубликовать наружу следующую версию, её нужно одобрить заново. В организации этот режим подчиняется её политике внешнего доступа — она описана в разделе «Аккаунт, профили и организации».

Поделиться приложением можно двумя ссылками:

ссылка входа в Искре вида …/apps/enter/адрес — по ней человек сначала входит в Искру (или выбирает, в каком профиле продолжить), а потом попадает в приложение. Это штатный путь: кнопка «Открыть приложение» в карточке ведёт именно туда;

прямой адрес приложения — он показан в шапке карточки рядом с адресом. По нему человек попадает сразу на приложение.

Если у человека нет доступа, он увидит одну и ту же страницу «Приложение недоступно» с кнопкой «Войти» — независимо от того, нет ли такого приложения вовсе, закрыт ли к нему доступ или истёк ли вход. Страница одинакова во всех этих случаях специально, и название приложения на ней не показывается: иначе по ней можно было бы проверять, существует ли чужое приватное приложение и как оно называется. Название человек видит уже после проверки доступа — на странице входа в Искре.

Исключение — остановленное общедоступное приложение: его существование уже раскрыто самим публичным адресом, поэтому вместо «недоступно» показывается честное «временно недоступно».

Как изменить адрес

Кнопка «Изменить адрес» в шапке карточки открывает окно с полем нового адреса и предпросмотром будущей ссылки. Права те же, что у остановки и запуска: владелец приложения и администратор организации.

Прежде чем подтвердить, прочитайте список последствий — он показан в том же окне:

старые ссылки перестанут открываться. Переадресации со старого адреса нет: все, кому вы дали прежнюю ссылку, должны получить новую;

зрители войдут заново. Открытые сеансы приложения завершаются;

приложение перезапустится. Короткий перерыв в работе неизбежен; данные приложения при этом сохраняются — они привязаны к самому приложению, а не к адресу;

старый адрес ещё около минуты может отвечать ошибкой — платформа некоторое время его помнит. Новый адрес работает сразу; в облаке первое открытие бывает чуть дольше обычного — под новый адрес выпускается сертификат;

у общедоступного приложения адрес, который уже разошёлся, меняется, и администраторы организации получают уведомление. В карточке появляется предупреждение о том, что адрес изменён после одобрения версии.

Переименований не больше трёх в сутки на одно приложение. Счётчик обнуляется в начале следующих суток по UTC. Ограничение не косметическое: каждый занятый адрес закрепляется за приложением навсегда, а в облаке под новый адрес ещё и выпускается сертификат. Если лимит исчерпан, платформа откажет и предложит повторить позже.

Другие частые отказы: адрес уже занят другим приложением, введён текущий адрес приложения, адрес не подходит по правилам (только строчные латинские буквы, цифры и дефис, не по краям, до 63 символов).

Кто что видит

Владелец Администратор Участник приложения организации организации

только при доступе

Видит приложение в

да да «Организация» или

списке

«Все пользователи»

Открывает

да да по режиму доступа

приложение

Публикует версии и

да нет нет

активирует их

Запрашивает режим

да нет нет

«Все пользователи»

Возвращает приложение из режима «Все да да нет пользователи» обратно

Владелец Администратор Участник приложения организации организации

Меняет название и адрес, останавливает, запускает и да да нет удаляет, работает с секретами приложения

Одобряет режим «Все пользователи» нет да нет и меняет лимиты

Рядовой участник организации не видит приватного приложения коллеги вовсе — для него оно выглядит как несуществующее, а не как закрытое. Чужой черновик он не видит тоже, даже если у того выбран доступ «Организация»: пока версии нет, показывать нечего. Два пользователя без организации никогда не видят приложений друг друга.

У приложения, созданного вне организации, администратора нет: одобрять там некому, поэтому владелец включает режим «Все пользователи» сам, а лимиты остаются платформенными по умолчанию.

Приложение или доска: что выбрать

Доска показывает готовый файл — отчёт, таблицу, презентацию; приложение — это работающая программа со своим адресом, версиями, секретами и журналом.

Доска подходит, когда нужно показать результат: читатель открывает вкладку по аудитории доски и видит ту версию, которую выбрал её владелец. Приложение нужно там, где страница должна что-то делать на стороне сервера — принимать отправленную форму, обращаться к внешнему сервису, работать от имени открывшего. HTML-документ на доске так не умеет; его ограничения описаны в разделе «Доски».

Политика внешнего доступа организации действует на публичный адрес приложения: что она закрывает и когда требует нового одобрения, описано в разделе «Аккаунт, профили и организации». Досок она не касается — их внешние аудитории открывает персональное право участника «Разрешить выносить доски наружу». Одно другого не заменяет: право выносить доски наружу публичный режим приложения не открывает, а одобренное публичное приложение доску наружу не выносит.

Обзор

Навык Яндекс.Метрика показывает в чате Искры данные ваших счётчиков Метрики: посещаемость за период, источники трафика, цели и конверсии. Навык только читает статистику — счётчики, цели и настройки Метрики он не меняет.

Обзор

Навык находится в категории «Данные» каталога навыков. При включённом маркетплейсе установите его; если маркетплейс на вашем контуре выключен — включите навык в каталоге. Затем задайте личный OAuth-токен Яндекса в защищённой форме навыка (она откроется сама при первом вопросе к Метрике или из карточки навыка). Не отправляйте токен сообщением в чат.

Как получить токен:

1. Откройте oauth.yandex.ru под аккаунтом, у которого есть доступ к нужным счётчикам, и

создайте приложение. В доступах отметьте «Яндекс.Метрика — получение статистики, чтение параметров» (право metrika:read ); другие права навыку не нужны.

2. Скопируйте ClientID приложения и откройте ссылку

3. Подтвердите доступ — Яндекс покажет токен. Вставьте его в форму навыка.

Та же инструкция коротко показана в форме навыка как подсказка к полю токена — именно к ней Искра отсылает, когда просит задать или заменить токен.

Токен принадлежит вам: даже при установке навыка в организацию каждый участник задаёт свой токен и видит только свои счётчики. Токен хранится в защищённом хранилище, не показывается повторно и уходит только на api-metrika.yandex.net . Если вы отозвали токен или он перестал работать, Искра сообщит об этом и снова откроет форму, чтобы заменить его.

Обзор

Счётчики. «Какие счётчики Метрики у меня есть?» — список с названием, сайтом и правами доступа.

Посещаемость. «Сколько было посетителей на сайте за последние 30 дней?», «Как менялась посещаемость по неделям в августе?» — визиты, посетители, новые посетители, просмотры, доля отказов, глубина просмотра и средняя длительность визита; по запросу — динамика по дням, неделям или месяцам.

Источники трафика. «Откуда приходят посетители?», «Сколько трафика из поиска?» — визиты и посетители по каналам (поиск, прямые заходы, ссылки, соцсети, реклама), при необходимости с детализацией до площадки или поисковой системы.

Цели. «Какие цели настроены и сколько заявок было за месяц?» — список целей счётчика с числом достижений и конверсией за период.

Период задаётся словами («за вчера», «за последние 7 дней», «с 1 по 15 августа»); без уточнения берётся последняя неделя. Данные за текущий день в Метрике ещё неполные. Если Метрика рассчитала отчёт по выборке, Искра предупредит об этом.

Обзор

Если в аккаунте один активный счётчик, называть его не нужно. Если счётчиков несколько, назовите сайт в вопросе («посещаемость shop.example.ru за неделю») или выберите счётчик из списка, который предложит Искра. Сводку сразу по всем счётчикам навык не строит — попросите отчёт по каждому сайту отдельно.

Обзор

«Нужен OAuth-токен» — токен не задан: заполните открывшуюся форму.

«Метрика отклонила токен» — токен недействителен или отозван: получите новый по инструкции выше и замените его в форме.

«Нет прав на этот счётчик» — аккаунт Яндекса, выдавший токен, не имеет доступа к счётчику; попросите владельца счётчика выдать доступ.

«Исчерпана квота запросов» — Яндекс ограничивает число обращений к API в сутки; повторите позже.

Обзор

Текущий навык получает источники трафика и достижения целей отдельными отчётами. Для источников доступны визиты, посетители и отказы. Достижения целей и конверсия рассчитываются по всему счётчику за период, без разбивки по источникам: отдельно для поискового или рекламного трафика их получить нельзя. Навык не связывает цели с конкретной рекламной кампанией и не получает её расходы или стоимость заявки. Для атрибуции целей конкретному каналу нужна отдельная выгрузка с такой сегментацией; все достижения сайта нельзя приписывать одному каналу. Для анализа расходов и кампаний нужен Яндекс Директ — навык «Яндекс Директ — статистика кампаний»; индексацию, поисковые запросы, позиции и проблемы сайта в поиске показывает навык «Яндекс Вебмастер».

Доход от показа чужой рекламы на ваших площадках доступен через отдельный навык «РСЯ — доход от рекламы на своих площадках».

Обзор

Навык подключает к Искре файловое хранилище, которое работает по протоколу WebDAV: Nextcloud, ownCloud, Synology DSM, корпоративный Apache или nginx с включённым DAV. Агент видит список папок, ищет файлы по имени, скачивает их в разговор и загружает файлы из чата обратно на сервер. Это отдельный навык от «Диска» самой Искры (синхронизация папок с компьютера) и от будущего навыка Яндекс.Диска — в описаниях агент называет хранилище «WebDAV-сервер».

Весь протокол ведёт сервер Искры: навык не видит ваш пароль и не ходит в сеть сам. Пароль хранится в защищённом хранилище и используется только для запросов к указанному вами адресу.

Обзор

1. Узнайте адрес WebDAV у своего хранилища:

показан в настройках файлов, раздел «WebDAV»);

Synology DSM — включите пакет WebDAV Server, адрес вида

Корпоративный сервер — адрес выдаёт администратор.

2. Создайте пароль приложения, если хранилище их поддерживает (Nextcloud:

«Настройки» → «Безопасность» → «Устройства и сеансы» → «Создать новый пароль приложения»). Пароль приложения WebDAV — отдельный от паролей для почты и календаря.

3. В Искре: Витрина навыков → «Диск на своём сервере (WebDAV)» → добавить в личный

профиль → на карточке навыка нажмите «Требует настройки» (позже те же поля открывает «Подробнее» → вкладка «Настройки»). В окне «Настройки навыка» откроется группа настроек «Подключение к WebDAV-серверу»:

Название подключения — короткое имя хранилища одним словом без / , например work или nas . Пока подключение одно, оно служит только подписью карточки; когда подключений два и больше, оно становится папкой верхнего уровня в путях (см. «Несколько хранилищ»), поэтому название обязано быть годным именем папки уже сейчас;

Логин — имя пользователя на сервере;

Адрес сервера — полный адрес с путём, обязательно https:// ( http:// Искра заменит на https:// , по незащищённому протоколу подключение не пойдёт);

Пароль приложения — поле write-only: посмотреть сохранённое значение нельзя, только заменить.

4. Попросите агента проверить подключение — он вызовет check_connection и назовёт

диагноз: подключено, неверный пароль, сервер не найден или адрес заблокирован.

Организация может задать общее подключение для всех сотрудников (настройки навыка в области организации). Тогда форма перед каждой записью показывает адрес сервера, область подключения ( организация ) и логин. Для личного подключения форма показывает область профиль . Если эти настройки изменились, пока форма была открыта, Искра ничего не записывает и просит подтвердить операцию заново.

Данные подключения вводите только через форму настроек навыка. Не вставляйте пароль в переписку с агентом.

Обзор

Один установленный навык подключает до десяти хранилищ: например, корпоративный Nextcloud и домашний Synology. В форме настроек каждое подключение — отдельная карточка со своим названием; кнопка «Добавить подключение» доступна, пока не набрано десять. Хранилища равноправны, «текущего» или «главного» нет, и ни один инструмент не просит выбрать подключение — его называет путь:

Одно подключение — пути пишутся от корня хранилища: «Документы/Отчёты».

Два и больше — первая часть любого пути — название подключения: «work/ Документы/Отчёты», «home/Фото». Корень хранилища («покажи, что есть на диске») показывает названия подключений как папки верхнего уровня. Регистр букв в названии не важен: Work/Документы и work/Документы — одно и то же подключение. Названия из разных алфавитов или с разными пробельными символами, выглядящие одинаково, считаются разными.

Поиск идёт внутри одного хранилища: «найди отчёт в work». Чтобы найти файл во всех хранилищах, агент повторит поиск по каждому названию из корня.

Копирование и перемещение работают внутри одного хранилища. Чтобы перенести файл в другое, попросите скачать его в разговор и загрузить в нужное хранилище.

Форма перед записью называет подключение, сервер, область и логин. Если исправить путь в форме на другое подключение, Искра ничего не записывает и просит подтвердить операцию заново.

Проверка подключения («проверь подключения к дискам») опрашивает каждое хранилище и называет, какая коллекция подключений действует — личная или организации.

Одинаковые названия. Если два подключения названы одинаково (с учётом регистра: work и Work — одно название), оба недоступны по пути, пока одно из них не переименовано; агент называет пару и открывает форму настроек. Название с / или невидимыми символами не годится как имя папки — такое подключение показано отдельно в корне и по пути недостижимо.

Переходы. Когда к единственному подключению добавляется второе, пути меняют вид (появляется название); когда подключений снова остаётся одно, пути пишутся без названия — старый путь вида work/Документы в этом случае читается как обычная папка work оставшегося хранилища.

Обновление с прежней версии навыка. Единственное подключение, настроенное до появления названия, показано как ненастроенное, пока не введено название; пароль вводить заново не нужно.

Личные и организационные подключения не складываются. Если у организации настроены общие хранилища, а вы завели личное подключение, для вас действует только

личная коллекция — организационные хранилища перестают использоваться, пока личная коллекция существует. Предел в десять подключений считается по действующей коллекции. Форма настроек предупреждает об этом перед созданием первого личного подключения.

Обзор

Список папки — «покажи, что лежит в папке Документы»: имя, размер, дата изменения; по умолчанию до 100 записей, дальше — «показать ещё».

Поиск по имени — «найди файл со словом отчёт»: обход дерева на глубину до 3 уровней (максимум 5), не больше 500 результатов; поиска по содержимому нет.

Скачать файл — файл сохраняется в артефакты разговора и открывается в панели артефактов; предел — 8 МБ на файл.

Загрузить файл — источник только файлы текущего разговора (приложенные к сообщению или созданные агентом), до 3 МБ на файл; агент показывает форму с неизменяемым фактическим путём исходного файла, папкой назначения, редактируемым именем на сервере и галочкой «перезаписать». Загрузка идёт только по кнопке «Загрузить файл».

Создать папку — по кнопке «Создать папку» в форме.

Скопировать, переместить или переименовать — переименование это перемещение с новым именем в той же папке; перед операцией агент показывает форму с исходным и новым путём. Изменение выполняется только по кнопке формы; отмена или таймаут формы ничего не копируют и не перемещают.

Удалить — после вашего согласия в чате агент показывает форму с путём; удаление выполняется только по кнопке «Удалить безвозвратно», отмена формы ничего не удаляет. Корзины нет: удаление безвозвратно, восстановить файл через Искру нельзя.

Публичных ссылок навык не создаёт; если нужно поделиться файлом, сделайте это в интерфейсе самого хранилища.

Обзор

Поддерживаются серверы с Basic-аутентификацией по HTTPS (пароль или пароль приложения). Если сервер принимает только Digest, Kerberos или корпоративный вход через браузер, агент ответит, что такой способ входа не поддерживается — попросите администратора включить Basic по HTTPS или пароли приложений.

Сертификат сервера должен быть доверенным: самоподписанный сертификат даёт ошибку защищённого соединения.

Скачиваются файлы до 8 МБ, загружаются из чата — до 3 МБ (ограничение канала файлов разговора).

Файлы и папки адресуются путём: если сервер отдаёт версии или варианты файла через «?» в адресе, такие записи в списке не показываются.

Если сервер возвращает зарезервированный знак в адресе имени в форме, отличной от безопасного адреса следующего запроса, запись не показывается. Например, + должен приходить как %2B : эти две формы нельзя считать одним файлом на всех WebDAV-серверах и прокси. Переименуйте такой файл в интерфейсе хранилища или исправьте кодирование href на сервере.

Навык не следует перенаправлениям сервера. Если сервер отвечает на запрос перенаправлением на другой адрес, агент сообщит об этом — укажите в настройках тот адрес, который сервер считает основным.

Адрес во внутренней сети (например https://cloud.corp.local ) по умолчанию заблокирован политикой безопасности. Его должен внести администратор контура

Искры в список разрешённых внутренних серверов навыка — см. раздел «Типичные ошибки».

Обзор

Что сказал агент Причина Что делать

Форма настроек не Заполнить «Подключение к

Навык не подключён

заполнена WebDAV-серверу»

Создать пароль

Сервер отклонил логин или Неверный пароль или нужен

приложения и вставить его

пароль пароль приложения

в форму

На сервере отключён вход

Сервер требует вход через Уточнить у администратора

по паролю для внешних

браузер (SSO) хранилища

программ

Способ входа не Сервер предлагает только Включить Basic по HTTPS поддерживается Digest/Kerberos на сервере

Попросить администратора

Сервер во внутренней сети,

контура добавить хост в

Адрес во внутренней сети а администратор Искры не

настройку навыка

запрещён политикой внёс его в список

«Внутренние WebDAV-

разрешённых

серверы»

Указан не основной адрес Указать в настройках

Сервер перенаправляет

хранилища, или сервер адрес, который сервер

запрос

отдаёт вход через браузер называет основным

Назвать хранилище в пути:

Первая часть пути должна Подключений несколько, а

«work/Документы»

быть названием путь не начинается с

(названия перечислены в

подключения названия одного из них

ответе)

Два подключения названы

Названия подключений Переименовать одно из них

одинаково с точностью до

совпадают в форме настроек навыка

регистра

Исправить название в

Название подключения не В названии / , .. или

форме настроек навыка

годится как имя папки невидимые символы

(одним словом, без / )

Копирование и Скачать файл в разговор и

Путь назначения указывает

перемещение работают загрузить его в нужное

на другое хранилище

внутри одного подключения хранилище

Не удалось установить Недоверенный сертификат Проверить сертификат и защищённое соединение или не HTTPS адрес

Файл или папка уже Загрузка без перезаписи, Разрешить перезапись или существует папка или имя заняты выбрать другое имя

Скачивание больше 8 МБ Передать файл другим

Файл слишком большой

или загрузка больше 3 МБ способом

Папка только для чтения

Нет прав на это действие Проверить права на сервере

или чужая

Обзор

Пароль не покидает сервер Искры: навык получает только результат операции, а пароль отправляется только на точный адрес сервера, который вы указали. Перенаправления сервера не выполняются вовсе, поэтому пароль и файлы никогда не уходят на другой адрес — даже соседний в том же домене.

Подключение только по HTTPS; каждый адрес проверяется по IP перед соединением. Адреса внутренней сети открываются только по списку администратора контура, а служебные адреса (link-local, metadata) закрыты всегда.

В логи не попадают ни пароль, ни имена файлов, ни содержимое.

Режим «действовать без переспроса», который есть у некоторых навыков, для этого навыка не предлагается: запись и удаление всегда ждут вашей кнопки в форме. Так ошибка агента или инструкция, спрятанная в присланном документе, не может ничего удалить или перезаписать без вас.

Обзор

Искра умеет вести ваши «Планы» вместе с внешним календарём: события и задачи ходят в обе стороны. Встреча, созданная в Яндекс.Календаре, появляется в «Планах» — и наоборот, запись, заведённая в Искре, уезжает в тот календарь, который вы назначили целью.

Подключения живут в Настройки → «Календари и задачи». Вторая точка входа — подписанная кнопка с иконкой календаря в «Планах» на вкладке «Календарь», в отдельной строке над переключателем видов. Без подключений она называется «Подключить календарь». Пока список ещё не загружен и при наличии подключений видно нейтральное «Календари и задачи»; у подключений также показана пилюля общего состояния обмена.

Подключения привязаны к активному профилю: у личного профиля и у каждой организации свои календари. Переключите профиль, чтобы увидеть другие.

Если раздела нет в настройках, синхронизация на вашем контуре выключена администратором.

Обзор

Провайдер Как входит

Яндекс, Mail.ru, iCloud логин и пароль приложения

Google кнопка «Войти через Google»

Exchange Server адрес сервера, доменный логин и пароль

Другой CalDAV-сервер адрес сервера, логин, пароль приложения

Пароль приложения — не пароль от почты. У Яндекса нужен пароль категории «CalDAV для Календаря»; ссылка на инструкцию есть прямо в мастере, рядом с полем пароля. У Яндекса, Mail.ru и iCloud поля адреса сервера в мастере нет вовсе, и искать адрес не нужно: карточка сама знает адрес своей службы — https://caldav.yandex.ru у Яндекса,

Ящик на домене организации подключается той же карточкой. Почта на домене компании — это та же служба, просто адрес у вас не на её публичном домене. Выберите

карточку своей службы: Искра пойдёт прямо на её сервер, а домен вашей организации при выбранной карточке не опрашивает вовсе. Для Яндекс 360 логином служит полный адрес почты вместе с доменом организации (например, ivan@corp.ru ), паролем — пароль приложения Яндекса; обходить это через «Другой CalDAV-сервер» и вписывать адрес руками больше не нужно. У других служб логин тот, которого ждёт сама служба: у iCloud это ваш Apple ID, даже если почта приходит на адрес собственного домена.

Если вы уже подключили такой ящик через «Другой CalDAV-сервер», он продолжает работать — переключаться на карточку не обязательно. Заводить второе подключение к тому же ящику не стоит: события приедут в «Планы» дважды.

Всё сказанное про карточки относится к мастеру в «Календарях и задачах». У навыка «Календарь» — это отдельная настройка для разовых просьб в чате — карточек служб нет, и для ящика на домене организации адрес сервера там по-прежнему вписывается вручную.

Инструкция Яндекса открывается на сайте Яндекса отдельно от формы — в новой вкладке браузера, а в мобильном и настольном приложениях во внешнем браузере. Вернувшись в Искру, продолжите подключение: выбранный провайдер и введённый логин остаются в форме.

У Exchange Server всё наоборот: пароль обычный доменный, отдельного «пароля приложения» он не требует, а адрес сервера обязателен — сама Искра его не ищет. Спросите адрес EWS у системного администратора и введите его целиком, с https:// :

https:// мастер не примет. Логин работает в двух видах, DOMAIN\ivanov и ivanov@company.ru ; если один не подошёл, попробуйте второй. Если сервер внутренний и Искра отвечает, что адрес ведёт во внутреннюю сеть, его должен разрешить администратор вашего контура.

Microsoft 365 (Outlook.com, Office 365) для синхронизации не подключается — ни как CalDAV, ни карточкой Exchange Server: для разовой работы с ним есть навык «Microsoft Exchange».

Обзор

Мастер занимает три шага.

1. Провайдер. Выберите, что подключаете.

2. Данные. Введите логин и пароль (для своего сервера и для Exchange — ещё и адрес) и

нажмите «Проверить и продолжить». Искра входит в календарь и читает список календарей — это занимает до двадцати секунд. Окно можно закрыть, не дожидаясь ответа: подключение всё равно заведётся, и карточка появится в списке.

3. Календари и переключатели. Отметьте календари и списки задач, которые нужны в

Искре. По умолчанию включены основной календарь и основной список задач. У календаря, в который сервер не даёт Искре писать (чужой календарь, открытый вам на просмотр, подписка на праздники), в списке стоит пометка «только чтение»: его записи приезжают в Искру, но наружу из Искры ничего не уходит. Здесь же два переключателя:

«Отправлять в этот календарь и задачи, которые выполняет Искра» — выключен; инструкции агента туда не попадают, только сами задачи;

«Напоминать в Искре о событиях из этого календаря» — включён; напоминание придёт дважды: из календаря и из Искры. Если хватает напоминаний календаря, снимите переключатель здесь или позже в «Настроить».

Закрытие мастера на третьем шаге ничего не отменяет: подключение уже создано и останется с настройками по умолчанию.

Google

У Google свой вход: пароль приложения он не принимает.

1. На шаге «Провайдер» выберите Google.

2. Нажмите «Войти через Google» — откроется страница согласия Google.

3. Разрешите доступ к календарю. Искра вернёт вас на страницу подключений, а новая

карточка подсветится.

Искра запрашивает у Google доступ к календарю и ваш адрес почты — адресом подписывается карточка подключения. Пароль от аккаунта Google Искре не известен и не хранится.

В мобильном приложении Google не подключается: Google не разрешает вход внутри приложения. Подключите Google с компьютера в веб-версии — после этого синхронизация работает и в приложении. Пресеты с паролем приложения (Яндекс, Mail.ru, iCloud) в приложении подключаются как обычно.

Если карточки Google нет в списке провайдеров, на вашем контуре не настроен клиент Google — обратитесь к администратору.

Обзор

У провайдеров разные возможности. Ссылка «что синхронизируется» на карточке подключения раскрывает панель «Что синхронизируется» — она отвечает «да» или «нет» про это подключение по девяти пунктам: «Задачи», «Внешние участники и приглашения», «Теги ↔ категории», «Исключения серии», «Дата начала задачи», «Ссылка на созвон», «Важность», «Видимость», «Занятость».

Таблица ниже — не эта панель, а сравнение провайдеров целиком: в ней есть и то, о чём панель не спрашивает.

Яндекс / Mail.ru /

Google Exchange Server

iCloud / CalDAV

События да да да

там, где у календаря там, где у ящика

Задачи нет

есть список дел есть список задач

да, приглашения

Внешние участники

да да рассылает сам

и приглашения

Exchange

Ответ на

да да да

приглашение

нет (теги остаются в

Теги ↔ категории да да

Искре)

ссылка Meet

строкой в описании

Ссылка на созвон да читается, своя

встречи

записывается

нет (остаются в

Напоминания да да

Искре)

приезжают, но из

Исключения серии да да

Искры не уезжают

Дата начала задачи да — да

Яндекс / Mail.ru /

Google Exchange Server

iCloud / CalDAV

Важность да — да

Синхронизируются записи в окне около текущей даты — далёкое прошлое и далёкое будущее в Искру не тянутся, но и не пропадают из календаря.

Что нужно знать про Exchange Server

Напоминания остаются в Искре. Exchange их не принимает: напоминание, заведённое в Искре, в Outlook не появится. Обратной беды нет — правка встречи в Outlook напоминание Искры не стирает.

Исключения серии ходят в одну сторону. Отменённое или перенесённое вхождение, приехавшее из Exchange, Искра видит и показывает. А вот отменённое или перенесённое в Искре остаётся только в Искре. И если поменять само правило повторения, Exchange соберёт серию заново — прежние исключения этой серии в нём пропадут.

У задачи нет времени, только день. Своего времени и своей часовой зоны у задачи Exchange не бывает: задача, у которой в Искре срок со временем, станет в Exchange задачей «на весь день». Какой это календарный день, Искра считает по часовому поясу подключения — одинаково и когда отправляет задачу, и когда читает её обратно. Часовой пояс самой записи на срок задачи не влияет: две разные зоны сдвигали бы срок на сутки каждым обменом.

Ссылка на созвон едет строкой. Отдельного поля под неё у встречи Exchange нет, поэтому ссылка, заведённая в Искре, приписывается к описанию встречи строкой «Ссылка на встречу: …» и оттуда же читается обратно. Ссылку собственного онлайн-совещания Exchange Искра просто читает.

Повторяющаяся запись в редкой часовой зоне может не уехать. Если зону записи нечем назвать так, чтобы её понял Exchange, такая повторяющаяся запись остаётся в Искре и попадает в «не удалось синхронизировать»; остальной календарь при этом продолжает обмениваться, а одиночная встреча уезжает.

Запись «на весь день» без названной часовой зоны может съехать на сутки, если часовой пояс почтового ящика отличается от часового пояса подключения. Часовой пояс подключения меняется в «Настроить».

Обзор

Блок «Куда попадают новые записи» называет календарь для новых событий и список для новых задач. Пока цель вида не выбрана, ею становится первый включённый подходящий календарь — так об этом и говорит подсказка блока. Это происходит и когда подходящих календарей несколько: Искра берёт первый по названию, а не спрашивает, — поэтому, подключив несколько календарей, выберите цель сами. Вариант «Оставлять только в Искре» оставляет новые записи этого вида в Искре.

Снимете галочку с календаря, который был целью, — цель опустеет, и соседний календарь Искра взамен не подставит. Вы просили убрать этот календарь, а не переселить свои записи в другой. В блоке «Куда попадают новые записи» у этого вида окажется «Оставлять только в Искре»: новые события (или задачи) будут оставаться в Искре, пока вы сами не выберете календарь. Если они должны уезжать в другой календарь, выберите его в этом блоке сразу после того, как закроете «Настроить». В мастере подключения это правило не действует: если на последнем шаге вы сняли предложенный календарь и включили другой, после «Готово» целью станет первый включённый подходящий календарь этого подключения — как и обещает подпись под списком.

Отдельную запись можно отвязать от календаря: в карточке записи — «не синхронизировать». Это не способ убрать запись: ничего не удаляется ни здесь, ни там — запись остаётся в Искре, объект остаётся в календаре, они просто перестают обмениваться изменениями.

И держится отвязка недолго. Об этом говорит само окно отвязки: обмен прекращается «до тех пор, пока эта запись снова не приедет из календаря». Приедет она при первом же изменении в календаре или когда подключение перечитает его целиком, — и Искра свяжет их заново. А если у этого вида записей назначена цель («Куда попадают новые записи»), запись без связи считается новой и уезжает в целевой календарь ближайшим обменом. Держать запись в стороне от календаря отвязкой не получится.

Записи из календаря только для чтения правятся в нём самом: время, название, место, напоминания и внешние участники меняются там, а в Искре у такой записи правятся проект, теги, внутренние участники, уведомления и работа Искры. Удалить её в Искре тоже нельзя — она вернулась бы следующим обменом. Убрать такие записи из «Планов» можно только целым календарём: снимите его галочку в «Настроить» — всё, что из него приехало, Искра удалит у себя, а сам календарь не тронет. «Не синхронизировать» для этого не годится: запись остаётся на месте.

Теги такой записи остаются вашими. При первом появлении записи в Искре её тегами становятся категории календаря, а дальше теги принадлежат вам: обмен их больше не переписывает, даже если в календаре у записи поменяли категории. У обычного календаря теги и категории по-прежнему ходят в обе стороны.

Обзор

Обмен двусторонний, поэтому запись, ушедшая из «Планов», уходит и из календаря. Объект во внешнем календаре удаляется, когда связанная с ним запись:

удалена в Искре;

отменена кнопкой «Отменить» или отклонена вами кнопкой «Отклонить» — для календаря это то же самое, что удаление;

перестала попадать под переключатель «Отправлять в этот календарь и задачи, которые выполняет Искра». Выключенный переключатель не просто перестаёт отправлять новое: работа Искры, уже уехавшая в этот календарь, из него стирается.

У Exchange удаление встречи с приглашёнными — это ещё и письма об отмене: рассылает их сам сервер, живым людям.

Обратный случай — «Отключить» и снятая галочка календаря: они убирают записи из Искры и во внешнем календаре не удаляют ничего.

Удалённую в Искре запись обратно не приведут ни «Синхронизировать сейчас», ни пауза с возобновлением, ни повторный вход. Искра запоминает удаление: обычный обмен продолжает работать, но удалённую запись не пересоздаёт — иначе любое удаление тут же отменял бы следующий обмен. Поможет ли переподключить тот же календарь заново, видно по самому календарю: если объекта там уже нет, переподключение запись не вернёт; если объект ещё виден (например, синхронизация стояла на паузе и удаление не успело до него доехать), он цел — после переподключения запись вернётся в «Планы», когда объект снова приедет в Искру.

Отменённая и отклонённая запись — не удалённая: стёрт только объект в календаре, но из обычных списков «Планов» такая запись тоже уходит, и обратно её не включить. Восстановление объекта на стороне календаря прежнюю запись не вернёт; если запись снова нужна — создайте её заново.

Задачи работы Искры при выключенном переключателе не удаляются: верните переключатель — и текущие задачи заново уедут в тот календарь, который сейчас выбран

для задач в блоке «Куда попадают новые записи».

Вернуть удалённую по ошибке запись можно двумя способами. Если ваш календарь умеет восстанавливать удалённое — например, у него есть корзина на сайте, — восстановите объект там: когда он снова приедет в Искру, запись вернётся в «Планы». Если восстановить нечем, создайте запись заново.

Обзор

Пилюля на карточке говорит, что происходит:

Синхронизируется — обмен идёт;

На паузе — вы приостановили обмен кнопкой «Пауза»;

Ошибка — обмен не удался; причина написана словами под подписью;

Нужно войти заново — доступ больше не действует.

Действия карточки: «Синхронизировать сейчас», «Пауза» / «Возобновить», «Настроить» (подпись, календари, переключатели, часовой пояс) и «Отключить». «Синхронизировать сейчас» показывается, только когда обмен идёт или прерван ошибкой: на паузе и при «Нужно войти заново» подключение в обмен не берётся вовсе, и кнопки там нет — сначала «Возобновить» или вход.

«Нужно войти заново» чинится одной кнопкой:

у Google — «Войти заново»: это то же согласие, что и при первом подключении. Так бывает, если вы отозвали доступ Искре в настройках аккаунта Google или сменили пароль. Календари и настройки подключения при этом сохраняются;

у остальных — «Ввести пароль»: новый пароль приложения. Искра сначала проверит его и только потом сохранит, поэтому опечатка не сотрёт рабочий пароль.

Если несколько записей не удалось синхронизировать, карточка скажет об этом и даст ссылку «показать» — она откроет эти записи в «Планах».

Обзор

Список календарей Искра перечитывает не сама по себе, а когда вы нажимаете «Обновить список» в «Настроить», подключаете календарь заново или входите заново. Если к этому моменту календаря у сервера больше нет — его удалили, переименовали или у вас забрали доступ, — Искра снимет с него галочку сама, а всё, что из него приехало, останется в «Планах» на месте. Записи не удаляются: пропажа календаря из ответа чужого сервера — не ваш жест, и стирать по ней ваши события и задачи Искра не станет.

Что вы увидите: календарь остался в списке «Настроить», но без галочки, и обмен по нему стоит. Если он был целью для новых записей, блок «Куда попадают новые записи» скажет об этом прямо: «Цель — „…“, но этот календарь выключен: новые записи туда не попадают — выберите другой».

Что делать: календарь вернулся — поставьте галочку обратно, и обмен продолжится с того же места. Не вернулся — выберите другую цель для новых записей. Записи, приехавшие из пропавшего календаря, так и останутся в «Планах»: чтобы убрать их из Искры, отключите подключение целиком.

Обзор

«Отключить» удаляет из Искры события и задачи, пришедшие из этого календаря, вместе с их напоминаниями в Пульсе. Записи, созданные в Искре, останутся, но перестанут синхронизироваться. Во внешнем календаре не удаляется ничего.

Обзор

Пароль приложения и доступ к Google хранятся в защищённом хранилище контура: их нельзя увидеть ни на странице, ни через API — только заменить. Искра ходит только к тому адресу, который вы назвали, и только по HTTPS.

Обзор

Доски доступны, если эта возможность включена на вашей установке. Если её временно отключили, раздел, публикация и ранее выданные ссылки недоступны; файлы и сами доски сохраняются.

Доска — отдельная страница, на которой вы показываете готовые файлы людям за пределами чата: коллеге, руководителю, заказчику. На доску попадают только те файлы, которые вы на неё положили: переписка, соседние папки и настройки чата читателю не видны.

Доска состоит из вкладок. Одна вкладка — один файл: HTML-отчёт, текст, таблица, презентация. У доски одно название, один владелец и одна аудитория — круг людей, которые её открывают.

Как опубликовать файл на доске

1. В панели файлов чата откройте меню файла (кнопка «⋯») и выберите «Опубликовать

на доске».

2. В форме выберите «Создать новую доску» и введите название либо «Выбрать

доску» из тех, которыми вы уже управляете. Для поиска по названию есть строка «Поиск доски».

3. Новая доска создаётся с аудиторией «Только я»: её не видит никто, пока вы сами не

измените аудиторию. Даже если файл лежит в проекте, доска остаётся закрытой.

4. Форма показывает рабочий контекст будущей доски — личное пространство или

организацию. Личной доской управляете только вы; доской в организации управляете вы и администратор организации. Контекст выбирается один раз и потом не меняется.

5. Для каждого файла выберите режим версии: «Следовать файлу» или

«Зафиксировать версию».

6. Нажмите «Проверить размещение». Откроется экран «Что получат читатели»:

название доски, аудитория, вкладки с режимом версии и счётчик «Вкладок на доске: … из …». Предел числа вкладок задан для контура и зависит от аудитории доски.

7. Нажмите «Разместить». Появится «Размещение выполнено» и число новых вкладок.

Подтверждение действует ограниченное время — форма показывает, до какого момента. Если срок истёк, подготовьте размещение заново: старое согласие на изменившийся материал не переносится. Если за это время доска изменилась, форма сообщает об этом и показывает обновлённое размещение.

Один файл занимает на доске одну вкладку. Повторная публикация того же файла на ту же доску второй вкладки не создаёт: экран «Что получат читатели» отмечает такой файл подписью «Файл уже размещён на этой доске: повторная вкладка не появится».

Рядом с файлом в панели файлов и в предпросмотре появляется отметка о размещении: «Размещён на доске» или «Размещён на досках: …», а также «Зафиксированная версия», «Показана версия от …» и «Исходник изменён …», когда исходник ушёл вперёд показанной версии. «Читатели ещё не видят изменения» означает, что им по-прежнему доступна прежняя версия. Если часть нынешних читателей не получает материал вовсе, отметка сообщает об этом отдельно и предлагает обновить показанную версию в окне «Доступ».

Состояние подготовки показано рядом: «Готовится к публикации», «Нужна подготовка вкладки», «Превышен лимит доски», «Размещение остановлено» или «Исходник удалён». Например, при превышенном лимите прежняя готовая версия может оставаться доступной — сама причина задержки не означает, что читатели ничего не получают.

Какую версию файла видят читатели доски

У каждой вкладки свой режим версии. Для аудиторий «Только я», «Организация» и «Группа» он определяет, что открывает читатель:

Режим Что видит читатель

Последнюю сохранённую и

«Следовать файлу»

подготовленную к показу версию файла

Ту версию, которую вы закрепили, пока

«Зафиксировать версию»

фиксация не снята

Для внешних аудиторий — «Адресно» и «По ссылке» — действует показанная версия всей доски: готовый снимок вкладок на момент открытия внешнего доступа. Это относится и к личным доскам. Последующие сохранения исходников и добавление вкладок сами этот снимок не меняют, даже в режиме «Следовать файлу».

Когда изменения готовы, владелец открывает «Доступ» и нажимает «Обновить показанную версию». Секретная ссылка и приглашения сохраняются, читателям становится доступен новый снимок доски. Если вкладка ещё не готова к показу, окно сообщит об этом: завершите подготовку и повторите обновление. У зафиксированной вкладки снимок по-прежнему возьмёт закреплённую версию.

Искра сохраняет и промежуточные правки: конец ответа ещё не означает, что документ готов. Для внутренней аудитории фиксация позволяет удержать готовый результат, пока вы продолжаете работу над исходником. Для внешней аудитории публикуйте обновлённый снимок после завершения правок.

Режим меняется в списке досок: «Зафиксировать версию» закрепляет ту версию, которую читатели получают сейчас, а «Снять фиксацию» возвращает следование за файлом. Во внешней аудитории после снятия фиксации обновите показанную версию, чтобы читатели получили изменения.

Открытая страница не подменяет документ у читателя посреди чтения. Пока вкладка браузера видима, страница примерно раз в полминуты спрашивает доску; когда появилась новая редакция, читатель видит «Доска обновилась» и кнопку «Показать новую редакцию». Скачивание и копия тоже отдают ту версию, которая показана на экране, а не внезапно обновившийся исходник.

Кто видит доску: пять аудиторий

Аудитория Кто открывает доску

Владелец доски. Так создаётся каждая

«Только я»

новая доска

Действующие участники организации,

«Организация»

которой принадлежит доска

Участники выбранной группы этой же

«Группа»

организации

Аудитория Кто открывает доску

Люди, приглашённые по адресу почты: доска открывается после входа или

«Адресно»

регистрации в Искре с этим подтверждённым адресом

Любой, у кого есть секретная ссылка; она

«По ссылке»

открывается без входа

Аудитория одна на всю доску: все её вкладки видит один и тот же круг людей. Если материалы предназначены разным получателям, сделайте отдельные доски. Аудитории «Организация» и «Группа» есть у доски организации; личной доске предлагаются «Только я», «Адресно» и «По ссылке».

Аудиторию меняет человек — кнопка «Доступ» у доски. Выбор режима сам по себе доступа не меняет, его применяет отдельное действие. Приглашение отправляется кнопкой «Пригласить», а секретная ссылка выдаётся кнопкой «Выпустить ссылку».

У приглашения есть срок, до которого его нужно принять; отзыв приглашения окончателен — вернуть доступ можно только новым приглашением. У доски одна действующая секретная ссылка: перевыпуск закрывает прежнюю сразу, и по ней доска больше не открывается. Секрет ссылки показывается один раз — скопируйте его сразу; для получателя есть готовый адрес.

Срока у секретной ссылки нет: она работает, пока вы её не отозвали и не перевыпустили, — так и написано в окне доступа. Исключение одно: ссылке доски организации срок ставит потолок, заданный на вашей платформе теми, кто её обслуживает, — не организацией и не вами; в окне доступа тогда видно, до какого момента ссылка действует.

Право читать файл — это ещё не право его распространять. Если источник файла запрещает распространение, доска его не покажет и сообщит об этом.

Внешний показ доски организации — «Адресно» и «По ссылке» — открывает персональное право участника «Разрешить выносить доски наружу». Его выдают владелец и администратор организации в списке сотрудников; у самих владельца и администратора это право есть по роли. Пока права нет, окно доступа так и говорит: выносить доски наружу разрешает владелец или администратор организации — попросите у них это право. Личная доска права не требует, её внешние аудитории работают сразу.

Право спрашивается при каждом открытии доски и относится к её нынешнему владельцу. Поэтому отзыв права закрывает читателям все внешние доски этого человека сразу, а доски коллеги, у которого право есть, продолжают работать. Передача доски тому, у кого права нет, закрывает её так же; передача обратно — возвращает.

Отзыв закрывает доступ к доске, но не забирает уже скачанный файл: копию, которая уже у получателя, вернуть нельзя.

Где найти свои доски

Откройте «Настройки» → «Публичные ссылки» → вкладка «Доски». Там собраны все доски, которыми вы управляете, включая закрытые: «Только я», доски организации и доски группы. Есть поиск по названию и фильтры по аудитории и состоянию — действующие или удалённые доски.

Карточка доски показывает аудиторию, владельца, дату обновления, число вкладок и отметку «ссылка выдана». Кнопка «Показать состав доски» раскрывает вкладки: здесь переименовывают доску и вкладки, меняют порядок кнопками «Выше» и «Ниже», фиксируют версию и снимают размещение.

«Снять размещение» закрывает ссылку вкладки, а сам файл остаётся у вас; возвращение файла на доску создаёт новую вкладку. «Удалить доску» закрывает её ссылки и выдачу сразу, исходники остаются на месте. Удалённую доску видно по фильтру «Удалённые доски», и её можно восстановить — она вернётся частной, а прежние секретные ссылки не оживут.

Доски, связанные с разговором, видны прямо в чате — в блоке «Доски разговора» панели запроса.

Что видит читатель доски

В шапке — название доски и её вкладки, у материала — владелец, режим версии у автора и время, когда показанная версия попала на доску. Название вкладки может отличаться от имени файла.

HTML открывается как документ, текстовый файл — текстом, остальные форматы — карточкой с кнопкой «Скачать файл». Вкладки переключаются без перезагрузки страницы, кнопки «назад» и «вперёд» в браузере работают ожидаемо, а при большом числе вкладок есть список «Все вкладки». Одновременно работает только открытая вкладка: соседние документы в фоне не выполняются.

Владелец на постоянном адресе видит кнопку «Управлять доской» и переходит к управлению прямо со страницы. Внизу доски, открытой по секретной ссылке, стоит подпись «Сделано в Искре».

Если доска открыта, но готовых вкладок в ней ещё нет, читатель видит «Показывать пока нечего».

Скачивание файла и копия себе

«Скачать файл» отдаёт именно показанную версию вкладки.

«Скопировать в мой чат» создаёт вашу собственную копию показанной версии: файл появляется в ваших файлах, а ссылка «Открыть копию» ведёт в папку, куда он лёг. Дальше это ваш файл — его можно править и обсуждать с Искрой, исходник автора при этом не меняется.

Копируется одна вкладка. Соседние вкладки, переписка автора, приглашения и ссылка на доску в копию не попадают, как и место в документе, открытое сейчас на экране. Копия занимает место в вашем хранилище: если места не хватает, Искра попросит освободить его и повторить, а слишком большой файл предложит скачать вместо копирования.

Доску, открытую по секретной ссылке, читать можно без входа, а копия сохраняется в ваши файлы — для неё нужен вход. Кнопка «Войти и скопировать» запоминает вкладку и версию, и после входа копия создаётся сама.

Ссылка на вкладку и место в документе

Постоянный адрес доски выглядит как /boards/<доска>/tabs/<вкладка> , адрес по секретной ссылке — /b/<токен>/tabs/<вкладка> . В адресе только идентификаторы, поэтому переименование доски, вкладки или файла его не меняет. Адрес доски без вкладки открывает первую доступную вкладку.

Кнопка «Скопировать ссылку» даёт адрес вкладки. Если документ сам сообщает, где вы находитесь — на каком слайде или с каким фильтром, — появляется «Скопировать ссылку с этим местом в документе»: к адресу добавляется часть #state=… . Подпись показывает, какой именно адрес скопируется: в фильтре может оказаться значение, которое вы не хотели бы отправлять. Получатель ссылки всё равно проходит обычную проверку доступа к доске.

Неверная, отозванная или истёкшая ссылка не раскрывает название доски. Если ссылка вела на вкладку, которой больше нет, страница предлагает открыть доску целиком.

Что умеет HTML-документ на доске и чего не умеет

Внутри документа работает его собственная разметка, стили и скрипты: фильтры, вкладки, слайды, диаграммы и расчёты по данным, которые лежат в самом файле.

Документ на доске не ходит в сеть. Запросы к сайтам и сервисам, отправка форм и всплывающие окна в нём не работают, и он не видит ваш профиль, переписку и соседние вкладки доски. Форма заявки внутри HTML не отправится: для неё сделайте Приложение.

Поэтому до читателей доходит только самодостаточный документ: всё, что он показывает, лежит в самом файле. Внешний адрес — это картинка с чужого сайта, картинка по соседнему пути вроде logo.png , адрес картинки в стилях ( background-image: url(…) ) и обычная ссылка на сайт или на почту. Найденные в документе переходы наружу перечислены на экране «Что получат читатели» в блоке «Переходы наружу» — проверьте его до размещения.

Одного внешнего адреса хватает, чтобы вкладка до читателей не дошла: она остаётся с отметкой «Готовится к публикации» или «Нужна подготовка вкладки», и читатель, открывший такую вкладку, документа не получает. Само размещение при этом проходит, и вкладка видна в ряду вкладок доски. Если вкладка уже показывала прежнюю версию, читатели остаются на ней, а новая до них не доходит.

Выход — версия файла без внешних адресов: попросите Искру встроить картинки прямо в файл, а адреса, которые нужны читателю, оставить обычным текстом. Ссылки из документа на соседние файлы доски не работают — доска не является веб-каталогом.

Если вы хотите, чтобы ссылка открывалась на нужном месте документа, попросите Искру записывать это место в адрес: документ читает его из строки запроса и якоря адреса, а меняет обычными ссылками вида #раздел либо через History API ( pushState / replaceState ). Тогда «Скопировать ссылку с этим местом в документе» откроет у получателя тот же слайд или фильтр. Само приложение не угадывает внутренние переменные документа.

Как доработать файл, размещённый на доске

Материал, размещённый на доске, остаётся обычным файлом, и его можно дорабатывать дальше. Там, где показано размещение файла, — например, в карточке файла в разделе «Память», — тому, кто вправе менять исходник, предлагается «Доработать в чате»: выберите доску и разговор — доска свяжется с разговором, а папка файла подключится к контексту этого разговора. Если подходящего разговора нет, выберите «Новый разговор»: беседа заведётся, и доска свяжется с ней, как только вы отправите первое сообщение.

Новая доска, созданная публикацией из беседы, связывается с этим разговором сама и сразу появляется в блоке «Доски разговора». Связь возникает только у доски, рождённой в этом разговоре: размещение файла на уже существующей доске разговор с ней не связывает — свяжите её сами через «Доработать в чате», если хотите видеть её в блоке. Доска, размещённая из одного чата, в соседнем разговоре сама не возникает; общая папка, общий исходник и общий проект связью не являются.

Дальше работайте как обычно: внутренняя аудитория увидит новую готовую версию вкладки в режиме «Следовать файлу». Для «Адресно» и «По ссылке» после правок откройте «Доступ» и обновите показанную версию. Зафиксированная вкладка останется на прежней версии, пока вы не снимете фиксацию.

Читателю, у которого нет права менять исходник, доступна копия: «Скопировать в мой чат» и дальнейшая работа со своим файлом.

Что делать, если доска не открывается

«Показ версии закрыт сроком» — нажмите «Обновить доску»: сервер покажет действующую версию.

«Войдите, чтобы открыть эту доску» — доска закрыта для незнакомого читателя; войдите под тем профилем, которому она доступна.

«Выдача этой доски на сегодня исчерпана» — дневной предел выдачи доски или её контекста; попробуйте позже.

«Этот файл открывается только скачиванием» — формат не показывается на странице, скачайте файл.

Ссылка больше не работает — владелец перевыпустил или отозвал её, либо организация больше не разрешает её владельцу выносить доски наружу. Попросите у владельца новую ссылку.

Обзор

Для владельцев сайтов и приложений, размещающих рекламу РСЯ: доход, показы и клики по вашим площадкам. Искра получает статистику заработка на размещении рекламы: итоги за выбранный период и динамику по дням, по всему кабинету или одной площадке. Навык только читает данные.

РСЯ, Директ, Метрика и Вебмастер: какой сервис нужен

Источник данных и возможности

Ваша задача

навыков Искры

Навык Яндекс Директ — статистика

Оценить рекламу, за которую вы платите:

кампаний. Текущий навык РСЯ эти данные

кампании, расходы, стоимость заявки

не получает

Навык Яндекс.Метрика. Источники и цели

Узнать посещаемость сайта, источники получаются отдельными отчётами; трафика и достижения целей конверсия каждой рекламной кампании в

текущем навыке не рассчитывается

Навык Яндекс Вебмастер: ИКС, страницы в

Проверить индексацию, позиции и ошибки

поиске, проблемы, поисковые запросы и их

сайта в поиске Яндекса

динамика

Узнать доход от показа рекламы на ваших

Этот навык РСЯ

сайтах и в приложениях

«Клики по рекламе Яндекс Директа» в статистике РСЯ относятся к рекламе на ваших площадках. Это не отчёт о расходах ваших рекламных кампаний.

Подключение РСЯ и получение OAuth-токена

1. Откройте кабинет РСЯ под аккаунтом, зарегистрированным в Рекламной сети

Яндекса. Если предлагается регистрация, сначала завершите подключение к РСЯ. Обычный Яндекс ID или кабинет рекламодателя Директа сами по себе не подтверждают доступ к статистике РСЯ. Для отчёта с показателями у площадок должна накопиться статистика.

2. Найдите «РСЯ — доход от рекламы на своих площадках» в категории «Данные»

каталога навыков и установите. Если маркетплейс на вашем контуре выключен, включите навык в каталоге.

3. Откройте официальную инструкцию API статистики, перейдите по ссылке получения

токена для статистики и войдите под аккаунтом из первого шага. Другой официальный путь: в кабинете РСЯ справа нажмите значок API → «Получить OAuth-

токен для API статистики». Токен API настройки блоков предназначен для другой задачи.

4. Вставьте только значение токена в поле rsya_oauth_token защищённой формы

навыка: без префикса OAuth , кавычек и пробелов. Форма доступна из карточки навыка; при запросе данных с пустым или отклонённым токеном Искра предложит открыть её из чата. Токен вводится в поле формы, а не сообщением в чат.

5. Сохраните настройку и напишите «Проверь подключение РСЯ» либо повторите запрос

отчёта с датами. Сохранение токена ещё не означает успешный доступ: его подтверждает ответ API на проверку подключения.

В официальной ссылке получения токена уже указан client_id — идентификатор OAuth-приложения из документации Яндекса. Это не ваш секрет. Ссылку используют как есть; создавать собственное приложение по инструкции Метрики для этого способа подключения РСЯ не требуется.

Если у вас есть единый OAuth-токен для Метрики, Wordstat или Директа, наличие этих прав само по себе не подтверждает доступ к статистике РСЯ. Проверить сохранённый токен можно запросом подключения; при отказе используйте официальный способ получения токена статистики РСЯ выше.

Токен хранится для текущего профиля и используется только для обращений к partner.yandex.ru . При установке в организацию каждый участник подключает собственный токен. Отозванный токен можно заменить в той же форме, после сохранения нужно повторить запрос.

Примеры вопросов

«Покажи доход РСЯ, показы и клики за 1–31 августа 2026 года, с динамикой по дням».

«Какие площадки встречаются в статистике РСЯ за август 2026 года?»

«Покажи статистику площадки 458472 за 1–7 августа 2026 года».

Указывайте конкретный период и, если нужна одна площадка, её ID из списка. Искра получает доступные названия показателей из вашего кабинета: если источник разделяет виды кликов, в ответе сохраняется этот вид, например «клики по рекламе Яндекс Директа».

Как читать результат

Доход указан в рублях без НДС, дни — по московскому времени. В ответе должны быть выбранные даты и охват: весь кабинет или конкретная площадка. Данные текущего дня могут ещё пополняться.

Список охватывает площадки со статистикой за выбранный период. Площадки без активности могут в него не попасть; полный состав кабинета проверяйте в интерфейсе РСЯ.

Если источник не предоставляет показатель или его значение отсутствует, Искра сообщает, что он недоступен. Это отличается от числового нуля. Пустой отчёт означает отсутствие данных за выбранные даты и площадку. Успешное подключение подтверждает доступ к API; наличие статистики за конкретный период проверяется отдельно. Искра сообщает об отсутствии строк, сохраняя выбранный период и охват отчёта.

Ошибки подключения РСЯ и получения отчёта

Токен не настроен, содержит лишние символы или отклонён — заполните или обновите его в форме. После замены повторите свой запрос.

Нет доступа (HTTP 403) — откройте кабинет под аккаунтом выдачи токена и проверьте права; при необходимости уточните их у владельца кабинета или поддержки РСЯ.

Ресурс не найден (HTTP 404) — сохранённый токен использован для запроса, но этот ответ сам по себе не доказывает, что токен неверный или аккаунт не зарегистрирован. Откройте partner.yandex.ru под аккаунтом токена: если показана регистрация, завершите подключение; если кабинет доступен, обратитесь в поддержку РСЯ с кодом HTTP 404. Внутренний request_id Искры предназначен для поддержки Искры. До уточнения причины сохранённый токен можно оставить без изменений. Автоматическое повторение запроса причину не устраняет.

Превышена частота запросов или источник временно недоступен — повторите позже.

Отчёт получен не полностью — сначала выполните рекомендацию по причине ошибки: например, проверьте доступ или замените отклонённый токен в форме. Если причина — объём выгрузки, сузьте период и повторите запрос. Неполная выгрузка не выдаётся за итог.

Показатель недоступен для такого отчёта — выберите доступный показатель по предложенной Искрой схеме; для разных групп она может сделать несколько запросов за одни и те же даты.

Схема статистики слишком велика — посмотрите полный список показателей в кабинете РСЯ. Если схема превышает допустимый размер, навык отказывает в её передаче вместо обрезанного списка.

Обзор

Навык Яндекс Вебмастер показывает в чате Искры, как ваш сайт живёт в поиске Яндекса: какие сайты подтверждены в аккаунте, индекс качества сайта (ИКС), сколько страниц в поиске и сколько исключено, какие проблемы нашёл Вебмастер, по каким запросам сайт показывается и как менялись показы, клики и ИКС. Навык только читает данные — сайты, права, переобход и sitemap он не меняет.

Обзор

Навык находится в категории «Данные» каталога навыков. При включённом маркетплейсе установите его; если маркетплейс на вашем контуре выключен — включите навык в каталоге. Затем задайте личный OAuth-токен Яндекса в защищённой форме навыка (она откроется сама при первом вопросе к Вебмастеру или из карточки навыка). Не отправляйте токен сообщением в чат.

Как получить токен:

1. Откройте oauth.yandex.ru под аккаунтом, в котором подтверждены нужные сайты, и

создайте приложение: платформа «Веб-сервисы», Redirect URI

Вебмастера «Получение информации о сайтах» ( webmaster:hostinfo ); право на добавление сайтов навыку не нужно.

2. Скопируйте ClientID приложения и откройте ссылку

3. Подтвердите доступ — Яндекс покажет токен. Вставьте его в форму навыка.

Та же инструкция коротко показана в форме навыка как подсказка к полю токена — именно к ней Искра отсылает, когда просит задать или заменить токен. Заявка на доступ к API, в отличие от Яндекс Директа, не требуется.

Токен принадлежит вам: даже при установке навыка в организацию каждый участник задаёт свой токен и видит только сайты своего аккаунта. Токен действует полгода, хранится в защищённом хранилище, не показывается повторно и уходит только на

api.webmaster.yandex.net . Если вы отозвали токен или он перестал работать, Искра сообщит об этом и снова откроет форму.

Обзор

Сайты. «Какие сайты у меня в Вебмастере?» — список с адресом, признаком подтверждения и главным зеркалом, если оно другое.

Сводка сайта. «Какой ИКС у example.ru?», «Сколько страниц в поиске и какие проблемы у сайта?» — индекс качества, страницы в поиске и исключённые, число проблем по уровням (фатальные, критичные, возможные проблемы, рекомендации) и перечень текущих проблем с датой появления.

Поисковые запросы. «По каким запросам показывается сайт?», «Какие запросы дают клики и на каких позициях?» — популярные запросы за период с показами, кликами и средними позициями показа и клика, с фильтром по типу устройства.

Динамика. «Как менялись показы за месяц?», «Как менялся ИКС за квартал?» — ряд по дням для показов, кликов или ИКС.

Период задаётся календарными датами («с 1 по 30 августа 2026»); без уточнения Вебмастер берёт последнюю неделю, а фактические границы периода Искра показывает в ответе. Если у показателя нет данных, Искра так и скажет, а не подставит ноль.

Обзор

Если в аккаунте один подтверждённый сайт, называть его не нужно. Если сайтов несколько, назовите адрес в вопросе («ИКС example.ru», «проблемы https://www.example.ru») или выберите сайт из списка, который предложит Искра. Адреса с http:// , https:// и www в Вебмастере — разные сайты: полный адрес со схемой выбирается точно, домен без схемы — по имени сайта. Если у сайта в аккаунте объявлено главное зеркало, данные берутся у зеркала, и Искра отмечает это в ответе. Сводку сразу по всем сайтам навык не строит — попросите отчёт по каждому сайту отдельно.

Обзор

«Нужен OAuth-токен» — токен не задан: заполните открывшуюся форму.

«Вебмастер отклонил токен» — токен недействителен или отозван: получите новый по инструкции выше и замените его в форме.

«Нет права webmaster:hostinfo» — токен выдан приложением без нужного доступа: отметьте право в настройках приложения и получите токен заново.

«Права на сайт не подтверждены» — сайт есть в аккаунте, но права на него не подтверждены в Вебмастере; данные доступны только подтверждённым сайтам.

«Сайт ещё не загружен или не проиндексирован» — Вебмастер пока не собрал данные; если у сайта объявлено другое главное зеркало, Искра назовёт его.

«Исчерпана квота запросов» — Яндекс ограничивает число обращений к API в сутки; повторите позже.

Обзор

Посещаемость сайта, источники трафика и цели — навык «Яндекс.Метрика». Расходы рекламодателя, кампании и стоимость заявки относятся к Яндекс Директу. Доход от показа чужой рекламы на ваших площадках — навык «РСЯ — доход от рекламы на своих площадках».

Обзор

Для рекламодателей Яндекс Директа: список кампаний с их состоянием и ключевыми целями, расходы без НДС, показы, клики, CTR, средняя цена клика, конверсии по целям Метрики и стоимость заявки за период. Искра показывает итоги за выбранные даты, динамику по дням и разбивку по кампаниям — по всему кабинету или по выбранным кампаниям. Навык только читает статистику: кампании, ставки и бюджеты он не меняет.

Директ, РСЯ, Метрика и Вебмастер: какой сервис нужен

Источник данных и возможности

Ваша задача

навыков Искры

Оценить рекламу, за которую вы платите:

Этот навык Яндекс Директа

кампании, расходы, стоимость заявки

Навык РСЯ — доход от рекламы на своих

Узнать доход от показа рекламы на ваших

площадках. Расходы и кампании

сайтах и в приложениях

рекламодателя он не получает

Навык Яндекс.Метрика. Оттуда же удобно

Узнать посещаемость сайта, источники

взять ID цели, которую вы считаете

трафика и достижения целей

заявкой

Проверить индексацию, позиции и ошибки Яндекс Вебмастер. Эти сведения не входят сайта в поиске Яндекса в навыки Директа, РСЯ и Метрики

Конверсии в отчёте Директа считаются по целям Яндекс.Метрики, привязанным к кампаниям. Посещаемость и источники трафика сайта целиком остаются в навыке Метрики.

Подключение Директа: своё приложение и токен

Директ выдаёт доступ к API приложению, а не пользователю, поэтому токен получают через собственное OAuth-приложение. Искра своё приложение в Директе не регистрирует.

1. Откройте oauth.yandex.ru под аккаунтом рекламодателя и создайте приложение. В

доступах отметьте «Использование API Яндекс Директа» (право direct:api ); другие права навыку не нужны.

2. В интерфейсе Директа подайте заявку на доступ к API для этого приложения: раздел

«Настройки API» → «Мои заявки». Заявка рассматривается в рабочие дни от часа до трёх суток, в пиковые периоды — до семи. До одобрения токен приложения к статистике не допускается.

рекламодателя и подтвердите доступ — Яндекс покажет токен. ID приложения указан в его карточке на oauth.yandex.ru.

4. Найдите «Яндекс Директ — статистика кампаний» в категории «Данные» каталога

навыков и установите. Если маркетплейс на вашем контуре выключен, включите навык в каталоге. В защищённой форме навыка заполните два поля:

«Окружение API Директа» — оставьте production : это рабочий кабинет рекламодателя. Значение sandbox выбирают только для проверки приложения в песочнице Директа с тестовыми кампаниями; в песочнице отчёт строится по одной кампании.

«OAuth-токен» — вставьте только значение токена, без префикса Bearer , кавычек и пробелов. Токен вводится в поле формы, а не сообщением в чат. Форма доступна из карточки навыка; при запросе с пустым или отклонённым токеном Искра предложит открыть её из чата.

5. Сохраните настройку и напишите «Покажи мои кампании в Директе». Успешный

список кампаний подтверждает подключение: токен принят и приложение допущено к API. Сохранение токена само по себе доступ ещё не доказывает.

Если заявка приложения ещё не одобрена, Директ отвечает ошибкой 58 «Незавершенная регистрация» ( app_not_approved ). Это не ошибка токена: менять или перевыпускать его не нужно — дождитесь решения по заявке и повторите запрос. Искра в этом случае форму не открывает, а напоминает о порядке рассмотрения.

Токен хранится для текущего профиля и уходит только на выбранный хост API Директа —

навыка в организацию каждый участник подключает собственный токен и видит только свои кампании. Отозванный токен можно заменить в той же форме, после сохранения нужно повторить запрос. Агентские аккаунты Директа с выбором клиента (заголовок Client-Login ) навык не поддерживает: статистика читается по кабинету, которому принадлежит токен.

Примеры вопросов

«Какие кампании есть в моём Директе и какие из них активны?»

«Сколько потратили за прошлую неделю и сколько было кликов и заявок?»

«Сравни стоимость заявки по кампаниям за август 2026 года».

«Покажи расходы и клики по дням за 1–31 августа 2026 года».

Указывайте календарный период; если нужны отдельные кампании, назовите их — Искра найдёт их в списке кампаний по названию, а при совпадениях уточнит, какие именно имеются в виду. Для вопросов о заявках Искра берёт ключевую цель кампании из списка кампаний или спрашивает, какую цель считать заявкой.

Как читать результат

Расходы указаны без НДС в валюте кабинета — валюту Искра берёт из настроек вашего кабинета Директа. Даты периода включительно; один отчёт охватывает не более 366 дней, более длинный период Искра разбивает на несколько запросов. В ответе должны быть выбранный период, охват (весь кабинет или конкретные кампании), валюта и пометка «без НДС».

Конверсии считаются только по отдельным целям Метрики: «заявка» — это одна конкретная цель. Ею служит ключевая цель кампании из списка кампаний или та цель, которую назовёте вы. При сравнении кампаний с разными ключевыми целями стоимость заявки каждой кампании считается по её собственной цели. Искра не складывает конверсии разных целей: одно событие на сайте может достигать нескольких целей, и такая сумма не равна числу заявок. Если цель не указана, показывается агрегат Директа «по всем целям» — Искра называет его именно так. Конверсии считаются по модели атрибуции LC (последний переход).

Если источник не отдал показатель, Искра сообщает, что он недоступен, и указывает, в скольких строках отчёта значения нет. Это отличается от числового нуля: «недоступно» в итогах означает, что сумма по периоду не получена, а не что заявок не было. Пустой отчёт означает отсутствие строк за выбранный период и охват; Искра сообщает об этом, сохраняя период и охват.

CTR, среднюю цену клика, стоимость заявки и конверсию Искра считает сама из итоговых сумм отчёта — показов, кликов, расходов и конверсий выбранной цели. При нулевом знаменателе (нет кликов или конверсий) показатель помечается недоступным, а не нулём.

Очередь отчётов Директа

Большие отчёты Директ формирует не сразу, а в очереди. Искра ждёт готовности до нескольких минут и затем показывает результат. Если ответ содержит «отчёт ещё

формируется» ( report_pending ), повторите тот же запрос примерно через минуту — Искра продолжит ожидание того же отчёта, а не закажет новый. В очереди Директа одновременно находится не больше пяти отчётов одного пользователя; готовые отчёты Директ хранит пять часов.

Ошибки подключения и отчёта

Токен не настроен, содержит лишние символы или отклонён ( not_configured , invalid_token , token_rejected ) — заполните или обновите токен в защищённой форме, она откроется из чата. После сохранения повторите свой запрос.

Приложение не допущено к API ( app_not_approved , ошибка 58 «Незавершенная регистрация») — заявка на доступ к API для вашего приложения ещё не одобрена. Токен менять не нужно; дождитесь решения по заявке в разделе «Настройки API» → «Мои заявки» Директа.

Аккаунт не подключён к Директу ( login_not_registered , ошибка 513) — токен получен под аккаунтом, у которого нет кабинета рекламодателя. Получите токен под аккаунтом с кабинетом Директа и замените его в форме.

Нет прав ( access_denied ) — приложению или аккаунту запрещён доступ к запрошенным данным. Проверьте права приложения и аккаунта в Директе; при необходимости обратитесь к владельцу кабинета или в поддержку Яндекса.

Исчерпан суточный лимит баллов ( units_exhausted ) — Директ ограничивает число обращений к API баллами, которые обновляются раз в сутки. Повторите запрос позже.

Превышена частота запросов ( rate_limited ) — повторите позже.

Очередь отчётов заполнена ( queue_full ) — в очереди Директа уже пять ваших отчётов. Дождитесь их готовности и повторите запрос.

Отчёт ещё формируется ( report_pending ) — повторите тот же запрос через минуту, Искра продолжит тот же отчёт.

Директ не успел сформировать отчёт ( report_timeout , HTTP 502) — сузьте период или число кампаний и повторите запрос.

Директ отклонил параметры запроса ( invalid_request ) — Искра сообщит, что именно не принято. В песочнице отчёт строится по одной кампании: укажите одну кампанию.

Источник временно недоступен ( source_error ) — Директ ответил ошибкой сервера или ответ не удалось получить. Повторите позже; для обращения в поддержку Яндекса Искра сообщает идентификатор запроса, если Директ его вернул.

Отчёт слишком велик ( report_too_large ) — сузьте период или попросите отчёт по выбранным кампаниям, а не по всему кабинету. Частичный итог не показывается.

Ответ источника не разобран ( invalid_response ) — Директ вернул отчёт в неожиданном виде, и Искра отказалась показывать его частично. Повторите запрос; при повторении ошибки обратитесь в поддержку Искры.

Обзор

Навык GitHub позволяет работать с выбранным репозиторием из чата: читать и скачивать файлы, готовить commit, создавать и изменять issues и pull requests (PR), оставлять комментарии и reviews, смотреть результаты CI и сливать PR. Искра действует от вашего имени и в пределах прав вашего GitHub-токена. Каждое изменение требует отдельного решения в форме подтверждения.

Подключение

1. Откройте «Навыки» → «Каталог», найдите GitHub и установите его в личный

профиль. Если каталог в вашей Искре выключен, включите GitHub в списке доступных

навыков. Подключение всегда личное: даже установка организацией не заменяет токен каждого пользователя.

2. Создайте в GitHub personal access token (PAT). Для подходящих ему задач используйте

fine-grained token: выберите владельца, нужные репозитории, срок действия и права только для своих операций. Порядок создания описан в инструкции GitHub.

3. Откройте настройки навыка и введите PAT в защищённое поле подключения GitHub.

Токен вводится только в эту форму: не вставляйте его в чат, файлы или комментарии. Искра не возвращает значение токена в ответах, созданных файлах и обычных журналах.

4. При желании задайте репозиторий по умолчанию в полном виде owner/repository и

ветку по умолчанию. Без них назовите репозиторий и нужную ветку в поручении; Искра не подставляет main или master .

5. Попросите: «Проверь подключение GitHub и выбери репозиторий my-team/project ».

При выборе нового репозитория проверьте его полное имя в форме.

Минимальные права зависят от действия:

Задача Права fine-grained PAT

Читать файлы и историю Contents: Read-only

Создавать ветки, изменять файлы и

Contents: Read and write

делать commit; сливать PR

Читать issues Issues: Read-only

Создавать и править issues, комментарии,

Issues: Read and write

метки и исполнителей

Читать PR, их изменения и reviews Pull requests: Read-only

Создавать и править PR, комментировать и

Pull requests: Read and write

отправлять review

Читать запуски GitHub Actions, задания и

Actions: Read-only

логи

Administration: Read and write и

Создавать репозитории разрешение владельца создавать

репозитории

Права токена не расширяют ваши права в GitHub. Организация может требовать одобрения токена; до одобрения доступ к закрытым репозиториям не появится. Для classic PAT организация с SSO может требовать отдельной авторизации токена. Для отдельных видов проверок, fork и изменений файлов workflow GitHub может потребовать дополнительные права или другой поддерживаемый тип токена. Сверяйтесь с правами конкретных API GitHub, если доступ к части действий отклонён.

Навык работает с вашим PAT и не списывает отдельные МТ за обращение к GitHub. Обычная работа Искры в чате учитывается по условиям вашего плана. И облачной, и установленной у вас Искре нужен сетевой доступ к GitHub.com и сервисам GitHub для интеграции; изолированный контур без такого доступа подключиться не сможет.

Выбор репозитория и чтение

Искра обращается к репозиторию, который вы выбрали в настройках или подтвердили для этого профиля. В результате она указывает полное имя owner/repository и, когда действие связано с файлами, ветку или версию. Перед записью проверьте их в форме: одинаковое короткое имя бывает у разных владельцев.

Примеры поручений:

«В my-team/project , ветка release , покажи README и последние commits».

«Найди открытые issues про экспорт в my-team/project ».

«Покажи diff, reviews и результаты проверок PR №42 в my-team/project ».

«Покажи неуспешные задания последнего запуска CI и конец их логов».

Скачанный файл появляется среди артефактов чата. Предел одного файла — 3 МиБ; слишком большой файл Искра отклонит до сохранения. Каталог показывает содержимое запрошенной папки, а не обязательно всё дерево репозитория. Списки и логи могут приходить частями: признаки has_more или truncated означают неполную выдачу. Попросите следующую страницу или сузьте запрос; отсутствие объекта в таком ответе не доказывает, что объекта нет.

Изменения и подтверждение

Для записи Искра сначала показывает форму с репозиторием, целью и точными изменениями. Проверьте её и подтвердите действие. Отказ, закрытие формы или отсутствие ответа не отправляют запись. Установка навыка и режим его включения не заменяют это подтверждение.

Репозитории и ветки: создание репозитория, fork или новой ветки с явно показанным исходным commit и местом назначения.

Файлы: добавление, изменение, удаление и переименование одним commit. Можно использовать файл текущего чата. Форма показывает пути, изменения, исходную версию ветки и сообщение commit; для двоичных файлов — размер и контрольную сумму. Одна операция включает до 20 изменений и до 3 МиБ новых данных. Если вершина ветки изменилась после подготовки, весь commit отклоняется: нужно получить свежую версию и заново подтвердить изменения.

Issues и PR: создание, редактирование заголовка и описания, смена состояния, обычные комментарии. У issues можно добавлять и снимать метки и исполнителей; неуказанные метки и исполнители сохраняются. Логин исполнителя в форме показан в нижнем регистре: GitHub не различает регистр логина, и в этом же виде Искра сверяет результат.

Review: чтение обсуждений и отправка review PR целиком. Создание построчных комментариев в незавершённом review пока недоступно.

Merge: отдельное подтверждение конкретной версии PR и способа слияния. Если вершина PR изменилась, слияние отклоняется. Правила защиты веток, необходимые проверки и права GitHub продолжают действовать.

Несколько действий, например закрыть issue и добавить метку, подтверждаются по отдельности. Искра не обещает общую транзакцию для разных действий. Успешный результат содержит ссылку на объект или commit и наблюдаемый итог.

Конфликт заголовка или описания

Перед изменением title/body Искра показывает прежний и новый текст, затем снова проверяет объект. Если он уже изменился, запись останавливается до отправки. После отправки Искра перечитывает результат и сообщает о выявленном расхождении.

Для этих полей GitHub не даёт такой же проверки версии при записи, как для файлового commit. Между последним чтением и изменением остаётся короткое окно: чужая одновременная правка может быть перезаписана, и это не всегда удастся обнаружить. Для совместно редактируемого текста согласуйте работу с коллегами; при расхождении откройте ссылку и сравните актуальный текст. Искра не делает автоматический откат или повторную перезапись.

Если исход неизвестен

Связь может оборваться после того, как GitHub уже выполнил действие. Тогда Искра сообщает «исход неизвестен», сохраняет сведения об операции и проверяет GitHub чтением. Попросите «проверь результат этой операции»; если у вас есть ссылка на созданный объект, приложите её для проверки. Это не запускает действие повторно.

Неполный список, отсутствие найденного совпадения или неоднозначный ответ не превращают неизвестный исход в неуспех. Если вам нужно другое самостоятельное действие, выберите в форме новое независимое действие и подтвердите его полное содержание. Прежний неизвестный исход останется сохранённым; новая операция не отменяет его и может добавить ещё один объект в GitHub.

Если Искра сообщает, что место для истории операций исчерпано, новая запись не отправляется. Сохраните сообщение и обратитесь к администратору; ранее неизвестные исходы при этом не сбрасываются.

Если во время открытой формы подключить другой аккаунт GitHub, подтверждённое действие не отправляется: форма и её содержимое собраны на прежнем подключении. Повторите просьбу — Искра соберёт форму заново под текущий аккаунт.

Ограничения и ошибки доступа

Первая версия работает с GitHub.com через PAT. OAuth-вход, GitHub Enterprise, запуск или перезапуск workflows, удаление репозитория и фоновая синхронизация не входят в её возможности. Читать результаты GitHub Actions можно.

При отказе доступа проверьте срок PAT, выбранного владельца и репозитории, права на нужное действие, одобрение организации и правила защиты ветки. Показывайте поддержке текст ошибки без токена. При ограничении частоты запросов дождитесь указанного GitHub срока; неизвестную запись сначала проверяйте чтением. Искра не повторяет часть записи и не откатывает её автоматически.