Перейти к содержанию

Как устроен Wikilect

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

Остались вопросы — напишите в поддержку, адреса на странице «Помощь, поддержка и обучение».

Из чего состоит платформа

Часть Что делает
Кабинет (сервер) Учётные записи, пространства компаний, оргструктура и права, настройки, разговоры, задачи. Через него проходят все действия человека и агента.
Интерфейс То, что человек видит в браузере или в приложении: разговоры с агентом, файлы, настройки. Сам данных не хранит, всё берёт у кабинета.
База данных (СУБД) PostgreSQL с расширением pgvector. Хранит учётные записи, права, разговоры, настройки и поисковый индекс по документам.
Хранилище файлов S3-совместимое хранилище: загруженные документы, вложения, записи встреч.
Шлюз моделей LiteLLM — единая дверь ко всем языковым моделям. Выдаёт каждому человеку и агенту свой ключ, считает расход, ставит лимиты. Умеет скрывать персональные данные до отправки в модель (см. ниже).
Узел агентов Сервер, на котором работают агенты. У каждого человека своя отдельная среда агента (изолированный контейнер): в ней агент читает файлы, запускает навыки и выполняет команды. Среды разных людей друг друга не видят.
Распознавание речи Превращает записи встреч и голосовые сообщения в текст.

Как идут данные

  1. Человек пишет вопрос в интерфейсе. Запрос уходит по HTTPS в кабинет.
  2. Кабинет проверяет, кто это и что ему можно, и передаёт вопрос в среду агента этого человека.
  3. Агент ищет ответ: в базе знаний, в файлах, в подключённых системах — с правами этого человека. Агент ходит пропуском человека и видит ровно то же, что видит он сам.
  4. Когда нужна языковая модель, агент обращается к ней только через шлюз моделей. Напрямую из среды агента к моделям не ходят.
  5. Ответ возвращается человеку и сохраняется в разговоре.

Где хранятся данные

  • Учётные записи, права, разговоры, настройки — в базе данных 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, для поддержки). Администратор пространства по умолчанию может видеть материалы сотрудников; в продукте есть ограничение «администратор без доступа к данным».
  • Проверить, что видит конкретный человек, можно кнопкой «Посмотреть глазами» в настройках оргструктуры.