На этой странице
Пространства и доступ¶
Создание и проверка пространства¶
Откройте Пространства → Создать пространство. У аккаунта должно быть право создавать пространства. Задайте имя, выберите модель эмбеддингов, хранилище и пайплайн.
Устраните блокирующие замечания из отчёта проверки и сохраните пространство. Ваш аккаунт станет его прямым владельцем.
Загрузите пробный документ и найдите фразу из него. Установка и быстрый старт
POST /api/v1/spaces/ возвращает 201 Created. В поле name укажите
от 1 до 255 символов. В embedding_model_id и vector_backend_id можно
указать общие записи реестра или записи своего аккаунта. Пропуск поля
выбирает значение установки по умолчанию.
Поля запроса
Без config пайплайн использует чанки фиксированного размера, плотный
поиск, объединение без изменений и генератор LLM. Для поиска без генерации
выберите поисковый пресет или укажите generate: null в пайплайне.
Отправьте то же тело в POST /api/v1/spaces/validate для проверки без
создания пространства. Валидный запрос возвращает 200 с отчётом,
даже если вердикт блокирует создание.
Если запрос создания вернул
422, исправьте структурную ошибку или несовместимость из отчёта.Если запрос создания вернул
409сblocked_by_probe_only, проверьте доступность и учётные данные ресурсов из отчёта. Укажитеforceв теле запроса создания, только если готовы продолжить при провале проверок доступности.
Роли и права¶
Право на уровне установки
Позволяет создавать пространства.
Роль в пространстве
Определяет доступные действия в конкретном пространстве.
Роль |
Возможности |
|---|---|
Чтение ( |
Читать документы, искать фрагменты и задавать вопросы. |
Редактирование ( |
Также загружать, изменять и удалять документы, если это допускает хранилище. |
Владелец ( |
Настраивать пространство, управлять его прямыми участниками и удалять пространство. |
Действует наивысшая роль из прямого назначения и всех групп. Снятие прямой роли сохраняет доступ через группы. Оставьте хотя бы одного прямого владельца, даже если роль владельца назначена группе. Администратору установки для доступа к содержимому нужна роль в пространстве. Для разных аудиторий используйте разные пространства и хранилища, особенно если подключаете готовый индекс.
Владельцам доступна аналитика пространства. Для чтения сохранённых текстов запросов и проверок ответа нужно отдельное право.
Доступ отдельному человеку¶
С ролью владельца откройте раздел Участники, введите адрес электронной почты и выберите роль. Активный аккаунт получит доступ сразу. Если аккаунт новый или приглашение ещё не принято, отправьте ссылку, по которой участник задаст пароль. Если ссылка потеряна, снова добавьте тот же адрес.
Меняйте или снимайте прямую роль в списке участников. Если доступ сохранился, проверьте Доступ через группы.
Получите список участников или добавьте участника через
/api/v1/spaces/{space_id}/members. Используйте /members/{user_id}
в том же пространстве для смены или снятия прямой роли. API участников
требует интерактивной сессии.
Доступ группе и право создания¶
Откройте Группы с правами администратора установки. Создайте локальную группу, добавьте аккаунты и назначьте роль отдельно для каждого пространства. Право создавать пространства выдаётся отдельно. Изменения действуют со следующего запроса вместе с остальными назначениями.
В группу Все пользователи входят все активные аккаунты. Состав группы Администраторы меняет только суперадминистратор, созданный при первом запуске. Перед удалением локальной группы снимите её роли в пространствах и права установки. Изменения состава группы и назначений видны в журнале.
Ключ API для приложения¶
Откройте Доступ и ключи под аккаунтом приложения. Создайте ключ и выдайте минимальный нужный уровень доступа к каждому пространству.
Уровень ключа |
Возможности |
|---|---|
|
Читать пространство, получать найденные фрагменты и задавать вопросы. |
|
Также записывать документы в пространство. |
|
Также управлять пайплайном, проверками и оценкой, удалять пространство. |
Доступ ключа ограничен текущей ролью его владельца в пространстве.
Выдать manage может только владелец пространства. Для вызовов между
серверами используйте generic. Ключу mcp назначьте хотя бы одно
пространство и уровень не выше write. У ключа без назначений список
пространств пуст. Если аккаунт может создавать пространства, при создании
через API ключ получит доступ к новому пространству в пределах своего
назначения.
Скопируйте ключ при показе, храните его на сервере приложения и передавайте
в X-API-Key. В разделе Доступ и ключи можно проверить префикс, назначения,
срок действия, последнее использование и состояние ключа, а также
отозвать его. Смена ролей, создание ключей и изменение настроек пространства,
например LLM, требуют интерактивной сессии.
Интеграции · Подключите клиент MCP
Проверка доступа и удаление¶
401. Проверьте состояние ключа, тип учётных данных и заголовки.403. При создании проверьте право создавать пространства, для других операций — итоговую роль в пространстве.404. Для существующего пространства проверьте прямые роли, роли через группы и назначения ключа. При создании проверьте также идентификаторы модели и хранилища.
Меняйте параметры извлечения, LLM и исходящие подключения в настройках пространства. Пайплайн меняйте в разделе Конфигурация. Модель эмбеддингов и хранилище привязываются при создании. Для смены модели создайте новое пространство и заново проиндексируйте документы. Для готовых векторов выберите исходную модель.
Удалите пространство через его настройки или DELETE /api/v1/spaces/{id}.
После 204 пространство сразу недоступно. Документы, сохранённые оригиналы
и управляемые индексы удаляются в фоне. При подключённом хранилище исходный
корпус сохраняется. Выберите, что делать со строками, добавленными
пространством. Подключения и хранилища