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

Copilot Studio позволяет расширять работу агента, используя skills. Если у вас уже есть агенты, созданные и развернутые в вашей организации (с использованием Пакет SDK агентов Microsoft 365 или других инструментов про-кода) для конкретных сценариев, вы можете преобразовать этих ботов в навык и зарегистрировать его в агенте Copilot Studio.

Замечание

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

Эта статья предназначена для системных администраторов или IT-специалистов, знакомых с навыками.

После регистрации навыка у агента Copilot Studio вы можете без проблем активировать действия навыка в разговоре.

Предпосылки

Это важно

Copilot Studio агенты поддерживают только навыки, созданные с использованием Legacy Bot Framework SDK версии 4.12.0+ и Пакет SDK агентов Microsoft 365 v1.0.0+. Новые навыки следует развивать с помощью Пакет SDK агентов Microsoft 365.

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

Когда использовать потоки агентов или навыки

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

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

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

Во-первых, используйте Copilot Studio создайте агента и создайте и внедрите навык с помощью инструментов профессионального кода в вашей организации. Обратитесь к этим примерам:

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

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

  1. Обратитесь к своему агенту.

  2. Выберите Настройки>Навыки, чтобы перейти на страницу навыков.

  3. Выберите добавить навык.

  4. Скопируйте свой агентский ID. Вам нужно предоставить ID агента вашему разработчику навыков.

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

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

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

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