Публикации
Публикации -- это механизм версионирования проекта, позволяющий создавать неизменяемые снапшоты (снимки) всех компонентов проекта и предоставлять к ним доступ через публичный API. Публикация фиксирует состояние проекта в конкретный момент времени: все рабочие процессы, агенты, функции и MCP-серверы.
Зачем нужны публикации
- Версионирование -- каждая публикация получает номер версии; вы всегда знаете, какая именно конфигурация работает в продакшне
- Стабильность -- опубликованная версия не меняется при редактировании проекта; ваш API будет работать стабильно, пока вы не активируете новую версию
- Откат -- при обнаружении проблем можно мгновенно переключиться на предыдущую рабочую версию
- Доступ через API -- только опубликованные рабочие процессы доступны для вызова через публичный API
Что включает снапшот
При создании публикации платформа собирает полный снапшот проекта:
| Компонент | Описание |
|---|---|
| Рабочие процессы | Все рабочие процессы с нодами, связями и конфигурацией |
| Агенты | Все агенты с настройками модели, промптами и инструментами |
| Функции | Все активные функции с кодом и параметрами |
| MCP-серверы | Конфигурация всех MCP-серверов |
| Память | Данные памяти проекта и организации (опционально) |
Снапшот является неизменяемым. Любые изменения, внесенные в проект после публикации, не влияют на уже опубликованную версию. Для обновления API необходимо создать новую публикацию.
Концепция версий
Нумерация
Каждая публикация имеет порядковый номер версии (1, 2, 3, ...). Платформа автоматически предлагает следующий номер. При желании вы можете использовать семантическое версионирование (например, 1.0.0, 1.1.0, 2.0.0).
Активная версия
В каждый момент времени может быть только одна активная версия. Именно активная публикация обслуживает запросы через публичный API. Остальные версии сохраняются в истории.
Жизненный цикл
- Создание -- вы создаете публикацию, указывая версию и примечания
- Активация -- новая публикация автоматически становится активной (или вы можете активировать любую версию вручную)
- Использование -- API-запросы обслуживаются активной версией
- Деактивация -- при активации другой версии текущая становится неактивной
- Удаление -- неактивные версии можно удалить (активную -- нельзя)
Страница публикаций
Страница Публикации в разделе текстовых агентов отображает все версии в виде таблицы:
| Столбец | Описание |
|---|---|
| Версия | Номер версии (активная помечена иконкой ракеты) |
| Статус | Активная (зеленый тег) или Неактивная |
| Создано | Дата и время создания |
| Автор | Имя пользователя, создавшего публикацию |
| Примечания к выпуску | Описание изменений в версии |
Нажмите на строку публикации, чтобы открыть детальное представление со сводкой снапшота и содержимым (рабочие процессы, агенты, функции).
Детальный просмотр
На странице деталей публикации отображается:
- Информация о публикации -- ID, дата создания, статус, примечания
- Сводка снапшота -- количество рабочих процессов, агентов, функций и MCP-серверов
- Содержимое -- три вкладки с таблицами: Workflows, Agents, Functions
Кнопка Rollback to this version позволяет создать новую публикацию на основе выбранной версии.
Нельзя удалить активную публикацию. Сначала активируйте другую версию, затем удалите ненужную.
Для интеграции опубликованных процессов в приложение используйте публичный API.