Cuando intenta importar una solución en Copilot Studio desde un entorno diferente de Power Platform, el proceso de importación puede fallar con un mensaje de error genérico o una advertencia específica relacionada con permisos. Este problema ocurre típicamente porque la solución contiene componentes que requieren privilegios elevados o porque el entorno de destino carece de la asignación de licencia necesaria de Dataverse for Teams o Copilot Studio. Este artículo explica las causas raíz del fallo de importación y proporciona una solución clara y paso a paso para resolver el problema.
Conclusiones clave: Resolución de fallos de importación de soluciones en Copilot Studio
- Centro de administración de Power Platform > Entornos > Entorno de destino > Administrar solución: Verifique que el entorno de destino tenga asignada la licencia de complemento de Copilot Studio antes de importar.
- Centro de administración de Power Platform > Entornos > Entorno de destino > Configuración > Productos: Confirme que Dataverse for Teams esté habilitado en el entorno de destino para los componentes de la solución que dependen de él.
- Centro de administración de Power Platform > Entornos > Entorno de origen > Exportar solución > Configuración avanzada: Exporte la solución con la opción Incluir todas las dependencias para evitar errores de componentes faltantes durante la importación.
Por qué falla la importación de soluciones en Copilot Studio
El proceso de importación en Copilot Studio se basa en el marco de soluciones de Power Platform, que aplica estrictas comprobaciones de dependencias y validaciones de permisos. Cuando exporta una solución desde un entorno de origen, el manifiesto de la solución registra cada componente, incluidos conectores personalizados, modelos de AI Builder y variables de entorno. Si el entorno de destino carece de uno o más de estos componentes o de sus licencias requeridas, el motor de importación rechaza la solución en la etapa de validación.
Las causas raíz más comunes son:
- Falta de licencia de Copilot Studio: El entorno de destino debe tener asignada una licencia de complemento de Copilot Studio activa. Sin ella, el motor de importación bloquea cualquier solución que contenga componentes de Copilot Studio.
- Dataverse for Teams no habilitado: Muchas soluciones de Copilot Studio incluyen tablas de Dataverse for Teams. Si esta característica está deshabilitada en el entorno de destino, la importación falla.
- Dependencias faltantes: La solución puede hacer referencia a un conector personalizado, variable de entorno o modelo de AI Builder que no existe en el entorno de destino.
- Permisos insuficientes: El usuario que realiza la importación debe tener el rol de Personalizador del sistema o Administrador del sistema en el entorno de destino.
Cómo funciona la validación de importación
Cuando sube un archivo de solución en Copilot Studio, el sistema ejecuta una validación previa a la importación. Esta validación verifica cada componente contra los metadatos del entorno de destino. Si algún componente falta o es incompatible, la validación devuelve una lista de errores. El proceso de importación no continúa hasta que se resuelvan todos los errores de validación.
Pasos para solucionar fallos de importación de soluciones en Copilot Studio
- Verifique la licencia de Copilot Studio en el entorno de destino
Abra el Centro de administración de Power Platform. Vaya a Entornos, seleccione su entorno de destino y luego seleccione Configuración > Productos. Confirme que la licencia de complemento de Copilot Studio aparezca como Activa. Si falta, asigne una licencia a través del Centro de administración de Microsoft 365 o contacte a su administrador de inquilino. - Habilite Dataverse for Teams en el entorno de destino
En el Centro de administración de Power Platform, navegue a Entornos, seleccione el entorno de destino y luego seleccione Configuración. En Productos, busque Dataverse for Teams y establézcalo en Habilitado. Este paso es necesario si la solución contiene tablas de Dataverse for Teams. - Exporte la solución con todas las dependencias
Vaya al entorno de origen en el Centro de administración de Power Platform. Abra Soluciones, seleccione su solución y luego elija Exportar. En la configuración avanzada, marque la casilla etiquetada Incluir todas las dependencias. Esto asegura que cada componente referenciado se incluya en el archivo de solución exportado. - Verifique el rol del usuario en el entorno de destino
En el Centro de administración de Power Platform, seleccione el entorno de destino y luego elija Configuración > Usuarios + permisos > Roles de seguridad. Confirme que su cuenta de usuario tenga el rol de Personalizador del sistema o Administrador del sistema. Si no, pida a un administrador que asigne el rol apropiado. - Importe la solución nuevamente
En Copilot Studio, vaya a Configuración > Soluciones. Seleccione Importar solución, suba el archivo recién exportado y siga las indicaciones. Supervise el progreso de la importación. Si aparecen errores, anote el mensaje de error exacto y el nombre del componente. - Resuelva manualmente los errores de componentes faltantes
Si la importación falla debido a un componente faltante, cree ese componente en el entorno de destino primero. Por ejemplo, si el error menciona un conector personalizado faltante, cree un conector personalizado con el mismo esquema en el entorno de destino. Luego reintente la importación.
Si Copilot Studio aún no puede importar la solución
La importación falla con el error “La solución no es compatible con este entorno”
Este error indica que la solución contiene un componente que requiere una versión superior de Dataverse o una licencia premium. Verifique la lista de dependencias de la solución en el entorno de origen. Busque modelos de AI Builder, conectores premium o API personalizadas. Asegúrese de que el entorno de destino tenga asignadas las licencias premium necesarias. Si el componente no es crítico, elimínelo de la solución antes de exportar.
La importación se realiza correctamente pero Copilot Studio no muestra el bot importado
Después de una importación exitosa, el bot puede no aparecer en Copilot Studio inmediatamente. Este retraso ocurre porque la importación de la solución no publica automáticamente el bot. Para publicar el bot, vaya a Copilot Studio, seleccione Bots, encuentre el bot importado y luego seleccione Publicar. Si el bot aún falta, verifique la lista de componentes de la solución en el entorno de destino para confirmar que el componente del bot se importó correctamente.
La importación falla con el error “Privilegios insuficientes para completar la operación”
El usuario que realiza la importación carece del rol de seguridad requerido. Este error aparece incluso si el usuario tiene el rol de Personalizador del sistema en algunos casos, porque la importación puede necesitar privilegios elevados para ciertos componentes de la solución. Asigne el rol de Administrador del sistema al usuario temporalmente para la importación, luego revóquelo después de que la importación se complete.
| Elemento | Entorno de origen | Entorno de destino |
|---|---|---|
| Licencia de Copilot Studio | No requerida para exportar | Requerida para importar y activar el bot |
| Dataverse for Teams | Habilitado si la solución usa tablas de Teams | Debe estar habilitado para que la importación tenga éxito |
| Rol de usuario | Personalizador del sistema o superior para exportar | Administrador del sistema para importar |
| Configuración de exportación de solución | Incluir todas las dependencias recomendado | No aplicable |
Después de resolver los problemas de licencia, características y permisos, el proceso de importación en Copilot Studio debería completarse sin errores. Siempre exporte las soluciones con la opción Incluir todas las dependencias marcada para minimizar errores de componentes faltantes. Si un componente específico continúa bloqueando la importación, cree ese componente manualmente en el entorno de destino antes de reintentar la importación. Para soluciones complejas con muchas dependencias, considere usar la CLI de Power Platform para exportar e importar la solución con resolución completa de dependencias.