Поделиться через

Реализация навыка для использования в Copilot Studio

  • Статья

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

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

Если вы ожидаете, что ваш навык будет использоваться из copilot Studio copilot, существуют некоторые другие ограничения, которые вы должны учитывать.

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

Copilot Studio устанавливает ограничения на то, что можно объявить в манифесте навыка.

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

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

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

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

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

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

Этап проверки Код ошибки Сообщение об ошибке Описание или устранение рисков
Допустимый 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 Произошла ошибка при проверке навыка. Copilot Studio получил неизвестный ответ при отправке EndOfConversation действия в навык. Убедитесь, что ваш навык работает и отвечает правильно.
Навык авторизован ENDPOINT_HEALTHCHECK_UNAUTHORIZED Этот навык не разрешен в списке бота. Проверьте, соответствует ли бот списку разрешений навыка. Дополнительные сведения см. в Статье о настройке навыка в Copilot Studio.