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

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

Platform RAG

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

Поддержка нового источника или формата данных реализуется отдельным интеграционным сервисом. В релизе 2026.3.5 эталонный интеграционный сервис (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

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

После публикации 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 либо использовать разрешенный платформенный механизм. Если нужного профиля нет, пользователь обращается к администратору и не создает временный открытый секрет.