Freigeben über


Lernprogramm: Erstellen einer Chat-App mit Phi Silica und .NET MAUI

Von Bedeutung

Die Phi-Silika-APIs sind Teil eines Eingeschränkten Zugriffsfeatures (siehe LimitedAccessFeatures-Klasse). Für weitere Informationen oder zum Anfordern eines Entsperrtokens verwenden Sie bitte das Anforderungsformular für LAF-Zugriffstoken.

Dieses kurze Lernprogramm führt Sie durch das Windows AI-API-Beispiel für .NET MAUI.

Hinweis

Phi-Silika-Features sind in China nicht verfügbar.

Voraussetzungen

  • Copilot+ PC mit NPU – erforderlich für Phi-Silika. Weitere Informationen finden Sie im Entwicklerhandbuch für Copilot+ PCs.
  • Windows 11 Build 26100 oder höher (25H2) – Wenden Sie sich an winver.
  • Entwicklermodus aktiviert – Windows-Einstellungen → System→ Für Entwickler → Entwicklermodus.
  • Visual Studio 2022 mit der Arbeitslast für die Entwicklung von Windows-Anwendungen .
  • Windows App SDK 2.0.0-preview1 – Installation über NuGet (Microsoft.WindowsAppSDK Version 2.0.0-preview1).

Führen Sie die plattformspezifischen Schritte für .NET MAUI aus, die im Abschnitt "Erste Schritte beim Erstellen einer App mit Windows AI-APIs" beschrieben sind.

Einleitung

In diesem Beispiel wird gezeigt, wie Verschiedene Windows AI-APIs verwendet werden, einschließlich LanguageModel für die Textgenerierung und ImageScaler zum Skalieren und Schärfen von Bildern.

Das Beispiel enthält die folgenden vier Dateien:

  1. MauiWindowsAISample.csproj: Fügt die erforderliche Windows App SDK-Paketreferenz für die Windows AI-APIs hinzu und legt das erforderliche TargetFramework für Windows fest.
  2. Plattformen/Windows/MainPage.cs: Implementiert Partielle Methoden aus der freigegebenen MainPage-Klasse , die die Textgenerierungs- und Bildskalierungsfunktionalität anzeigen und verarbeiten.
  3. MainPage.xaml: Definiert Steuerelemente zum Anzeigen der Textgenerierung und Bildskalierung.
  4. MainPage.xaml.cs: Definiert Partielle Methoden, die MainPage.cs implementiert.

In der zweiten oben aufgeführten Datei finden Sie die folgende Funktion, die die Funktionalität der Textzusammenfassung veranschaulicht.

  1. Erstellen einer LanguageModel-Instanz (languageModel).
  2. Übergeben Sie dieses LanguageModel an den TextSummarizer-Konstruktor .
  3. Übergeben Sie Text an die SummarizeAsync-Methode , und drucken Sie das Ergebnis.
using Microsoft.Windows.AI; 
using Microsoft.Windows.AI.Text;
 
using LanguageModel languageModel = await LanguageModel.CreateAsync(); 
 
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(prompt); 
 
Console.WriteLine(result.Text); 
using namespace winrt::Microsoft::Windows::AI::Text;

auto languageModel = LanguageModel::CreateAsync().get();

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(prompt).get();

std::wcout << result.Text() << std::endl;

Hinweis

Die LanguageModelSkill Enum (Summarize, Rewrite) ist in der Windows App SDK 2.0-Vorschau nicht verfügbar. In den obigen Beispielen wird das Prompt-Engineering verwendet, bei dem eine Anweisung dem Eingabetext vorangestellt wird, um dasselbe Ergebnis zu erzielen. Wenn die Skill-API veröffentlicht wird, können Sie die Eingabeaufforderungskonstruktion durch new LanguageModelOptions { Skill = LanguageModelSkill.Summarize }ersetzen.

Erstellen und Ausführen des Beispiels

  1. Klonen Sie das WindowsAppSDK-Samples-Repository .
  2. Navigieren Sie zum Ordner "Samples/WindowsAIFoundry/cs-maui ".
  3. Öffnen Sie MauiWindowsAISample.sln in Visual Studio 2022.
  4. Stellen Sie sicher, dass auf der Debugsymbolleiste als Zielgerät „Windows-Computer“ festgelegt ist.
  5. Drücken Sie F5, oder wählen Sie im Menü "Debuggen starten" aus, um das Beispiel auszuführen (das Beispiel kann auch ohne Debugging ausgeführt werden, indem sie im Menü "Debuggen starten" oder STRG+F5 auswählen).
  6. Klicken Sie auf eine der Schaltflächen "Skalieren", um das Bild zu skalieren, oder geben Sie eine Textaufforderung ein, und klicken Sie auf die Schaltfläche "Generieren", um eine Textantwort zu generieren.

Siehe auch