Интеграция управления знаниями в Dynamics 365 с ботами Copilot Studio

Заметка

Информация о доступности функций следующая.

Dynamics 365 Contact Center — внедренное	Dynamics 365 Contact Center — автономное	Dynamics 365 Customer Service
нет	Да	Да

Важно

Возможности и функции Power Virtual Agents теперь являются частью Microsoft Copilot Studio после значительных инвестиций в генеративный искусственный интеллект и расширенную интеграцию с Microsoft Copilot.

Некоторые статьи и снимки экрана могут ссылаться на Power Virtual Agents, пока мы обновляем документацию и учебные материалы.

Интегрируйте управление знаниями с ботом Copilot Studio для использования настраиваемых разговоров. Боты помогают отвечать на вопросы, выполнять действия и решать простые задачи. Это высвобождает время вашего агента для решения сложных вопросов, требующих вмешательства человека.

Copilot Studio позволяет настраивать боты, настроенные на различные темы и триггерные фразы, чтобы автоматически решать вопросы, заданные вашими клиентами на странице вашего портала. Дополнительные сведения: Обзор Copilot Studio

Вы можете интегрировать управление знаниями с ботом Copilot Studio одним из следующих способов:

• Поиск по статьям базы знаний Dynamics 365
• Шаблон потока Power Automate

Предварительные условия

• Для интеграции должен быть включен поиск в Dataverse. У вас должна быть роль системного администратора, чтобы иметь возможность включить поиск Dataverse. Дополнительные сведения: Настройка поиска Dataverse для вашей среды

• Перед началом интеграции необходимо выполнить следующие два шага:

  1. Создайте и опубликуйте статьи базы знаний на портале, созданном в Power Apps.

     Настройте свой портал с функцией порталов Power Apps, прежде чем интегрировать управление знаниями с ботом Copilot Studio. Больше информации: Использование параметров, чтобы настроить управление знаниями. Для получения дополнительной информации о настройке вашего портала Power Apps см. раздел: Документация портала Power Apps.

     Вы можете создавать статьи базы знаний и управлять ими, установив для поля Внутренние значение Нет в веб-API Microsoft Datverse. Дополнительные сведения: knowledgearticle EntityType

  2. Создайте бот Copilot Studio и тему в нем.

     • Дополнительные сведения о создании бота см. в разделе Создание и удаление ботов Copilot Studio.
     • Для получения дополнительной информации о создании темы см. в разделе Создание и изменение тем в боте Copilot Studio.

Использование действия "Поток поиска по статьям базы знаний Dynamics 365"

Выполните следующие шаги, если ходите интегрировать бот Copilot Studio с управлением знаниями, используя действие Поиск по статьям базы знаний Dynamics 365:

1. Задайте ссылки подключения.
2. Добавьте действие в тему Copilot Studio.

Задание ссылок подключения

Решение интеграции управления знаниями с Copilot Studio использует поток с подключениями, такими как Преобразование содержимого и Microsoft Dataverse. Вы должны настроить эти ссылки на подключения перед включением действия Поток поиска по статьям базы знаний Dynamics 365.

Заметка

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

Чтобы задать ссылки подключения:

1. Перейдите на сайт make.powerapps.com.

2. Перейдите в Решения. На странице Решения отображается уведомление со ссылкой на настройку ссылок подключения.

   

3. Выберите ссылку. Если вы не видите уведомление на странице Решения, перейдите в раздел Решения по умолчанию>Ссылки на подключения.

   

4. Выберите подключения для Microsoft Dataverse и Преобразование содержимого на странице Ссылки для подключения.

5. Выберите Сохранить и закрыть.

6. Перейдите в раздел Решение по умолчанию>Облачные потоки и включите поток Поток поиска по статьям базы знаний Dynamics 365.

   

Добавление действия в тему Copilot Studio

После настройки ссылок на подключение в make.powerapps.com перейдите в раздел Чат-боты>Список и выберите нужный чат-бот. Это приведет вас на портал Copilot Studio, на котором вы можете создать тему. Если вам нужно создать чат-бот, см. Создание чат-ботов из Power Apps.

Вы можете создать тему с двумя узлами вопросов для текста поиска и фильтра или настроить интеграцию поиска, чтобы настроить резервную тему в случае нераспознанной фразы для поиска. Дополнительная информация: Настройка системной резервной темы в Copilot Studio

Если вы создаете тему с двумя узлами вопросов для узла вопроса фильтра, автор Copilot Studio может предоставить пример значения фильтра, например, statecode eq 3.

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

1. На портале Copilot Studio выберите Темы>Создать тему.

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

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

4. Выберите Добавить узел (+) и выберите Вызвать действие. Выберите действие Поток поиска по статьям базы знаний Dynamics 365.

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

   

6. Добавьте узел сообщения, чтобы показать результаты, возвращаемые потоком. Дополнительная информация: Отображение результатов

   

7. Выберите Сохранить.

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

   Совет

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

   

9. После настройки темы замените Поток поиска по статьям базы знаний Dynamics 365 действием Поиск статей базы знаний Dynamics 365. Теперь вы можете настроить любой бот в организации для доступа к статьям базы знаний с помощью действия Поиск статей базы знаний Dynamics 365.

   

10. Удалите узел вопроса фильтра. Дополнительные сведения: Работа с фильтрами.

11. Обновите узел сообщения с выходными данными действия и выберите Сохранить.

Работа с фильтрами

• По умолчанию поиск выполняется по внешним опубликованным статьям (statecode eq 3 и isinternal eq false). Если вам необходимо выполнить дополнительную фильтрацию, вы можете задать требуемый фильтрующий запрос в качестве входной переменной фильтра (текст).
• Чтобы проверить, какие фильтры можно использовать, а также атрибуты сущности статьи базы знаний, см. раздел knowledgearticle EntityType.
• Чтобы написать поисковый запрос Dataverse с использованием фильтров, см. раздел Работа с операторами.
• Чтобы увидеть условия фильтра, которые не поддерживаются поиском Dataverse, см. раздел Настройка поиска Dataverse для улучшения результатов поиска и производительности.
• Чтобы отфильтровать строковый атрибут, например ключевые слова, добавьте строковое значение к тексту поиска.

Публикция изменений

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

Использование шаблона потока Power Automate

Выполните следующие шаги, если хотите интегрировать бот Copilot Studio с управлением знаниями с помощью шаблона потока Power Automate:

1. Создайте поток с помощью шаблона.
2. Добавьте поток решения в тему Copilot Studio.

Создание потока с помощью шаблона

1. Перейдите на powerautomate.microsoft.com.

2. На странице шаблонов найдите шаблон Генерация ответов из статей базы знаний Dataverse для Power Virtual Agent.

   

3. Выберите Продолжить. Вы будете перенаправлены на шаблон потока Power Automate.

4. Сохраните шаблон, затем выберите Решения. Вам может быть выведено сообщение, в котором вы можете выбрать ОК.

5. Выберите Создать решение.

6. Введите отображаемое имя. Список решений включает каждое решение в вашей организации. Выберите соглашение об именовании, которое поможет вам фильтровать только ваше решение. Например, вы можете добавить свой адрес электронной почты перед именем вашего решения: johndoe-power-virtual-agent-knowledgesearch-fallback.

7. Выберите своего издателя из списка вариантов.

8. Примите значения по умолчанию для имени и версии.

9. Выберите Создать, чтобы завершить процесс.

   

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

11. В решении выберите Добавить существующие, затем выберите Облачный поток из списка.

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

Дополнительные сведения о управлении решениями Copilot Studio см. в статье Экспорт и импорт ботов с использованием решений.

Добавление потока решения в тему Copilot Studio

1. Откройте браузер с холстом разработки.

2. Над полем действия Сообщение выберите соединитель и выберите Вызвать действие.

3. Во всплывающем окне потока выберите новый поток с именем Генерация ответов из статей базы знаний Dataverse для Power Virtual Agent. В потоке появится новое действие.

4. Чтобы правильно установить входную переменную для действия, выберите Выберите переменную, затем выберите bot.UnrecognizedTriggerPhrase.

5. Чтобы вернуть результаты поиска статьи базы знаний боту, перейдите в раздел Отображение результатов.

Отображение результатов

Чтобы вернуть результаты поиска статьи базы знаний боту, выполните одно из следующих действий:

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

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

#kbcardjson()

-  
{ 

  "type": "AdaptiveCard", 

    "body": [ 

        { 

            "type": "ColumnSet", 

            "columns": [ 

                { 

                    "type": "Column", 

                    "items": [ 

                        { 

                            "type": "Image", 

                            "height": "35px", 

                            "url": "https://th.bing.com/th/id/R4fbade037f8209666b06aa22641708fc?rik=ya%2bpnPJ41EFFMg&riu=http%3a%2f%2fmolnar-institute.com%2ffileadmin%2f_processed_%2fcsm_KnowledgeManagement_icon_forWebsite_bcda89676b.png&ehk=J%2bz2G15xtbJgd7ssSXo7X2q7LDLaMGl7EuGUSQU6P2s%3d&risl=&pid=ImgRaw", 

                            "size": "Small" 

                        } 

                    ], 

                    "width": "auto" 

                }, 

                { 

                    "type": "Column", 

                    "items": [ 

                        { 

                            "type": "TextBlock", 

                            "weight": "Bolder", 

                            "text": "${json(virtualagent.jsonResult).articles[0].title}", 

                            "wrap": true, 

                            "size": "Large" 

                        }, 

                        { 

                            "type": "TextBlock", 

                            "spacing": "None", 

                            "text": "Last modified on ${json(virtualagent.jsonResult).articles[0].modifiedon}", 

                            "isSubtle": true, 

                            "wrap": true 

                        } 

                    ], 

                    "width": "stretch" 

                } 

            ] 

        }, 

        { 

            "type": "TextBlock", 

            "text": "${json(virtualagent.jsonResult).articles[0].description}", 

            "wrap": true, 

            "size": "medium" 

        } 

    ], 

    "actions": [ 

        { 

            "type": "Action.OpenUrl", 

            "title": "View article in Dynamics App", 

            "url": "${json(virtualagent.jsonResult).articles[0].crmAppUrl}" 

        } 

    ], 

    "$schema": "http://adaptivecards.io/schemas/adaptive-card.json", 

    "version": "1.0" 

} 

Устранить неполадки

• Если диалоговое окно имеет перекрестные ссылки, после внесения в него изменений вы увидите ошибку проверки при публикации, и Copilot Studio заблокирует публикацию. Дополнительные сведения: Публикация новейшего содержимого бота

• Если при сохранении темы обнаружены ошибки в области Проверка темы отображаются затрагиваемые темы. Ошибки помешают работе бота и должны быть исправлены, прежде чем вы сможете опубликовать своего бота. Дополнительные сведения: Ошибки темы

• Дополнительные сведения о кодах ошибок потоков см. в статье Коды ошибок: Copilot Studio

См. также

Создание и изменение тем