Известные ограничения и временные решения

Критичные ограничения

Активность и потребление

Нагрузочная квалификация ещё не завершена

AU-I05 остаётся открытым этапом. Для функции пока не подтверждены итоговый профиль ресурсов, пропускная способность и целевые задержки чтения на большой истории. Отдельный успешный прогон или миллион синтетических событий не подтверждают все эти свойства одновременно.

В основном dev-local используется один ClickHouse и один Collector с постоянной очередью на диске. Промышленная топология, высокая доступность и гарантированная граница потери данных при отказе узла либо PVC не поставляются этой итерацией. Автоматическое подключение Activity в QA/RC ещё не выполнено.

Известный расход может быть меньше полного

В закреплённом OpenAI-совместимом профиле agentgateway 1.5.0 отсутствующее поле usage превращается в ноль до экспорта телеметрии. Collector не может восстановить потерянное различие. Поэтому профиль agentgateway-1.5-conservative/v2 принимает согласованный положительный набор входных, выходных и суммарных токенов, а неоднозначный набор считает неизвестным.

Например, 11/7/18 учитывается; при 11/0/11 невозможно доказать, что выходные токены действительно равны нулю, поэтому весь набор не входит в достоверные суммы. Противоречивые 11/7/99 также не начисляются. Доказанный отказ шлюза до обращения к провайдеру имеет отдельное основание для нулевого расхода.

Пользователь должен учитывать покрытие показателя и подпись «Известные токены». Эти суммы нельзя использовать как полный финансовый расчёт. Обновление шлюза потребует повторной проверки JSON/SSE и новой версии нормализации; одного изменения номера образа недостаточно.

Запрос к агенту не является полным запуском агента

Агрегаты показывают HTTP-запросы, наблюдаемые Platform Agent Gateway. Один запрос может запустить продолжительную работу, а один логический запуск — содержать несколько HTTP-запросов. Поддержка Agent runs, фонового жизненного цикла A2A-задач и отдельного журнала запусков отложена.

Непрозрачный общий процесс агента использует принадлежащий ему служебный ключ. Расход относится к ключу и агенту; личность человека, инициировавшего конкретный LLM-вызов, не определяется. Команды, проекты, денежная стоимость и накопительные квоты также не входят в этот выпуск Activity.

Постоянная очередь не исключает все потери

Для события, принятого фильтрами поставляемого профиля, подтверждение OTLP означает приём постоянной очередью Collector. Оно не означает запись в ClickHouse. До этого подтверждения буфер шлюза остаётся недолговечным; переполнение, истечение повторных попыток, повреждение либо потеря PVC могут оставить пропуск.

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

Хранение и откат имеют отдельные границы

API скрывает данные старше 30 дней независимо от фонового удаления ClickHouse. Физический TTL и удаление резервных копий выполняются отдельно. Локальная проверка восстановления не предоставляет промышленное хранилище резервных копий и не подтверждает срок физического удаления на полной нагрузке.

После миграции в activity-storage/v2 старый читатель схемы v1 несовместим с новой версией. Возвращайте совместимый образ либо временно отключайте чтение Activity; не понижайте маркер схемы вручную. Отключение экспорта, опустошение очереди и возврат описаны в руководстве оператора.

Platform RAG

Для Low-code Конструктора также действуют ограничения самостоятельной поставки RAG и Memory: публикация агента не настраивает автоматически эти сервисы и их интеграции. Подключение и доступ необходимо согласовать отдельно.

Интеграционный сервис отсутствует

Поддержка нового источника или формата данных реализуется отдельным интеграционным сервисом. В релизе 2026.4.1 эталонный интеграционный сервис (Confluence или S3) не входит в поставку.

Для наполнения коллекции документами необходимо написать собственный интеграционный сервис, использующий контракт приёма submit_documents.

Интеграционный сервис обязан:

• владеть собственными Secrets и NetworkPolicy, ограничивающими сетевой egress до своего источника;
• выводить ACL документа из источника, а не доверять правам из внешнего события;
• передавать нормализованные документы через RAG API; прямая запись в OpenSearch, S3 или Redis pub/sub запрещена.

Внутренняя очередь — Redis pub/sub

Внутренняя очередь заданий ingest использует Redis pub/sub для низколатентной доставки уведомлений воркерам. PostgreSQL job store является источником истины по заданию.

Фоновый процесс периодически сверяет зависшие PENDING задания и повторно публикует уведомления, компенсируя возможную потерю сообщений Redis pub/sub. Воркеры должны быть идемпотентны по content_hash + idempotency_key.

Индексация не мгновенна

После приёма документа проходит время от публикации в Redis pub/sub до завершения обработки воркером (chunk → embed → index). Документ доступен для поиска только после перехода статуса в DONE. В среднем это занимает несколько секунд, но зависит от размера документа и загруженности воркеров.

Пустой ACL в приватной коллекции отклоняется

Для приватной коллекции документ с пустым acl отклоняется сервисом (политика reject). Это предотвращает утечку данных, но требует от интеграционного сервиса обязательного вывода ACL из источника.

Изменение профиля эмбеддинга требует переиндексации

In-place изменение профиля эмбеддинга или стратегии чанкинга не допускается. Для смены профиля необходимо выполнить версионируемую переиндексацию, что требует дополнительного времени и ресурсов.

Отказ зависимостей блокирует операции

• Отказ AI Gateway блокирует как приём (эмбеддинг), так и поиск (реранк, переписывание запроса).
• Отказ OpenSearch отключает поиск, но не приём: документы принимаются, регистрируются, но не индексируются до восстановления.
• Отказ SpiceDB запрещает защищённые операции (fail-closed, ответ 503).

Memory Service

Извлечение фактов асинхронно

После вызова POST /v1/memories факт становится доступен для поиска через несколько секунд. Клиент должен проверять статус через GET /v1/events/{event_id}. Не полагайтесь на немедленную доступность записанного факта в поиске.

Поиск не возвращает истёкшие записи по умолчанию

Записи с истёкшей expiration_date исключаются из результатов поиска и списка по умолчанию. Для их просмотра необходимо явно указать show_expired=true.

Отказ зависимостей блокирует операции

• Отказ AI Gateway блокирует как запись (эмбеддинг, инференс), так и поиск (эмбеддинг запроса).
• Отказ OpenSearch отключает поиск, но не приём: сообщения принимаются, регистрируются в очереди, но не индексируются до восстановления.
• Отказ SpiceDB запрещает защищённые операции (fail-closed, ответ 503).
• Отказ Redis блокирует рабочую память сессий, но не долговременную память.
• Отказ очереди RabbitMQ ставит на паузу асинхронную запись; синхронный поиск и чтение остаются доступными.

Guardrails обязательны на записи

Персональные данные не попадают в долговременную память в открытом виде — они маскируются Guardrails перед сохранением. Без доступного Guardrails запись может быть отклонена.

Право на забвение необратимо

Удаление всех записей по фильтру DELETE /v1/memories необратимо. Подтверждение возвращается в виде confirmation_id для аудита, но сами удалённые факты восстановить невозможно.

Скоупы памяти обязательны

Для любой операции поиска или списка обязателен минимум один entity-скоуп (agent_id или run_id). user_id доступен только для admin/compliance операций.

Agent Registry

Границы SDK и MCP в унаследованных документах требуют согласования

В документации остаётся конкретное расхождение. Базовый контракт docs/specifications/agent-registry/contracts/http-api.md описывает источником каталога только low-code A2A, опубликованный Publisher. При этом ранее принятое решение ADR-0011 и реализация Registry добавляют отдельно включаемый профиль agent-platform.agent-registry.sdk-helm/v1 для самостоятельных SDK-агентов. Текст базового HTTP-контракта ещё не синхронизирован с этим дополнением.

Руководство регистрации SDK относится именно к этому отдельному профилю: его по умолчанию не принимают, а включение требует соответствующей политики допуска ресурсов и назначенного оператора Helm. Установка не создаёт публикацию SDK через Control Plane; Registry по-прежнему не предоставляет ручного API создания агента. Наличие инструкции не подтверждает включение профиля в конкретной QA-среде. Эта возможность принята до CORE-1980 и не добавляется функцией Activity.

В пользовательском руководстве Registry также сохранены значения фильтра mcp и примеры метаданных MCP. Наличие этих значений в схеме обеспечивает совместимость формата, но не подтверждает действующий источник регистрации или наполнения каталога MCP. Не используйте их как обещание доступного способа публикации MCP в текущем профиле. Согласование этих унаследованных разделов относится к документации Registry; добавление Activity не расширяет протоколы регистрации и публикации.

Обнаружение выполняется не мгновенно

После публикации workload в Kubernetes запись появляется в каталоге только после взаимодействия с Kubernetes, формирования карточки агента и авторизационных данных в SpiceDB.

Отказ зависимого сервиса не ослабляет контроль доступа

При недоступности SpiceDB, защищенные операции возвращают типизированный ответ 503.

При недоступности AI Gateway либо OpenSearch не работает только поиск; просмотр списка остается доступным, если его собственные зависимости исправны.

Ручная запись в Registry запрещена

Registry не предоставляет API для ручного создания, изменения или удаления записей агентов. Registry наблюдает только то, что Publisher написал в Kubernetes. Любая попытка прямой записи в Registry является нарушением контракта.

Low-code Runtime

Flow меняется только новой версией

Low-code Runtime читает один артефакт при запуске и не обновляет его во время работы. Для изменения low-code агента нужно создать новую версию и повторно развернуть рабочую нагрузку. Редактирование файла внутри контейнера недопустимо.

Возможности агента публикуются только при рабочем runtime path

Возможности агента указываются в Agent Card/descriptor только при пройденном conformance test.

Low-code Studio

Интерфейс может измениться до принятия спецификации

Названия экранов и расположение активных элементов в адаптированном LangFlow еще не зафиксированы.

Руководство описывает смысл операций, но окончательные подписи и адрес среды должен подтвердить владелец Low-code Studio.

Сохранение не равно публикации

Сохраненный и успешно проверенный Flow остается рабочей версией в Langflow.

Секреты не входят в состав Flow

Ключи моделей, токены и пароли нельзя вставлять в поля узлов Flow или экспортируемый JSON. Low-code Studio должен ссылаться на профиль Vault либо использовать разрешенный платформенный механизм. Если нужного профиля нет, пользователь обращается к администратору и не создает временный открытый секрет.

Работоспособность всех доступных узлов не гарантирована

При создании low-code агента в Конструкторе доступны все узлы, разрешенные политикой. Их работоспособность в составе опубликованого агента не протестирована в полном объеме, что может привести к сбоям в работе low-code агентов.