WorkenДокументация/ Материалыworken.ru

материалы · статья 11

База знаний: создать и наполнить

ИИ-сотрудник отвечает клиентам только тем, что знает. Из коробки он знает лишь то, что вы написали в инструкции; про цены, расписание и правила оплаты он честно скажет «не знаю». База знаний — способ выдать ему ваши документы: прайсы, регламенты, страницы сайта. Экран «База знаний» — отдельный пункт меню в блоке материалов.

1

Как устроен экран

Слева — список баз, справа — карточка выбранной. Под заголовком — итог по всем базам: сколько их, сколько в них фрагментов и сколько места занято. Фрагмент — кусочек текста из вашего документа, которым сотрудник отвечает; везде на экране считаются только те фрагменты, что реально дошли до сотрудников.

Экран «База знаний»: слева список баз с состояниями и типами, справа карточка «Прайсы и регламенты» — блок «Что с ней сейчас» с четырьмя ступенями и начало таблицы источников. Над колонками полоса «Внимание: 1 обновление не дошло до сотрудников» с кнопкой «Разобраться»
Слева базы с состояниями, справа карточка выбранной. Полоса «внимание» появляется, только когда есть о чём предупредить.

У каждой базы в списке — состояние одним словом:готово — все документы дошли до сотрудников,работает частично — часть не дошла, но база отвечает, не разобралась — отвечать нечем,никто не читает — база не подключена ни к одному сотруднику. Если что-то требует вас, над колонками появляется полоса «внимание»; кнопка Разобраться сразу открывает проблемный документ.

2

Два типа баз — и как создать свою

Базы бывают двух типов, и тип виден у каждой строки списка:

  • Векторная — собирается из документов: файлы, страницы сайта, тексты. Сотрудник ищет по ней по смыслу и отвечает своими словами. Подходит для прайсов, регламентов, описаний и правил — про неё эта статья.
  • Табличная — таблица позиций, где каждая строка — услуга или товар с ценой: сотрудник отвечает точными значениями, а не пересказом. Такая база — «Услуги и цены», она ведётся на экране «Товары и услуги»: как её собрать — статья 13.

Новая база создаётся кнопкой Создать базунад списком: в диалоге два таба — по одному на тип. Имя можно не заполнять — база получит имя по дате создания, как «База от 13 мая» на кадре выше. Лучше всё же назвать по содержимому: имя потом меняется кликом прямо по заголовку карточки.

Диалог «Создать базу знаний» с табами «Векторная» и «Табличная»: описание векторной базы, поле «имя базы» с подсказкой «Можно не заполнять — база получит имя по дате создания», кнопки «Отмена» и «Создать базу»
Создание разведено по табам: у каждого типа своё объяснение и своя кнопка.
Кнопка «Создать базу» открывает диалог с табами: сначала таб «Векторная», затем переключение на «Табличная» с кнопкой «Создать табличную базу»
«Создать базу» → выбор типа. На табе «Табличная» кнопка меняется на «Создать табличную базу».

В первый день, пока баз нет вовсе, экран не заставляет ничего создавать: он предлагает просто загрузить прайс — первая база создастся сама и получит имя по первому файлу.

3

Добавить источники

Источники добавляются лаймовой кнопкойДобавить источник на карточке базы. В шторке пять способов:

  • Файлы — pdf, docx, xlsx, csv, txt, md, rtf, pptx, до 20 МБ на файл. До загрузки экран показывает оценку: сколько займёт разбор и сколько добавит хранение в месяц.
  • Сайт по ссылке — укажите адрес, число страниц и глубину обхода, перечислите разделы, которые не брать («/blog, /news»). Сначала Посмотреть, что найдётся: платформа показывает список найденных страниц, и в базу попадают только отмеченные. Обход можно повторять по расписанию — раз в неделю или раз в месяц.
  • Текст — если проще рассказать словами: заголовок обязателен, безымянных фрагментов не бывает.
  • Таблица — xlsx или csv с расписанием, услугами, ценами: выбираете строку-заголовок и сразу видите, как будет выглядеть один фрагмент.
  • Worken Диск — выбор из уже загруженных в проект файлов.

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

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

Главное: четыре ступени доставки

Блок «Что с ней сейчас» — сердце экрана. Загруженный документ не сразу попадает в ответы: он едет по четырём ступеням, и на каждой стоит число — сколько источников до неё доехало.

ступеньчто это значит
ЗагруженоФайлы приняты и лежат на платформе. Это ещё ничего не говорит о том, что сотрудник ими отвечает.
РазобраноИз файлов достали текст и порезали на фрагменты. Скан без распознавания или пустая таблица эту ступень не проходят.
В поискеФрагменты находятся, если спросить саму базу. Но это ответ базы, а не сотрудника.
У сотрудниковСотрудники этими фрагментами отвечают клиентам. Единственное честное «готово».
Блок «Что с ней сейчас»: Загружено 6, Разобрано 4 — достали 1 336 фрагментов, В поиске 4, У сотрудников 3 — 1 240 фрагментов. Ниже оранжевая рамка «1 источник дошёл до поиска, но не до сотрудников» с кнопкой «Пересобрать базу» и строка «Доставка проверена сегодня в 12:04 у Регины контрольным вопросом»
6 → 4 → 4 → 3: числа расходятся намеренно — разница и есть документы, которые до сотрудников не доехали.

Смотрите всегда на последнюю ступень. «Загружено 6» не значит, что сотрудник отвечает по шести документам: на кадре у сотрудников только три. Ступень, где число меньше предыдущей, помечается оранжевым, а под лестницей появляется объяснение — какой именно документ застрял.

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

Последняя ступень — не индикатор, а измерение: платформа задаёт сотруднику контрольный вопрос и смотрит, отвечает ли он по базе. Время последней проверки подписано под лестницей, там же кнопка «Проверить снова» с ценой — около 0.02 W.

5

Источники: судьба каждого файла

Ниже лестницы — пофайловая таблица: название, тип, размер, фрагменты, доставка, дата. Вкладки над ней фильтруют строки:Все, Не доехали,С ошибкой, во время разбора — ещё иИдут. Вкладка с нулём не рисуется вовсе.

Таблица источников базы «Прайсы и регламенты»: шесть строк с колонками название, тип, размер, фрагменты, доставка, добавлен. У трёх источников зелёный статус «у сотрудников», у «Прайса от 8 августа» оранжевый «не доехал» и 0 фрагментов, у двух файлов красный «не разобрался» и прочерк
Колонка «фрагменты» считает только доступное сотруднику: ноль у застрявшего — правда, а не ошибка.

Статусы в колонке «доставка»:

статусчто происходит
загруженПринят, разбор ещё не начался.
разбираемИдёт разбор — обычно до 2 минут.
в поискеНаходится поиском, но сотрудник им ещё не отвечает.
у сотрудниковСотрудник этим пользуется — документ доехал.
не доехалРазобран и ищется, а до сотрудников не доехал. Файл здоров, сломана доставка — лечится пересборкой базы.
не разобралсяТекст достать не удалось. Причина — в раскрытии строки: скан вместо текста, пароль, пустая таблица.

Клик по строке раскрывает подробности: причина по-человечески и что делать, первые фрагменты — как их видит сотрудник, история версий и номер источника для обращения в поддержку. В колонке «фрагменты» прочерк и ноль — разные утверждения: прочерк — текст не достали вовсе, ноль — разобран, но сотруднику недоступен.

Меню «⋯» в строке — действия с одним источником: заменить файл, скачать, пересобрать только его, проверить доставку контрольным вопросом, убрать из базы. При загрузке файла с тем же именем платформа спросит: заменить — прежняя версия сохранится в истории — или добавить второй копией.

обновили файл — проверьте доставкуНовая версия проходит все четыре ступени заново. Пока стадия не дошла до «У сотрудников», сотрудник отвечает по старой версии — например, называет цены из прошлого прайса. Загрузили обновление — убедитесь, что оно доехало.
6

Подключить базу сотруднику

База отвечает только через тех сотрудников, к которым подключена. Блок «Кто читает эту базу» показывает их поимённо; кнопкаПодключить сотрудника открывает список всего штата с поиском — отмечаете галочками, кто должен опираться на эту базу. Второй путь — вкладка «Знания» в карточке самого сотрудника: о ней — статья 05. Если базу не читает никто, экран говорит об этом прямо: она просто занимает место и стоит денег.

Переключатель Кто что читает под списком баз разворачивает общую таблицу «сотрудник × база» — удобно проверить, что новенький подключён ко всему нужному.

Читатели — это и предохранитель при удалении. Диалог «Удалить базу» показывает, кто её читает, объясняет последствия и требует ввести имя базы:

Диалог «Удалить базу „Прайсы и регламенты“?»: строка «Читают: Регина · Марк · Пётр · Вера · Аня», предупреждение «После удаления они перестанут отвечать на вопросы из этой базы», строка «Пропадут 6 источников и 1 240 фрагментов. Вернуть их будет нельзя», предложение «Отключить вместо удаления» и поле «введите имя базы, чтобы подтвердить»
Кнопка «Удалить базу» неактивна, пока имя не введено точно. Обратимый вариант — «Отключить вместо удаления».

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

7

Проверить вопросом — прямо на экране

Не верьте индикаторам на слово — спросите. Блок «Проверить вопросом» задаёт вопрос в двух режимах: у базы — бесплатно, показывает, что нашлось в документах, — и у сотрудника — по-настоящему, как спросил бы клиент, около 0.02 W.

Блок «Проверить вопросом»: вопрос «Сколько стоит приём кардиолога?», режимы «у базы — бесплатно» и «у сотрудника — Регина». Ниже находки базы с метками точно/близко/далеко и цитатами из прайсов, фиолетовый ответ Регины «Первичный приём кардиолога — 2 900 ₽» и оранжевое предупреждение «База знает ответ, а Регина — нет» с кнопкой «Пересобрать базу»
Самый ценный случай — расхождение: база нашла августовский прайс, а Регина отвечает по июньскому.

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

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

8

Пробелы: что спрашивали, а ответа не было

Внизу карточки — блок «Пробелы»: вопросы клиентов за 30 дней, на которые сотрудник не нашёл ответа, сгруппированные по повторяющимся темам. У каждой — кнопкаДобавить ответ: пишете ответ, он становится источником базы и едет по тем же четырём ступеням. Как разбирать пробелы системно — статья 12.

И последнее: база — это ещё и деньги. Блок «Что она стоит» показывает хранение за месяц в воркенах и честно предупреждает, что подключённая база немного удорожает каждый ответ сотрудника — даже когда в ней ничего не нашлось. Пустые и никем не читаемые базы выгоднее удалять.