Compartilhar via

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

Importante

Os aplicativos que usam o Phi Silica APIs podem encontrar problemas com o suporte ao Recurso de Acesso Limitado (consulte LimitedAccessFeatures).

Neste momento, é recomendável usar versões experimentais, pois elas não exigem tokens LAF.

Requirements

Equipamento

Os recursos do Phi Silica exigem um PC Copilot+ (os teclados de laptop têm uma chave Copilot dedicada). Consulte o Guia do Desenvolvedor de PCs Copilot+ 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).

Captura de tela da caixa de diálogo de versão do Windows exibida digitando 'winver' e pressionando Enter.

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).

Captura de tela do aplicativo de exemplo da Galeria de Desenvolvimento de IA mostrando um exemplo básico do recurso Geração de Texto.

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 válida do WinAppSDK.

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

  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.

Outras diretrizes

Consulte também

  • Last updated on