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

Requerimentos

Equipamento

Windows AI APIs suporta hardware diferente dependendo da API. Consulte a tabela de hardware suportado para uma visão geral completa.

Para funcionalidades aceleradas por NPUs, consulte Copilot+ PCs developer guide para uma lista de dispositivos recomendados.

Programa informático

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

Certifique-se de que pode usar as funcionalidades da Phi Silica:

1. Descarregue e instale a aplicação AI Dev Gallery a partir da Microsoft Store.
2. Execute o aplicativo.
3. Seleciona IA APIs no painel esquerdo.
4. Clique emGeração de Texto>.
5. Confirma que a Phi Silica responde a um prompt (a aplicação de exemplo começa com um prompt padrão).

Outras recomendações

Ativar o Modo Desenvolvedor noSistema> de Definições>Para Desenvolvedores>Modo Desenvolvedor.

Instale o Visual Studio com as cargas de trabalho e componentes necessários para desenvolver com o WinUI e o SDK de Aplicações Windows. Para obter mais detalhes, consulte Cargas de trabalho e componentes necessários.

Debugging

Se a Phi Silica não parecer funcionar no seu sistema, há algumas coisas que pode fazer.

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

2. Verifique se a sua aplicação está a usar uma versão válida do SDK de Aplicações Windows.

   • 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 Definições>Atualizações para garantir que as atualizações do Windows não estão pausadas.

4. Recolha vestígios através da aplicação Windows Feedback Hub e partilhe-os com a equipa do Windows para rever.

   1. Abra a aplicação Feedback Hub (tecla Windows + F).
   2. Inicia sessão com a tua conta preferida.
   3. Introduza os detalhes do bug na secção 1 (prefixe o título do bug com "[Windows AI APIs]").
   4. Na secção 2, clique em Problema, selecione Plataforma para Desenvolvedores no primeiro menu suspenso e depois selecione Windows AI Foundry no segundo menu suspenso.
   5. A Secção 3 irá mostrar qualquer feedback existente semelhante ao seu. Se não for encontrado feedback existente, selecione Novo feedback e clique em Próximo.
   6. Na secção 4 pode:
      1. Clica em Recriar o meu problema, depois em Iniciar gravação, executa a Galeria de Desenvolvimento do IA, reproduz o problema e pára a gravação.
      2. Inclua informações adicionais e anexos (como imagens). Forneça o máximo de detalhes possível, incluindo passos de reprodução e mensagens de erro.
   7. Envie os comentários.

Resolução de problemas da GPU (Phi Silica)

Phi Silica na GPU requer que o Modo Desenvolvedor esteja ativado (Sistema> de Definições>para Desenvolvedores>, Modo Desenvolvedor).

Correr Phi Silica na GPU requer o driver mais recente instalado diretamente pelo fabricante da GPU (NVIDIA GeForce 615.21 beta, AMD Software: Adrenalin Edition 26.10.2). Os drivers predefinidos do Windows Update ou das instalações OEM podem não ser suficientes. Note que os drivers OEM ou o Windows Update podem sobrescrever drivers da GPU previamente instalados — se a Phi Silica deixar de funcionar após uma atualização, reinstale o driver mais recente diretamente do fabricante da GPU.

O suporte para GPUs Phi Silica requer GPUs NVIDIA (série RTX 30 e mais recentes com 6+ GB vRAM) ou GPUs AMD Radeon com o driver mais recente. Se EnsureReadyAsync falhar num dispositivo com GPU, verifica se a versão do driver da tua GPU cumpre os requisitos mínimos.

Resolução de problemas do CPU (Super Resolução de Vídeo, Reconhecimento de Fala)

Estas funcionalidades funcionam em qualquer CPU, mas têm melhor desempenho em dispositivos que cumpram as especificações recomendadas: pelo menos 4 núcleos físicos, uma frequência base de 3 GHz ou superior, e 32 MB ou mais de cache L3. Se notar desempenho lento, stutters ou qualidade reduzida, verifique o CPU host com base nestas recomendações. Para uma verificação em tempo de execução que retorna true quando o dispositivo cumpre as especificações recomendadas, consulte o MeetsRecommendedCpuSpecs exemplo de C# na documentação Video Super Resolution.

O modelo VSR vem com o SDK de Aplicações Windows e não é descarregável separadamente; se o VSR falhar em inicializar, verifique a documentação VSR para resoluções suportadas e restrições de formato em vez do estado do modelo.

Outras orientações

• As aplicações que usam Windows AI APIs precisam de receber identidade de pacote em tempo de execução. Para obter detalhes, consulte Vantagens e desvantagens de empacotar seu aplicativo. Se estiver a ver um erro UnauthorizedAccessException (ou a ter outros problemas de acesso), certifique-se de que a sua aplicação está empacotada e que a funcionalidade systemAIModels foi adicionada ao seu ficheiro de manifestos (veja Começar a construir uma aplicação com Windows AI APIs).

• Requisitos para Funcionalidades de Acesso Limitado (LAF):

  • Verifique se solicitou e recebeu um token LAF da Microsoft
  • Os seguintes valores de estado indicam que a LAF falhou.
    • LimitedAccessFeatureStatus.NãoDisponível
    • LimitedAccessFeatureStatus.Desconhecido

• Aplicações autónomas não podem correr a partir da pasta Downloads (nem de qualquer lugar dentro da C:\Users pasta). Para obter mais detalhes, consulte Vantagens e desvantagens de empacotar seu aplicativo e Visão geral da implantação do SDK de Aplicativo Windows.

• O canal experimental do SDK de Aplicações Windows inclui APIs e funcionalidades em fases iniciais de desenvolvimento. Todos os APIs no canal experimental estão sujeitos a extensas revisões e alterações significativas e podem ser removidos de lançamentos subsequentes a qualquer momento. Os recursos experimentais não são suportados para uso em ambientes de produção e os aplicativos que os usam não podem ser publicados na Microsoft Store.

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

Ver também

• AI Dev Galeria
• Exemplos de API de IA do Windows