Версии готового решения

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

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

Исходный проект

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

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

Как создать версию

Нажмите «Создать версию».
Проверьте пояснение в окне создания черновика.
Нажмите «Создать».

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

Что настроить в черновике

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

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

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

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

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

Замена ресурсов

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

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

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

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

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

Удаление черновика

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

Как опубликовать

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

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

Публикация в каталоге

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

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

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

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

Статусы версии

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

Уже установленные решения

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

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

Доступ разработчика к диалогам

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

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

Если действие недоступно

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