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 o mejorar una solución con un agente, y eliminar una capa no gestionada de un agente gestionado.

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

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 la solución, como se describe en Conceptos de solución y Creación y administración de soluciones en Copilot Studio.

Lo que debe saber...

• No puede exportar comentarios en el 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 elimine 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. Si elimina o cambia los componentes de un agente directamente desde la solución, la exportación y la importación fallarán.

• No se pueden exportar soluciones administradas. Cuando crea una solución, por defecto no está administrada. Si lo cambia a una solución administrada, no podrá exportarlo. Necesita crear una solución nueva.

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

Creación de una solución personalizada y adición del agente

1. Siga los pasos descritos en Creación y administración de soluciones en Copilot Studio para crear una nueva solución en el Explorador de soluciones de Copilot Studio.

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 agentes existentes, seleccione el agente o agentes que desea exportar y, a continuación, seleccione Agregar.

Agregar componentes a un agente en una solución personalizada

Si agrega componentes, como temas o flujos, a su agente en Copilot Studio, también debe agregarlos al agente en su solución no administrada antes de exportar.

1. Abra el explorador de solución en Copilot Studio.

2. Seleccione la solución que contiene su agente.

3. En el panel Objetos, localice al agente en Agentes.

4. Selecciona los tres puntos (⋮), selecciona Avanzado y luego selecciona Añadir objetos requeridos.

También debe revisar las instrucciones y los requisitos de la documentación de Power Apps para agregar un componente existente a una solución.

Exportar la solución con su agente

Los agentes se exportan e importan exportando e importando las soluciones que los contienen de un entorno a otro.

Para exportar la solución con el agente, siga estos pasos:

1. Abra el explorador de solución en Copilot Studio.

2. En la lista de soluciones no administradas, seleccione la solución que contiene el agente.

3. Seleccione Exportar solución. Como en la experiencia de las soluciones de exportación de Power Apps, aparece el panel derecho Antes de exportar.

4. El resto de los pasos son los mismos que para exportar soluciones en Power Apps. Siga las instrucciones y los requisitos de la documentación de Power Apps para finalizar la exportación de la solución.

Importar la solución con su agente

Para importar la solución con el agente en otro entorno, siga estos pasos:

1. En el entorno de destino, abra el Explorador de soluciones en Copilot Studio.

2. Seleccione Importar solución. Como en la experiencia de importación de soluciones de Power Apps, aparece el panel derecho Importar una solución.

3. El resto de los pasos son los mismos que para importar soluciones en Power Apps. Siga las instrucciones y los requisitos de la documentación de Power Apps para finalizar la importación de la solución.

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. En el Explorador de soluciones, seleccione la nueva solución importada de la lista.

2. En el panel Objetos, seleccione Agentes. A continuación, seleccione el nombre del agente para abrir el agente en Copilot Studio en una nueva pestaña.

3. Vuelva a configurar la autenticación de usuario para el agente.

Exportar e importar agentes en Teams

En Microsoft Teams, puede exportar e importar agentes entre equipos individuales mediante la aplicación 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 desde 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 Importación de personalizaciones en Dataverse for Teams.

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