Маркетплейс коннекторов

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

Источник данных · Откуда KnowledgeBase забирает документы

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

1С:Документооборот

Документы и файлы из 1С:ДО: приказы, регламенты, договоры.

Бетаtype: onec_do

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

Сетевая папка SMB

Документы из корпоративных сетевых папок по пути вида //server/share.

Готовtype: dfs1.1.0

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

Файловая система

Рекурсивный обход папки на диске сервера KnowledgeBase.

Готовtype: filesystem1.1.0

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

Confluence

Страницы пространства и их вложения: картинки, PDF, офисные документы.

Готовtype: confluence1.2.0

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

Naumen Service Desk

Статьи базы знаний сервис-деска: решения типовых обращений и инструкции.

Готовtype: itsm_shlz1.1.0

Экстрактор · Кто превращает файл в Markdown

PAЭкстрактор

Paleograph

Любой файл в Markdown: PDF, офисные форматы, сканы и картинки.

Готовtype: paleograph1.1.0

Индексатор · Где документы индексируются и ищутся

HIИндексатор

Hippocampus

Гибридный поиск по фрагментам документов с фильтрами по метаданным.

Готовtype: hippocampus1.2.0

Как коннекторы складываются в пайплайн

У каждого коннектора одна из трёх ролей. Источник данных говорит, какие документы есть и как их скачать. Экстрактор превращает файл в Markdown. Индексатор хранит текст и ищет по нему. Источник явно указывает, каким экстрактором и индексатором пользоваться.

Несколько экземпляров одного коннектора

Два пространства Confluence или три сетевые папки подключаются без правки кода: это просто несколько блоков [[default.plugins]] с разными instance_id. Идентификатор экземпляра попадает в индекс, поэтому база знаний всегда знает, откуда пришёл документ и куда идти за оригиналом.

[[default.plugins]]
role = "data_source"
type = "confluence"
instance_id = "confluence_docs"
space_key = "DOCS"
extractor_instance_id = "paleograph_default"
indexer_instance_id = "hippocampus_default"

[[default.plugins]]
role = "data_source"
type = "confluence"
instance_id = "confluence_hr"
space_key = "HR"
extractor_instance_id = "paleograph_default"
indexer_instance_id = "hippocampus_default"

Свой коннектор

Коннектор оформляется отдельным Python-пакетом с функцией setup(ctx) и зависимостью от пакета контракта. Что нужно реализовать для каждой роли, описано в разделе Контракт коннекторов.

Чтобы коннектор появился в маркетплейсе, добавьте его описание в папку catalog/connectors репозитория документации.