Introduzione alla creazione di un'app con Windows per intelligenza artificiale APIs

1. Verifica che il tuo dispositivo soddisfi i requisiti hardware per Windows AI APIs che prevedi di usare. La maggior parte dei APIs richiede un Copilot+ PC con una NPU (è consigliabile usare i dispositivi elencati nella guida per sviluppatori Copilot+ PCs). Alcuni APIs supportano anche l'esecuzione su GPU o CPU su dispositivi non Copilot+ — consulta la tabella dell'hardware supportato per i dettagli.

2. Eseguire il comando seguente in Terminale Windows.

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

   Viene eseguito un file di configurazione WinGet che esegue le attività seguenti:

   • Verifica la versione minima del sistema operativo.
   • Abilita la modalità sviluppatore.
   • Installa Visual Studio Community Edition con WinUI e altri carichi di lavoro necessari.
   • Installa il SDK per app di Windows.

• Verifica che il tuo dispositivo soddisfi i requisiti hardware per Windows AI APIs che intendi usare. La maggior parte dei APIs richiede un Copilot+ PC con una NPU (è consigliabile usare i dispositivi elencati nella guida per sviluppatori Copilot+ PCs). Alcuni APIs supportano anche l'esecuzione della GPU o della CPU. Per informazioni dettagliate, vedere la tabella hardware supportata .
• Installare Windows 11 Insider Preview build 26120.3073 (Dev and Beta Channels) o versioni successive (per controllare la versione del sistema operativo, eseguire winver da Windows Search).
  • Per Phi Silica con GPU: usare Windows Insider Experimental Channel build 26300.8553 o versione successiva.
• Abilitare la modalità sviluppatore in Impostazioni>sistema>per sviluppatori> modalitàsviluppatore. Questa operazione è necessaria per Phi Silica sulla GPU.
• Installare Visual Studio con carichi di lavoro e componenti specifici per lo sviluppo con WinUI e SDK per app di Windows. Per altri dettagli, vedere Carichi di lavoro e componenti necessari.
• Usare SDK per app di Windows versione 2.2.2-experimental9 (Sperimentale di giugno 2026) o successiva per Phi Silica su GPU.

1. In Visual Studio, creare un nuovo progetto WinUI selezionando il modello App vuota, Impacchettata (WinUI 3 in Desktop).

   

2. In Esplora soluzioni fare clic con il pulsante destro del mouse sul nodo del progetto, selezionare Proprietà>Generale> e assicurarsi che il framework di destinazione sia impostato su .NET 8.0 e che il sistema operativo di destinazione sia impostato su 10.0.22621 o versione successiva.

   

3. Modificare il file Package.appxmanifest (fare clic con il pulsante destro del mouse e selezionare Visualizza codice) e aggiungere i frammenti di codice seguenti.

   • Funzionalità systemAIModels del <Capabilities> nodo:

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

   • Identificatore systemai dello spazio dei nomi in "IgnorableNamespaces" nel <Package> nodo:

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

   • La versione massima testata nell'elemento TargetDeviceFamily del <Dependencies> nodo deve essere almeno 10.0.26226.0:

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

4. Aggiungere quanto segue al file con estensione waproj, csproj o .vcxproj. Questo passaggio è necessario per fare in modo che Visual Studio non sovrascriva la versione massima testata.

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

5. Fare clic con il pulsante destro del mouse sul nodo del progetto e scegliere Gestisci pacchetti NuGet.

6. In Gestione pacchetti NuGet selezionare la casella di controllo Includi versione preliminare e selezionare SDK per app di Windows versione 1.8.250410001-experimental1. Fare clic su Installa o Aggiorna.

   

7. Assicurarsi che la configurazione di compilazione sia impostata sull'architettura appropriata per il dispositivo, ad esempio ARM64 o x64.

   

8. Compilare ed eseguire l'app.

9. Se l'app viene avviata correttamente, quindi continua ad aggiungere la tua prima intelligenza artificiale API. In caso contrario, vedere Risoluzione dei problemi.

1. In Visual Studio creare un nuovo progetto macchine virtuali Windows selezionando il modello applicazione macchine virtuali Windows .

2. In Esplora soluzioni fare clic con il pulsante destro del mouse sul nodo del progetto e scegliere Modifica file di progetto per aprire come XML. Sostituire tutto all'interno di <PropertyGroup> con quanto segue:

   <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. Modificare il file Package.appxmanifest (fare clic con il pulsante destro del mouse e selezionare Visualizza codice) e aggiungere i frammenti di codice seguenti.

   • Funzionalità systemAIModels del <Capabilities> nodo:

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

   • Identificatore systemai dello spazio dei nomi in "IgnorableNamespaces" nel <Package> nodo:

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

   • La versione massima testata nell'elemento TargetDeviceFamily del <Dependencies> nodo deve essere almeno 10.0.26226.0:

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

4. Aggiungere quanto segue al file con estensione waproj, csproj o .vcxproj. Questo passaggio è necessario per fare in modo che Visual Studio non sovrascriva la versione massima testata.

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

5. In Esplora soluzioni fare clic con il pulsante destro del mouse sul nodo Dipendenze e scegliere Gestisci pacchetti NuGet.

6. In Gestione pacchetti NuGet selezionare la casella di controllo Includi versione preliminare e selezionare SDK per app di Windows versione 1.8.250410001-experimental1. Fare clic su Installa o Aggiorna.

7. Compilare ed eseguire l'app.

8. Se l'app viene avviata correttamente, quindi continua ad aggiungere la tua prima intelligenza artificiale API. In caso contrario, vedere Risoluzione dei problemi.

Per altre info, vedi Configurare il progetto macchine virtuali Windows per il supporto di SDK per app di Windows.

1. In Visual Studio creare un nuovo progetto WinForms selezionando il modello App Windows Form .

2. In Esplora soluzioni fare clic con il pulsante destro del mouse sul nodo > del progetto Modifica file di progetto per aprire come XML. Sostituire tutto all'interno di <PropertyGroup> con quanto segue:

   <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. Modificare il file Package.appxmanifest (fare clic con il pulsante destro del mouse e selezionare Visualizza codice) e aggiungere i frammenti di codice seguenti.

   • Funzionalità systemAIModels del <Capabilities> nodo:

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

   • Identificatore systemai dello spazio dei nomi in "IgnorableNamespaces" nel <Package> nodo:

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

   • La versione massima testata nell'elemento TargetDeviceFamily del <Dependencies> nodo deve essere almeno 10.0.26226.0:

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

4. Aggiungere quanto segue al file con estensione waproj, csproj o .vcxproj. Questo passaggio è necessario per fare in modo che Visual Studio non sovrascriva la versione massima testata.

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

5. In Esplora soluzioni fare clic con il pulsante destro del mouse sul nodo >Gestisci pacchetti NuGet...

6. In Gestore pacchetti NuGet, >, selezionare Includi versione preliminare e scegliere SDK per app di Windows versione 1.8.250410001-experimental1. Fare clic su Installa o Aggiorna.

7. Compilare ed eseguire l'app.

8. Se l'app viene avviata correttamente, quindi continua ad aggiungere la tua prima intelligenza artificiale API. In caso contrario, vedere Risoluzione dei problemi.

Per altre info, vedi Configurare il progetto WinForms per il supporto di SDK per app di Windows.

1. Creare un progetto MAUI seguendo le istruzioni riportate in Compilare la prima app MAUI .NET.

2. In Esplora soluzioni fare clic con il pulsante destro del mouse sul nodo > del progetto Modifica file di progetto per aprire come XML.

3. Nella parte inferiore del file di progetto aggiungere queste righe per fare riferimento alla versione corretta del pacchetto Microsoft.WindowsAppSDK (durante la compilazione per la piattaforma Windows):

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

   Annotazioni

   Anche se è possibile fare clic sul nodo del progetto e selezionare l'opzione Gestisci pacchetti NuGet per aggiungere il pacchetto necessario, se l'app viene compilata anche per altre piattaforme, ad esempio Android e iOS, è comunque necessario modificare il file di progetto in modo da definire il riferimento al pacchetto per le compilazioni solo Windows.

4. Aggiungere quanto segue al file con estensione waproj, csproj o .vcxproj. Questo passaggio è necessario per fare in modo che Visual Studio non sovrascriva la versione massima testata.

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

5. In Esplora soluzioni fare clic con il pulsante destro del mouse sul nodo del progetto, selezionare Proprietà e assicurarsi che Windows Framework di destinazione sia impostato su 10.0.22621 o versione successiva.

6. Modificare il file Package.appxmanifest (fare clic con il pulsante destro del mouse e selezionare Visualizza codice) e aggiungere i frammenti di codice seguenti.

   • Funzionalità systemAIModels del <Capabilities> nodo:

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

   • Identificatore systemai dello spazio dei nomi in "IgnorableNamespaces" nel <Package> nodo:

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

   • La versione massima testata nell'elemento TargetDeviceFamily del <Dependencies> nodo deve essere almeno 10.0.26226.0:

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

7. Compilare ed eseguire l'app.

8. Se l'app viene avviata correttamente, quindi continua ad aggiungere la tua prima intelligenza artificiale API. In caso contrario, vedere Risoluzione dei problemi.

1. In MainWindow.xaml aggiungere un controllo TextBlock per visualizzare la risposta LanguageModel .

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

2. Nella parte superiore di MainWindow.xaml.cs aggiungere la direttiva seguente using Microsoft.Windows.AI .

   using Microsoft.Windows.AI; 
   

3. In MainWindow.xaml.cssostituire la classe MainWindow con il codice seguente, che conferma che LanguageModel è disponibile e quindi invia una richiesta che chiede al modello di rispondere con la formula molecolare del glucosio.

   public sealed partial class MainWindow : Window
   {
       public MainWindow()
       {
           this.InitializeComponent();
           InitAI();
       }
   
       private async void InitAI()
       {
           OutputText.Text = "Loading..";
   
           if (LanguageModel.GetReadyState() == AIFeatureReadyState.EnsureNeeded)
           {
               var result = await LanguageModel.EnsureReadyAsync();
               if (result.Status != PackageDeploymentStatus.CompletedSuccess)
               {
                   throw new Exception(result.ExtendedError().Message);
               }
           }            
   
           using LanguageModel languageModel = 
              await LanguageModel.CreateAsync();
   
           string prompt = "Provide the molecular formula of glucose.";
           var result = await languageModel.GenerateResponseAsync(prompt);
           OutputText.Text = result.Response;
       }
   }
   

4. Compilare ed eseguire l'app.

5. La formula per il glucosio dovrebbe essere visualizzata nel blocco di testo.

1. In MainWindow.xaml aggiungere un controllo TextBlock per visualizzare la risposta LanguageModel .

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

2. Nella parte superiore di MainWindow.xaml.cs aggiungere la direttiva seguente using Microsoft.Windows.AI .

   using Microsoft.Windows.AI; 
   

3. In MainWindow.xaml.cs sostituire la classe MainWindow con il codice seguente, che conferma che LanguageModel è disponibile e quindi invia una richiesta che chiede al modello di rispondere con la formula molecolare del glucosio.

   public sealed partial class MainWindow : Window
   {
       public MainWindow()
       {
           this.InitializeComponent();
           InitAI();
       }
   
       private async void InitAI()
       {
           OutputText.Text = "Loading..";
   
           if (LanguageModel.GetReadyState() == AIFeatureReadyState.EnsureNeeded)
           {
               var result = await LanguageModel.EnsureReadyAsync();
               if (result.Status != PackageDeploymentStatus.CompletedSuccess)
               {
                   throw new Exception(result.ExtendedError().Message);
               }
           }            
   
           using LanguageModel languageModel = await LanguageModel.CreateAsync();
   
           string prompt = "Provide the molecular formula for glucose.";
           var result = await languageModel.GenerateResponseAsync(prompt);
           OutputText.Text = result.Response;
       }
   }
   

4. Compilare ed eseguire l'app.

5. La formula per il glucosio dovrebbe essere visualizzata nel blocco di testo.

1. In Windows Forms Designer, trascinare un Label nella pagina e assegnarle il nome OutputLabel.

2. Nella parte superiore di Form1.cs aggiungere la direttiva seguente using Microsoft.Windows.AI .

   using Microsoft.Windows.AI; 
   

3. In Form.cs sostituire la classe Form con il codice seguente, che conferma che LanguageModel è disponibile e quindi invia una richiesta che chiede al modello di rispondere con la formula molecolare del glucosio.

   public partial class Form1 : Window
   {
       public Form1()
       {
           this.InitializeComponent();
           InitAI();
       }
   
       private async void InitAI()
       {
           OutputLabel.Text = "Loading..";
   
           if (LanguageModel.GetReadyState() == AIFeatureReadyState.EnsureNeeded)
           {
               var result = await LanguageModel.EnsureReadyAsync();
               if (result.Status != PackageDeploymentStatus.CompletedSuccess)
               {
                   throw new Exception(result.ExtendedError().Message);
               }
           }            
   
           using LanguageModel languageModel = await LanguageModel.CreateAsync();
   
           string prompt = "Provide the molecular formula for glucose.";
           var result = await languageModel.GenerateResponseAsync(prompt);
           OutputLabel.Text = result.Response;
       }
   }
   

4. Compilare ed eseguire l'app.

5. La formula per il glucosio dovrebbe essere visualizzata nel blocco di testo.

Per informazioni dettagliate sull'aggiunta di codice specifico della piattaforma a un'app MAUI, vedere Richiamare il codice della piattaforma .

Per questo esempio, usiamo le classi parziali e l'approccio ai metodi parziali per inserire il codice Windows nella cartella Platform\Windows.

1. In MainPage.xaml.cs aggiungere una definizione di metodo parziale come partial void ChangeLanguageModelAvailability(); e chiamare tale metodo parziale dal gestore OnCounterClicked per il CounterBtn pulsante creato dal modello app MAUI .NET.

2. In Esplora soluzioni espandere Piattaforme, fare clic con il pulsante destro del mouse su Windows, scegliere Aggiungi>classe..., digitare il nome MainPage.cs e fare clic su Aggiungi.

3. Il nuovo MainPage.cs deve essere visualizzato nella finestra dell'editor. Passare nuovamente a MainPage.xaml.cs per copiare la riga dello spazio dei nomi.

4. Passa di nuovo alla nuova MainPage.cs e sostituisci la riga dello spazio dei nomi con la riga da MainPage.xaml.cs. Ciò consente di rendere la classe Platform\Windows un'estensione parziale della classe MainPage di base.

5. Per completare l'esecuzione di MainPage.cs un'estensione, sostituire internal nella dichiarazione di classe con partial.

6. Aggiungere il codice seguente al metodo parziale ChangeLanguageModelAvailability definito nel passaggio 1.

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

7. Eseguire di nuovo l'app, fare clic sul pulsante Fai clic su di me e osservare l'output nel riquadro di output del debug di Visual Studio.