---
title: Версии
description: Пять осей версий, с которыми встречается клиент — сборка платформы, capability-версия агентов, API-контракт, сборка портала и версии пайплайнов — где каждая видна, как обнаружить изменение и какие правила совместимости действуют.
locale: ru
version: 0.2.0
canonical: https://enterium-developer-docs.pages.dev/developers/ru/reference/versions/
---

> Documentation index: https://enterium-developer-docs.pages.dev/developers/llms.txt — every page of this portal has a Markdown twin at <route>.md; the frozen API contract is at https://enterium-developer-docs.pages.dev/developers/api/openapi.json.

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

## Оси

| Ось | Где читать | Схема | Меняется, когда |
| --- | --- | --- | --- |
| **Сборка платформы** | `version` в `GET /healthz` и `/api/status.json` | SemVer, выводится из истории релизов | Выходит любой модуль — большинство сборок не трогают то, что может агент |
| **Capability-версия агентов** | Заголовок `x-capability-version` на каждом ответе API · `serverInfo.version` при MCP-подключении · `capability_version` в `start_here` | Привязана к дате, монотонна (`2026-09-03.1`) — работает простое строковое сравнение | Меняется **читающая поверхность агентов**: новые/изменённые инструменты, поля, семантика. У каждого бампа есть запись в [capability-ченжлоге](../release-notes/#capability-ченжлог-агентов) |
| **API-контракт** | `info.version` в [`openapi.json`](/developers/api/openapi.json) (заморожен вместе со сборкой портала) | SemVer | Меняются пути, схемы или объявленные ответы |
| **Сборка портала** | [`versions.json`](/developers/versions.json) (`version`, `builtAt`) · [`manifest.json`](/developers/manifest.json) (маршрут → хэш содержимого) · бейдж под заголовком каждой страницы | SemVer | Документация переопубликована |
| **Версии пайплайнов** | [Каталог пайплайнов](../../pipelines/catalog/) | На пайплайн, неизменяемые каталоги | Пайплайн «вырезан» заново — см. [Жизненный цикл версий](../../pipelines/versioning/) |

## Как обнаружить изменение

- **Агентам:** кэшируйте `capability_version`; при каждом переподключении передавайте
  его в `start_here` как `last_seen_version` — `changed: true` и `whats_new` и есть
  ваш дифф. Между подключениями заголовок `x-capability-version` на любом ответе
  говорит то же самое без вызова.
- **Потребителям доки:** сравните сохранённый `manifest.json` с текущим и перечитайте
  только маршруты, у которых сдвинулся хэш; `.md`-двойники несут `ETag`.
- **Всем:** [`changelog.json`](/developers/changelog.json) (JSON Feed 1.1) — машинный двойник
  [заметок о выпусках](../release-notes/); подпишитесь на него.

## Правила совместимости

1. **Аддитивное — молча.** Новые эндпоинты, инструменты и необязательные поля
   появляются без major-бампа контракта; неизвестные поля игнорируйте.
2. **Переименования и удаления объявляются заранее.** Они попадают в
   capability-ченжлог в `deprecated` с заменой, живут рядом минимум одну
   capability-версию, затем переходят в `removed` в заметках о выпусках.
3. **Ломающие изменения контракта поднимают major контракта** и capability-версию
   в один день; замороженный `openapi.json` предыдущей сборки портала остаётся
   доступен в истории выпусков.
4. **Версии пайплайнов не мутируют.** Изменение — это новый каталог версии; пин
   каталога решает, какая работает в проде.