Implementación de una aptitud en Power Virtual Agents

  • Artículo

SE APLICA A: SDK v4

Una aptitud es un bot que puede usar otro bot. De este modo, puede crear un solo bot orientado al usuario y ampliarlo con una o varias aptitudes. Puede obtener más información sobre las aptitudes en general en Acerca de las aptitudes y cómo crearlas en Implementación de una aptitud. Como alternativa, las plantillas de Virtual Assistant contienen un conjunto de aptitudes precompiladas que puede personalizar e implementar en lugar de crear una desde cero.

Si tiene previsto que su aptitud se utilice a partir de un bot de Power Virtual Agents, existen algunas restricciones adicionales impuestas a su aptitud que deberá tener en cuenta.

Manifiesto de restricciones

Power Virtual Agents impone restricciones en lo que puede declarar en su manifiesto de aptitud.

  • Puede declarar solo 25 acciones o menos.
  • Cada acción se limita a 25 entradas o salidas o menos.
  • No puede usar el tipo de matriz para entradas o salidas.

Restricción del mismo inquilino

Para garantizar el cumplimiento y la gobernanza adecuada de las aptitudes personalizadas que se registran para su uso en Power Virtual Agents, el bot de aptitud debe ser una aplicación registrada de Microsoft Entra ID. Tras agregar una aptitud, se valida si el identificador de la aplicación de la aptitud es el del inquilino del usuario que ha iniciado sesión y el punto de conexión de aptitudes coincide con la Home Page URL de la aplicación registrada.

Antes de que pueda registrar el bot como aptitud en Power Virtual Agents, debe asegurarse de que, en el bot, la página principal de Azure Portal se establece en la dirección URL del manifiesto de aptitud del bot.

Validación realizada durante el registro de una aptitud

Cuando un usuario final intenta conectarse a su aptitud desde su bot de Power Virtual Agents, primero deberá importar la aptitud a Power Virtual Agents. Su aptitud pasará por una serie de comprobaciones de validación. Un error encontrado durante una de estas comprobaciones puede dar lugar a un mensaje de error, tal como se describe en esta tabla.

Paso de validación Código de error Mensaje de error Descripción o mitigación
La dirección URL del manifiesto es válida URL_MALFORMED, URL_NOT_HTTPS El vínculo no es válido; el vínculo debe empezar por https:// Vuelva a introducir el vínculo como una URL segura.
El manifiesto es recuperable MANIFEST_FETCH_FAILED Hemos tenido problemas para obtener el manifiesto de aptitud. Compruebe que la dirección URL del manifiesto es un vínculo al manifiesto; intente abrir la dirección 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 legible MANIFEST_TOO_LARGE El manifiesto es demasiado grande. El manifiesto debe ser de 500 KB o menos.
El manifiesto es legible MANIFEST_MALFORMED El manifiesto es incompatible. Compruebe si el manifiesto es un archivo JSON válido. Compruebe si el manifiesto contiene las propiedades necesarias, como name, msaAppId, etc. Consulte Restricciones del manifiesto para obtener más información.
La aptitud aún no está registrada MANIFEST_ALREADY_IMPORTED Ya se ha agregado esta capacidad al bot. Elimine la aptitud y regístrela de nuevo.
Coincidencia de dominios de punto de conexión de manifiesto y de página principal MANIFEST_ENDPOINT_ORIGIN_MISMATCH Hay un error de coincidencia en los puntos de conexión de aptitudes. El dominio de dirección URL de la página principal de la aplicación de Microsoft Entra ID y el dominio de dirección URL del manifiesto deben coincidir. Consultar el apartado Restricción del mismo inquilino
La aptitud se hospeda en el inquilino del usuario que ha iniciado sesión APPID_NOT_IN_TENANT Para agregar una aptitud, primero se debe registrar. Un administrador global debe registrar la aptitud en la organización del usuario que ha iniciado sesión.
Las acciones son limitadas LIMITS_TOO_MANY_ACTIONS La capacidad está limitada a 100 acciones. Hay demasiadas acciones de capacidad definidas en el manifiesto de capacidad. Quite acciones y vuelva a intentarlo.
Los parámetros de entrada de acción son limitados LIMITS_TOO_MANY_INPUTS Las acciones están limitadas a 25 entradas. Hay demasiados parámetros de entrada de acción de capacidad. Quite parámetros y vuelva a intentarlo.
Los parámetros de salida de acción son limitados LIMITS_TOO_MANY_OUTPUTS Las acciones están limitadas a 25 salidas. Hay demasiados parámetros de salida de acción de capacidad. Quite el parámetro e inténtelo de nuevo.
El recuento de aptitudes es limitado LIMITS_TOO_MANY_SKILLS Su bot puede tener un máximo de 25 aptitudes. Se han agregado demasiadas capacidades a un bot. Quite una capacidad existente y vuelva a intentarlo.
El token de seguridad es válido AADERROR_OTHER Parece que se produjo algún problema. Puede haber un error transitorio para adquirir un token de seguridad a fin de desencadenar la aptitud. Reintente la importación de la aptitud.
La aptitud es correcta ENDPOINT_HEALTHCHECK_FAILED, HEALTH_PING_FAILED Se ha producido un problema al comprobar la capacidad. Power Virtual Agents recibió una respuesta desconocida al enviar una actividad EndOfConversation a la aptitud. Asegúrese de que su aptitud se ejecuta y responde correctamente.
La aptitud está autorizada ENDPOINT_HEALTHCHECK_UNAUTHORIZED Esta capacidad no permite enumerar su bot. Compruebe si se ha agregado el bot a la lista de permitidos de las capacidades. Para más información, consulte la sección Power Virtual Agents cómo configurar una aptitud.