Comece a criar um aplicativo com a IA do Windows APIs

1. Confirma se o teu dispositivo cumpre os requisitos de hardware para o Windows AI APIs que planeias usar. A maioria dos APIs requer um Copilot+ PC com uma NPU (recomendamos os dispositivos listados no guia para desenvolvedores Copilot+ PCs). Alguns APIs também suportam execução por GPU ou CPU em dispositivos sem Copilot+ — consulte a tabela de hardware suportado para obter detalhes.

2. Execute o seguinte comando no Terminal do Windows.

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

   Isso executa um arquivo de configuração do WinGet que executa as seguintes tarefas:

   • Verifica a versão mínima do sistema operacional.
   • Habilita o Modo de Desenvolvedor.
   • Instala o Visual Studio Community Edition com WinUI e outras cargas de trabalho necessárias.
   • Instala o SDK do Aplicativo Windows.

• Confirma se o teu dispositivo cumpre os requisitos de hardware para o Windows AI APIs que planeias usar. A maioria dos APIs requer um Copilot+ PC com uma NPU (recomendamos os dispositivos listados no guia para desenvolvedores Copilot+ PCs). Alguns APIs também suportam execução por GPU ou CPU — consulte a tabela de hardware suportada para mais detalhes.
• Instale o Windows 11 Insider Preview build 26120.3073 (Canais Dev e Beta) ou posterior (para verificar a versão do seu sistema operacional, execute winver a partir do Windows Search).
  • Para Phi Silica em GPU: Utilize a compilação 26300.8553 ou posterior do Windows Insider Experimental Channel.
• Habilite o Modo de Desenvolvedor em Configurações>Sistema>para desenvolvedores>Modo de Desenvolvedor. Isto é obrigatório para a Phi Silica na GPU.
• Instale o Visual Studio com as cargas de trabalho e componentes específicos para desenvolvimento com WinUI e o SDK de aplicativos do Windows. Para obter mais detalhes, consulte Cargas de trabalho e componentes necessários.
• Utilize a versão 2.2.2-experimental9 (Experimental de junho de 2026) do SDK de Aplicações Windows ou posterior para o Phi Silica na GPU.

1. No Visual Studio, crie um novo projeto WinUI selecionando o modelo Aplicação em Branco, Empacotada (WinUI 3 in Desktop).

   

2. No Gerenciador de Soluções, clique com o botão direito do mouse no nó do projeto, selecione Propriedades>do Aplicativo>Geral e verifique se a estrutura de destino está definida como .NET 8.0 e se o sistema operacional de destino está definido como 10.0.22621 ou posterior.

   

3. Edite o arquivo Package.appxmanifest (clique com o botão direito do mouse e selecione Exibir código) e adicione os seguintes trechos.

   • Capacidade do systemAIModels para o nó <Capabilities>.

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

   • O systemai especificador de namespace para "IgnorableNamespaces" no <Package> nó:

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

   • A versão máxima testada no elemento TargetDeviceFamily do nó <Dependencies> precisa ser de pelo menos 10.0.26226.0.

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

4. Adicione o seguinte ao seu arquivo .waproj, .csproj ou .vcxproj. Esta etapa é necessária para garantir que o visual studio não substitua a versão máxima testada.

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

5. Clique com o botão direito do mouse no nó do projeto e selecione Gerenciar pacotes NuGet....

6. No Gerenciador de Pacotes NuGet, marque a caixa de seleção Incluir pré-lançamento e selecione SDK de Aplicações Windows versão 1.8.250410001-experimental1. Clique em Instalar ou Atualizar.

   

7. Certifique-se de que a configuração da sua build está definida para a arquitetura adequada ao seu dispositivo (por exemplo, ARM64 ou x64).

   

8. Crie e execute seu aplicativo.

9. Se a aplicação for iniciada com sucesso, continue a Adicionar a sua primeira IA API. Caso contrário, consulte Solução de problemas.

1. No Visual Studio, crie um novo projeto WPF selecionando o modelo Aplicativo WPF .

2. No Gerenciador de Soluções, clique com o botão direito do mouse no nó do projeto e selecione Editar Arquivo de Projeto para abrir como XML. Substitua tudo o que está dentro <PropertyGroup> pelo seguinte:

   <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. Edite o arquivo Package.appxmanifest (clique com o botão direito do mouse e selecione Exibir código) e adicione os seguintes trechos.

   • Capacidade do systemAIModels para o nó <Capabilities>.

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

   • O systemai especificador de namespace para "IgnorableNamespaces" no <Package> nó:

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

   • A versão máxima testada no elemento TargetDeviceFamily do nó <Dependencies> precisa ser de pelo menos 10.0.26226.0.

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

4. Adicione o seguinte ao seu arquivo .waproj, .csproj ou .vcxproj. Esta etapa é necessária para garantir que o visual studio não substitua a versão máxima testada.

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

5. No Gerenciador de Soluções, clique com o botão direito do mouse no nó Dependências e selecione Gerenciar Pacotes Nuget....

6. No Gerenciador de Pacotes NuGet, marque a caixa de seleção Incluir pré-lançamento e selecione SDK de Aplicações Windows versão 1.8.250410001-experimental1. Clique em Instalar ou Atualizar.

7. Crie e execute seu aplicativo.

8. Se a aplicação for iniciada com sucesso, continue a Adicionar a sua primeira IA API. Caso contrário, consulte Solução de problemas.

Para obter mais informações, consulte Configurar seu projeto WPF para suporte ao SDK de aplicativos Windows.

1. No Visual Studio, crie um novo projeto WinForms selecionando o modelo Windows Forms App .

2. No Explorador de Soluções, clique com o botão direito do rato no nó do projeto >Editar Ficheiro de Projeto para abrir como XML. Substitua tudo o que está dentro <PropertyGroup> pelo seguinte:

   <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. Edite o arquivo Package.appxmanifest (clique com o botão direito do mouse e selecione Exibir código) e adicione os seguintes trechos.

   • Capacidade do systemAIModels para o nó <Capabilities>.

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

   • O systemai especificador de namespace para "IgnorableNamespaces" no <Package> nó:

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

   • A versão máxima testada no elemento TargetDeviceFamily do nó <Dependencies> precisa ser de pelo menos 10.0.26226.0.

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

4. Adicione o seguinte ao seu arquivo .waproj, .csproj ou .vcxproj. Esta etapa é necessária para garantir que o visual studio não substitua a versão máxima testada.

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

5. No Explorador de Soluções, clique com o botão direito do mouse no nó Dependências>.

6. No Gerenciador de Pacotes NuGet>Procura, marque Incluir pré-lançamento e selecione SDK de Aplicações Windows versão 1.8.250410001-experimental1. Clique em Instalar ou Atualizar.

7. Crie e execute seu aplicativo.

8. Se a aplicação for iniciada com sucesso, continue a Adicionar a sua primeira IA API. Caso contrário, consulte Solução de problemas.

Para obter mais informações, consulte Configurar seu projeto WinForms para suporte ao SDK de aplicativos Windows.

1. Crie um projeto MAUI seguindo as instruções em Crie seu primeiro aplicativo .NET MAUI.

2. No Explorador de Soluções, clique com o botão direito do rato no nó do projeto >Editar Ficheiro de Projeto para abrir como XML.

3. Na parte inferior do arquivo de projeto, adicione estas linhas para fazer referência à versão correta do pacote Microsoft.WindowsAppSDK (ao compilar para a plataforma Windows):

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

   Observação

   Embora possas clicar no nó do projeto e selecionar a opção Gerir Pacotes NuGet para adicionar o pacote necessário, se a tua aplicação também estiver a ser construída para outras plataformas, como Android e iOS, ainda precisas de editar o ficheiro do projeto para condicionar a referência do pacote para compilações apenas para Windows.

4. Adicione o seguinte ao seu arquivo .waproj, .csproj ou .vcxproj. Esta etapa é necessária para garantir que o visual studio não substitua a versão máxima testada.

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

5. No Gerenciador de Soluções, clique com o botão direito do mouse no nó do projeto, selecione Propriedades e verifique se a Estrutura do Windows de Destino está definida como 10.0.22621 ou posterior.

6. Edite o arquivo Package.appxmanifest (clique com o botão direito do mouse e selecione Exibir código) e adicione os seguintes trechos.

   • Capacidade do systemAIModels para o nó <Capabilities>.

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

   • O systemai especificador de namespace para "IgnorableNamespaces" no <Package> nó:

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

   • A versão máxima testada no elemento TargetDeviceFamily do nó <Dependencies> precisa ser de pelo menos 10.0.26226.0.

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

7. Crie e execute seu aplicativo.

8. Se a aplicação for iniciada com sucesso, continue a Adicionar a sua primeira IA API. Caso contrário, consulte Solução de problemas.

1. Em MainWindow.xaml, adicione um TextBlock para exibir a resposta LanguageModel .

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

2. Na parte superior da MainWindow.xaml.cs, adicione a seguinte using Microsoft.Windows.AI diretiva.

   using Microsoft.Windows.AI; 
   

3. No MainWindow.xaml.cs, substitua a classe MainWindow pelo código a seguir, que confirma que o LanguageModel está disponível e, em seguida, envia um prompt solicitando que o modelo responda com a fórmula molecular da glicose.

   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. Compile e execute a aplicação.

5. A fórmula para glicose deve aparecer no bloco de texto.

1. Em MainWindow.xaml, adicione um TextBlock para exibir a resposta LanguageModel .

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

2. Na parte superior da MainWindow.xaml.cs, adicione a seguinte using Microsoft.Windows.AI diretiva.

   using Microsoft.Windows.AI; 
   

3. No MainWindow.xaml.cs, substitua a classe MainWindow pelo código a seguir, que confirma que o LanguageModel está disponível e, em seguida, envia um prompt solicitando que o modelo responda com a fórmula molecular da glicose.

   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. Compile e execute a aplicação.

5. A fórmula para glicose deve aparecer no bloco de texto.

1. No Windows Forms Designer, arraste um Label para a página e nomeie-o OutputLabel.

2. Na parte superior da Form1.cs, adicione a seguinte using Microsoft.Windows.AI diretiva.

   using Microsoft.Windows.AI; 
   

3. Em Form.cs, substitua a classe Form pelo código a seguir, que confirma que o LanguageModel está disponível e, em seguida, envia um prompt solicitando que o modelo responda com a fórmula molecular da glicose.

   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. Compile e execute a aplicação.

5. A fórmula para glicose deve aparecer no bloco de texto.

Consulte Invocar código de plataforma para obter detalhes sobre como adicionar código específico da plataforma a um aplicativo MAUI.

Neste exemplo, usamos a abordagem de classes parciais e métodos parciais para colocar o código do Windows na pasta Platform\Windows.

1. No MainPage.xaml.cs, adicione uma definição de método parcial como partial void ChangeLanguageModelAvailability(); e chame esse método parcial do manipulador OnCounterClicked para o CounterBtn botão criado pelo modelo .NET MAUI App.

2. No Gerenciador de Soluções, expanda Plataformas, clique com o botão direito do mouse em Windows, selecione Adicionar>Classe..., digite o nome MainPage.cs e clique em Adicionar.

3. O novo MainPage.cs deve ser mostrado na janela do editor. Volte para MainPage.xaml.cs para copiar a linha do namespace.

4. Volte para o novo MainPage.cs e substitua sua linha de namespace pela linha de MainPage.xaml.cs. Isso é para tornar a classe Platform\Windows uma extensão parcial da classe MainPage base.

5. Para concluir em tornar MainPage.cs numa extensão, substitua na declaração de classe internal por partial.

6. Adicione o seguinte código ao método parcial ChangeLanguageModelAvailability definido na etapa 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. Execute a aplicação novamente, clique no botão Clique em mim e observe a saída no painel de depuração de saída do Visual Studio.