Delen via

Probleemoplossing voor Windows AI-API

Belangrijk

Apps die de Phi Silicium APIs gebruiken, kunnen problemen ondervinden met ondersteuning voor beperkte toegangsfuncties (zie LimitedAccessFeatures).

Op dit moment raden we u aan experimentele releases te gebruiken omdat ze geen LAF-tokens nodig hebben.

Requirements

Apparatuur

PhiSilium-functies vereisen een Copilot+ pc (laptoptoetsenborden hebben een speciale Copilot-toets). Zie de ontwikkelaarshandleiding voor Copilot+ pc's voor een lijst met aanbevolen apparaten.

Programmatuur

Windows 11, versie 25H2 (build 10.0.26200.7309) of hoger moet zijn geïnstalleerd op de Copilot+ pc. Dit kan worden gecontroleerd door het startmenu te openen, 'winver' te typen en op Enter te drukken (een dialoogvenster met de details van het besturingssysteem, vergelijkbaar met het volgende, moet worden weergegeven).

Schermopname van het windows-versievenster dat wordt weergegeven door 'winver' te typen en op Enter te drukken.

Zorg ervoor dat u PhiSilium-functies kunt gebruiken:

  1. Download en installeer de AI Dev Gallery-app vanuit de Microsoft Store.
  2. Voer de app uit.
  3. Selecteer AI APIs in het linkerdeelvenster.
  4. Klik op Phi Silica>Text Generation.
  5. Controleer of Phi Silicium reageert op een prompt (de voorbeeld-app begint met een standaardprompt).

Schermopname van de ai Dev Gallery-voorbeeld-app met een basisvoorbeeld van de functie Tekstgeneratie.

Andere aanbevelingen

Schakel de ontwikkelaarsmodus in hetinstellingensysteem>> invoor ontwikkelaarsmodus>.

Installeer Visual Studio met de workloads en onderdelen die nodig zijn voor het ontwikkelen met WinUI en de Windows App SDK. Zie Vereiste workloads en onderdelen voor meer informatie.

Fouten opsporen

Als Phi Silicium niet lijkt te werken aan uw systeem, zijn er een paar dingen die u kunt doen.

  1. Controleer of u alle vereiste modellen hebt geïnstalleerd door naar Instellingen > systeem-AI-onderdelen >te gaan, waarin de AI-modellen worden weergegeven die beschikbaar zijn op het systeem. Als het vereiste model niet wordt vermeld, gaat u naar Instellingen > Windows Update en klikt u op Controleren op updates (mogelijk is opnieuw opstarten vereist).

  2. Controleer of uw app een geldige minimumversie van WinAppSDK gebruikt.

    • Stabiel: 1.8.3
    • Experimenteel: 2.0-Exp3

  3. Controleerinstellingenupdates> om ervoor te zorgen dat Windows-updates niet worden onderbroken.

  4. Verzamel traceringen via de Windows Feedback Hub-app en deel ze met het Windows-team om te controleren.

    1. Open de App Feedback Hub (Windows-toets + F).
    2. Meld u aan met uw favoriete account.
    3. Voer foutdetails in sectie 1 in (voorvoegsel van de titel van de bug met '[Windows AI APIs]').
    4. Klik in sectie 2 op Probleem, selecteer Developer Platform in de eerste vervolgkeuzelijst en selecteer vervolgens Windows AI Foundry in de tweede vervolgkeuzelijst.
    5. In sectie 3 worden alle bestaande feedback weergegeven die vergelijkbaar is met die van u. Als bestaande feedback niet wordt gevonden, selecteert u Nieuwe feedback en klikt u op Volgende.
    6. In sectie 4 kunt u het volgende doen:
      1. Klik op Mijn probleem opnieuw maken en klik vervolgens op Opname starten, AI Dev Gallery uitvoeren, het probleem reproduceren, de opname stoppen.
      2. Voeg aanvullende informatie en bijlagen toe (zoals afbeeldingen). Geef zoveel mogelijk details op, inclusief reproductiestappen en foutberichten.
    7. Dien de feedback in.

Andere richtlijnen

  • Apps die gebruikmaken van Windows AI APIs moeten op runtime pakketidentiteit worden verleend. Zie Voor meer informatie voordelen en nadelen van het verpakken van uw app. Als u een UnauthorizedAccessException-fout ziet (of andere toegangsproblemen ondervindt), controleert u of uw app is verpakt en of de systemAIModels-mogelijkheid is toegevoegd aan uw manifestbestand (zie Aan de slag met het bouwen van een app met Windows AI APIs).

  • Vereisten voor functie voor beperkte toegang (LAF):

  • Zelfstandige apps kunnen niet worden uitgevoerd vanuit de map Downloads (of vanaf een willekeurige locatie onder de C:\Users map). Zie voor meer informatie de voordelen en nadelen van het verpakken van uw app en windows App SDK-implementatieoverzicht.

  • Het experimentele kanaal van de Windows App SDK bevat APIs alsook functies in een vroeg stadium van ontwikkeling. Alle APIs in het experimentele kanaal zijn onderhevig aan uitgebreide revisies en belangrijke wijzigingen en kunnen op elk gewenst moment worden verwijderd uit volgende releases. Experimentele functies worden niet ondersteund voor gebruik in productieomgevingen en apps die deze gebruiken, kunnen niet worden gepubliceerd naar de Microsoft Store.

  • Geef feedback over deze APIs en hun functionaliteit door een nieuw probleem te maken in de GitHub-opslagplaats van de Windows App SDK (inclusief Phi Silicium in de titel) of door te reageren op een bestaand probleem.

Zie ook

  • Last updated on