Partager via

Résolution des problèmes liés à l’API Windows AI

Importante

Les applications utilisant Phi Silicon APIs peuvent rencontrer des problèmes avec la prise en charge des fonctionnalités d’accès limité (voir LimitedAccessFeatures).

À ce stade, nous vous recommandons d’utiliser des versions expérimentales , car elles ne nécessitent pas de jetons LAF.

Spécifications

Matériel

Les fonctionnalités de Phi Silicon nécessitent un PC Copilot+ (les claviers portables ont une touche Copilot dédiée). Consultez le guide du développeur des PC Copilot+ pour obtenir la liste des appareils recommandés.

Logiciel

Windows 11, version 25H2 (build 10.0.26200.7309) ou version ultérieure doit être installé sur le PC Copilot+. Cela peut être vérifié en ouvrant le menu Démarrer, en tapant « winver » et en appuyant sur Entrée (une boîte de dialogue contenant les détails du système d’exploitation, semblable à ce qui suit, doit apparaître).

Capture d’écran de la boîte de dialogue Version de Windows affichée en tapant « winver », puis en appuyant sur Entrée.

Assurez-vous que vous pouvez utiliser les fonctionnalités de Phi Silicon :

  1. Téléchargez et installez l’application ai Dev Gallery à partir du Microsoft Store.
  2. Exécutez l’application.
  3. Sélectionnez l’IA APIs dans le volet gauche.
  4. Cliquez sur Phi Silicon>Text Generation.
  5. Vérifiez que Phi Silicon répond à une invite (l’exemple d’application commence par une invite par défaut).

Capture d’écran de l’exemple d’application ai Dev Gallery montrant un exemple de base de la fonctionnalité Génération de texte.

Autres recommandations

Activez le mode développeur dans lesystème>paramètres>pour les développeurs>en mode développeur.

Installez Visual Studio avec les charges de travail et les composants requis pour le développement avec WinUI et le Kit de développement logiciel (SDK) d’application Windows. Pour plus d’informations, consultez Charges de travail et composants obligatoires.

Débogage

Si Phi Silicon ne semble pas travailler sur votre système, il y a quelques choses que vous pouvez faire.

  1. Vérifiez que tous les modèles requis sont installés en accédant aux composants IA du système > de paramètres>, qui affichent les modèles IA disponibles sur le système. Si le modèle requis n’est pas répertorié, accédez à Paramètres > Windows Update et cliquez sur « Rechercher les mises à jour » (un redémarrage peut être nécessaire).

  2. Vérifiez que votre application utilise une version minimale WinAppSDK valide.

    • Stable : 1.8.3
    • Expérimental : 2.0-Exp3

  3. Vérifiez lesmises à jour> pour vous assurer que les mises à jour Windows ne sont pas suspendues.

  4. Collectez les traces via l'application Hub de commentaires Windows et partagez-les pour révision par l'équipe Windows.

    1. Ouvrez l’application Hub de commentaires (touche Windows + F).
    2. Connectez-vous avec votre compte préféré.
    3. Entrez les détails du bogue dans la section 1 (préfixez le titre du bogue avec « [Windows AI APIs] »).
    4. Dans la section 2, cliquez sur Problème, sélectionnez Plateforme de développement dans la première liste déroulante, puis Sélectionnez Windows AI Foundry dans la deuxième liste déroulante.
    5. La section 3 affiche tous les commentaires existants similaires à ceux dont vous avez fait l’objet. Si aucun commentaire existant n’est trouvé, sélectionnez Nouveau commentaire , puis cliquez sur Suivant.
    6. Dans la section 4, vous pouvez :
      1. Cliquez sur Recréer mon problème, puis cliquez sur Démarrer l’enregistrement, exécutez ai Dev Gallery, reproduisez le problème, arrêtez l’enregistrement.
      2. Incluez des informations et des pièces jointes supplémentaires (telles que des images). Fournissez autant de détails que possible, y compris les étapes de reproduction et les messages d’erreur.
    7. Envoyez les commentaires.

Autres conseils

Voir aussi

  • Last updated on