Настройка навыка Bot Framework для использования в Copilot Studio

Статья
08/12/2024

Copilot Studio позволяет расширить помощника, используя навыки Bot Framework. Если вы уже создали и развернули ботов в своей организации (используя SDK Bot Framework и профессиональные инструменты разработки) для конкретных сценариев, вы можете преобразовать эти боты в навык и зарегистрировать этот навык в помощнике Copilot Studio.

Заметка

Чтобы добавить навык из приложения Copilot Studio в Microsoft Teams, вам нужна автономная подписка Microsoft Copilot Studio.

Эта статья предназначена для системных администраторов или ИТ-специалистов, которые знакомы с навыками Bot Framework. После того, как навык был зарегистрирован в помощнике Copilot Studio, авторы могут без проблем запускать действия навыка в разговоре.

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

Просмотр ограничений и проверка для навыков, используемых в Copilot Studio

Важно

Помощники Copilot Studio поддерживают только навыки, созданные с использованием Bot Framework SDK версии 4.12.0+.

Классические чат-боты поддерживают только навыки, созданные с использованием Bot Framework SDK версии 4.7+.

Если вы используете Bot Framework Composer, настоятельно рекомендуется использовать Composer 2.x. Если вы хотите использовать существующего помощника Composer 1.x, сначала перенесите его в Composer 2.x, прежде чем использовать его как навык.

Чтобы настроить навык, для связанной регистрации приложения в Microsoft Entra ID вашего навыка должна быть установлена конфигурация с несколькими арендаторами.

Действия потоков и навыков

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

	Действия потока	Действия навыка
Пользователь	Разработчики помощников могут создавать многократно используемые потоки, чтобы встроить их в любой разговор с помощником	Разработчики могут создавать, развертывать и размещать пользовательские навыки в своей среде
Разговор	Используйте потоки для простых одношаговых операций. Например, оформить заказ или получить статус заказа.	Используйте навыки для сложных, многошаговых операций. Например, запланировать встречу или забронировать рейс.
Отклик	Используйте потоки, чтобы выдать ответ помощника. Например, показать персональное сообщение или встроенные изображения.	Используйте навыки, чтобы выдать любой поддерживаемый ответ помощника. Например, показать адаптивную карточку или отправить случайные ответы.
Действия	Используйте потоки для запуска одношаговых действий на стороне сервера. Например, вызов HTTP API или активация пользовательского соединителя.	Используйте навыки для запуска событий и действий на стороне сервера и на стороне клиента. Например, переход на страницу после ответа помощника.

Настройка навыка

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

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

Чтобы добавить навык в помощника:

В области навигации разверните Параметры, затем выберите Навыки.
Вверху страницы Навыки выберите Добавить навык.
Скопируйте ИД помощника и сообщите его разработчику навыков.
Введите URL-адрес манифеста навыка. Манифест навыка содержит информацию, которая понадобится вашему помощнику для запуска действий в навыке.
Выберите Далее, чтобы начать процесс проверки. После успешной проверки ваш навык будет добавлен к вашему помощнику. Теперь можно использовать этот навык в своих темах.

Особенности соответствия

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

Устранение ошибок при регистрации навыков

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

Сообщение об ошибке	Устранение неполадок/устранение рисков
Возникла проблема при получении манифеста навыка. (`MANIFEST_FETCH_FAILED`)	Попробуйте открыть свой URL-адрес манифеста в веб-браузере. Если URL-адрес отображает страницу в течение 10 секунд, заново зарегистрируйте свой навык.
Манифест несовместим. (`MANIFEST_MALFORMED`)	(a) Проверьте, является ли манифест допустимым файлом JSON. (b) Проверьте, содержит ли манифест необходимые свойства Например, (`name`, `msaAppId`, одна `endpoint`, `activities`/`id`, `activities`/`description`, `activities`/`type` (поддерживается только `event` или `message`)).
В ваших конечных точках есть несоответствие (`MANIFEST_ENDPOINT_ORIGIN_MISMATCH`)	Проверьте, соответствует ли ваша конечная точка навыка `Publisher domain` (предпочтительно) или `Home page URL` вашей регистрации приложения Microsoft Entra ID. Узнайте больше о настройке домашней страницы для конечных точек.
Для добавления навыка его сначала необходимо зарегистрировать (`APPID_NOT_IN_TENANT`)	Проверьте, зарегистрирован ли идентификатор приложения вашего навыка в клиенте Microsoft Entra ID вашей организации.
Ссылка не действительна; ссылка должна начинаться с https:// (`URL_MALFORMED`, `URL_NOT_HTTPS`)	Повторно введите ссылку в виде безопасного URL-адреса.
Слишком большой размер манифеста; (`MANIFEST_TOO_LARGE`)	Проверьте размер манифеста. Но должен быть меньше или равен 500 КБ.
Этот навык уже добавлен в вашего помощника. (`MANIFEST_ALREADY_IMPORTED`)	Удалите навык и попробуйте зарегистрировать снова.
Навык ограничен 100 действиями. (`LIMITS_TOO_MANY_ACTIONS`)	В манифесте навыка определено слишком много действий навыка. Удалите действия и повторите попытку.
Действия ограничены 25 входными параметрами. (`LIMITS_TOO_MANY_INPUTS`)	Слишком много входных параметров действия навыка. Удалите параметры и повторите попытку.
Действия ограничены 25 выходными параметрами. (`LIMITS_TOO_MANY_OUTPUTS`)	Слишком много выходных параметров действия навыка. Удалите параметры и повторите попытку.
Ваш помощник может иметь максимум 100 навыков. (`LIMITS_TOO_MANY_SKILLS`)	В помощника добавлено слишком много навыков. Удалите существующий навык и попробуйте снова.
Похоже, что-то пошло не так. (`AADERROR_OTHER`)	Во время проверки вашего навыка произошла временная ошибка. Повторите попытку.
Произошла ошибка при проверке навыка. (`ENDPOINT_HEALTHCHECK_FAILED`, `HEALTH_PING_FAILED`)	Убедитесь, что конечная точка навыка находится в сети и отвечает на сообщения.
Ваш помощник не указан в списке разрешений этого навыка (`ENDPOINT_HEALTHCHECK_UNAUTHORIZED`)	Проверьте, был ли ваш помощник добавлен в список разрешений навыков.

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