Felsökning av Windows AI API

Kravspecifikation

Hårdvara

Windows AI APIs stöder olika maskinvara beroende på API:et. Se tabellen över maskinvara som stöds för en fullständig översikt.

Information om NPU-accelererade funktioner finns i utvecklarguiden Copilot+ PCs för en lista över rekommenderade enheter.

Programvara

Windows 11 version 25H2 (version 10.0.26200.7309) eller senare måste installeras på Copilot+ PC. Detta kan verifieras genom att öppna Start-menyn, skriva "winver" och trycka på Retur (en dialogruta med operativsystemets information, liknande följande, bör visas).

Se till att du kan använda Phi Silica-funktioner:

1. Ladda ned och installera AI Dev Gallery-appen från Microsoft Store.
2. Kör appen.
3. Välj AI APIs i den vänstra rutan.
4. Klicka på Phi Silica>Text Generation.
5. Bekräfta att Phi Silica svarar på en uppmaning (exempelappen börjar med en standardprompt).

Andra rekommendationer

Aktivera Utvecklarläge i Inställningar>System>För utvecklare>Utvecklarläge.

Installera Visual Studio med de arbetsbelastningar och komponenter som krävs för utveckling med WinUI och Windows App SDK. Mer information finns i Obligatoriska arbetsbelastningar och komponenter.

Felsökning

Om Phi Silica inte verkar fungera på ditt system finns det några saker du kan göra.

1. Kontrollera att du har alla nödvändiga modeller installerade genom att gå till Inställningar > System > AI-komponenter, som visar de AI-modeller som är tillgängliga i systemet. Om den modell som krävs inte visas går du till Inställningar > Windows Update och klickar på "Sök efter uppdateringar" (en omstart kan krävas).

2. Kontrollera att appen använder en giltig Windows App SDK lägsta version.

   • Stabil kanal: 1.8.0 (1.8.250907003) eller senare
   • Experimentell kanal (krävs för Phi Silica på GPU): 2.2.2-experimental9 (juni 2026 Experimental) eller senare

3. Kontrollera Inställningar>Uppdateringar för att se till att Windows-uppdateringar inte pausas.

4. Samla in spårningar via Windows Feedback Hub-appen och dela dem med Windows-teamet för granskning.

   1. Öppna feedbackhubbens app (Windows-nyckel + F).
   2. Logga in med önskat konto.
   3. Ange felinformation i avsnitt 1 (prefixet felrubriken med "[Windows AI APIs]").
   4. I avsnitt 2 klickar du på Problem, väljer Utvecklarplattform i den första listrutan och väljer sedan Windows AI Foundry i den andra listrutan.
   5. Avsnitt 3 visar all befintlig feedback som liknar din. Om befintlig feedback inte hittas väljer du Ny feedback och klickar på Nästa.
   6. I avsnitt 4 kan du:
      1. Klicka på Återskapa mitt problem, klicka sedan på Starta inspelning, kör AI Dev Gallery, återskapa problemet, stoppa inspelningen.
      2. Inkludera ytterligare information och bifogade filer (till exempel bilder). Ange så mycket information som möjligt, inklusive reproduktionssteg och felmeddelanden.
   7. Skicka feedbacken.

GPU-felsökning (Phi Silica)

Phi Silica på GPU kräver att utvecklarläget är aktiverat (inställningssystem>>för utvecklares>utvecklarläge).

Att köra Phi Silica på GPU kräver den senaste drivrutinen installerad direkt från GPU-tillverkaren (NVIDIA GeForce 615.21 beta, AMD Software: Adrenalin Edition 26.10.2). Standarddrivrutiner från Windows Update- eller OEM-installationer kanske inte räcker. Observera att OEM-drivrutiner eller Windows Update kan skriva över tidigare installerade GPU-drivrutiner – om Phi Silica slutar fungera efter en uppdatering installerar du om den senaste drivrutinen direkt från GPU-tillverkaren.

Stöd för Phi Silica GPU kräver NVIDIA GPU:er (RTX 30-serien och senare med 6+ GB vRAM) eller AMD Radeon GPU:er med den senaste drivrutinen. Om EnsureReadyAsync misslyckas på en GPU-enhet, kontrollera att versionen av GPU-drivrutinen uppfyller minimikraven.

CPU-felsökning (Video Super Resolution, Speech Recognition)

Dessa funktioner körs på alla processorer men fungerar bäst på enheter som uppfyller de rekommenderade specifikationerna: minst 4 fysiska kärnor, en 3 GHz eller högre basklocka och 32 MB eller mer av L3-cachen. Om du ser långsamma prestanda, stamningar eller minskad kvalitet kontrollerar du värdprocessorn mot dessa rekommendationer. Information om en körningskontroll som returnerar true när enheten uppfyller de rekommenderade specifikationerna finns i MeetsRecommendedCpuSpecsC#-exemplet i dokumentationen för Video Super Resolution.

VSR-modellen levereras med Windows App SDK och kan inte laddas ned separat. Om VSR inte kan initieras kontrollerar du VSR-dokumentationen för lösnings- och formatbegränsningar som stöds i stället för modelltillstånd.

Annan vägledning

• Appar som använder Windows AI APIs måste beviljas paketidentitet vid körning. Mer information finns i Fördelar och nackdelar med att paketera din app. Om du ser ett UnauthorizedAccessException-fel (eller om du har andra åtkomstproblem) kontrollerar du att appen är paketerad och att funktionen systemAIModels har lagts till i manifestfilen (se Kom igång med att skapa en app med Windows AI APIs).

• Krav för funktionen Begränsad åtkomst (LAF):

  • Kontrollera att du har begärt och tagit emot en LAF-token från Microsoft
  • Följande statusvärden anger att LAF har misslyckats.
    • BegränsadÅtkomstFunktionStatus.Otillgänglig
    • LimitedAccessFeatureStatus.Unknown

• Fristående appar kan inte köras från mappen Nedladdningar (eller var som helst under C:\Users mappen). Mer information finns i Fördelar och nackdelar med att paketera din app och översikt över Windows App SDK-distribution.

• Windows App SDK:s experimentella kanal innehåller APIs och funktioner i tidiga utvecklingsstadier. Alla APIs i den experimentella kanalen är föremål för omfattande uppdateringar och icke-bakåtkompatibla ändringar och kan när som helst tas bort från framtida versioner. Experimentella funktioner stöds inte för användning i produktionsmiljöer och appar som använder dem kan inte publiceras till Microsoft Store.

• Ge feedback om dessa APIs och deras funktioner genom att skapa ett nytt problem i GitHub-lagringsplatsen för Windows App SDK (inkludera Phi Silica i rubriken) eller genom att svara på ett befintligt problem.

Se även

• AI-utvecklingsgalleri
• Exempel på Windows AI API