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

Requerimentos

Equipamento

As funcionalidades da Phi Silica requerem um PC Copilot+ (os teclados dos portáteis têm uma tecla dedicada Copilot). Consulte o guia para programadores do Copilot+ PCs 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 Windows App SDK. 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. Verifica se a tua aplicação está a usar uma versão válida do WinAppSDK no mínimo.

   • Estável: 1.8.3
   • Experimental: 2.0-Exp3

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.

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 Windows App SDK 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