Документация / Источники данных

Источники данных

Редакция 24 сентября 2026, дополнена 9 ноября 2026

Для администратораПри подключении автоматизации

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

Два способа отдать данные

Начинать разумно с выгрузки. Она не требует согласования доступов и показывает качество ответов на ваших настоящих документах за день, а не за месяц.

Какие источники есть

Новый экземпляр любой из этих систем, свое хранилище, свой ящик, свой Битрикс24, администратор заводит из кабинета сам. Источник, которого в списке нет, подключают отдельной доработкой платформы, потому что для него нужен новый программный код.

Как подключается источник

Новый экземпляр системы из списка выше администратор заводит сам, из кабинета. Порядок такой.

1. Заводится учетная запись в вашей системе

   Отдельная, только для платформы, с правом чтения нужного раздела. Общая учетная запись сотрудника не подходит, потому что по журналу должно быть видно, что читала именно платформа.

2. Подключение объявляется в кабинете

   Адрес системы, корни (какие папки или разделы видны автоматизации) и учетные данные. Учетные данные платформа шифрует ключом вашего экземпляра и обратно не показывает, ни на экране, ни в ответах.

3. Адрес сверяется с сетями, объявленными при развертывании

   Адрес вне этих сетей отклоняется при сохранении, до первого обращения. Рамка задается описателем платформы, и кабинет к правилам сетевого экрана не обращается.

4. Класс данных сверяется с образцом

   Вы объявляете, какие данные приходит из системы. Платформа делает один читающий вызов в режиме проверки, прогоняет ответ через обезличивание и смотрит, какие категории нашлись. Если найденное строже объявленного, подключение не включается, а платформа перечисляет найденные категории без самих значений.

5. Автоматизация связывается с подключением

   На экране настройки автоматизации, вкладка подключений к системам. Там же видно, когда подключение последний раз отвечало.

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

Свой сервер NextCloud

NextCloud - это файловое хранилище, которое компания разворачивает на своем сервере. Платформа только читает из него файлы и ничего в них не создает, не меняет и не удаляет. Подходит NextCloud версии 33 и новее, на более старой версии подключение отклоняется.

Подключает NextCloud администратор организации. Порядок такой.

1. Администратор открывает подключение NextCloud

   В кабинете администратора организации он открывает вкладку «База знаний», затем вкладку «Источники», нажимает «Подключить хранилище» и выбирает NextCloud. Вкладка «База знаний» стоит рядом с вкладками «Сотрудники» и «Расход» и есть у организаций, у которых доступна база знаний.

2. Администратор называет адрес сервера

   Адрес вводится в поле «Адрес NextCloud», после чего нажимается «Войти». Адрес должен открываться по защищенному соединению (https) на стандартном порту и быть публичным. Адреса внутренней сети компании и служебные имена платформа отклоняет.

3. Администратор разрешает доступ в самом NextCloud

   В новой вкладке откроется страница входа вашего NextCloud. Администратор организации входит в NextCloud той учетной записью, под которой платформа будет читать файлы, и нажимает «Разрешить доступ». Пароль учетной записи на платформу не попадает. NextCloud выдает платформе отдельный пароль приложения, а платформа хранит его в зашифрованном виде и обратно не показывает.

4. Администратор отмечает папки

   В окне «Папки и обновление», которое открывается из строки источника, администратор отмечает папки. Пока папки не отмечены, платформа не скачивает ни одного файла. Отметить можно учетную запись целиком или любую папку на любой глубине, в том числе папку, которой с этой учетной записью поделились. Для каждой отмеченной папки администратор в поле «Кто видит» выбирает группу сотрудников, которой доступны документы этой папки. Права, настроенные в самом NextCloud, платформа не учитывает, доступ сотрудников к документам задают группы платформы.

Платформа получает от NextCloud перечень всех файлов, которые видит учетная запись, а содержимое скачивает только из отмеченных папок. Поэтому для платформы стоит завести в NextCloud отдельную учетную запись, войти ею при подключении и открыть ей только нужные папки. Из отмеченных папок платформа берет файлы тех форматов, которые умеет разбирать, остальные пропускает.

Журнал изменений платформа от NextCloud не получает, поэтому при каждой сверке она сравнивает перечень файлов с прошлым и так находит новые, измененные и удаленные файлы. Как часто сверять, администратор выбирает в окне «Папки и обновление», в поле «Как часто обновлять». Выбрать можно «раз в час», «раз в 4 часа», «дважды в сутки» или «раз в сутки». По умолчанию стоит «раз в 4 часа». Кнопка «Обновить сейчас» запускает сверку вне расписания. Если источник обновлялся меньше десяти минут назад, платформа отклоняет нажатие.

При входе платформа называет себя в NextCloud именем «Svaya Knowledge Base». Если NextCloud перестанет принимать выданный платформе пароль приложения (например, администратор NextCloud отозвал этот доступ), платформа перестанет получать документы, а источник в кабинете покажет отказ «Поставщик не принял вход, поэтому документы из этого источника не загружаются». Чтобы вернуть источник, NextCloud подключают заново.

Как документ попадает в поиск

Документ проходит один и тот же путь, откуда бы он ни пришел, из выгрузки или из вашей системы.

1. Разбор

   Файл приводится к тексту. Форматы, которые платформа не разбирает, отклоняются с причиной, а не молча пропускаются.

2. Нарезка на куски

   Целый документ в модель не помещается, поэтому он режется на куски по выбранному профилю. Куски нумеруются, и по номеру потом видно, откуда взят ответ.

3. Перевод в числовой вид

   Каждый кусок переводится в набор чисел, по которым идет поиск по смыслу, а не по совпадению слов. Считает это отдельная часть платформы, не языковая модель.

4. Запись в корпус

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

В ответе ассистента ссылка ведет на документ и на кусок. Это и есть ответ на вопрос «откуда платформа это взяла», и именно поэтому ассистент показывает источник, а не просто текст.

Два профиля нарезки

Профиль выбирается при настройке корпуса и решает, как документ режется. Профилей два.

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

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

Когда документы меняются

Платформа сверяет документы по содержимому, а не по имени файла и не по дате. Отсюда два практических следствия.

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

Удаленный из источника документ исчезает из поиска при следующем согласовании корпуса. Пока согласование не прошло, ассистент может ответить по документу, которого в вашей системе уже нет, и это стоит помнить, снимая документ с публикации.

Права и что видит платформа

• Только то, что разрешено. Платформа читает раздел, названный в подключении, и скачивает содержимое только из него, даже если учетной записи хватило бы прав на большее.
• Чтение и запись разделены. Ассистенту достаточно чтения. Право записи нужно только агенту и только на тех шагах маршрута, где запись объявлена.
• Каждое обращение в журнале. Видно, какая автоматизация, к какой системе и когда обращалась.

Когда источник не отвечает

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

Разбор остальных отказов собран на странице диагностики отказов.