> For the complete documentation index, see [llms.txt](https://docs.poweromni.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.poweromni.ai/migracao.md).

# Migração

O Power Omni está passando por uma atualização importante na infraestrutura que sustenta os agentes de IA da plataforma.

Até agora, os agentes utilizavam a base clássica do Microsoft Foundry. Essa estrutura atendeu bem ao produto por bastante tempo, mas está sendo descontinuada pela Microsoft e será substituída pela nova geração do Microsoft Foundry Agents.

Por esse motivo, será necessário migrar os agentes do Power Omni para a nova infraestrutura.

Essa migração mantém o Power Omni alinhado com a evolução da Microsoft e prepara a plataforma para recursos mais modernos, mais estabilidade e novas possibilidades dentro dos agentes de IA.

### Aviso de atualização disponível

Quando a migração estiver disponível para o seu ambiente, o Power Omni exibirá um aviso no topo da tela:

“Uma atualização importante está disponível para o seu ambiente. Saiba mais sobre os benefícios.”

<figure><img src="/files/HagdrwNP0TEQzawynKgd" alt=""><figcaption></figcaption></figure>

Ao clicar em Saiba mais, você será direcionado para a página Migração New Foundry.

Nessa página, você poderá entender os benefícios da atualização, revisar os impactos da migração e iniciar o processo.

### Página Migração New Foundry

Na página Migração New Foundry, você poderá revisar as informações principais da atualização antes de iniciar o processo.

<figure><img src="/files/fcxcdjW1VYedGxBjQhrR" alt=""><figcaption></figcaption></figure>

Essa tela apresenta o motivo da migração, os prazos importantes definidos pela Microsoft, os benefícios imediatos e as possibilidades que a nova infraestrutura abre para o produto.

### Por que essa migração é necessária?

A Microsoft está encerrando gradualmente o suporte às tecnologias antigas utilizadas na versão clássica do Foundry.

A Assistants API, usada como base para agentes em estruturas anteriores, será encerrada em 26 de agosto de 2026. Após essa data, agentes que ainda dependam dessa tecnologia podem deixar de funcionar.

Além disso, o suporte ao Foundry Classic será encerrado em 31 de março de 2027. Depois dessa data, a migração não poderá mais ser feita pela base antiga.

Por isso, recomendamos realizar a migração com antecedência.

### O que muda na prática?

A principal mudança acontece na camada técnica do Power Omni.

O usuário continua acessando seus agentes dentro da plataforma, mas a infraestrutura por trás deles passa a utilizar a nova base do Microsoft Foundry.

Com isso, os agentes passam a funcionar sobre uma estrutura mais atual, preparada para lidar melhor com conversas longas, consultas em arquivos, conectores e novas ferramentas que poderão ser adicionadas ao produto.

### Benefícios imediatos

<figure><img src="/files/UdkFg8J6WnfjvhFeYP95" alt=""><figcaption></figcaption></figure>

Com a nova infraestrutura, os agentes passam a ter respostas mais fluidas.

O mecanismo de streaming foi reescrito na nova plataforma, permitindo que as respostas sejam entregues de forma mais contínua, com menos interrupções em textos longos ou consultas mais complexas.

Outro ponto importante é a estabilidade das conversas. A nova arquitetura trata cada conversa de forma mais isolada, reduzindo problemas onde o histórico de uma sessão poderia interferir em outra, principalmente em agentes com muitos arquivos, documentos ou conectores ativos.

### O que essa nova base permite para o futuro?

A migração também abre espaço para novas possibilidades dentro do Power Omni.

Entre elas, está o suporte a modelos além da família GPT, incluindo modelos como Claude, DeepSeek, Grok e outros modelos disponíveis no catálogo da Microsoft.

Também será possível evoluir o uso de ferramentas nativas, como busca na web em tempo real e interpretador de código, conforme esses recursos forem avaliados e integrados ao produto.

Outro caminho que essa nova base abre é a colaboração entre agentes. Isso permite criar fluxos em que um agente pode acionar outro, formando automações mais avançadas e especializadas.

Essas funcionalidades dependem da migração concluída e ainda podem passar por validação antes de serem liberadas no Power Omni.

### Como iniciar a migração?

O processo é simples.

Acesse a página Migração New Foundry e revise as informações exibidas.

Ao iniciar a migração, o Power Omni exibirá uma janela de confirmação chamada Confirmar início da migração.

Essa tela mostra o que ficará temporariamente bloqueado, o que será transferido e quais pontos exigem atenção antes de continuar.

<figure><img src="/files/xzaqm7JIzYkFxBp5it2K" alt=""><figcaption></figcaption></figure>

Para prosseguir, clique em Confirmar e Iniciar.

Caso ainda não queira iniciar, clique em Cancelar.

### Funcionalidades bloqueadas durante o processo

Enquanto a migração estiver em andamento, algumas ações ficarão temporariamente indisponíveis no ambiente.

Durante esse período, não será possível criar, editar ou excluir agentes.

Também não será possível criar, editar ou excluir conectores dos tipos Document, OpenAPI, Fabric, N8N, Logic App e SharePoint.

O upload e a exclusão de arquivos também ficarão bloqueados até a migração ser concluída.

Esse bloqueio é temporário e serve para evitar alterações no ambiente enquanto os recursos estão sendo transferidos para a nova infraestrutura.

### Histórico de conversas

O histórico atual de conversas dos agentes não será transferido.

Isso significa que as threads e interações antigas não serão migradas para a nova infraestrutura.

Depois que a migração for concluída, as novas conversas começarão do zero.

Os agentes serão migrados, mas o histórico das conversas anteriores não será mantido.

### O que será transferido?

Os principais recursos do ambiente serão migrados automaticamente para a nova infraestrutura.

Serão transferidos:

* Agentes, incluindo configurações, instruções e system prompt.
* Conectores.
* Arquivos associados aos agentes.

Os arquivos serão reenviados para a nova plataforma durante a migração.

### Possíveis falhas parciais

Alguns conectores do tipo Documento podem falhar durante a migração.

Isso pode acontecer, por exemplo, quando um arquivo está corrompido, quando há limite de quota ou quando o reenvio para a nova infraestrutura não é concluído corretamente.

Nesses casos, o agente será criado sem o conector que apresentou problema.

Depois que a migração terminar, esse conector poderá ser recriado manualmente.

### Acompanhando o progresso

Após confirmar o início da migração, o Power Omni exibirá o status Migração em andamento.

Você poderá acompanhar o progresso pela tela de migração ou pelo botão Ver Progresso.

<figure><img src="/files/5q3eF0AD17f9twzXhJqL" alt=""><figcaption></figcaption></figure>

Enquanto o processo estiver em andamento, aguarde a conclusão antes de tentar alterar agentes, conectores ou arquivos.

<figure><img src="/files/TCVq4rWn0IA4JgWusE8A" alt=""><figcaption></figcaption></figure>

### O que devo conferir após migrar?

Após concluir a migração, valide os seguintes pontos:

* Se o agente responde normalmente.
* Se os documentos conectados continuam sendo consultados.
* Se os conectores configurados continuam funcionando.
* Se as respostas estão coerentes com as instruções do agente.

Caso encontre qualquer comportamento diferente, entre em contato com o suporte do Power Omni.

### Preciso recriar meus agentes?

Não necessariamente.

A migração foi pensada para atualizar a infraestrutura que sustenta os agentes, sem exigir que o usuário reconstrua tudo do zero.

Mesmo assim, recomendamos revisar os agentes mais importantes depois da migração, principalmente aqueles que usam documentos, conectores ou instruções mais específicas.

### Posso continuar usando a versão antiga?

A versão antiga continuará disponível apenas durante o período de transição.

Como a Microsoft já definiu prazos para encerramento das tecnologias antigas, a recomendação é migrar o quanto antes para evitar interrupções futuras.

### Preciso de ajuda?

Se tiver qualquer dúvida durante o processo, entre em contato com o suporte do Power Omni.

Nossa equipe pode auxiliar na migração, revisar o ambiente e ajudar na validação dos agentes após a atualização.
