Implementación de una aptitud en Power Virtual AgentsImplement a skill for use in Power Virtual Agents

se aplica a: SDK V4APPLIES TO: SDK v4

Una aptitud es un bot que puede usar otro bot.A skill is a bot that can be used by another bot. De este modo, puede crear un solo bot orientado al usuario y ampliarlo con una o varias aptitudes.In this way you can create a single user-facing bot and extend it with one or more skills. 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.You can learn more about skills in general in Skills Overview, and how to build them in Implement a skill. 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.Alternatively, the Virtual Assistant templates contain a set of pre-built skills you can customize and deploy instead of building one from scratch.

Si espera que la aptitud se consuma desde un bot de Power Virtual Agents, hay algunas restricciones adicionales que deberá tener en cuenta en su aptitud.If you expect that your skill will be consumed from a Power Virtual Agents bot, there are some additional restrictions placed on your skill you'll need to account for.

Manifiesto de restriccionesManifest restrictions

Power Virtual Agents impone restricciones en lo que puede declarar en su manifiesto de aptitud.Power Virtual Agents places restrictions on what you may declare in your skill manifest.

  • Solo puede declarar 100 acciones o menos.You may declare only 100 or fewer actions.
  • Cada acción se limita a 25 entradas o salidas o menos.Each action is limited to 25 or fewer inputs or outputs.
  • No puede usar el tipo de matriz para entradas o salidas.You cannot use the array type for inputs or outputs.

Restricción del mismo inquilinoSame-tenant restriction

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 Azure Active Directory.In order to ensure compliance and adequate governance of custom skills being registered for use within Power Virtual Agents, your skill bot must be a registered application in Azure Active Directory. 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.Upon adding a skill, we validate if the skill's application ID is the in the tenant of the signed in user and the skills endpoint matches the registered application's Home Page URL.

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.Before you can register your bot as a skill within Power Virtual Agents, you must ensure that for the bot, the home page in the Azure Portal is set to the bot's skill manifest URL.

Validación realizada durante el registro de una aptitudValidation performed during registering a Skill

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.When an end user attempts to connect to your skill from their Power Virtual Agents bot, they'll first need to import the skill to Power Virtual Agents. Su aptitud pasará por una serie de comprobaciones de validación.Your skill will go through a series of validation checks. Un error encontrado durante una de estas comprobaciones puede dar lugar a un mensaje de error, tal como se describe en esta tabla.A failure of one of these checks may result in an error message as described in this table.

Paso de validaciónValidation step Código de errorError code Mensaje de errorError message Descripción o mitigaciónDescription or mitigation
La dirección URL del manifiesto es válidaManifest URL is valid URL_MALFORMED, URL_NOT_HTTPSURL_MALFORMED, URL_NOT_HTTPS El vínculo no es válido; el vínculo debe empezar por https://The link isn't valid; The link must begin with https:// Vuelva a escribir el vínculo como dirección URL segura.Re-enter the link as a secure URL.
El manifiesto se puede recuperarManifest is retrievable MANIFEST_FETCH_FAILED Hemos tenido problemas para obtener el manifiesto de aptitud.We ran into problems getting the skill manifest. 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.Verify your manifest URL is a link to your manifest; try opening your manifest URL in a web browser. Si la dirección URL representa la página en 10 segundos, vuelva a registrar la aptitud.If the URL renders the page within 10 seconds, re-register your skill.
El manifiesto es legibleManifest is readable MANIFEST_TOO_LARGE El manifiesto es demasiado grande.The manifest is too large. El manifiesto debe tener 500 KB o menos.Your manifest must be 500 KB or less.
El manifiesto es legibleManifest is readable MANIFEST_MALFORMED El manifiesto no es compatible.The manifest is incompatible. Compruebe si el manifiesto es un archivo JSON válido.Check if the manifest is a valid JSON file. Compruebe si el manifiesto contiene las propiedades necesarias, como name , , y así msaAppId sucesivamente.Check if the manifest contains required properties, such as name, msaAppId, and so on. Consulte Restricciones de manifiesto para obtener más información.See Manifest restrictions for more information.
La aptitud aún no está registradaSkill is not yet registered MANIFEST_ALREADY_IMPORTED Esta aptitud ya se ha agregado al bot.This skill has already been added to your bot. Elimine la aptitud y regístrela de nuevo.Delete the skill and register it again.
Coinciden el punto de conexión del manifiesto y los dominios de la página principalManifest endpoint and homepage domains match MANIFEST_ENDPOINT_ORIGIN_MISMATCH Hay un error de coincidencia en los puntos de conexión de aptitudes.There's a mismatch in your skill endpoints. Debe Azure AD dominio de dirección URL de la página principal de la aplicación y dominio de dirección URL del manifiesto.You Azure AD app's homepage URL domain and manifest URL domain must match. Consultar el apartado Restricción del mismo inquilinoSee Same-tenant restriction
La aptitud se hospeda en el inquilino del usuario que ha iniciado sesiónSkill is hosted in signed in user's tenant APPID_NOT_IN_TENANT Para agregar una aptitud, primero se debe registrar.To add a skill, it must first be registered. Un administrador global debe registrar la aptitud en la organización del usuario que ha iniciado sesión.A global administrator must register the skill into the signed in user's organization.
Las acciones son limitadasActions are limited LIMITS_TOO_MANY_ACTIONS La aptitud está limitada a 100 acciones.The skill is limited to 100 actions. Hay demasiadas acciones de la aptitud definidas en el manifiesto de aptitud.There are too many skill actions defined in skill manifest. Quite las acciones e inténtelo de nuevo.Remove actions and try again.
Los parámetros de entrada de acción están limitadosAction input parameters are limited LIMITS_TOO_MANY_INPUTS Las acciones se limitan a 25 entradas.Actions are limited to 25 inputs. Hay demasiados parámetros de entrada de acciones de la aptitud.There are too many skill action input parameters. Quite los parámetros e inténtelo de nuevo.Remove parameters and try again.
Los parámetros de salida de acción son limitadosAction output parameters are limited LIMITS_TOO_MANY_OUTPUTS Las acciones se limitan a 25 salidas.Actions are limited to 25 outputs. Hay demasiados parámetros de salida de acciones de la aptitud.There are too many skill action output parameters. Quite el parámetro e inténtelo de nuevo.Remove parameter and try again.
El recuento de aptitudes es limitadoSkill count is limited LIMITS_TOO_MANY_SKILLS Su bot puede tener un máximo de 25 aptitudes.Your bot can have a maximum of 25 skills. Hay demasiadas aptitudes agregadas en un bot.There are too many skills added into a bot. Quite una aptitud existente e inténtelo de nuevo.Remove an existing skill and try again.
El token de seguridad es válidoSecurity token is valid AADERROR_OTHER Parece que se produjo algún problema.It looks like something went wrong. Puede haber un error transitorio para adquirir un token de seguridad a fin de desencadenar la aptitud.There may be a transient error to acquire a security token to trigger the skill. Reintente la importación de la aptitud.Retry importing the skill.
La aptitud está en buen estadoSkill is healthy ENDPOINT_HEALTHCHECK_FAILED, HEALTH_PING_FAILEDENDPOINT_HEALTHCHECK_FAILED, HEALTH_PING_FAILED Hubo un problema al comprobar la aptitud.Something went wrong while checking your skill. Power Virtual Agents una respuesta desconocida al enviar una EndOfConversation actividad a la aptitud.Power Virtual Agents received an unknown response when sending an EndOfConversation activity to your skill. Asegúrese de que su aptitud se ejecuta y responde correctamente.Make sure your skill is running and responding correctly.
La aptitud está autorizadaSkill is authorized ENDPOINT_HEALTHCHECK_UNAUTHORIZED Esta aptitud no ha permitido la enumeración del bot.This skill has not allow-listed your bot. Compruebe si el bot se ha agregado a la lista de permitidos de la aptitud.Check if your bot has been added to the skill's allow list. Para obtener más información, vea el Power Virtual Agents cómo configurar una aptitud.For more information, see the Power Virtual Agents how to Configure a Skill.