Dela via

Felsökning av Windows AI API

Viktigt!

Appar som använder Phi Silica APIs kan stöta på problem med funktionsstöd för begränsad åtkomst (se LimitedAccessFeatures).

För närvarande rekommenderar vi att du använder experimentella versioner eftersom de inte kräver LAF-token.

Kravspecifikation

Hårdvara

Phi Silica-funktioner kräver en Copilot+ PC (bärbara tangentbord har en dedikerad Copilot-nyckel). En lista över rekommenderade enheter finns i utvecklarguiden för Copilot+-datorer .

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

Skärmbild av dialogrutan Windows-version som visas genom att skriva

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

Skärmbild av AI Dev Gallery-exempelappen som visar ett grundläggande exempel på textgenereringsfunktionen.

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 din app använder en giltig WinAppSDK-lägsta version.

    • Stabil: 1.8.3
    • Experimentell: 2.0-Exp3

  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.

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

  • 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

  • Last updated on