Configurar habilidades para su uso en agentes de Copilot Studio

Copilot Studio le permite ampliar su agente mediante habilidades. Si ya tiene agentes creados e implementados en su organización (con el SDK de agentes de Microsoft 365 u otras herramientas de pro-código) para escenarios específicos, puede convertir esos bots en una aptitud y registrar esa aptitud en un agente de Copilot Studio.

Billete

Para agregar una aptitud desde la aplicación Copilot Studio en Microsoft Teams, debe tener una suscripción independiente Microsoft Copilot Studio.

Este artículo está pensado para administradores del sistema o profesionales de TI que están familiarizados con las aptitudes.

Una vez que haya registrado una destreza con un agente de Copilot Studio, puede activar acciones de destreza en la conversación.

Requisitos previos

Importante

los agentes de Copilot Studio solo admiten aptitudes creadas con Legacy Bot Framework SDK versión 4.12.0+ y SDK de agentes de Microsoft 365 v1.0.0+. Se deben crear nuevas aptitudes con SDK de agentes de Microsoft 365.

Para configurar una capacidad, debe establecer el registro de aplicaciones asociado en Microsoft Entra ID para su capacidad para la configuración de un solo inquilino.

Cuándo usar flujos de agente o habilidades

** La tabla siguiente le ayuda para determinar cuándo usar flujos de agente o habilidades para una conversación.

Factor Cuándo usar flujos de agentes Cuándo usar habilidades
Rol Los creadores de agentes pueden crear flujos reutilizables para integrarlos en cualquier conversación de agente. Los desarrolladores pueden crear, implementar y hospedar capacidades personalizadas en su propio entorno.
Tipo de conversación Use flujos para operaciones sencillas de un solo turno. Por ejemplo, realizar un pedido u obtener el estado del pedido. Use las habilidades para operaciones complejas de múltiples turnos. Por ejemplo, programar una reunión o reservar un vuelo.
Respuesta Utilice los flujos para emitir una respuesta de agente. Por ejemplo, mostrar un mensaje personalizado o imágenes dentro del texto. Utilice las habilidades para generar cualquier respuesta de agente compatible. Por ejemplo, mostrar una tarjeta adaptable o enviar respuestas aleatorias.
Acciones Use los flujos para desencadenar acciones de un solo turno en el servidor. Por ejemplo, llamar a una API de HTTP o desencadenar un conector personalizado. Use habilidades para desencadenar eventos y acciones en el servidor y en el cliente. Por ejemplo, desplazarse a una página tras la respuesta del agente.

Configurar una habilidad

En primer lugar, use Copilot Studio para crear un agente y crear e implementar una aptitud mediante herramientas de código pro en su organización. Consulte estos ejemplos:

Antes de registrar la habilidad, especifique la identificación del agente a su desarrollador de habilidades para autorizar que el agente llame a acciones en la habilidad. Infórmate más sobre la lista de permisos para una habilidad. Puede obtener la identificación de su agente en la ventana Agregar una capacidad.

Para agregar una habilidad a tu agente:

  1. Vaya a su agente.

  2. Seleccione Configuración>Capacidades para ir a la página de capacidades.

  3. Seleccione Agregar una capacidad.

  4. Copia tu identificación de agente. Debe proporcionar el identificador del agente al desarrollador de habilidades.

  5. Introduzca la URL en el manifiesto de capacidad. El manifiesto de una habilidad contiene la información que su agente necesitará para desencadenar acciones en la habilidad.

  6. Seleccione Siguiente para iniciar el proceso de validación. Una vez que la validación se realiza correctamente, su habilidad es añadida a su agente. Ahora puede usar esta capacidad en sus temas.

Consideraciones de cumplimiento

Para proteger la privacidad del usuario, es necesario registrar habilidades como una aplicación en el tenant de Microsoft Entra ID del usuario que ha iniciado sesión.

Solucionar errores durante el registro de capacidades

El sistema ejecuta una serie de comprobaciones de validación en la dirección URL. Estas comprobaciones garantizan el cumplimiento, la gobernanza y la facilidad de uso de la aptitud que va a agregar al agente. Debe corregir estos errores antes de registrar una habilidad.

Mensaje de error Solución/mitigación de problemas
Tuvimos problemas para conseguir el manifiesto de habilidades.
(MANIFEST_FETCH_FAILED)		 Intente abrir la URL del manifiesto en un explorador web. Si la URL muestra la página dentro de 10 segundos, registra nuevamente la habilidad.
El manifiesto es incompatible.
(MANIFEST_MALFORMED)		 (a) Compruebe si el manifiesto es un archivo JSON válido.
(b) Comprobar si el manifiesto contiene las propiedades requeridas
Por ejemplo, (name, msaAppId, , single endpoint, activities/id, activities/description, activities/type(solo event o message soportado)).
Hay una discrepancia en tus endpoints
(MANIFEST_ENDPOINT_ORIGIN_MISMATCH)		 Compruebe si el punto de conexión de su habilidad coincide con el campo Publisher domain (preferido) o el campo Home page URL del registro de aplicación de Microsoft Entra ID. Más información sobre cómo configurar la página principal de puntos de conexión.
Para añadir una habilidad, primero debe registrarse
(APPID_NOT_IN_TENANT)		 Compruebe si el ID de la aplicación de su habilidad está registrado en el tenant de Microsoft Entra ID de su organización.
El enlace no es válido; El enlace debe comenzar por https://
(URL_MALFORMED, URL_NOT_HTTPS)		 Revise el vínculo para agregar una dirección URL segura.
El manifiesto es demasiado grande;
(MANIFEST_TOO_LARGE)		 Compruebe el tamaño del manifiesto. Debe ser menor o igual que 500 KB.
Ya se ha agregado esta capacidad al agente.
(MANIFEST_ALREADY_IMPORTED)		 Elimine la habilidad y pruebe registrarse de nuevo.
La capacidad está limitada a 100 acciones.
(LIMITS_TOO_MANY_ACTIONS)		 Hay demasiadas acciones de capacidad definidas en el manifiesto de capacidad. Retire las acciones e intente nuevamente.
Las acciones están limitadas a 25 entradas.
(LIMITS_TOO_MANY_INPUTS)		 Hay demasiados parámetros de entrada de acción de habilidad. Quite parámetros y vuelva a intentarlo.
Las acciones están limitadas a 25 salidas.
(LIMITS_TOO_MANY_OUTPUTS)		 Hay demasiados parámetros de salida de acciones de habilidad. Quite parámetros y vuelva a intentarlo.
El agente puede tener un máximo de 100 capacidades.
(LIMITS_TOO_MANY_SKILLS)		 Se han agregado demasiadas habilidades a un agente. Elimine una habilidad existente e inténtelo de nuevo.
Parece que algo salió mal.
(AADERROR_OTHER)		 Se ha producido un error transitorio al validar la habilidad. Reinténtelo.
Se ha producido un problema al comprobar la habilidad.
(ENDPOINT_HEALTHCHECK_FAILED, HEALTH_PING_FAILED)		 Comprueba si el endpoint de tu habilidad está en línea y respondiendo a mensajes. Compruebe también que el registro de la aplicación de la capacidad de arrendatario único se haya implementado en el mismo arrendatario.
Esta habilidad no ha permitido incluir a tu agente
(ENDPOINT_HEALTHCHECK_UNAUTHORIZED)		 Compruebe si se ha agregado el agente a la lista de permisos de las habilidades.
  • Last updated on