Merge pull request #1142 from MicrosoftDocs/main

Auto Publish – main to live - 2026-03-17 19:00 UTC

Author: learn-build-service-prod[bot]

docs/TOC.yml

@@ -13,8 +13,10 @@ items:
             items:
             - name: Overview
               href: ./apis/phi-silica.md
-            - name: Tutorial
+            - name: Tutorial (MAUI)
               href: ./apis/phi-silica-tutorial.md
+            - name: Tutorial (WinUI 3)
+              href: ./apis/phi-silica-winui-tutorial.md
             - name: LoRA fine-tuning
               href: ./apis/phi-silica-lora.md
         - name: Image Description

docs/apis/phi-silica-tutorial.md

@@ -1,14 +1,14 @@
 ---
-title: Get Started with a Phi Silica Walkthrough
-description: Learn about the new Artificial Intelligence (AI) Phi Silica features and walk through tutorials
-ms.topic: get-started
-ms.date: 11/17/2025
+title: "Tutorial: Build a chat app with Phi Silica and .NET MAUI"
+description: Step-by-step guide to building a .NET MAUI app that uses the Phi Silica on-device language model for text generation and summarization.
+ms.topic: tutorial
+ms.date: 03/17/2026
 dev_langs:
 - csharp
 - cpp
 ---
 
-# Phi Silica walkthrough
+# Tutorial: Build a chat app with Phi Silica and .NET MAUI
 
 > [!IMPORTANT]
 > The Phi Silica APIs are part of a Limited Access Feature (see [LimitedAccessFeatures class](/uwp/api/windows.applicationmodel.limitedaccessfeatures)). For more information or to request an unlock token, please use the [LAF Access Token Request Form](https://go.microsoft.com/fwlink/?linkid=2271232&c1cid=04x409).
@@ -20,7 +20,13 @@ This short tutorial walks through the [Windows AI API sample for .NET MAUI](http
 
 ## Prerequisites
 
-Complete the steps for .NET MAUI described in the [Get started building an app with Windows AI APIs](get-started.md).
+- **Copilot+ PC** with NPU — required for Phi Silica. See the [Copilot+ PCs developer guide](../npu-devices/index.md).
+- **Windows 11 build 26100 or later** (25H2) — check with `winver`.
+- **Developer Mode** enabled — Windows Settings → System → For developers → Developer Mode.
+- **Visual Studio 2022** with the **Windows application development** workload.
+- **Windows App SDK 2.0.0-preview1** — install via NuGet (`Microsoft.WindowsAppSDK` version `2.0.0-preview1`).
+
+Complete the platform-specific steps for .NET MAUI described in the [Get started building an app with Windows AI APIs](get-started.md).
 
 ## Introduction
 
@@ -41,40 +47,38 @@ In the second file listed above, you'll find the following function, which demon
 
 ```csharp
 using Microsoft.Windows.AI; 
+using Microsoft.Windows.AI.Text;
 
 using LanguageModel languageModel = await LanguageModel.CreateAsync(); 
 
-string prompt = "This is a large amount of text I want to have summarized.";
-
-LanguageModelOptions options = new LanguageModelOptions {
-    Skill = LanguageModelSkill.Summarize
-};
+string inputText = "This is a large amount of text I want to have summarized.";
+string prompt = $"Summarize the following text concisely:\n\n{inputText}";
 
-var result = await languageModel.GenerateResponseAsync(options, prompt); 
+var result = await languageModel.GenerateResponseAsync(prompt); 
 
 Console.WriteLine(result.Text); 
 ```
 
 ```cppwinrt
-using namespace winrt::Microsoft::Windows::AI::Generative;
+using namespace winrt::Microsoft::Windows::AI::Text;
 
 auto languageModel = LanguageModel::CreateAsync().get();
 
-std::string prompt = "This is a large amount of text I want to have summarized.";
-
-LanguageModelOptions options = LanguageModelOptions();
-options.Skill = LanguageModelSkill.Summarize;
+std::wstring inputText = L"This is a large amount of text I want to have summarized.";
+std::wstring prompt = L"Summarize the following text concisely:\n\n" + inputText;
 
-auto result = languageModel.GenerateResponseAsync(options, prompt).get();
+auto result = languageModel.GenerateResponseAsync(prompt).get();
 
-std::cout << result.Text() << std::endl;
+std::wcout << result.Text() << std::endl;
 ```
 
+> [!NOTE]
+> The `LanguageModelSkill` enum (`Summarize`, `Rewrite`) is not available in Windows App SDK 2.0 preview. The examples above use prompt engineering — prepending an instruction to the input text — to achieve the same result. When the Skill API is released, you can replace the prompt construction with `new LanguageModelOptions { Skill = LanguageModelSkill.Summarize }`.
+
 ## Build and run the sample
 
 1. Clone the [WindowsAppSDK-Samples](https://github.com/microsoft/WindowsAppSDK-Samples) repo.
-1. Switch to the "release/experimental" branch.
-1. Navigate to the [Samples/WindowsAIFoundry/cs-maui](https://github.com/microsoft/WindowsAppSDK-Samples/tree/release/experimental/Samples/WindowsAIFoundry/cs-maui) folder.
+1. Navigate to the [Samples/WindowsAIFoundry/cs-maui](https://github.com/microsoft/WindowsAppSDK-Samples/tree/main/Samples/WindowsAIFoundry/cs-maui) folder.
 1. Open MauiWindowsAISample.sln in Visual Studio 2022.
 1. Ensure the debug toolbar has "Windows Machine" set as the target device.
 1. Press F5 or select "Start Debugging" from the Debug menu to run the sample (the sample can also be run without debugging by selecting "Start Without Debugging" from the Debug menu or Ctrl+F5).