Перейти к основному содержимому

Настройка и управление базой знаний

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

Вы управляете базой знаний через Управление → База знаний. Существующие ссылки и центральные документы знаний отображаются вместе в одной таблице.

Что видят пользователи​

Опубликованные элементы видны в Базе знаний: знания для всего управления — в разделе Управление школой → Документы, знания для одной или нескольких школ — в разделе соответствующей школы → Документы, а ссылки — в разделе Ссылки. В зависимости от настройки ссылки базы знаний могут также отображаться на панели управления. Пользователи видят только информацию для всей организации или для своей школы. Шаблоны документов, предназначенные для определённых отделов, также отображаются у сотрудников этих отделов в разделе школа → Мои отделы.

Документ знаний можно использовать двумя способами:

  1. Пользователь открывает документ из раздела Документы.
  2. AI-School автоматически просматривает документ при релевантном запросе в чате, без необходимости выбирать его вручную с помощью скрепки.

Обычная Ссылка ведёт только на веб-страницу, видео или внешний источник. Только обработанный документ знаний содержит канонический Markdown, который может быть использован как центральный источник для поиска в чате.

Уровни организации и школы​

Каждый документ знаний имеет область действия:

  • Вся организация — доступен для всех школ в среде.
  • Выбранные школы — доступен только для пользователей одной или нескольких выбранных школ.

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

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

Обзор базы знаний​

В обзоре вы можете:

  • искать и фильтровать;
  • добавлять элементы с помощью кнопки плюс;
  • изменять порядок с помощью перетаскивания;
  • редактировать ссылки и документы знаний;
  • публиковать, архивировать или удалять документы;
  • импортировать или экспортировать пакет OKF.

Индекс и установленный порядок определяют, как элементы сортируются в разделе Документы.

Добавление элемента​

Нажмите кнопку плюс над таблицей. Вы можете выбрать один из трёх типов содержимого.

Ссылка​

Выберите Ссылка для существующей веб-страницы, видео, курса или другого внешнего источника. Заполните понятное название, описание, категорию и URL. Ссылка будет видна в базе знаний, но внешняя страница не будет автоматически индексироваться как центральный документ знаний.

Добавить документ​

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

  1. Введите уникальное имя файла и понятный заголовок.
  2. Выберите тип и добавьте описание и теги.
  3. Напишите или вставьте содержимое в Markdown-редактор.
  4. Выберите статус и область действия.
  5. Сохраните документ.

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

Добавить исходный файл​

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

AI-School сохраняет исходный файл и дополнительно создаёт канонический Markdown. PDF-, Word-, PowerPoint-, Markdown- и другие поддерживаемые файлы получают единый формат для отображения, экспорта и индексирования поиска.

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

Перед публикацией проверьте:

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

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

Настройка метаданных​

В разделе Настройка документа знаний вы управляете, среди прочего:

ПолеИспользование
ЗаголовокИмя, которое видят пользователи в базе знаний и при ссылке на источник.
ТипВид содержимого, например политика, протокол или руководство.
ОписаниеКраткое объяснение цели и содержания.
ТегиТермины для поиска и управления, разделённые запятыми.
Источник или ресурсПроисхождение или владелец содержимого.
URL источникаСсылка на исходный или актуальный источник.
Дата измененияДата последнего обновления содержимого источника.
Статус публикацииЧерновик, Опубликовано или Архивировано.
Область действияВся организация или выбранные школы.
Доступ дляСотрудники, учащиеся или оба.
ОтделыТолько для школьных знаний: отделы, для которых предназначен документ.
Канонический MarkdownСодержимое, которое отображается, экспортируется и индексируется.

Доступ для сотрудников, учащихся и отделов​

С помощью Доступ для вы определяете, кто видит опубликованный документ в базе знаний и кто получает его в чате как источник: сотрудники, учащиеся или оба. Новый документ по умолчанию доступен только сотрудникам. Документы, существовавшие до появления этой настройки, остаются доступными для всех, пока вы их не измените.

Для знаний выбранных школ вы также можете выбрать Отделы. Выбирайте из отделов, настроенных для школы (Управление → Школы). Тогда документ видят только сотрудники этих отделов в разделах школа → Документы и школа → Мои отделы. Если поле оставить пустым, документ доступен всем сотрудникам школы. Отделы применяются только к сотрудникам; документы, доступные учащимся, видят все учащиеся школы.

Администраторы всегда видят документ для проверки. Отделы сотрудников настраиваются в Управление → Сотрудники → Назначение отделов.

Статус и публикация​

  • Черновик — виден только в управлении и ещё не доступен для запросов в чате.
  • Опубликовано — виден в разделе Документы и доступен для поиска в установленной области.
  • Архивировано — хранится в управлении, но не активно доступен пользователям.

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

Принадлежность организации и хранение​

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

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

Что такое OKF?​

OKF (Open Knowledge Format) — это переносимый формат центральной базы знаний. Он состоит из обычного Markdown с YAML-frontmatter для содержательных метаданных.

---
type: "beleid"
title: "Schoolprotocol"
resource: "schoolprotocol.pdf"
tags: ["beleid", "veiligheid"]
source_format: "pdf"
source_file: "schoolprotocol.pdf"
---

# Schoolprotocol

## Veilig melden

De inhoud staat in normale, leesbare Markdown.

Статус публикации и область действия школы остаются отдельными настройками безопасности в AI-School; они не являются частью переносимого документа.

Импорт и экспорт OKF​

С помощью кнопки экспорта вы скачиваете центральные документы знаний в ZIP-пакете. Пакет содержит Markdown-документы, index.md и лог экспорта. Исходный PDF- или Word-файл остаётся в AI-School как источник.

С помощью кнопки импорта вы добавляете ZIP-пакет с Markdown-документами. Импортированные документы начинаются как Черновик, чтобы администратор мог проверить заголовок, содержимое, область и метаданные перед публикацией.

Пакет может содержать максимум 25 Markdown-документов и 8 МБ сжатого и распакованного содержимого. Большие коллекции разделяйте на несколько пакетов.

Полная проверка​

  1. Опубликуйте документ с чётко узнаваемым фактом.
  2. Войдите как пользователь школы в установленной области.
  3. Проверьте, что документ находится в разделе Документы и его можно открыть.
  4. Задайте в обычном чате релевантный вопрос без ручного выбора документа.
  5. Проверьте, что ответ соответствует документу и упоминается центральный источник.
  6. Повторите тест с пользователем вне области; он не должен видеть документ или использовать его в чате.

Для файлов, которые пользователь связывает только с одним разговором, смотрите Чат с документами.