Configurar una capacidad de Bot Framework para usarla en Copilot Studio

Copilot Studio le permite extender su copiloto mediante las habilidades de Bot Framework. Si ya ha creado e implementado bots en su organización (mediante el SDK y las herramientas de desarrollo profesional de Bot Framework) para escenarios específicos, puede convertir esos bots en una habilidad y registrar esa habilidad en un copiloto de Copilot Studio.

Nota

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

Este artículo se destina a administradores de sistemas o profesionales de TI que conozcan las habilidades de Bot Framework. Después de registrar una habilidad con un copiloto de Copilot Studio, los autores pueden desencadenar acciones de habilidades en la conversación sin problemas.

Requisitos previos

• Revisar las restricciones y la validación de las capacidades utilizadas en Copilot Studio

Importante

Los copilotos de Copilot Studio solo admiten habilidades construidas usando Bot Framework SDK versión 4.12.0+.

Los bots de chat clásicos solo admiten habilidades construidas usando Bot Framework SDK versión 4.7+.

Si está usando Bot Framework Composer se recomienda encarecidamente que utilice Composer 2.x. Si desea utilizar un copiloto Composer 1.x existente, primero debe migrarlo a Composer 2.x antes de usarlo como una capacidad.

Para configurar una habilidad, el registro de aplicación asociado en Microsoft Entra ID de su habilidad debe estar configurado en Configuración multiinquilino.

Acciones de flujos y acciones de habilidades

La tabla siguiente le ayudará a determinar cuándo se deben usar las habilidades en una conversación.

	Acciones de flujo	Acciones de capacidad
Rol	Los creadores de Copilot pueden crear flujos reutilizables para integrarlos en cualquier conversación de copiloto	Los desarrolladores pueden crear, implementar y hospedar capacidades personalizadas en su propio entorno
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.
Response	Utilice los flujos para emitir una respuesta de copiloto. Por ejemplo, mostrar un mensaje personalizado o imágenes en línea.	Use las capacidades para emitir cualquier respuesta de copiloto admitida. 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 copiloto.

Configurar una aptitud

Primero, utilice Copilot Studio para crear un copiloto y crear e implementar una habilidad usando herramientas de código profesional en su organización.

Antes de registrar la habilidad, especifique la identificación del copiloto a su desarrollador de habilidades para autorizar que el copiloto haga llamadas a acciones en la capacidad. Más información sobre la lista de permitidos de la capacidad. Puede obtener la identificación de su copiloto en la ventana Agregar una habilidad.

Para agregar una habilidad a su copiloto:

1. En el panel de navegación, expanda Configuración y seleccione Capacidades.

2. Al principio de la página Capacidades, seleccione Agregar capacidad.

3. Copie la identificación de su copiloto y entréguesela a su desarrollador de habilidades.

   

4. Introduzca la URL del manifiesto de capacidad. El manifiesto de una capacidad contiene la información que el copiloto necesitará para desencadenar acciones en la capacidad.

5. Seleccione Siguiente para iniciar el proceso de validación. Una vez que se realice la validación correctamente, su habilidad se agrega a su copiloto. Ahora puede usar esta capacidad en sus temas.

Consideraciones de cumplimiento

Para proteger la privacidad del usuario, requerimos que se registren las capacidades como una aplicación en el inquilino de Microsoft Entra ID del usuario que inició sesión.

Solucionar errores durante el registro de capacidades

Se realizan una serie de comprobaciones de validación con la URL. Estas comprobaciones garantizan el cumplimiento, la gobernanza y la facilidad de uso de la capacidad que se va a agregar al copiloto. Debe corregir estos errores antes de registrar una capacidad.

Mensaje de error	Solución/mitigación de problemas
Tuvimos problemas para obtener el manifiesto de capacidades. (MANIFEST_FETCH_FAILED)	Intente abrir la URL del manifiesto en un explorador web. Si la URL muestra la página en 10 segundos, vuelva a registrar la capacidad.
El manifiesto es incompatible. (MANIFEST_MALFORMED)	(a) Compruebe si el manifiesto es un archivo JSON válido. (b) Verifique si el manifiesto contiene las propiedades requeridas Por ejemplo, (name, msaAppId, único endpoint, activities/id, activities/description, activities/type (solamenteevent o message soportado)).
Hay una discordancia en los puntos de conexión (MANIFEST_ENDPOINT_ORIGIN_MISMATCH)	Compruebe si el punto de conexión de la capacidad coincide con el campo Publisher domain (preferido) o 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 agregar una capacidad, primero se debe registrar (APPID_NOT_IN_TENANT)	Compruebe si el id. de aplicación de la capacidad está registrado en el inquilino de Microsoft Entra ID de la organización.
El vínculo no es válido; debe empezar por https:// (URL_MALFORMED, URL_NOT_HTTPS)	Vuelva a introducir el vínculo como una 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 copiloto. (MANIFEST_ALREADY_IMPORTED)	Elimine la capacidad y pruebe a registrarla de nuevo.
La capacidad está limitada a 100 acciones. (LIMITS_TOO_MANY_ACTIONS)	Hay demasiadas acciones de capacidad definidas en el manifiesto de capacidad. Quite acciones y vuelva a intentarlo.
Las acciones están limitadas a 25 entradas. (LIMITS_TOO_MANY_INPUTS)	Hay demasiados parámetros de entrada de acción de capacidad. 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 acción de capacidad. Quite parámetros y vuelva a intentarlo.
El copiloto puede tener un máximo de 100 capacidades. (LIMITS_TOO_MANY_SKILLS)	Se han agregado demasiadas capacidades a un copiloto. Quite una capacidad existente y vuelva a intentarlo.
Parece que se ha producido un problema: (AADERROR_OTHER)	Se ha producido un error transitorio al validar la capacidad. Reinténtelo.
Se ha producido un problema al comprobar la capacidad. (ENDPOINT_HEALTHCHECK_FAILED, HEALTH_PING_FAILED)	Compruebe si el punto de conexión de la capacidad está en línea y responde a los mensajes.
Esta capacidad no ha incluido el copiloto en la lista de permitidos (ENDPOINT_HEALTHCHECK_UNAUTHORIZED)	Compruebe si se ha agregado el copiloto a la lista de permitidos de las capacidades.