Как устроен Wikilect
Страница для службы безопасности и ИТ: как устроено, из каких частей состоит платформа (архитектура), где хранятся данные, какая СУБД, как работает шифрование, какие сертификаты и какие модели отвечают. Пишем как есть: где чего-то пока нет — так и сказано.
Остались вопросы — напишите в поддержку, адреса на странице «Помощь, поддержка и обучение».
Из чего состоит платформа
| Часть | Что делает |
|---|---|
| Кабинет (сервер) | Учётные записи, пространства компаний, оргструктура и права, настройки, разговоры, задачи. Через него проходят все действия человека и агента. |
| Интерфейс | То, что человек видит в браузере или в приложении: разговоры с агентом, файлы, настройки. Сам данных не хранит, всё берёт у кабинета. |
| База данных (СУБД) | PostgreSQL с расширением pgvector. Хранит учётные записи, права, разговоры, настройки и поисковый индекс по документам. |
| Хранилище файлов | S3-совместимое хранилище: загруженные документы, вложения, записи встреч. |
| Шлюз моделей | LiteLLM — единая дверь ко всем языковым моделям. Выдаёт каждому человеку и агенту свой ключ, считает расход, ставит лимиты. Умеет скрывать персональные данные до отправки в модель (см. ниже). |
| Узел агентов | Сервер, на котором работают агенты. У каждого человека своя отдельная среда агента (изолированный контейнер): в ней агент читает файлы, запускает навыки и выполняет команды. Среды разных людей друг друга не видят. |
| Распознавание речи | Превращает записи встреч и голосовые сообщения в текст. |
Как идут данные
- Человек пишет вопрос в интерфейсе. Запрос уходит по HTTPS в кабинет.
- Кабинет проверяет, кто это и что ему можно, и передаёт вопрос в среду агента этого человека.
- Агент ищет ответ: в базе знаний, в файлах, в подключённых системах — с правами этого человека. Агент ходит пропуском человека и видит ровно то же, что видит он сам.
- Когда нужна языковая модель, агент обращается к ней только через шлюз моделей. Напрямую из среды агента к моделям не ходят.
- Ответ возвращается человеку и сохраняется в разговоре.
Где хранятся данные
- Учётные записи, права, разговоры, настройки — в базе данных PostgreSQL.
- Документы и вложения — в хранилище файлов (S3).
- Рабочие файлы агента — в среде агента на узле агентов.
- Облако Wikilect: кабинет, база, файлы и среды агентов размещены на серверах в России. Запрос к облачной языковой модели уходит её провайдеру, а он может находиться за рубежом (см. «Какие модели отвечают»).
- Свой контур: все части стоят на серверах компании, данные из контура не выходят, кроме запросов к моделям, если компания сама подключила внешнюю модель.
Шифрование
При передаче.
- Снаружи платформа доступна только по HTTPS (порт 443). В облаке Wikilect — TLS 1.3, обычный адрес по HTTP перенаправляется на HTTPS.
- Внутри одного контура части платформы общаются по внутренней сети. В своём контуре связь между серверами компании может идти без отдельного шифрования — это решается при установке вместе с ИТ компании.
При хранении.
- Пароли хранятся только в виде хеша, сам пароль не хранится.
- Ключи доступа к моделям, пропуска агентов, секретные переменные и секреты входа через единый вход (SSO) хранятся в базе зашифрованными.
- Остальные данные (разговоры, документы) продукт сам не шифрует. Шифрование дисков — на стороне площадки: в облаке — хостинга, в своём контуре — ИТ компании.
Сертификаты
- Облако Wikilect: общедоступные сертификаты Let's Encrypt, продлеваются автоматически.
- Свой контур: сертификат и корневой сертификат компании (её удостоверяющего центра) ставятся при установке. Корень компании добавляется в доверие кабинета и сред агентов, чтобы агент мог ходить во внутренние системы компании.
- Лицензионного ключа у продукта нет.
Какие модели отвечают и где работают
- Все обращения к моделям идут через шлюз моделей. Модель выбирается у поля ввода; модель по умолчанию задаёт администратор для группы.
- Облако Wikilect: модели крупных разработчиков (например, OpenAI, Anthropic, Google) через наш шлюз — по подпискам Wikilect или через посредников-агрегаторов моделей. Сами модели работают у своих разработчиков.
- Свой контур: модели, которые выбрала компания, — развёрнутые внутри контура или облачные модели компании. Wikilect подключает их к шлюзу в контуре.
- Скрытие персональных данных. Шлюз умеет до отправки в модель заменять имена, телефоны, почту, ИНН, СНИЛС, паспортные данные и номера карт метками — и в вопросах, и в результатах работы инструментов. В своём контуре это включается при установке; включено ли оно в вашем облачном пространстве — уточните в поддержке.
- Распознавание речи: в своём контуре — своя модель внутри контура; облачную службу распознавания можно подключить отдельно.
Облако или свой контур
| Облако Wikilect | Свой контур | |
|---|---|---|
| Где работает | Серверы Wikilect | Серверы компании |
| Вход | Почта и пароль или единый вход | Через службу каталогов компании (например, AD / AD FS) |
| Модели | Подписки Wikilect через наш шлюз | Модели, выбранные компанией |
| Обновления | Выпускает Wikilect | По согласованию с ИТ компании |
| Резервные копии | Делает Wikilect | Настраиваются при установке, хранение — у компании |
Резервные копии
- Облако Wikilect: база данных копируется каждую ночь в отдельное хранилище, у базы есть рабочая копия на втором сервере. Среды агентов копируются каждую ночь в зашифрованном виде (хранятся 7 дневных и 4 недельные копии).
- Свой контур: ночная копия базы настраивается при установке; где хранить копии и сколько — решает ИТ компании. Порядок восстановления передаём ИТ вместе с установкой.
Кто что видит: права доступа
- Пространство — это компания. Данные разных компаний разделены.
- Оргструктура: отделы — узлы дерева компании, у каждого сотрудника есть уровень. Уровней бывает разное число (например, пять: от руководства до рядового сотрудника), схему компания настраивает сама.
- Правило одно для всего — разговоров, файлов, писем, встреч, задач:
- сотрудник видит своё;
- руководитель видит свой отдел и всё, что ниже;
- выше по уровню видят всё, что ниже;
- смежные отделы открываются по понятному правилу;
- личное остаётся личным.
- Агент видит ровно то, что видит человек, от чьего имени он работает. Закрытое от человека агент не покажет.
- Роли: пользователь, администратор пространства, глобальный администратор (сотрудники Wikilect, для поддержки). Администратор пространства по умолчанию может видеть материалы сотрудников; в продукте есть ограничение «администратор без доступа к данным».
- Проверить, что видит конкретный человек, можно кнопкой «Посмотреть глазами» в настройках оргструктуры.