Расшаривание баз знаний между пространствами

Расшаривание открывает базу знаний одного рабочего пространства другим пространствам той же организации — на чтение и целиком. Платформа не копирует содержимое: все пространства работают с одним источником, поэтому изменения владельца получатели видят сразу. Доступ вы выдаёте и отзываете в окне Управление доступом на вкладке Доступ пространствам. Расшаривание работает только в коробочной поставке (on-prem) и только на всю базу: открыть отдельную папку или документ нельзя.

Только on-prem. В облачной поставке вкладка Доступ пространствам показывает сообщение «Расшарка баз знаний другим пространствам доступна только в коробочной поставке (on-prem)».

Что вам понадобится

• коробочная поставка платформы;
• право kb:share:manage — «Расшаривание баз знаний другим пространствам (on-prem)»;
• база знаний, созданная в вашем рабочем пространстве;
• название пространства-получателя;
• обычное право на просмотр баз знаний у участников пространства-получателя.

Право kb:share:manage есть у системных ролей Владелец (owner) и Менеджер (manager), а также у пользовательской роли с уровнем Редактирование в разделе прав Базы знаний. Отдельного права на чтение расшаренной базы получателю не нужно.

Как открыть доступ к своей базе знаний

Откройте базу, нажмите кнопку с многоточием в шапке базы — подсказка Действия с базой знаний — и выберите Доступ. В окне Управление доступом перейдите на вкладку Доступ пространствам — вкладка видна только для базы знаний и только при наличии права kb:share:manage. Дальше есть два способа: перечислить пространства поимённо или открыть базу всей инсталляции.

1. В блоке Отдельные пространства раскройте список Выберите пространство.
2. Выберите пространство-получателя.
3. Нажмите + Добавить.

Пространство появляется в списке с пометкой Чтение, платформа подтверждает действие сообщением «Доступ выдан». Повторите шаги для каждого получателя.

Чтобы открыть базу всем сразу, включите переключатель Всем пространствам инстанса. Доступ получают все текущие и будущие пространства, а индивидуальный список при этом не нужен. Когда доступ выдан, закройте окно кнопкой Закрыть.

Примечание. Платформа применяет изменения на вкладке Доступ пространствам сразу, отдельной кнопки сохранения нет.

Выдать доступ собственному пространству нельзя — платформа отвечает «Нельзя расшарить базу знаний тому же пространству». Доступ всегда направленный: если пространство A открыло базу пространству B, это не даёт B права передать базу дальше.

Как получателю найти и подключить базу

Расшаренная база появляется у получателя автоматически — запрашивать или импортировать её не нужно. Откройте раздел База знаний и нажмите название базы в заголовке страницы: расшаренные базы платформа показывает внизу списка, в группе Доступные из других пространств, с пометкой Только чтение и названием пространства-владельца.

Такую базу можно открыть и просмотреть: дерево папок и документы видны, а все действия по изменению отключены — рядом с названием базы стоит пометка Только чтение.

Чтобы ассистент получателя начал отвечать по такой базе:

1. Откройте настройки нужного ассистента на вкладке Знания.
2. Нажмите Подключить базу.
3. В группе Доступные из других пространств отметьте нужную базу.
4. Нажмите Подключить одну базу. При нескольких выбранных подпись меняется на Подключить 2 базы, Подключить 5 баз, а до выбора кнопка подписана Выберите базы. Базы подключаются сразу, отдельно сохранять форму не нужно.

Ассистент опирается на расшаренную базу так же, как на собственную: находит в ней фрагменты и ссылается на них в ответах. Один ассистент работает и со своими базами, и с расшаренными одновременно: в окне Подключить базу свои базы собраны в группе Базы пространства, открытые вам — в группе Доступные из других пространств; отметить можно базы из обеих групп, и в одном ответе платформа ищет по всем подключённым базам, а найденные фрагменты сводит в общий список Источники.

Расшаренную базу можно указать прямо в сообщении через @, не подключая её к ассистенту: в меню она лежит в группе Доступные из других пространств с названием пространства-владельца, а выбранная база становится чипом База знаний: …. Ответ ищется только в указанных базах; подробнее — Чаты.

Расшаренная база доступна и узлу Поиск по знаниям в редакторе сценариев. В режиме Конкретная база знаний поле выбора показывает группу Доступные из других пространств, а после смены базы область поиска по документам сбрасывается — выберите документы заново. Если владелец отзовёт доступ, публикация новой версии сценария остановится с ошибкой ссылки, а запуск узла завершится сообщением об отозванном доступе.

Что можно делать с расшаренной базой

Получатель работает с расшаренной базой только на чтение: смотрит документы и подключает базу к своим ассистентам. Всё, что меняет базу или её доступы, остаётся за владельцем.

Дополнительные ограничения, о которых стоит знать заранее:

• владелец и получатель работают на общей модели эмбеддингов инсталляции: если базу переиндексировали другой моделью, поиск по ней у получателя может не сработать;
• кредиты за ответ платформа списывает с пространства-владельца, только когда все базы ответа принадлежат владельцу.

Если ассистент собрал ответ по базам разных пространств или по системным базам инсталляции, запрос оплачивает пространство, из которого задан вопрос. Агент ищет по расшаренной базе и читает её документы наравне со своими базами пространства, но изменить такую базу не может: изменения вносит владелец.

Как отозвать доступ

Откройте Доступ → Доступ пространствам для нужной базы. Чтобы закрыть доступ одному пространству, нажмите значок корзины напротив него в списке. Чтобы закрыть общий доступ, выключите переключатель Всем пространствам инстанса. Доступ закрывается сразу: платформа сбрасывает кэш прав при отзыве.

Отзыв — обратимая операция. Платформа намеренно сохраняет привязку базы к ассистентам получателя: если доступ вернут, ассистент снова заработает без донастройки.

При попытке использовать базу с закрытым доступом ассистент получателя выдаёт ошибку:

Нет доступа к базе знаний «<название>» — доступ отозван владельцем. Обновите список источников ассистента или свяжитесь с владельцем базы.

На вкладке Знания ассистента такие базы остаются в секции Источники для ответов отдельными карточками с заголовком Недоступная база знаний и подписью Доступ отозван или база удалена. Отвязать карточку можно крестиком на ней, по одной базе за раз.

Отзыв закрывает и указание базы через @: на сообщение с чипом закрытой базы платформа отвечает «Нет доступа к базе знаний «<название>»».

Частые вопросы

Не вижу вкладку «Доступ пространствам»

Вкладка скрыта из-за поставки или прав. Проверьте:

• платформа развёрнута в коробочной поставке;
• окно доступа открыто для базы знаний, а не для другого ресурса;
• у вашей роли есть право kb:share:manage.

Открыл доступ, но получатель не видит базу

База появляется у получателя в группе Доступные из других пространств — в списке выбора базы раздела База знаний и в окне Подключить базу на вкладке Знания ассистента. Попросите получателя обновить страницу и убедитесь, что доступ выдан нужному пространству. Свои базы пространства из списка при этом не пропадают и поиск по ним работает, поэтому отсутствие только расшаренной базы указывает на доступ или пространство-владельца, а не на сбой поиска.

Ассистент получателя показывает ошибку про отозванный доступ

Владелец закрыл доступ к базе. На вкладке Знания найдите карточку Недоступная база знаний в секции Источники для ответов и отвяжите её крестиком, либо свяжитесь с владельцем базы, чтобы доступ вернули.

Кто платит за ответ, если ассистент искал и в своей, и в расшаренной базе

Пространство-владелец платит, только когда все базы ответа принадлежат ему. Если в ответе смешаны базы разных пространств или системные базы инсталляции, платит пространство, из которого задан вопрос.

Можно ли поделиться одной папкой или дополнить чужую базу

Нет. Вы открываете доступ ко всей базе целиком и только на чтение — все изменения вносит владелец, и получатели видят их сразу.

Что дальше

• Базы знаний — наполнить и проиндексировать базу перед тем, как открывать её другим.
• Ассистенты — подключить расшаренную базу к ассистенту получателя.
• RAG и поиск по знаниям — разобраться, почему ассистент не находит материалы в подключённой базе.
• Агент — как агент пользуется базами, открытыми другими пространствами.
• Чаты — указать базу знаний прямо в сообщении.
• Роли и права доступа — выдать право на расшаривание нужным участникам.