Kom igång med att skapa en app med Windows AI APIs

1. Kontrollera att din enhet uppfyller de maskinvarukrav som gäller för den Windows AI APIs-funktion som du planerar att använda. De flesta APIs kräver en Copilot+ PC med en NPU (vi rekommenderar de enheter som anges i utvecklarguiden Copilot+ PCs). Vissa APIs stöder även GPU- eller CPU-körning på enheter utan Copilot+ – se tabellen över maskinvara som stöds för mer information.

2. Kör följande kommando i Windows-terminalen.

   winget configure https://raw.githubusercontent.com/microsoft/winget-dsc/refs/heads/main/samples/Configuration%20files/Learn%20tutorials/Windows%20AI/learn_wcr.winget
   

   Detta kör en WinGet-konfigurationsfil som utför följande uppgifter:

   • Söker efter lägsta operativsystemversion.
   • Aktiverar utvecklarläge.
   • Installerar Visual Studio Community Edition med WinUI och andra nödvändiga arbetsbelastningar.
   • Installerar Windows App SDK.

• Kontrollera att din enhet uppfyller de maskinvarukrav som gäller för den Windows AI APIs-funktion som du planerar att använda. De flesta APIs kräver en Copilot+ PC med en NPU (vi rekommenderar de enheter som anges i utvecklarguiden Copilot+ PCs). Vissa APIs stöder även GPU- eller CPU-körning – se maskinvarutabellen som stöds för mer information.
• Installera Windows 11 Insider Preview build 26120.3073 (Dev- och Beta-kanaler) eller senare (om du vill kontrollera operativsystemversionen kör winver du från Windows Search).
  • För Phi Silica på GPU: Använd Windows Insider Experimental Channel build 26300.8553 eller senare.
• Aktivera utvecklarläge i Inställningar>System>För utvecklare>Utvecklarläge. Detta krävs för Phi Silica på GPU.
• Installera Visual Studio med specifika arbetsbelastningar och komponenter för utveckling med WinUI och Windows App SDK. Mer information finns i Börja här.
• Använd Windows App SDK version 2.2.2-experimental9 (juni 2026 Experimental) eller senare för Phi Silica på GPU.

1. I Visual Studio skapar du ett nytt WinUI-projekt genom att välja mallen Tom app, Paketerad (WinUI 3 i Desktop).

   

2. Högerklicka på projektnoden i Prieskumník riešení, välj Egenskaper>Program>allmänt och kontrollera att målramverket är inställt på .NET 8.0 och att måloperativsystemet är inställt på 10.0.22621 eller senare.

   

3. Redigera filen Package.appxmanifest (högerklicka och välj Visa kod) och lägg till följande kodfragment.

   • Funktionen systemAIModels för <Capabilities> noden:

     <Capabilities>
        <systemai:Capability Name="systemAIModels"/>
     </Capabilities>
     

   • Namnområdesspecificeraren systemai till "IgnorableNamespaces" i <Package> noden:

     xmlns:systemai="http://schemas.microsoft.com/appx/manifest/systemai/windows10"
     IgnorableNamespaces="uap rescap systemai"
     

   • Den högsta version som testas i TargetDeviceFamily nodens <Dependencies> element måste vara minst 10.0.26226.0:

     <TargetDeviceFamily Name="Windows.Desktop" MinVersion="10.0.17763.0" MaxVersionTested="10.0.26226.0" />
     

4. Lägg till följande i filen .waproj, .csproj eller .vcxproj. Det här steget är nödvändigt för att säkerställa att Visual Studio inte åsidosätter den maxversion som testats.

   <AppxOSMinVersionReplaceManifestVersion>false</AppxOSMinVersionReplaceManifestVersion>
   <AppxOSMaxVersionTestedReplaceManifestVersion>false</AppxOSMaxVersionTestedReplaceManifestVersion>
   

5. Högerklicka på projektnoden och välj Hantera NuGet-paket....

6. I NuGet Správca balíkov markerar du kryssrutan Inkludera förhandsversion och väljer Windows App SDK version 1.8.250410001-experimental1. Klicka på Installera eller uppdatera.

   

7. Kontrollera att byggkonfigurationen är inställd på rätt arkitektur för din enhet (till exempel ARM64 eller x64).

   

8. Skapa och kör din app.

9. Om appen startas framgångsrikt fortsätter du att lägga till din första AI API. Annars kan du läsa Felsökning.

1. I Visual Studio skapar du ett nytt WPF-projekt genom att välja WPF-applikation-mallen.

2. Högerklicka på projektnoden i Prieskumník riešení och välj Redigera projektfil för att öppna som XML. Ersätt allt inuti <PropertyGroup> med följande:

   <OutputType>WinExe</OutputType>
   <TargetFramework>net8.0-windows10.0.22621.0</TargetFramework>
   <RuntimeIdentifiers>win-x86;win-x64;win-arm64</RuntimeIdentifiers>
   <Nullable>enable</Nullable>
   <UseWPF>true</UseWPF>
   <ImplicitUsings>enable</ImplicitUsings>
   <WindowsPackageType>None</WindowsPackageType>
   

3. Redigera filen Package.appxmanifest (högerklicka och välj Visa kod) och lägg till följande kodfragment.

   • Funktionen systemAIModels för <Capabilities> noden:

     <Capabilities>
        <systemai:Capability Name="systemAIModels"/>
     </Capabilities>
     

   • Namnområdesspecificeraren systemai till "IgnorableNamespaces" i <Package> noden:

     xmlns:systemai="http://schemas.microsoft.com/appx/manifest/systemai/windows10"
     IgnorableNamespaces="uap rescap systemai"
     

   • Den högsta version som testas i TargetDeviceFamily nodens <Dependencies> element måste vara minst 10.0.26226.0:

     <TargetDeviceFamily Name="Windows.Desktop" MinVersion="10.0.17763.0" MaxVersionTested="10.0.26226.0" />
     

4. Lägg till följande i filen .waproj, .csproj eller .vcxproj. Det här steget är nödvändigt för att säkerställa att Visual Studio inte åsidosätter den maxversion som testats.

   <AppxOSMinVersionReplaceManifestVersion>false</AppxOSMinVersionReplaceManifestVersion>
   <AppxOSMaxVersionTestedReplaceManifestVersion>false</AppxOSMaxVersionTestedReplaceManifestVersion>
   

5. Högerklicka på noden Beroenden i Prieskumník riešení och välj Hantera Nuget-paket....

6. I NuGet Správca balíkov markerar du kryssrutan Inkludera förhandsversion och väljer Windows App SDK version 1.8.250410001-experimental1. Klicka på Installera eller uppdatera.

7. Skapa och kör din app.

8. Om appen startas framgångsrikt fortsätter du att lägga till din första AI API. Annars kan du läsa Felsökning.

Mer information finns i Konfigurera WPF-projektet för Windows App SDK-stöd.

1. Skapa ett nytt WinForms-projekt i Visual Studio genom att välja mallen Windows Forms App .

2. I Prieskumník riešení högerklickar du på projektnoden >Redigera projektfil för att öppna som XML. Ersätt allt inuti <PropertyGroup> med följande:

   <OutputType>WinExe</OutputType>
   <TargetFramework>net8.0-windows10.0.22621.0</TargetFramework>
   <RuntimeIdentifiers>win-x86;win-x64;win-arm64</RuntimeIdentifiers>
   <Nullable>enable</Nullable>
   <UseWindowsForms>true</UseWindowsForms>
   <ImplicitUsings>enable</ImplicitUsings>
   <WindowsPackageType>None</WindowsPackageType>
   

3. Redigera filen Package.appxmanifest (högerklicka och välj Visa kod) och lägg till följande kodfragment.

   • Funktionen systemAIModels för <Capabilities> noden:

     <Capabilities>
        <systemai:Capability Name="systemAIModels"/>
     </Capabilities>
     

   • Namnområdesspecificeraren systemai till "IgnorableNamespaces" i <Package> noden:

     xmlns:systemai="http://schemas.microsoft.com/appx/manifest/systemai/windows10"
     IgnorableNamespaces="uap rescap systemai"
     

   • Den högsta version som testas i TargetDeviceFamily nodens <Dependencies> element måste vara minst 10.0.26226.0:

     <TargetDeviceFamily Name="Windows.Desktop" MinVersion="10.0.17763.0" MaxVersionTested="10.0.26226.0" />
     

4. Lägg till följande i filen .waproj, .csproj eller .vcxproj. Det här steget är nödvändigt för att säkerställa att Visual Studio inte åsidosätter den maxversion som testats.

   <AppxOSMinVersionReplaceManifestVersion>false</AppxOSMinVersionReplaceManifestVersion>
   <AppxOSMaxVersionTestedReplaceManifestVersion>false</AppxOSMaxVersionTestedReplaceManifestVersion>
   

5. I Prieskumník riešení högerklickar du på noden >Hantera Nuget-paket....

6. I NuGet Správca balíkov>Browse kontrollerar du Inkludera förhandsversion och väljer Windows App SDK version 1.8.250410001-experimental1. Klicka på Installera eller uppdatera.

7. Skapa och kör din app.

8. Om appen startas framgångsrikt fortsätter du att lägga till din första AI API. Annars kan du läsa Felsökning.

Mer information finns i Konfigurera ditt WinForms-projekt för Windows App SDK-stöd.

1. Skapa ett MAUI-projekt genom att följa anvisningarna i Skapa din första .NET MAUI-app.

2. I Prieskumník riešení högerklickar du på projektnoden >Redigera projektfil för att öppna som XML.

3. Längst ned i projektfilen lägger du till dessa rader för att referera till rätt Microsoft.WindowsAppSDK-paketversion (vid kompilering för Windows-plattformen):

   <ItemGroup Condition="$([MSBuild]::GetTargetPlatformIdentifier('$(TargetFramework)')) == 'windows'">
      <PackageReference Include="Microsoft.WindowsAppSDK" Version="1.8.250410001-experimental1"/> 
   </ItemGroup>
   

   Anmärkning

   Du kan klicka på projektnoden och välja alternativet Hantera NuGet-paket... för att lägga till paketet som krävs, men om din app också skapas för andra plattformar, till exempel Android och iOS, måste du fortfarande redigera projektfilen för att villkora paketreferensen för Windows-versioner.

4. Lägg till följande i filen .waproj, .csproj eller .vcxproj. Det här steget är nödvändigt för att säkerställa att Visual Studio inte åsidosätter den maxversion som testats.

   <AppxOSMinVersionReplaceManifestVersion>false</AppxOSMinVersionReplaceManifestVersion>
   <AppxOSMaxVersionTestedReplaceManifestVersion>false</AppxOSMaxVersionTestedReplaceManifestVersion>
   

5. Högerklicka på projektnoden i Prieskumník riešení, välj Egenskaper och se till att Windows-målramverket är inställt på 10.0.22621 eller senare.

6. Redigera filen Package.appxmanifest (högerklicka och välj Visa kod) och lägg till följande kodfragment.

   • Funktionen systemAIModels för <Capabilities> noden:

     <Capabilities>
        <systemai:Capability Name="systemAIModels"/>
     </Capabilities>
     

   • Namnområdesspecificeraren systemai till "IgnorableNamespaces" i <Package> noden:

     xmlns:systemai="http://schemas.microsoft.com/appx/manifest/systemai/windows10"
     IgnorableNamespaces="uap rescap systemai"
     

   • Den högsta version som testas i TargetDeviceFamily nodens <Dependencies> element måste vara minst 10.0.26226.0:

     <TargetDeviceFamily Name="Windows.Desktop" MinVersion="10.0.17763.0" MaxVersionTested="10.0.26226.0" />
     

7. Skapa och kör din app.

8. Om appen startas framgångsrikt fortsätter du att lägga till din första AI API. Annars kan du läsa Felsökning.

1. I MainWindow.xaml lägger du till en TextBlock för att visa LanguageModel-svaret .

   <TextBlock x:Name="OutputText" HorizontalAlignment="Center" VerticalAlignment="Center" />
   

2. Lägg till följande using Microsoft.Windows.AI och using Microsoft.Windows.AI.Text direktiv överst i MainWindow.xaml.cs.

   using Microsoft.Windows.AI;
   using Microsoft.Windows.AI.Text;
   

3. I MainWindow.xaml.csersätter du klassen MainWindow med följande kod, som bekräftar att LanguageModel är tillgänglig och sedan skickar en uppmaning om att modellen ska svara med den molekylära formeln glukos.

   public sealed partial class MainWindow : Window
   {
       public MainWindow()
       {
           this.InitializeComponent();
           InitAI();
       }
   
       private async void InitAI()
       {
           OutputText.Text = "Loading..";
   
           var readyState = LanguageModel.GetReadyState();
           if (readyState == AIFeatureReadyState.NotReady)
           {
               var ensureResult = await LanguageModel.EnsureReadyAsync();
               if (ensureResult.Status != AIFeatureReadyResultState.Success)
               {
                   throw ensureResult.ExtendedError;
               }
   
               readyState = LanguageModel.GetReadyState();
           }
   
           if (readyState != AIFeatureReadyState.Ready)
           {
               throw new Exception($"LanguageModel is unavailable: {readyState}");
           }
   
           using LanguageModel languageModel = 
              await LanguageModel.CreateAsync();
   
           string prompt = "Provide the molecular formula of glucose.";
           var result = await languageModel.GenerateResponseAsync(prompt);
           OutputText.Text = result.Text;
       }
   }
   

4. Skapa och kör appen.

5. Formeln för glukos bör visas i textblocket.

1. I MainWindow.xaml lägger du till en TextBlock för att visa LanguageModel-svaret .

   <TextBlock x:Name="OutputText" HorizontalAlignment="Center" VerticalAlignment="Center" />
   

2. Lägg till följande using Microsoft.Windows.AI och using Microsoft.Windows.AI.Text direktiv överst i MainWindow.xaml.cs.

   using Microsoft.Windows.AI;
   using Microsoft.Windows.AI.Text;
   

3. I MainWindow.xaml.cs ersätter du klassen MainWindow med följande kod, som bekräftar att LanguageModel är tillgänglig och sedan skickar en uppmaning om att modellen ska svara med den molekylära formeln glukos.

   public sealed partial class MainWindow : Window
   {
       public MainWindow()
       {
           this.InitializeComponent();
           InitAI();
       }
   
       private async void InitAI()
       {
           OutputText.Text = "Loading..";
   
           var readyState = LanguageModel.GetReadyState();
           if (readyState == AIFeatureReadyState.NotReady)
           {
               var ensureResult = await LanguageModel.EnsureReadyAsync();
               if (ensureResult.Status != AIFeatureReadyResultState.Success)
               {
                   throw ensureResult.ExtendedError;
               }
   
               readyState = LanguageModel.GetReadyState();
           }
   
           if (readyState != AIFeatureReadyState.Ready)
           {
               throw new Exception($"LanguageModel is unavailable: {readyState}");
           }
   
           using LanguageModel languageModel = await LanguageModel.CreateAsync();
   
           string prompt = "Provide the molecular formula for glucose.";
           var result = await languageModel.GenerateResponseAsync(prompt);
           OutputText.Text = result.Text;
       }
   }
   

4. Skapa och kör appen.

5. Formeln för glukos bör visas i textblocket.

1. I Windows Forms Designer drar du en etikett till sidan och ger den namnet OutputLabel.

2. Lägg till följande using Microsoft.Windows.AI och using Microsoft.Windows.AI.Text direktiv överst i Form1.cs.

   using Microsoft.Windows.AI;
   using Microsoft.Windows.AI.Text;
   using System.Windows.Forms;
   

3. I Form.cs ersätter du klassen Form med följande kod, som bekräftar att LanguageModel är tillgänglig och sedan skickar en uppmaning om att modellen ska svara med den molekylära formeln glukos.

   public partial class Form1 : Form
   {
       public Form1()
       {
           this.InitializeComponent();
           InitAI();
       }
   
       private async void InitAI()
       {
           OutputLabel.Text = "Loading..";
   
           var readyState = LanguageModel.GetReadyState();
           if (readyState == AIFeatureReadyState.NotReady)
           {
               var ensureResult = await LanguageModel.EnsureReadyAsync();
               if (ensureResult.Status != AIFeatureReadyResultState.Success)
               {
                   throw ensureResult.ExtendedError;
               }
   
               readyState = LanguageModel.GetReadyState();
           }
   
           if (readyState != AIFeatureReadyState.Ready)
           {
               throw new Exception($"LanguageModel is unavailable: {readyState}");
           }
   
           using LanguageModel languageModel = await LanguageModel.CreateAsync();
   
           string prompt = "Provide the molecular formula for glucose.";
           var result = await languageModel.GenerateResponseAsync(prompt);
           OutputLabel.Text = result.Text;
       }
   }
   

4. Skapa och kör appen.

5. Formeln för glukos bör visas i etiketten.

Mer information om hur du lägger till plattformsspecifik kod i en MAUI-app finns i Anropa plattformskod .

I det här exemplet använder vi metoden partiella klasser och partiella metoder för att placera Windows-koden i mappen Platform\Windows.

1. I MainPage.xaml.cs lägger du till en partiell metoddefinition som partial void ChangeLanguageModelAvailability(); och anropar den partiella metoden från hanteraren OnCounterClicked för CounterBtn knappen som skapats av .NET MAUI App-mallen.

2. I Prieskumník riešení expanderar du Plattformar, högerklickar på Windows, väljer Lägg till>klass..., skriver namnet MainPage.cs och klickar på Lägg till.

3. Den nya MainPage.cs ska visas i redigeringsfönstret. Växla tillbaka till MainPage.xaml.cs för att kopiera dess namnområdesrad.

4. Växla tillbaka till den nya MainPage.cs och ersätt dess namnområdesrad med raden från MainPage.xaml.cs. Det här är för att göra klassen Platform\Windows till ett partiellt tillägg för basklassen MainPage .

5. För att göra MainPage.cs till ett tillägg, ersätt internal i klassdeklarationen med partial.

6. Lägg till följande kod i den partiella metoden ChangeLanguageModelAvailability som definieras i steg 1.

   partial void ChangeLanguageModelAvailability() 
   { 
      try 
      { 
         Microsoft.Windows.AI.AIFeatureReadyState readyState = Microsoft.Windows.AI.Text.LanguageModel.GetReadyState();
         System.Diagnostics.Debug.WriteLine($"LanguageModel.GetReadyState: {readyState}"); 
      } 
      catch (Exception e) 
      { 
         System.Diagnostics.Debug.WriteLine($"LanguageModel is not available: {e}"); 
      } 
   }
   

7. Kör appen igen, klicka på knappen Klicka på mig och observera utdata i utdatafönstret för Felsökning i Visual Studio.