Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Nie musisz przekształcać aplikacji w czatbota, aby dodać funkcję sztucznej inteligencji. W tym samouczku dodasz przycisk Podsumuj do małego edytora notatek. Aplikacja przechowuje oryginalny tekst i wyświetla wersję roboczą wygenerowaną przez sztuczną inteligencję wraz z nią.
Używasz języka C#, WinUI 3 i lokalnego rozwiązania Foundry. Lokalny zestaw SDK usługi Foundry uruchamia model wewnątrz procesu aplikacji. Nie potrzebujesz subskrypcji Azure, klucza interfejsu API, oddzielnego lokalnego serwera internetowego ani Copilot+ NPU.
Utworzysz własny projekt i skopiujesz kompletne bloki kodu z tematów do nazwanych plików. Nie jest wymagane żadne przykładowe repozytorium ani pobieranie kodu źródłowego.
Co tworzysz
Program LocalNotes umożliwia wprowadzenie krótkiej notatki, przygotowanie modelu lokalnego i wygenerowanie podsumowania. Przykład koncentruje się na jednej funkcji: nie zapisuje notatek, zarządza dokumentami ani nie wysyła zawartości do usługi w chmurze.
Do aplikacji dodaje się trzy elementy:
| Kawałek | Odpowiedzialność |
|---|---|
| Usługa podsumowania | Przygotuj model i wygeneruj tekst lokalnie. |
| Model widoku | Koordynuj postęp, anulowanie i błędy możliwe do naprawienia. |
| Strona | Zachowaj możliwość edycji notatki i oddzielnie pokaż podsumowanie. |
Jeśli masz już aplikację WinUI 3, użyj ponownie usługi i połącz ją z istniejącym modelem widoku. Nie musisz zastępować nawigacji, warstwy przechowywania danych ani architektury aplikacji.
Czego się uczysz
- Dodaj lokalny zestaw SDK sztucznej inteligencji do istniejącej aplikacji Windows.
- Zapytaj przed pobraniem modelu i pokaż postęp instalacji.
- Zachowaj responsywność interfejsu użytkownika podczas generowania ograniczonej odpowiedzi.
- Anuluj generowanie bez zastępowania oryginalnego tekstu użytkownika.
- Sprawdź jakość wyników, zachowanie w przypadku awarii oraz inferencję offline.
W tym przewodniku zastosowano takie samo podejście polegające na tworzeniu i analizowaniu jak w samouczku WinUI Notes oraz samouczku WinUI z pomocą AI. W tym miejscu sztuczna inteligencja jest funkcją w aplikacji, a nie narzędziem, które należy napisać.
Wymagania wstępne
Ukończ szybki start: najpierw utwórz pierwszą aplikację WinUI 3 . Na potrzeby tego samouczka użyj:
- Windows 11, wersja 24H2 (kompilacja 26100) lub nowsza na komputerze x64 lub Arm64.
- Tryb dewelopera jest włączony.
- Szablony .NET 10 SDK i WinUI do utworzenia projektu. Do edytowania i uruchamiania użyj programu Visual Studio 2026 z obciążeniem programistycznym do tworzenia aplikacji WinUI albo swojego edytora oraz interfejsu wiersza polecenia aplikacja dla systemu Windows Development CLI (
winapp). - Dostęp do Internetu na potrzeby przywracania i początkowego modelu NuGet oraz pobierania składników środowiska uruchomieniowego.
- Wystarczająca ilość miejsca na dysku i pamięć dla wybranego modelu. Sprawdź bieżący rozmiar pobierania i licencję w katalogu modeli lokalnych usługi Foundry.
W samouczku użyto wariantu procesora CPU Qwen2.5 0.5B, z około 878 MB buforowanych plików modelu w zweryfikowanych uruchomieniach. Zezwalaj na dodatkowe miejsce na zależności aplikacji i środowiska uruchomieniowego. Wybór procesora CPU jest celowy: możesz wypróbować tę funkcję bez jednostki NPU lub dedykowanego akceleratora sztucznej inteligencji.
Mały model jest przydatny podczas nauki integracji, ale może pomijać informacje lub słabo stosować się do instrukcji dotyczących formatowania. Przetestuj model pod kątem rzeczywistej zawartości aplikacji przed wybraniem go do środowiska produkcyjnego.
Ważna
Wnioskowanie lokalne nie oznacza zerowej aktywności sieciowej podczas instalacji. Pobieranie modeli i pobieranie składników środowiska uruchomieniowego korzystają z sieci. Ten przykład nie przekazuje notatek ani podsumowań i nie wraca do modelu w chmurze. Przed dystrybucją aplikacji zapoznaj się z informacjami o ochronie prywatności i diagnostyki lokalnej usługi Foundry oraz warunkami wybranego modelu.