Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Sie müssen Ihre App nicht in einen Chatbot umwandeln, um ein KI-Feature hinzuzufügen. In diesem Lernprogramm fügen Sie einem kleinen Notiz-Editor eine Schaltfläche "Zusammenfassen " hinzu. Die App behält den ursprünglichen Text bei und zeigt einen KI-generierten Entwurf an.
Sie verwenden C#, WinUI 3 und Foundry Local. Das Foundry Local SDK führt das Modell in Ihrem App-Prozess aus. Sie benötigen kein Azure-Abonnement, einen API-Schlüssel, einen separaten lokalen Webserver oder eine Copilot+ NPU.
Sie erstellen Ein eigenes Projekt und kopieren die vollständigen Codeblöcke aus den Themen in die benannten Dateien. Es ist kein Beispiel-Repository oder Quellcodedownload erforderlich.
Was Sie erstellen
Mit LocalNotes können Sie eine kurze Notiz eingeben, ein lokales Modell vorbereiten und eine Zusammenfassung generieren. Das Beispiel konzentriert sich auf ein Feature: Es speichert keine Notizen, verwaltet Dokumente oder sendet Inhalte an einen Clouddienst.
Sie fügen der App drei Teile hinzu:
| Stück | Verantwortung |
|---|---|
| Ein Zusammenfassungsdienst | Bereiten Sie das Modell vor, und generieren Sie Text lokal. |
| Ein Ansichtsmodell | Koordinieren Sie Fortschritt, Abbruch und behebbare Fehler. |
| Eine Seite | Lassen Sie die Notiz bearbeitbar, und zeigen Sie die Zusammenfassung separat an. |
Wenn Sie bereits über eine WinUI 3-App verfügen, verwenden Sie den Dienst wieder, und verbinden Sie ihn mit Ihrem vorhandenen Ansichtsmodell. Sie müssen Ihre Navigations-, Speicher- oder App-Architektur nicht ersetzen.
Was Sie lernen
- Fügen Sie einer vorhandenen Windows-App ein lokales AI SDK hinzu.
- Fragen Sie vor dem Herunterladen eines Modells, und zeigen Sie den Setupstatus an.
- Halten Sie die Benutzeroberfläche reaktionsfähig, während Sie eine begrenzungsgebundene Antwort generieren.
- Generierung abbrechen, ohne den ursprünglichen Text des Benutzers zu ersetzen.
- Überprüfen Sie die Ausgabequalität, das Fehlerverhalten und die Offline-Ableitung.
Die exemplarische Vorgehensweise folgt dem gleichen Build-and-Inspect-Ansatz wie das WinUI Notes-Lernprogramm und das AI-unterstützte WinUI-Lernprogramm. Hier ist KI ein Feature innerhalb der App, nicht ein Tool, das Sie schreiben müssen.
Voraussetzungen
Vollständiger Schnellstart: Erstellen Sie zuerst Ihre erste WinUI 3-App. Verwenden Sie für dieses Tutorial:
- Windows 11, Version 24H2 (Build 26100) oder höher, auf einem x64- oder Arm64-PC.
- Der Entwicklermodus ist aktiviert.
- Die .NET 10 SDK- und WinUI-Vorlagen zum Erstellen des Projekts. Verwenden Sie zum Bearbeiten und Ausführen Visual Studio 2026 mit der WinUI-Anwendungsentwicklungslast oder ihrem Editor und der Windows-App Development CLI (
winapp). - Internetzugriff für die NuGet-Wiederherstellung sowie für die anfänglichen Downloads von Modellen und Laufzeitkomponenten.
- Genügend Speicherplatz und Arbeitsspeicher für das ausgewählte Modell. Überprüfen Sie die aktuelle Downloadgröße und -lizenz im Foundry Local-Modellkatalog.
Das Lernprogramm verwendet die CPU-Variante von Qwen2.5 0,5B, mit ca. 878 MB zwischengespeicherten Modelldateien in der überprüften Ausführung. Zusätzlichen Speicherplatz für Anwendungs- und Laufzeitabhängigkeiten zulassen. Die CPU-Auswahl ist bewusst: Sie können das Feature ohne NPU oder einen dedizierten KI-Accelerator ausprobieren.
Ein kleines Modell ist nützlich, um die Integration zu erlernen, aber es kann Fakten weglassen oder Formatierungsanweisungen schlecht befolgen. Testen Sie ein Modell anhand des tatsächlichen Inhalts Ihrer App, bevor Sie es für die Produktion auswählen.
Important
Lokale Inferenz bedeutet nicht, dass es während der Einrichtung keinerlei Netzwerkaktivität gibt. Modellerwerb und Laufzeitkomponentendownloads verwenden das Netzwerk. Dieses Beispiel lädt keine Notizen oder Zusammenfassungen hoch und greift nicht auf ein Cloudmodell zurück. Überprüfen Sie die Datenschutz- und Diagnoseinformationen für Foundry Local und die Bedingungen des ausgewählten Modells, bevor Sie Ihre App verteilen.