Exportar e importar bots con soluciones

Seleccione la versión de Power Virtual Agents que está usando aquí:

Puede exportar e importar bots usando soluciones para poder mover sus bots a través de múltiples entornos.

Esto puede ser útil si usa diferentes entornos para diferentes propósitos, o emplea metodologías de implementación de anillo. Por ejemplo, puede tener un entorno específico en el que pruebe y valide bots internamente, otro entorno en el que pruebe bots solo para un subconjunto de usuarios y un entorno de producción final en el que comparta bots con clientes y usuarios finales.

Requisitos previos

• Obtenga más información sobre lo que puede hacer con Power Virtual Agents.

• Un fabricante requerirá los roles de seguridad mínimos del personalizador del sistema para usar esta función. Más información sobre Configuración de la seguridad del usuario a recursos en un entorno.

Agregar un bot a una solución

Utiliza soluciones para exportar bots de un entorno e importarlos a otro. La solución actúa como un "operador" para los bots y puede importar varios bots en una solución.

Crear una solución para administrar la exportación y la importación

1. Inicie sesión en el bot de Power Virtual Agents que desea exportar.

2. Seleccione Configuración y luego, seleccione Configuración general.

   

3. En Exportar/importar bot, seleccione Ir a Soluciones de Power Apps.

   

4. Inicie sesión en Power Apps, vaya a la pestaña Soluciones y seleccione Nueva solucion. Introduzca la información para cada uno de los campos como se describe en esta tabla, luego seleccione Crear.

   

   Campo	Descripción
   Nombre	Nombre que se muestra en la lista de soluciones. Puede cambiarlo más tarde.
   Nombre	Nombre único de la solución. Este se genera con el valor especificado en el campo Nombre para mostrar. Puede modificarlo antes de guardar la solución, pero no podrá hacerlo una vez haya guardado la solución.
   Editor	Puede seleccionar el editor predeterminado o crear un nuevo editor. Le recomendamos que cree un editor que pueda usar de manera coherente en todos los entornos donde usará la solución. Para obtener más información, visite la descripción general del editor de soluciones.
   Versión	Escriba un número para la versión de la solución. Solo es importante si exporta la solución. El número de versión se incluirá en el nombre de archivo cuando exporte la solución.

Agregar su bot a la solución

1. Seleccione la solución que acaba de crear.

2. Seleccione Agregar existente y elija Bot de chat.

   

3. En el panel Agregar bots de chat existentes, seleccione el bot (o bots) que desea exportar. Seleccione Agregar.

   

4. Si usa capacidades, elimine las variables de entorno Valor actual de la capacidad seleccionando Quitar de esta solución.

   

Exportar e importar bots

Exporta e importa bots exportando e importando sus soluciones contenedoras de un entorno a otro.

Exportar la solución con su bot

1. En la lista de soluciones, seleccione la solución que contiene el bot que quiere exportar. Seleccione Exportar.

   

   Nota

   No puede exportar soluciones administradas. Cuando crea una solución, por defecto no se administrará. Si lo cambia a solución administrada, no podrá exportarla y deberá crear una nueva solución.

   Si su bot tiene una gran cantidad de componentes (por ejemplo, más de 250 temas o más de 100 entidades), exporte el bot usando en lugar de ello el portal Power Apps clásico.

   

2. Seleccione Siguiente en el panel Antes de exportar.

3. Aparece el panel Exportar esta solución. Introduzca o seleccione entre las siguientes opciones y, a continuación, seleccione Exportar:

   Opción	Descripción
   Número de versión	Power Virtual Agents incrementa automáticamente la versión de su solución al mostrar la versión actual. Puede aceptar la versión predeterminada o introducir la suya.
   Exportar como	Seleccione el tipo de paquete, Administrado o No administrado. Más información acerca de soluciones administradas y no administradas.

La exportación puede tardar varios minutos en completarse. Una vez terminado, su navegador web descargará un archivo .zip. El archivo estará en el formato siguiente: SolutionName_Version_ManagementType.zip.

Importar la solución con su bot

1. En el menú superior, seleccione el nombre del entorno y seleccione el entorno donde desea importar su bot.

   

2. Vaya a la pestaña Soluciones y en la barra de comandos, seleccione Importar.

   

3. En la ventana Seleccionar paquete de soluciones, seleccione Elegir archivo y ubique el archivo .zip que contiene la solución con el bot que desea importar.

4. Seleccione Siguiente.

5. Información sobre cómo se muestra la solución. Seleccione Importar.

6. Es posible que tenga que esperar unos momentos mientras la importación se completa. Vea los resultados y, a continuación, seleccione Cerrar.

   Si la importación no se realiza correctamente, verá un informe que muestra los errores o advertencias que se capturaron. Seleccione Descargar archivo de registro para capturar detalles sobre la causa del error de importación en un archivo XML.

   La causa más común para que una importación falle es que la solución no contenía algunos componentes requeridos. Por ejemplo, es posible que no tenga bots actualizados en el entorno.

7. Si su bot tiene alguno de los siguientes, debe configurarlos después de importar la primera vez:

   • Autenticación de usuario final: configure la autenticación del usuario final en el bot para que pueda tomar medidas en nombre del usuario. El bot se puede configurar con cualquier proveedor de identidad OAuth2, como Azure Active Directory (Azure AD), una cuenta de Microsoft o Facebook.

   • Traspaso de servicio al cliente: configure servicios externos que transfieren las escaladas de bot a un agente humano.

   • Multicanal: configurar canales externos, como Facebook y Microsoft Teams:

     • Documentación de Microsoft Teams
     • Documentación de Facebook

8. Use el menú de filtro para seleccionar Bot de chat. Luego puede seleccionar el nombre del bot para abrir el bot en el portal Power Virtual Agents. También puede ir directamente a la aplicación web de Power Virtual Agents y abrir el bot importado en el entorno al que importó. También verá el nombre de la solución actual del bot para acceder fácilmente a las soluciones.

   

Renovar o actualizar una solución con un chatbot

Si agrega nuevos componentes de bot (como nuevos temas o flujos) a su bot en el portal de PVA, también deberá actualizar en el entorno de destino esos cambios del bot. Para ello, agregue los componentes a la solución no administrada seleccionando Agregar componentes necesarios mediante el menú ... situado junto al nombre del bot.

Hay ocasiones en las que podría necesitar instalar una actualización de una solución administrada existente. Para obtener más información, vaya a Actualizar una solución.

Eliminar una capa no administrada de un chatbot administrado

Existen soluciones administradas y no administradas en diferentes niveles dentro de un entorno de Microsoft Dataverse. Para obtener más información, vaya a Capas de soluciones.

Un componente administrado (por ejemplo, un tema o un flujo) obtiene una capa "Activa" no administrada cuando lo edita, lo que significa que no verá los últimos cambios después de implementar la solución.

Para mostrar las últimas actualizaciones, deberá eliminar la capa "Activa" no administrada.

Utilizar la opción Ver capas de solución para ver todas las soluciones de las que forma parte un componente. También puede ver una solución “Activa” por encima del resto de soluciones si hubiera cambiado algo directamente en la instancia.

1. Seleccione Ver capas de solución en el menú contextual ... junto al nombre del componente.

   

2. En la página Capa de solución, seleccione la capa no administrada y luego seleccione Quitar capa no administrada para quitar la capa.