Пример использования Qlik Answers: помощник по документации

Помощники по знаниям Qlik Answers можно использовать для различных целей в рамках Qlik Cloudв организации. В этом примере использования показано, как с помощью Qlik Answers можно предоставить пользователям Qlik Cloud помощника по документации.

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

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

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

Для этого команда по документации решила отправлять копию файлов сайта справки в блок Amazon S3 каждый раз при создании сайта справки. Используя подключение Amazon S3 V2 в Qlik Cloud, файлы можно сделать доступными для помощника Qlik Answers.

Роли пользователей в этом примере использования

В этом проекте команда по документации состоит из пользователей, перечисленных ниже.

Инженер по документации. Инженер по документации выводит содержимое документации в блок Amazon S3 для использования в базе знаний.
Администратор клиента. Администратор клиента устанавливает разрешения роли пользователя, чтобы позволить создавать и использовать помощник и базу знаний.
Владелец помощника. Владелец помощника создает, настраивает помощник и базу знаний и управляет ими.
Администратор аудита. Администратор аудита просматривает отзывы, собранные в помощнике.
Пользователи помощника. Предполагаемая аудитория для помощника по документации.

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

Создание помощника по документации

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

Подготовить сайт справки к экспорту в хранилище.
Подготовить роли в центре администрирования.
Подготовить пространства в Qlik Cloud.
Создать базу знаний по документации.
Создать помощника по документации.
Протестировать помощник.
Предоставить другим пользователям общий доступ к помощнику.
Просмотреть отзывы пользователей.

Кроме того, администратор клиента отслеживает использование помощника по документации и других помощников в организации с помощью приложения Answers Analyzer for Qlik Cloud.

Подготовка сайта справки к экспорту в хранилище — инженер по документации

Первый шаг — настройка сайта справки для экспорта содержимого в онлайн-хранилище в целях использования в базе знаний.

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

Подготовка ролей в центре Администрирование — администратор клиента

В центре Администрирование администратор клиента назначает возможности и разрешения для ролей, указанные ниже.

Владельцу помощника — возможность создавать помощников и базы знаний.

Владельцу помощника требуются разрешения, указанные ниже.
- Типы содержимого > Управление помощниками: разрешено.
- Типы содержимого > Базы знаний > Управление базами знаний: разрешено.
- Типы содержимого > Базы знаний > Индексация баз знаний: разрешено.
- Типы содержимого > Базы знаний > Поиск по базам знаний: разрешено.
Пользователям помощника — возможность использовать помощника.

Пользователям помощника требуются разрешения, указанные ниже.
- Типы содержимого > Управление помощниками: Просмотр помощников.
- Типы содержимого > Базы знаний > Поиск по базам знаний: разрешено.
Администратору аудита — возможность просматривать и анализировать отзывы о помощнике.

Администратору аудита требуются разрешения, указанные ниже.
- Типы содержимого > Управление помощниками: Просмотр помощников.
- Типы содержимого > Базы знаний > Поиск по базам знаний: разрешено.
- Типы содержимого > Базы знаний > Просмотр баз знаний: разрешено.
Кроме того, администратору аудита требуется роль пользователя Администратор аудита.

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

Подготовка пространств в Qlik Cloud — владелец помощника

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

В разделе Создать владелец помощника создает пространства, указанные ниже.

Данные помощника (Assistant Data) — управляемое пространство.

В это пространство необходимо добавить подключение к данным.
Помощники — управляемое пространство.

В это пространство необходимо добавить помощник по документации.

Когда помощник будет готов, необходимо добавить в пространства пользователей помощника и администратора аудита.

Создание базы знаний по документации — владелец помощника

В управляемом пространстве Данные помощника (Assistant Data) владелец помощника может создать свою базу знаний. Он создает базу знаний и подключение к блоку Amazon S3. Затем он использует динамические правила, чтобы получить все файлы из папок.

Выполните следующие действия.

В центре активности Аналитика перейдите на мини-страницу Ответ.
Нажмите Создать > База знаний.
В поле Имя введите Документация БЗ (Documentation KB).
В поле Пространство выберите Данные помощника (Assistant Data).
Выберите Открыть базу знаний и нажмите Создать.

Теперь можно создать подключение.
Нажмите Использовать подключение (Use connection).
Нажмите Создать подключение и настройте подключение к блоку Amazon S3 с помощью коннектора Amazon S3 V2.
Выберите подключение и нажмите кнопку Далее.
Выберите Динамические правила.
Измените глубину папки, чтобы она соответствовала глубине структуры папок сайта справки.

В этом примере использования, поскольку сайт справки имеет глубокую иерархию папок, владелец помощника выбирает 20.
Щелкните Выбрать.
Нажмите Индексировать все (Index all).
Когда индексация будет завершена, нажмите > Установить график.
Включите параметр График ежедневного индексирования и установите время начала и часовой пояс.
Нажмите Сохранить.

Создание помощника — владелец помощника

Теперь владелец помощника создает помощника в управляемом пространстве Помощники. Он добавляет базу знаний Документация БЗ (Documentation KB), а также настраивает варианты начала беседы и параметры помощника.

Выполните следующие действия.

В центре активности Аналитика перейдите на мини-страницу Ответ.
Нажмите Создать > Помощник.
В поле Имя введите Помощник по документации (Documentation Assistant).
В поле Пространство выберите Помощники.
Нажмите Создать.
На вкладке Обзор нажмите Добавить базу знаний.
Выберите Документация БЗ (Documentation KB) и нажмите Выбрать.
В разделе Начало беседы добавьте от трех до пяти вариантов начала беседы, чтобы помочь пользователям понять, какие вопросы они могут задавать помощнику.
В разделе Настройки установите значок Аватара и приветственное сообщение помощника.
Дополнительно можно настроить сообщения об ошибках для помощника.

Теперь помощник готов к тестированию.

Тестирование помощника

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

После завершения тестирования другим пользователям можно предоставлять общий доступ к помощнику.

Предоставление другим пользователям общего доступа к помощнику — владелец помощника

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

В управляемом пространстве Данные помощника (Assistant Data) в разделе Участники в поле Любой участник клиента <имя> (Anyone at <name> tenant) выберите Может использовать данные, чтобы все пользователи клиента могли задавать вопросы по данным.
В управляемом пространстве Помощники в разделе Участники в поле Любой участник клиента <имя> (Anyone at <name> tenant) выберите Может использовать данные и Имеет ограничения на просмотр.

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

Просмотр отзывов пользователей — администратор аудита

После запуска помощника по документации администратор аудита может просматривать отзывы в разделе Просмотр. Администратор аудита просматривает отзывы раз в неделю и создает задачи для команды по документации.

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

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

Управление использованием Qlik Answers — администратор клиента

Администратор клиента отслеживает использование Qlik Answers в клиенте с помощью приложения Qlik Cloud Answers Analyzer, доступного через Qlik Automate. Qlik Cloud Answers Analyzer помогает администратору клиента отслеживать использование Qlik Answers в помощнике по документации и базе знаний, а также с другими помощниками и базами знаний в организации.

Для получения дополнительной информации см. Мониторинг использования Qlik Answers.

Помогла ли вам эта страница?

Если вы обнаружили какую-либо проблему на этой странице или с ее содержанием — будь то опечатка, пропущенный шаг или техническая ошибка, сообщите нам об этом!

Оставьте свой отзыв здесь