Приложения

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

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

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

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

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

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

Мои и доступные приложения

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

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

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

Каждая группа показывает по четыре ряда карточек: до 12 приложений на широком экране, 8 при двух колонках и 4 при одной. В виде строк на странице четыре приложения. Если приложений больше, под группой появляются номера страниц, стрелки и диапазон показанных приложений. Группы листаются независимо; смена сортировки, вида или ширины экрана возвращает их на первую страницу.

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

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

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

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

Заказать разработку у команды Искры

Под списком есть блок «Разработаем приложение для вас» — он доступен и до создания первого приложения, и когда у вас уже есть приложения. Нажмите значок письма с подсказкой «Написать команде» или адрес mail@iskra.bot.ru: откроется ваш почтовый клиент с готовой темой и шаблоном письма. Письмо содержит короткое приветствие и место для описания задачи.

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

Как создать приложение

Раздел отмечен Beta и работает в тестовом режиме. Искра может создавать приложения, но при разработке и публикации пока возможны сложности. Если создание в чате не получилось, поручите разработку внешнему ИИ-агенту.

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

Задать название и адрес черновика

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

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

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

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

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

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

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

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

Создать приложение по запросу в чате

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

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

Сборка из чата выполняется без доступа к интернету. Нужные материалы приложите к запросу.

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

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

Приложение, связанное с беседой

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

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

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

Чем наполнить черновик

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

• «Создать в чате» — открывает чат со сценарием создания приложения; название, адрес и само приложение уже подставлены в заготовку запроса, поэтому Искра не будет спрашивать их заново. Отправьте заготовку запроса после дополнения своей идеей. Искра уточнит задачу и после отдельного подтверждения создаст файлы, проверит и опубликует версию сюда, а исходники оставит вам. Кнопка есть, только если создание приложений из чата включено на платформе.
• «Загрузить архив» — открывает окно выбора двух ZIP: архива для запуска (iskra-app pack) и авторских исходников (iskra-app source-pack). Кнопка публикации становится доступна после выбора обоих файлов. Номер версии платформа возьмёт из app.json. После проверки убедитесь, что версия стала текущей; одна готовность ещё не подтверждает активацию.

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

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

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

Подготовить приложение во внешней среде

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

Для публикации во внешней среде понадобятся пакет @iskra/apps, команды iskra-app init → check → publish, адрес платформы и API-ключ с правом «Публикация приложений» (apps:publish). В публичном README SDK есть установка, примеры и авторские инструкции; ссылку можно передать своему агенту. Минимальный SDK для публикации с обязательными исходниками — 0.1.5, требуется Node.js 24. Право публикации выбирается явно при создании ключа; если его нет в списке, обратитесь к администратору платформы. Подробнее — в главе «API-ключи».

publish --path ./app автоматически собирает и отправляет архив для запуска и исходники. Уже подготовленный ZIP можно отправить через --bundle, без повторной сборки:

export ISKRA_API_URL='https://iskra.example'
export ISKRA_API_KEY='isk_…'
npx iskra-app publish --bundle ./app.zip --source ./app-source.zip
npx iskra-app status --app-id UUID --version 1.0.0
npx iskra-app access --app-id UUID --access public

Без --app-id публикация создаёт приложение; с ним загружает новую версию в уже существующее ваше приложение. Подставьте полученный идентификатор вместо UUID, а в status — номер принятой версии. Для следующей публикации обновите номер в app.json, пересоберите ZIP и выполните npx iskra-app publish --bundle ./app.zip --source ./app-source.zip --app-id UUID. --bundle требует --source и используется отдельно от --path, --output и --closed. По умолчанию версия автоматически становится текущей после успешной проверки; --no-activate оставляет её готовой для последующей активации владельцем.

Команда access меняет доступ на private, org или public. Она доступна только владельцу приложения. Для org нужен профиль организации, для public — действующее право внешней публикации и активное приложение с текущей готовой версией. Публикация следующей версии сама доступ не меняет.

При отказе архива API возвращает безопасные подсказки в params: reason — категория ошибки, path — файл ZIP, field — известное поле манифеста, message — что исправить. Путь и поле присутствуют, когда их удалось определить. Например, неверный entry указывает на app.json и поле entry; повреждённый ZIP имеет другую категорию. CLI сохраняет эти поля в машинном ответе.

Проверить готовность и текущую версию

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

• ready — версия проверена. Стала ли она текущей, показывают отметка в «Версиях» и поля activated и current_version в результате публикации.
• ready_not_active — версия готова, но текущая не изменилась. Например, при подготовке публичного приложения у владельца отозвали право внешней публикации. После возврата права владелец явно активирует сохранённую готовую версию.
• probing — проверка принятой версии ещё идёт. Проверяйте её по тем же идентификатору приложения и номеру версии; повторять создание или публикацию вслепую не нужно.

CLI ждёт результат до пяти минут. Если после принятия версии ожидание закончилось с probing, выполните status для того же приложения и версии. Если ответ на отправку потерян (app_publication_unknown), приложение могло быть создано: сначала найдите его в разделе «Приложения» и проверьте состояние. CLI повторно архив не отправляет.

API может вернуть viewer_base_url; в результате CLI-публикации поле называется viewerBaseUrl. Это адрес открытия приложения. Его наличие само по себе не подтверждает готовность версии или её активацию.

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

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

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

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

Перед отправкой SDK проверяет совместимость установки. При source_contract_unavailable обновите установку или проверьте её адрес: публикация ещё не отправлялась. При source_project_incomplete перенесите указанный модуль в src и повторите сборку.

Скачать исходники версии

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

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

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

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

Продолжить разработку по исходникам

Кнопка «Доработать в чате» подготавливает новый черновик с запросом и авторским архивом выбранной версии, если исходники сохранены с ней. Дождитесь загрузки ZIP и опишите правки. Если у версии нет архива, вернитесь в чат создания либо скачайте оттуда свежий адрес-source.zip и приложите его вручную. Искра проверяет архив до распаковки и изменения.

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

Как приложение выглядит при открытии

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

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

В шапке приложения видны его название и пользователь, от имени которого оно открыто. Ссылка «Iskra Apps» возвращает к списку приложений.

Шапка появляется у приложений, которые собраны или пересобраны с новой версией пакета @iskra/apps. Приложение, опубликованное раньше, показывает её после того, как вы загрузите его новую версию (для созданных в чате — после доработки).

Название и адрес

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

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

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

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

Что показывает карточка приложения

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

• Шапка — название, под ним адрес и полная ссылка на приложение, статус («Черновик», «Активно», «Остановлено») и режим доступа.
• Панель значков — действия с приложением одной строкой; у каждого значка есть подсказка. Какие значки видны, зависит от ваших прав и состояния приложения:
  • «Открыть в новой вкладке» — открывает приложение;
  • «Скопировать ссылку» — копирует прямую ссылку публичного приложения или ссылку входа …/apps/enter/адрес для остальных аудиторий;
  • «Остановить» / «Запустить»;
  • «Изменить название» — правка названия на месте;
  • «Изменить адрес» — окно смены адреса (см. ниже);
  • «Загрузить новую версию» — окно выбора архива для запуска и исходников новой версии;
  • «Доработать в чате» — открывает новый черновик с заготовкой запроса и архивом исходников текущей версии, если он сохранён. Дождитесь загрузки ZIP и допишите, что изменить. Если архив не сохранился при публикации, можно продолжить в чате создания или приложить авторский архив вручную;
  • «Удалить».
• Состояние запуска — версия, состояние запуска («Развёртывается», «Работает», «Нестабильно», «Остановлено», «Ошибка запуска»), число перезапусков, время последнего отчёта и дата обновления. Здесь же можно проверить дату создания.
• «Доступ» — пять аудиторий и их настройки (см. «Как поделиться» ниже).
• «Параметры использования искусственного интеллекта» — выбор плательщика владельцем приложения; расположен под доступом.
• «Версии» — список опубликованных версий, отметка текущей и кнопка активации другой версии. Владелец может нажать «Доработать в чате» у нужной версии, включая неактивную: именно её исходники попадут в новый чат, а текущая версия приложения останется прежней. Хранятся последние десять готовых версий и текущая версия, если она старше этой десятки; сохранённые исходники хранятся вместе с ними.
• «Ожидающие версии» — версии, которые сейчас проверяются, и причина отказа, если проверка не прошла.
• «Личные секреты» — ваши собственные ключи и токены для этого приложения, если оно их запрашивает. Они сохраняются отдельно для выбранного профиля. После сохранения платформа показывает только заполненность слота, само значение повторно не отображается.
• «Внешние подключения» — отдельный блок с переключателем ограничения и списком доменов. Его меняет владелец приложения или администратор его организации.
• «Последние сообщения приложения», «История изменений» и «Лимиты приложения» — свёрнутые блоки; раскройте нужный щелчком по заголовку. В истории — кто и что делал с приложением: создание, публикация версий, смена названия и адреса, смена режима доступа, сетевых настроек, работа с секретами. Лимиты меняет только администратор организации.

Доработка с исходниками

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

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

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

Подготовка архива использует обычную загрузку файлов: нужен доступный тариф и достаточно свободного места в момент загрузки. Архив исходников ограничен 64 MiB; платформа и поставляемые тарифы допускают до 512 MiB на один файл. Отдельно действует предел 1000 файлов в рабочей области чата. В свежем чате обычно остаётся место для 997 файлов проекта после учёта служебных файлов и двух архивов. Допустимый архив приложения может содержать до 2000 записей: это не гарантирует его импорт в чат. При превышении бюджета распаковка не начинается; скачайте исходники и продолжите через SDK во внешней среде. При нехватке места сообщение не отправится: освободите место и повторите загрузку либо явно продолжите без архива.

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

Разобраться с ошибкой приложения

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

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

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

Остановить, запустить или удалить приложение

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

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

Список приложений

Приложения в списке показаны компактными карточками. Кнопки «Карточками» и «Строками» над списком переключают вид: строки ещё плотнее и удобны, когда приложений много; выбранный вид запоминается в этом браузере. Работающее приложение открывается нажатием на карточку в новой вкладке. Рядом есть значки «Настроить приложение» и «Скопировать ссылку». У черновика, остановленного или недоступного приложения нажатие на карточку открывает настройки. У публичного приложения копируется прямой адрес; у остальных — ссылка входа …/apps/enter/адрес.

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

Данные приложения

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

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

Объём хранилища ограничен настройкой «Лимиты приложения». Подключения к внешним сервисам настраиваются отдельно в блоке «Внешние подключения». Обе настройки описаны ниже.

Ключи, лимиты и владелец

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

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

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

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

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

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

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

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

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

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

Внешние подключения

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

Выключатель «Ограничить внешние подключения» задаёт три состояния:

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

Для ограничения введите до 32 доменов, по одному на строку, например analytics.example.com, без https://, пути, порта, IP-адресов и звёздочек. Нажмите «Сохранить» в этом блоке; «Отменить» вернёт сохранённые настройки. Изменение может вызвать краткий перезапуск приложения, его данные сохранятся. Внутренние адреса и служебная инфраструктура Искры защищены при любом режиме. Для входа во внешнюю систему приложению по-прежнему могут понадобиться общие или личные ключи.

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

Плательщик ИИ в приложении: кто платит и что оплачивает

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

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

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

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

Как поделиться приложением

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

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

Если право публикации отозвано

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

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

Передать ссылку читателю

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

• ссылка входа в Искре вида …/apps/enter/адрес — по ней человек сначала входит в Искру (или выбирает, в каком профиле продолжить), а потом попадает в приложение. для публичного приложения эта ссылка также работает без обязательного входа;
• прямой адрес приложения — он показан в шапке карточки рядом с адресом. Для публичного приложения значки открытия и копирования используют этот адрес; регистрация в Искре не требуется. Собственная авторизация ранее созданного приложения при этом сохраняется, пока его автор не обновит код.

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

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

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

Как изменить адрес

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

Прежде чем подтвердить, прочитайте список последствий — он показан в том же окне:

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

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

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

Кто что видит

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

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

Приложение или доска: что выбрать

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

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

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