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

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, чтобы создать агента, а затем создайте и разверните навык с помощью инструментов написания кода в вашей организации.

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

Чтобы добавить навык в агента:

1. В области навигации разверните Параметры, затем выберите Навыки.

2. Вверху страницы Навыки выберите Добавить навык.

3. Скопируйте идентификатор своего агента и сообщите его разработчику навыков.

4. Введите URL-адрес манифеста навыка. Манифест навыка содержит информацию, которая понадобится вашему агенту для запуска действий в навыке.

5. Выберите Далее, чтобы начать процесс проверки. После успешной проверки ваш навык будет добавлен к вашему агенту. Теперь можно использовать этот навык в своих темах.

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

Чтобы защитить конфиденциальность пользователей, мы требуем, чтобы навыки были зарегистрированы в качестве приложения в клиенте 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)	Проверьте, был ли ваш агент добавлен в список разрешений навыков.