Ao tentar importar uma solução no Copilot Studio de outro ambiente Power Platform, o processo de importação pode falhar com uma mensagem de erro genérica ou um aviso específico de permissão. Esse problema geralmente ocorre porque a solução contém componentes que exigem privilégios elevados ou porque o ambiente de destino não possui a licença necessária do Dataverse for Teams ou do Copilot Studio. Este artigo explica as causas raiz da falha de importação e fornece uma correção clara e passo a passo para resolver o problema.
Principais conclusões: Resolvendo falhas de importação de solução do Copilot Studio
- Power Platform admin center > Ambientes > Ambiente de destino > Gerenciar solução: Verifique se o ambiente de destino possui a licença complementar do Copilot Studio atribuída antes de importar.
- Power Platform admin center > Ambientes > Ambiente de destino > Configurações > Produtos: Confirme se o Dataverse for Teams está habilitado no ambiente de destino para componentes de solução que dependem dele.
- Power Platform admin center > Ambientes > Ambiente de origem > Exportar solução > Configurações avançadas: Exporte a solução com a opção Incluir todas as dependências para evitar erros de componentes ausentes durante a importação.
Por que a importação de solução do Copilot Studio falha
O processo de importação no Copilot Studio depende da estrutura de soluções do Power Platform, que impõe verificações rigorosas de dependência e validações de permissão. Ao exportar uma solução de um ambiente de origem, o manifesto da solução registra cada componente, incluindo conectores personalizados, modelos AI Builder e variáveis de ambiente. Se o ambiente de destino não tiver um ou mais desses componentes ou suas licenças necessárias, o mecanismo de importação rejeita a solução na etapa de validação.
As causas raiz mais comuns são:
- Licença do Copilot Studio ausente: O ambiente de destino deve ter uma licença complementar ativa do Copilot Studio atribuída. Sem ela, o mecanismo de importação bloqueia qualquer solução que contenha componentes do Copilot Studio.
- Dataverse for Teams não habilitado: Muitas soluções do Copilot Studio incluem tabelas do Dataverse for Teams. Se esse recurso estiver desabilitado no ambiente de destino, a importação falha.
- Dependências ausentes: A solução pode referenciar um conector personalizado, variável de ambiente ou modelo AI Builder que não existe no ambiente de destino.
- Permissões insuficientes: O usuário que realiza a importação deve ter a função de Personalizador do Sistema ou Administrador do Sistema no ambiente de destino.
Como funciona a validação de importação
Ao carregar um arquivo de solução no Copilot Studio, o sistema executa uma validação pré-importação. Essa validação verifica cada componente em relação aos metadados do ambiente de destino. Se algum componente estiver ausente ou for incompatível, a validação retorna uma lista de erros. O processo de importação não prossegue até que todos os erros de validação sejam resolvidos.
Passos para corrigir falhas de importação de solução do Copilot Studio
- Verifique a licença do Copilot Studio no ambiente de destino
Abra o Power Platform admin center. Vá em Ambientes, selecione seu ambiente de destino e depois Configurações > Produtos. Confirme se a licença complementar do Copilot Studio está listada como Ativa. Se estiver ausente, atribua uma licença pelo centro de administração do Microsoft 365 ou entre em contato com o administrador do locatário. - Habilite o Dataverse for Teams no ambiente de destino
No Power Platform admin center, navegue até Ambientes, selecione o ambiente de destino e depois Configurações. Em Produtos, encontre Dataverse for Teams e defina como Habilitado. Esta etapa é necessária se a solução contiver tabelas do Dataverse for Teams. - Exporte a solução com todas as dependências
Vá para o ambiente de origem no Power Platform admin center. Abra Soluções, selecione sua solução e escolha Exportar. Nas configurações avançadas, marque a caixa Incluir todas as dependências. Isso garante que cada componente referenciado seja incluído no arquivo de solução exportado. - Verifique a função do usuário no ambiente de destino
No Power Platform admin center, selecione o ambiente de destino e depois Configurações > Usuários + permissões > Funções de segurança. Confirme se sua conta de usuário tem a função de Personalizador do Sistema ou Administrador do Sistema. Caso contrário, peça a um administrador para atribuir a função apropriada. - Importe a solução novamente
No Copilot Studio, vá em Configurações > Soluções. Selecione Importar solução, carregue o arquivo recém-exportado e siga as instruções. Monitore o progresso da importação. Se aparecerem erros, anote a mensagem de erro exata e o nome do componente. - Resolva erros de componentes ausentes manualmente
Se a importação falhar devido a um componente ausente, crie esse componente no ambiente de destino primeiro. Por exemplo, se o erro mencionar um conector personalizado ausente, crie um conector personalizado com o mesmo esquema no ambiente de destino. Depois, tente a importação novamente.
Se o Copilot Studio ainda não conseguir importar a solução
Importação falha com o erro “Solução não é compatível com este ambiente”
Esse erro indica que a solução contém um componente que requer uma versão superior do Dataverse ou uma licença premium. Verifique a lista de dependências da solução no ambiente de origem. Procure por modelos AI Builder, conectores premium ou APIs personalizadas. Certifique-se de que o ambiente de destino tenha as licenças premium necessárias atribuídas. Se o componente não for crítico, remova-o da solução antes de exportar.
Importação bem-sucedida, mas o Copilot Studio não exibe o bot importado
Após uma importação bem-sucedida, o bot pode não aparecer imediatamente no Copilot Studio. Esse atraso ocorre porque a importação da solução não publica o bot automaticamente. Para publicar o bot, vá para Copilot Studio, selecione Bots, encontre o bot importado e depois selecione Publicar. Se o bot ainda estiver ausente, verifique a lista de componentes da solução no ambiente de destino para confirmar que o componente do bot foi importado corretamente.
Importação falha com o erro “Privilégios insuficientes para concluir a operação”
O usuário que realiza a importação não possui a função de segurança necessária. Esse erro aparece mesmo que o usuário tenha a função de Personalizador do Sistema em alguns casos, porque a importação pode exigir privilégios elevados para certos componentes da solução. Atribua a função de Administrador do Sistema ao usuário temporariamente para a importação e depois revogue-a após a conclusão.
| Item | Ambiente de Origem | Ambiente de Destino |
|---|---|---|
| Licença do Copilot Studio | Não necessária para exportação | Necessária para importação e ativação do bot |
| Dataverse for Teams | Habilitado se a solução usar tabelas do Teams | Deve estar habilitado para a importação ser bem-sucedida |
| Função do usuário | Personalizador do Sistema ou superior para exportação | Administrador do Sistema para importação |
| Configurações de exportação da solução | Incluir todas as dependências recomendado | Não aplicável |
Depois de resolver os problemas de licença, recurso e permissão, o processo de importação no Copilot Studio deve ser concluído sem erros. Sempre exporte soluções com a opção Incluir todas as dependências marcada para minimizar erros de componentes ausentes. Se um componente específico continuar bloqueando a importação, crie esse componente manualmente no ambiente de destino antes de tentar a importação novamente. Para soluções complexas com muitas dependências, considere usar o Power Platform CLI para exportar e importar a solução com resolução completa de dependências.