Exportar e importar bots con soluciones

Nota

Hay información adicional disponible para las personas que usan Power Virtual Agents (versión preliminar).

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.

Nota

No puede exportar comentarios a nivel de tema o de nodo cuando exporta un bot.

Requisitos previos

Crear una solución para administrar la exportación y la importació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.

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

  2. En el menú de navegación, en Configuración, seleccione General. Luego seleccione Exportar.

    Screenshot of the export button on the general setting page.

  3. Seleccione Ir a Power Apps Solutions.

    Screenshot of the export popup.

  4. Inicie sesión en Power Apps, vaya a la pestaña Soluciones y seleccione Nueva solucion.

    New solution button highlighted.

  5. Introduzca la información descrita para cada uno de los campos como se describe en esta tabla:

    Campo Description
    Display name 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.
    Publicador 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.
  6. Seleccione Crear.

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.

    Screenshot of the Chatbot option in the Add existing menu.

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

    Chatbot selected in the list of bots.

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

    Screenshot showing the Remove from this solution button.

Nota

Eliminar un bot de una solución no elimina sus componentes de una solución. La eliminación de los componentes debe hacerse por separado.

Advertencia

No elimine ningún subcomponente de bot de chat no administrado (como temas de bot) directamente del portal Power Apps, a menos que haya eliminado el bot de la solución.

Solo debe realizar cambios en los temas desde el portal Power Virtual Agents.

Eliminar o cambiar los subcomponentes de bot de chat desde dentro de Power Apps hará que la exportación e importación fallen.

Exportar la solución con su bot

Solo puede exportar las soluciones no administradas. De forma predeterminada, una nueva solución se crea como no administrada. Si luego la cambia a solución administrada, no podrá exportarla.

Importante

Si su bot tiene una gran cantidad de componentes (por ejemplo, más de 250 temas o más de 100 entidades), vea Exportar usando la experiencia clásica.

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

    Screenshot of the solution export button.

  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.

    Environment picker selected.

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

    Import button highlighted.

  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:

  8. En el panel Objetos, seleccione Bot de chat. Luego puede seleccionar el nombre del bot para abrir el bot en el portal de Power Virtual Agents.

    List of bots and environments in 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ó.

Importante

Agregar nuevos componentes a un bot de chat en una solución personalizada

Si agrega nuevos componentes de bot (como nuevos temas o flujos) a su bot en Power Virtual Agents, también deberá agregar esos componentes al bot en su solución no administrada.

  1. Vaya a su solución no administrada en el portal de Power Apps.

  2. Seleccione Bots de chat y busque su bot en la lista.

  3. Seleccione Comandos (), luego seleccione Agregar objetos requeridos.

    Screenshot highlighting the Add required components option under the More menu.

Renovar o actualizar una solución con un chatbot

Para actualizar o cambiar la versión de un solución administrada existente, 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 Comandos (los tres puntos verticales), seleccione Avanzadas y luego Ver capas de solución.

    See solution layers option.

  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.