Solução de problemas da API de IA do Windows

Requirements

Equipamento

Windows AI APIs dão suporte a hardwares diferentes dependendo da API. Consulte a tabela de hardware com suporte para obter uma visão geral completa.

Para obter recursos acelerados por NPU, consulte Copilot+ PCs guia do desenvolvedor para obter uma lista de dispositivos recomendados.

Programas de computador

O Windows 11, versão 25H2 (build 10.0.26200.7309) ou posterior deve ser instalado no pc Copilot+. Isso pode ser verificado abrindo o menu Iniciar, digitando "winver" e pressionando Enter (uma caixa de diálogo com os detalhes do sistema operacional, semelhante ao seguinte, deve aparecer).

Verifique se você pode usar recursos do Phi Silica:

1. Baixe e instale o aplicativo da Galeria de Desenvolvimento de IA da Microsoft Store.
2. Execute o aplicativo.
3. Selecione IA APIs no painel esquerdo.
4. Clique em Phi Silica>Geração de Texto.
5. Confirme se o Phi Silica responde a um prompt (o aplicativo de exemplo começa com um prompt padrão).

Outras recomendações

Habilitar Modo de Desenvolvedor em Configurações>Sistema>Para desenvolvedores>Modo de Desenvolvedor.

Instale o Visual Studio com as cargas de trabalho e os componentes necessários para o desenvolvimento com o WinUI e o SDK do Aplicativo do Windows. Para obter mais detalhes, consulte cargas de trabalho e componentes necessários.

Resolução de Erros

Se Phi Silica não parece estar funcionando em seu sistema, há algumas coisas que você pode fazer.

1. Verifique se todos os modelos necessários foram instalados acessando os Componentes de IA do Sistema > de Configurações>, que mostra os modelos de IA disponíveis no sistema. Se o modelo necessário não estiver listado, vá para Configurações > do Windows Update e clique em "Verificar se há atualizações" (uma reinicialização pode ser necessária).

2. Verifique se seu aplicativo está usando uma versão mínima SDK do Aplicativo Windows válida.

   • Canal estável: 1.8.0 (1.8.250907003) ou posterior
   • Canal experimental (necessário para Phi Silica na GPU): 2.2.2-experimental9 (experimental de junho de 2026) ou posterior

3. Verifique Configurações>Atualizações para garantir que as atualizações do Windows não estejam pausadas.

4. Colete rastros por meio do aplicativo do Hub de Comentários do Windows e compartilhe-os com a equipe do Windows para analisar.

   1. Abra o aplicativo Hub de Comentários (chave do Windows + F).
   2. Entre com sua conta preferencial.
   3. Insira detalhes do bug na seção 1 (prefixe o título do bug com "[Windows AI APIs]").
   4. Na seção 2, clique em Problema, selecione Plataforma de Desenvolvedor na primeira lista suspensa e selecione Windows AI Foundry na segunda lista suspensa.
   5. A seção 3 exibirá todos os comentários existentes semelhantes aos seus. Se os comentários existentes não forem encontrados, selecione Novos comentários e clique em Avançar.
   6. Na seção 4, você pode:
      1. Clique em Recriar meu problema e, em seguida, clique em Iniciar gravação, execute a Galeria de Desenvolvimento de IA, reproduza o problema, interrompa a gravação.
      2. Inclua informações e anexos adicionais (como imagens). Forneça o máximo de detalhes possível, incluindo etapas de reprodução e mensagens de erro.
   7. Envie os comentários.

Solução de problemas de GPU (Phi Silica)

O Phi Silica na GPU requer que o Modo de Desenvolvedor esteja habilitado (Configurações>Sistema>Para desenvolvedores>Modo de Desenvolvedor).

Executar o Phi Silica na GPU requer o driver mais recente instalado diretamente do fabricante da GPU (NVIDIA GeForce 615.21 beta, AMD Software: Adrenalin Edition 26.10.2). Os drivers padrão do Windows Update ou de instalações OEM podem não ser suficientes. Observe que os drivers OEM ou Windows Update podem substituir os drivers de GPU instalados anteriormente– se o Phi Silica parar de funcionar após uma atualização, reinstale o driver mais recente diretamente do fabricante da GPU.

O suporte à GPU Phi Silica requer GPUs NVIDIA (série RTX 30 e mais recentes com 6 GB de vRAM) ou GPUs AMD Radeon com o driver mais recente. Se EnsureReadyAsync falhar em um dispositivo GPU, verifique se a versão do driver de GPU atende aos requisitos mínimos.

Solução de problemas de CPU (Super resolução de vídeo, reconhecimento de fala)

Esses recursos são executados em qualquer CPU, mas têm o melhor desempenho em dispositivos que atendem às especificações recomendadas: pelo menos 4 núcleos físicos, um relógio base de 3 GHz ou superior e 32 MB ou mais de cache L3. Se você vir desempenho lento, gaguejar ou qualidade reduzida, verifique a CPU do host em relação a essas recomendações. Para obter uma verificação de runtime que retorna true quando o dispositivo atende às especificações recomendadas, consulte o MeetsRecommendedCpuSpecs exemplo de C# nos documentos sobre resolução de vídeo.

O modelo VSR é fornecido com o SDK do Aplicativo Windows e não é baixado separadamente; se o VSR não for inicializado, verifique a documentação VSR para obter restrições de resolução e formato com suporte em vez do estado do modelo.

Outras diretrizes

• Os aplicativos que usam Windows AI APIs precisam receber a identidade do pacote no runtime. Para obter detalhes, consulte Vantagens e desvantagens de empacotar seu aplicativo. Se você estiver vendo um erro UnauthorizedAccessException (ou tiver outros problemas de acesso), verifique se seu aplicativo está empacotado e se a funcionalidade systemAIModels foi adicionada ao seu arquivo de manifesto (consulte Introdução à criação de um aplicativo com Windows AI APIs).

• Requisitos do Recurso de Acesso Limitado (LAF):

  • Verifique se você solicitou e recebeu um token LAF da Microsoft
  • Os valores de status a seguir indicam que o LAF falhou.
    • LimitedAccessFeatureStatus.Unavailable
    • LimitedAccessFeatureStatus.Unknown

• Aplicativos autocontidos não podem ser executados da pasta Downloads (ou de qualquer lugar na pasta C:\Users). Para obter mais detalhes, consulte Vantagens e desvantagens de empacotar seu aplicativo e a visão geral da implantação do SDK de Aplicativos do Windows.

• O canal experimental do SDK do Aplicativo do Windows inclui APIs e recursos em estágios iniciais de desenvolvimento. Todos os APIs no canal experimental estão sujeitos a revisões abrangentes e alterações significativas e podem ser removidos das versões subsequentes a qualquer momento. Não há suporte para recursos experimentais para uso em ambientes de produção e aplicativos que os usam não podem ser publicados na Microsoft Store.

• Forneça comentários sobre essas APIs funcionalidades criando um novo problema no repositório GitHub do SDK de Aplicativos do Windows (inclua Phi Silica no título) ou respondendo a um problema existente.

Consulte também

• Galeria de Desenvolvimento de IA
• Exemplos de API de IA do Windows