Версии готового решения
Версия определяет состав ресурсов готового решения, шаги первой установки и действия при переходе существующей установки на этот выпуск. Автор явно выбирает агентов, сегменты, лендинги и триггеры, а нужные им MCP-серверы, материалы базы знаний, собственные метрики и переменные кабинет добавляет как зависимости. Для новой установки и обновления используется опубликованная версия с наибольшим номером.
На странице версий видны все выпуски и их состояния. Нажмите нужную версию, чтобы открыть её состав и доступные действия.
Исходный проект
Исходный проект — рабочий проект автора, из которого готовое решение берёт ресурсы. Если его ещё нет, нажмите «Создать проект». После создания проект можно открыть через его название в верхней части страницы.
Сначала настройте нужные ресурсы в исходном проекте. Если агент или лендинг изменён, опубликуйте его рабочую версию до публикации версии готового решения: готовое решение получает опубликованное состояние, а не незавершённые правки.
Как создать версию
- Если черновика ещё нет, нажмите «Создать».
- Проверьте пояснение в окне создания черновика.
- Нажмите «Создать». Если черновик уже существует, вместо создания нажмите «Продолжить черновик».
У готового решения может быть только один черновик. Если он уже существует, действие создания открывает его. Иначе кабинет присваивает следующий номер и переносит в новый черновик ресурсы и шаги установки последней опубликованной версии. Шаги обновления относятся только к конкретному выпуску и не копируются. Описание изменений остаётся пустым, а способ обновления по умолчанию — «После подтверждения».
Что настроить в черновике
На странице версии выберите способ применения обновления. Режим «После подтверждения» оставляет запуск обновления пользователю и разрешает добавить шаги обновления. Режим «Автоматически» обновляет установку без подтверждения, только если все версии между установленной и новой отмечены как автоматические. В автоматической версии нельзя добавлять шаги обновления, а набор шагов установки должен полностью совпадать с предыдущей опубликованной версией. Она также не может удалять установленные ресурсы или требовать от пользователя повторного подключения MCP и перенастройки подписки кнопки лендинга. Для таких изменений используйте режим «После подтверждения».
Заполните описание изменений и нажмите «Сохранить». Пишите о том, что изменится для пользователя: новые возможности, изменённые настройки, важные ограничения и действия после обновления.
В блоке ресурсов выберите тип основного ресурса, откройте поле выбора, при необходимости используйте поиск, отметьте нужный ресурс и нажмите «Добавить ресурс». Явно можно выбрать агента, сегмент, лендинг или триггер.
Кабинет сам добавляет зависимости и помечает, для какого ресурса или шага они нужны. Это могут быть сегменты, используемые кнопкой лендинга или триггером, MCP-серверы и источники базы знаний агента, собственные метрики, папки базы знаний и переменные проекта или лида. Автоматическую зависимость нельзя удалить отдельно: измените или удалите основной ресурс либо шаг, которому она нужна. Неактивный источник отмечается предупреждением, а удалённый или недоступный источник нужно исправить до публикации.
Не меняйте имя, тип или ограничения уже выпущенной переменной, сохраняя её как прежний ресурс: установленное готовое решение может уже хранить значение в старом формате. Для несовместимого изменения создайте новую переменную в исходном проекте и переведите ресурсы и шаги готового решения на неё.
Замена ресурсов
Замена нужна, когда новый ресурс должен занять место прежнего и сохранить ID уже установленных копий. В строке исходного ресурса нажмите «Заменить». Затем выберите новый источник того же типа в поле «Заменить на» и подтвердите действие кнопкой «Заменить».
Каждая замена применяется отдельно. После неё кабинет сразу пересчитывает автоматические зависимости, поэтому проверьте обновлённый состав ресурсов перед следующей заменой или публикацией. Кнопка недоступна, пока загружаются исходные ресурсы или когда в исходном проекте нет другого доступного ресурса того же типа.
Удаление основного ресурса исключает его и больше не нужные зависимости. Если агент используется шагом установки, сначала измените или удалите такой шаг.
В блоке «Шаги установки» нажмите «Добавить шаг», если действие нужно выполнить при первой установке этой версии. Существующий шаг открывается для редактирования, а удаление шага доступно прямо в списке. Типы шагов и их поля описаны в статье «Шаги установки».
В блоке «Шаги обновления» добавляйте только действия для проектов, которые переходят на эту версию с предыдущего выпуска. Эти шаги не показываются при новой установке и разрешены только в режиме «После подтверждения». Подробнее — в статье «Шаги обновления».
Менять режим обновления, описание, ресурсы и шаги можно только в черновике. Опубликованную версию не редактируют: для следующего выпуска создайте новый черновик.
Удаление черновика
Действие «Удалить черновик» удаляет ресурсы, описание и шаги только этого черновика. Опубликованные версии и уже установленные готовые решения не меняются. Действие требует подтверждения; после удаления можно создать новый черновик из последней опубликованной версии.
Как опубликовать
Перед публикацией оставьте в версии хотя бы один основной ресурс, проверьте итоговый состав, недоступные зависимости и шаги, а у изменённых агентов и лендингов опубликуйте рабочие версии. Затем нажмите «Опубликовать». Для этого действия, помимо управления версиями, нужно право публикации версий готового решения.
После публикации версия с наибольшим номером становится доступной для новых установок и обновлений. Версия с режимом «После подтверждения» ждёт действия пользователя и при необходимости проводит его через шаги обновления. Автоматическое обновление выполняется только по непрерывной цепочке автоматических версий.
Публикация в каталоге
Публикация версии и публикация карточки готового решения в каталоге — разные этапы. После выпуска первой версии откройте общие настройки готового решения и используйте кнопку отправки на модерацию. Этот же блок находится в общих настройках приложений остальных типов.
После одобрения через действие видимости готовое решение можно скрывать из каталога и показывать снова без повторной модерации. Подробнее требования всех типов описаны в разделе «Публикация в каталоге».
Статусы версии
- Черновик. Версию можно собирать и редактировать, но установить её в другой проект нельзя.
- Опубликована. Версия участвует в выборе актуального выпуска для установки и обновления.
Черновик можно удалить: это не затрагивает опубликованные версии и существующие установки. Опубликованную версию удалить отдельно нельзя — она остаётся неизменяемой частью истории готового решения, в том числе для уже установивших её проектов.
Удаление самого готового решения — отдельное действие. Готовое решение исчезает из кабинета и каталога, все его установки удаляются вместе с созданными ими ресурсами в проектах пользователей. Черновики и опубликованные версии сохраняются во внутреннем хранилище как часть истории готового решения.
Уже установленные готовые решения
Обновиться можно только до самой новой опубликованной версии. Кабинет последовательно синхронизирует ресурсы всех пропущенных выпусков и показывает шаги обновления каждого из них. Шаги установки повторно не запускаются. Выбор произвольной старой версии и откат на предыдущую версию не поддерживаются.
Перед ручным обновлением пользователь видит описание выпуска и последствия, которые потребуют внимания: удаление ресурса, повторное подключение доступа к MCP или повторную настройку подписки у кнопки лендинга. Автоматические версии применяются в фоне только по непрерывной автоматической цепочке без ручной границы.
Доступ разработчика к диалогам
Владелец устанавливающего проекта отдельно решает, выдавать ли разработчику доступ к диалогам готового решения. При установке доступ включён по умолчанию, но пользователь может выключить его до установки или позже на странице установленного готового решения. Автор готового решения не управляет этим выбором за чужой проект. Это не полные права на проект: разработчик видит только диалоги, в которых участвовали агенты готового решения.
Автор также может скрыть настройки установленных агентов. В таком случае пользователь проекта видит сообщение «Настройки скрыты» и может тестировать агента, но не менять его конфигурацию.