Exportar e importar agentes utilizando 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.

Para obtener más información sobre el explorador de soluciones en Copilot Studio, consulte View y administrar soluciones en Copilot Studio.

Requisitos previos

• Para utilizar esta característica, debe tener al menos el rol de seguridad de Personalizador del sistema. Más información sobre Configuración de la seguridad del usuario en un entorno.
• Debe estar familiarizado con 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 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 alguno de sus temas.

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

1. Para crear una nueva solución en el explorador de soluciones de Copilot Studio, siga los pasos descritos en Crear y administrar soluciones en 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 añades componentes, como temas o flujos, al agente en Copilot Studio, también debes añadirlos al agente en tu solución no administrada antes de exportar la solución.

1. Abrir el explorador de soluciones 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.

Añade conectores personalizados a tu solución

Si tu agente utiliza conectores personalizados, sigue los pasos en Crear conectores personalizados en soluciones y aprende sobre las limitaciones conocidas.

Agregar flujos de Power Automate

Al usar flujos y variables de entorno, añade los objetos necesarios para flujos y variables de entorno.

1. Abrir el explorador de soluciones en Copilot Studio.

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

3. En el panel de Objetos , localiza tus flujos de trabajo.

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

Adición de variables de entorno

Para añadir variables de entorno, sigue estos pasos:

1. Abrir el explorador de soluciones en Copilot Studio.

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

3. Si no existen variables de entorno en la solución, selecciona Añadir existente, selecciona Más y luego selecciona variable de entorno.

   1. Selecciona las variables de entorno requeridas.

   2. Selecciona Siguiente y luego selecciona Añadir.

4. Si todas las variables de entorno existen en la solución, selecciona los tres puntos (⋮), selecciona Avanzado y luego selecciona Añadir objetos requeridos para asegurarte de que todas las dependencias se añaden a la solución.

Personalizar componentes para soluciones gestionadas

Para hacer que los componentes sean personalizables en soluciones gestionadas, consulte Ver y editar propiedades gestionadas en tablas.

Asegúrate de que tu entorno permita la personalización antes de importar soluciones gestionadas. Verifica que tu entorno no bloquee personalizaciones ni soluciones no gestionadas. Aprende más en Personalizaciones no gestionadas bloqueadas en Dataverse.

Exportar la solución con su agente

Para exportar e importar los agentes, se exportan e importan las soluciones que los contienen de un entorno a otro.

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

1. Abrir el explorador de soluciones en Copilot Studio.

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

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

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

Importar la solución junto con su agente

Para importar la solución con su agente a otro entorno, siga estos pasos:

1. En el entorno de destino, abrir el explorador de soluciones en Copilot Studio.

2. Seleccione Importar solución. Como en la experiencia Power Apps import solutions, aparece el panel derecho Importar una solución.

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

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.

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