Реализация навыка для использования в Power Virtual Agents

  • Статья

ОБЛАСТЬ ПРИМЕНЕНИЯ: ПАКЕТ SDK версии 4

Навык — это бот, который может использоваться другим ботом. Таким образом можно создать однопользовательского бота и расширить его возможности одним или несколькими навыками. Чтобы узнать больше о навыках в общем, ознакомьтесь с разделом Обзор навыков. Чтобы узнать об их создании, ознакомьтесь с разделом Реализация навыка. Кроме того, шаблоны виртуального помощника содержат набор готовых навыков, которые можно настроить и развернуть, а не создавать их с нуля.

Если вы ожидаете, что навык будет использоваться из бота Power Virtual Agent , вам потребуется учитывать некоторые дополнительные ограничения на навык.

Ограничения манифеста

Служба Power Virtual Agents накладывает ограничения на то, что можно объявить в манифесте навыка.

  • Можно объявить только 100 или меньше действий.
  • Каждое действие может использовать не более 25 входных или выходных данных.
  • Нельзя использовать тип массива для входных или выходных данных.

Ограничение арендаторов

Чтобы обеспечить соответствие и адекватное управление пользовательскими навыками, зарегистрированными для использования в Power Virtual Agent, бот навыка должен быть зарегистрированным приложением в идентификаторе Microsoft Entra. После добавления навыка мы проверяем, что его идентификатор приложения относится к арендатору клиента, выполнившего вход, а конечная точка навыка соответствует Home Page URL зарегистрированного приложения.

Прежде чем зарегистрировать бот в качестве навыка в Power Virtual Agent, необходимо убедиться, что для бота домашняя страница в портал Azure задается URL-адрес манифеста навыка бота.

Проверка, выполненная при регистрации навыка

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

Этап проверки Код ошибки Сообщение об ошибке Описание или устранение рисков
Допустимый URL-адрес манифеста URL_MALFORMED, URL_NOT_HTTPS Недопустимая ссылка. Ссылка должна начинаться с https:// Повторно введите ссылку в виде безопасного URL-адреса.
Манифест можно получить MANIFEST_FETCH_FAILED При получении манифеста навыка возникли проблемы. Убедитесь, что URL-адрес манифеста является ссылкой на манифест; попробуйте открыть URL-адрес манифеста в веб-браузере. Если URL-адрес отображает страницу в течение 10 секунд, заново зарегистрируйте свой навык.
Манифест доступен для чтения MANIFEST_TOO_LARGE Манифест слишком велик. Манифест должен иметь значение 500 КБ или меньше.
Манифест доступен для чтения MANIFEST_MALFORMED Манифест несовместим. Проверьте, является ли манифест допустимым JSON-файлом. Проверьте, содержит ли манифест обязательные свойства, например name, msaAppIdи т. д. Дополнительные сведения см . в ограничениях манифеста .
Навык еще не зарегистрирован MANIFEST_ALREADY_IMPORTED Этот навык уже добавлен в ваш бот. Удалите навык и снова зарегистрируйте его.
Соответствие доменов конечной точки манифеста и домашней страницы MANIFEST_ENDPOINT_ORIGIN_MISMATCH Несоответствие в конечных точках навыка. Домен URL-адреса домашней страницы приложения Microsoft Entra ID и домен URL-адреса манифеста должен соответствовать. Ознакомьтесь с ограничением арендаторов.
Навык размещен в клиенте пользователя, вошедшего в систему APPID_NOT_IN_TENANT Чтобы добавить навык, его необходимо сначала зарегистрировать. Глобальный администратор должен зарегистрировать навык в организации пользователя, выполнившего вход.
Действия ограничены LIMITS_TOO_MANY_ACTIONS Навык ограничен 100 действиями. В манифесте навыка определено слишком много действий навыка. Удалите действия и повторите попытку.
Входные параметры действия ограничены LIMITS_TOO_MANY_INPUTS Действия ограничены 25 входными параметрами. Слишком много входных параметров действия навыка. Удалите параметры и повторите попытку.
Параметры выходных данных действия ограничены LIMITS_TOO_MANY_OUTPUTS Действия ограничены 25 выходными параметрами. Слишком много выходных параметров действия навыка. Удалите параметр и повторите попытку.
Количество навыков ограничено LIMITS_TOO_MANY_SKILLS У бота может быть до 25 навыков. В бот добавлено слишком много навыков. Удалите существующий навык и попробуйте снова.
Допустимый маркер безопасности AADERROR_OTHER Похоже, что произошла ошибка. Могла возникнуть временная ошибка при получении маркера безопасности для активации навыка. Повторите импорт навыка.
Навык работоспособен ENDPOINT_HEALTHCHECK_FAILED, HEALTH_PING_FAILED Произошла ошибка при проверке навыка. Power Virtual Agent получил неизвестный ответ при отправке действия навыку EndOfConversation . Убедитесь, что ваш навык работает и отвечает правильно.
Навык авторизован ENDPOINT_HEALTHCHECK_UNAUTHORIZED Этот навык не разрешен в списке бота. Проверьте, был ли бот добавлен в список разрешений навыка. Дополнительные сведения см. в разделе Power Virtual Agent, как настроить навык.