Exportar e importar agentes con soluciones

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

Primero, crea una solución personalizada y agrega su agente a ella. Entonces exporte la solución con su agente, e impórtela en otro entorno. También puede actualizar una solución con un agente y eliminar una capa no administrada de un agente administrado.

Consulte el artículo Ver y administrar soluciones en Copilot Studio para obtener más detalles sobre el explorador de soluciones en Copilot Studio.

Nota

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

Requisitos previos

• Debe tener al menos el rol de seguridad Personalizador del sistema para utilizar esta característica. Más información sobre Configuración de la seguridad del usuario en un entorno.
• Debe estar familiarizado con los conceptos de solución, tal como se describe en Conceptos de solución y Crear y administrar soluciones en Copilot Studio.

Lo que debe saber

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

• Eliminar un agente de una solución no elimina sus componentes de la solución. Debería eliminar los componentes por separado.

  Advertencia

  No elimine componentes de agentes no administrados, como temas de agentes, directamente de la solución, a menos que también haya eliminado el agente de la solución.

  Solo debe realizar cambios en los temas como parte del proceso de creación estándar en la interfaz de usuario de Copilot Studio. Eliminar o cambiar los componentes de un agente directamente desde la solución hará que la exportación e importación fallen.

• No puede exportar soluciones administradas. Cuando crea una solución, por defecto no está administrada. Si la cambia a solución administrada, no podrá exportarla. Deberá crear una nueva solución.

• No es posible exportar una solución que contenga un agente con puntos (.) en el nombre de cualquiera de sus temas.

Crear una solución personalizada y agregar su agente

1. Siga los pasos en Crear y administrar soluciones en Copilot Studio para crear una solución nueva.

2. La solución que creó debería abrirse automáticamente. Si no es así, selecciónelo en la lista de soluciones.

3. Seleccione Agregar existente y seleccione Agente y después Agente de nuevo.

4. En la lista Agregar copilotos existentes, seleccione el agente o agentes que desea exportar y, a continuación, seleccione Agregar.

Nota

Para un chatbot Clásico:

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

Eliminar un agente de una solución no elimina sus componentes de la solución. Debe retirar los componentes por separado.

Agregar componentes a un agente en una solución personalizada

Si agrega nuevos componentes, como nuevos temas o flujos, a su agente en Copilot Studio, también deberá agregar esos componentes al agente en su solución no administrada antes de exportarla.

1. Abra la solución que contiene el agente.
2. En el panel Objetos, localice al agente en Agentes.
3. Seleccione Comandos (⋮), seleccione Avanzadas y luego Agregar objetos requeridos.

Debería revisar las instrucciones y requisitos en la documentación de Power Apps para agregar un componente existente a una solución.

Exportar la solución con su agente

Exporta e importa agentes exportando e importando las soluciones que las contienen de un entorno a otro.

Siga las instrucciones y requisitos en la documentación de Power Apps para exportar soluciones.

Importante

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

Importar la solución con su agente

Siga las instrucciones y requisitos en la documentación de Power Apps para importar soluciones.

Si la importación no se realiza correctamente, seleccione Descargar archivo de registro para descargar un archivo XML que contenga detalles sobre la causa del error en la importación. La causa más común para que una importación falle es que la solución no contenía algunos componentes requeridos.

1. Configure la autenticación de usuario de nuevo.

2. En el panel Objetos, seleccione Agentes. A continuación, seleccione el nombre del agente para abrirlo.

Importante

• Debe publicar su agente importado antes de que se pueda compartir.
• El icono de su agente puede tardar hasta 24 horas en aparecer en todas partes.

Exportar e importar agentes en Teams

En Microsoft Teams, puede exportar e importar agentes entre equipos individuales utilizando la aplicación de Power Apps teams.

Por ejemplo, si exporta un agente en activo de un equipo de Teams (equipo A) y luego lo importa al equipo B, no tiene que crearlo desde cero para el equipo B.

Siga las instrucciones de Exportar personalizaciones de Dataverse for Teams.

Al seleccionar las personalizaciones para exportar, seleccione el agente que desea exportar. Puede usar el filtro en el panel lateral para mostrar solo los agentes dentro de ese equipo.

El agente se guarda en la carpeta Descargas del equipo.

Para importar en Teams, siga las instrucciones de cómo importar personalizaciones en Dataverse for Teams.

Su agente aparecerá en la aplicación Copilot Studio en Teams, en el equipo al que la importó.