Реализация навыка для использования в Copilot Studio
ОБЛАСТЬ ПРИМЕНЕНИЯ: ПАКЕТ SDK версии 4
Навык — это бот, который может использоваться другим ботом. Таким образом, вы можете создать одного пользователя бота и расширить его с помощью одного или нескольких навыков. Чтобы узнать больше о навыках в общем, ознакомьтесь с разделом Обзор навыков. Чтобы узнать об их создании, ознакомьтесь с разделом Реализация навыка. Кроме того, шаблоны Виртуальный помощник содержат набор предварительно созданных навыков, которые можно настроить и развернуть вместо создания с нуля.
Если вы ожидаете, что ваш навык будет использоваться из copilot Studio copilot, существуют некоторые другие ограничения, которые вы должны учитывать.
Ограничения манифеста
Copilot Studio устанавливает ограничения на то, что можно объявить в манифесте навыка.
- Можно объявить только 100 или меньше действий.
- Каждое действие может использовать не более 25 входных или выходных данных.
- Нельзя использовать тип массива для входных или выходных данных.
Ограничение арендаторов
Чтобы обеспечить соответствие и надлежащее управление пользовательскими навыками, зарегистрированными для использования в Copilot Studio, бот навыка должен быть зарегистрированным приложением в идентификаторе Microsoft Entra. После добавления навыка мы проверяем, находится ли идентификатор приложения навыка в клиенте пользователя, вошедшего в систему, и конечная точка навыков соответствует зарегистрированным приложениям Home Page URL.
Прежде чем зарегистрировать бот в качестве навыка в Copilot Studio, необходимо убедиться, что для бота домашняя страница в портал Azure задается URL-адрес манифеста навыка бота.
Ограничение с одним клиентом и мультитенантным доступом
Copilot Studio ранее создал многотенантные приложения Entra ID. Однако теперь создается однотенантное приложение Entra ID. Чтобы навыки правильно работали с агентами на основе новых приложений с идентификатором entra с одним клиентом, необходимо настроить навыки для экземпляра с одним клиентом.
Преобразование существующего навыка из мультитенантного в один клиент
Вы можете преобразовать существующие навыки из мультитенантной поддержки в поддержку одного клиента. Чтобы преобразовать мультитенантный навык в навык с одним клиентом, необходимо выполнить следующие изменения:
- Создание регистрации приложения с одним клиентом Entra ID
- Обновление конфигурации навыка для использования одного клиента
- Развертывание навыка
- Обновление исходного кода (необязательно)
Для навыков одного клиента требуются следующие значения:
| Свойство | Ценность |
|---|---|
MicrosoftAppType |
SingleTenant |
MicrosoftAppId |
Идентификатор приложения бота |
MicrosoftAppPassword |
Пароль приложения бота |
MicrosoftAppTenantId |
Идентификатор клиента приложения бота |
Для справки для мультитенантных навыков использовались следующие значения:
| Свойство | Ценность |
|---|---|
MicrosoftAppType |
MultiTenant |
MicrosoftAppId |
Идентификатор приложения бота |
MicrosoftAppPassword |
Пароль приложения бота |
MicrosoftAppTenantId |
Неприменимо; слева пустым для мультитенантных ботов |
После преобразования значений импортируйте навык в экземпляр агента, созданный в качестве экземпляра одного клиента. Вы также можете просмотреть регистрацию приложения идентификатора записи, чтобы узнать, как она была создана. Перейдите к разделу Управление>проверкой подлинности>Поддерживаемые типы учетных записей.
Многотенантное обновление кода с одним клиентом
После преобразования значений может потребоваться также обновить код, чтобы разрешить подключение указанного клиента к навыку. Дополнительные сведения см. в разделе BotBuilder-Samples.
Проверка, выполненная при регистрации навыка
Когда конечный пользователь пытается подключиться к навыку из своего 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. |