Skip to content

Commit 9aedc82

Browse files
Update MAUI tutorial prerequisites and SDK version notes
- Add explicit Copilot+ PC and Windows 11 build 26100 requirement - Add Developer Mode prerequisite - Specify Windows App SDK 2.0.0-preview1 (was unversioned) - Update LanguageModelSkill note: 'current experimental build' -> 'Windows App SDK 2.0 preview' - Remove 'release/experimental' branch switch (sample on main branch now) Co-authored-by: Copilot <[email protected]>
1 parent 71a68c9 commit 9aedc82

1 file changed

Lines changed: 11 additions & 6 deletions

File tree

docs/apis/phi-silica-tutorial.md

Lines changed: 11 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,13 @@ This short tutorial walks through the [Windows AI API sample for .NET MAUI](http
2020
2121
## Prerequisites
2222

23-
Complete the steps for .NET MAUI described in the [Get started building an app with Windows AI APIs](get-started.md).
23+
- **Copilot+ PC** with NPU — required for Phi Silica. See the [Copilot+ PCs developer guide](../npu-devices/index.md).
24+
- **Windows 11 build 26100 or later** (25H2) — check with `winver`.
25+
- **Developer Mode** enabled — Windows Settings → System → For developers → Developer Mode.
26+
- **Visual Studio 2022** with the **Windows application development** workload.
27+
- **Windows App SDK 2.0.0-preview1** — install via NuGet (`Microsoft.WindowsAppSDK` version `2.0.0-preview1`).
28+
29+
Complete the platform-specific steps for .NET MAUI described in the [Get started building an app with Windows AI APIs](get-started.md).
2430

2531
## Introduction
2632

@@ -50,7 +56,7 @@ string prompt = $"Summarize the following text concisely:\n\n{inputText}";
5056

5157
var result = await languageModel.GenerateResponseAsync(prompt);
5258

53-
Console.WriteLine(result.Response);
59+
Console.WriteLine(result.Text);
5460
```
5561

5662
```cppwinrt
@@ -63,17 +69,16 @@ std::wstring prompt = L"Summarize the following text concisely:\n\n" + inputText
6369
6470
auto result = languageModel.GenerateResponseAsync(prompt).get();
6571
66-
std::wcout << result.Response() << std::endl;
72+
std::wcout << result.Text() << std::endl;
6773
```
6874

6975
> [!NOTE]
70-
> The `LanguageModelSkill` enum (`Summarize`, `Rewrite`) is not available in the current experimental build. 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 }`.
76+
> 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 }`.
7177
7278
## Build and run the sample
7379

7480
1. Clone the [WindowsAppSDK-Samples](https://github.com/microsoft/WindowsAppSDK-Samples) repo.
75-
1. Switch to the "release/experimental" branch.
76-
1. Navigate to the [Samples/WindowsAIFoundry/cs-maui](https://github.com/microsoft/WindowsAppSDK-Samples/tree/release/experimental/Samples/WindowsAIFoundry/cs-maui) folder.
81+
1. Navigate to the [Samples/WindowsAIFoundry/cs-maui](https://github.com/microsoft/WindowsAppSDK-Samples/tree/main/Samples/WindowsAIFoundry/cs-maui) folder.
7782
1. Open MauiWindowsAISample.sln in Visual Studio 2022.
7883
1. Ensure the debug toolbar has "Windows Machine" set as the target device.
7984
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).

0 commit comments

Comments
 (0)