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

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

Platform RAG

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

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

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

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

После приёма документа проходит время от публикации в RabbitMQ до завершения обработки воркером (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

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

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

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

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

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

Low-code Runtime

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

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

Low-code IDE

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

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

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

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

Сохраненный и успешно проверенный Flow остается рабочей версией в Low-code IDE. Пока Agent Publisher отсутствует, нажатие или имитация действия публикации не должно писать в Agent Registry, Kubernetes или объектное хранилище. Развертывание производится вручную.

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

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

Миграции и восстановление

Схема Agent Registry создается только задачей Alembic. При ошибке миграции развертывание останавливают; разрушительные команды SQL из интерактивного контейнера запрещены