Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Non è necessario trasformare l'app in un chatbot per aggiungere una funzionalità di intelligenza artificiale. In questa esercitazione, aggiungerai un pulsante Riassumi a un piccolo editor di note. L'app mantiene il testo originale e visualizza una bozza generata dall'intelligenza artificiale insieme.
Si usano C#, WinUI 3 e Foundry Local. Foundry Local SDK esegue il modello all'interno del processo dell'app. Non è necessaria una sottoscrizione Azure, una chiave API, un server Web locale separato o una Copilot+ NPU.
Si crea un progetto personalizzato e si copiano i blocchi di codice completi dagli argomenti nei file denominati. Non è necessario alcun repository di esempio o download del codice sorgente.
Cosa costruisci
LocalNotes consente di immettere una breve nota, preparare un modello locale e generare un riepilogo. L'esempio è incentrato su una funzionalità: non salva note, gestisce documenti o invia contenuto a un servizio cloud.
Aggiungere tre parti all'app:
| Pezzo | Responsabilità |
|---|---|
| Un servizio di riepilogo | Preparare il modello e generare testo in locale. |
| Un modello di visualizzazione | Coordinare lo stato di avanzamento, l'annullamento e gli errori ripristinabili. |
| Una pagina | Mantenere la nota modificabile e visualizzare il riepilogo separatamente. |
Se si dispone già di un'app WinUI 3, riutilizzare il servizio e connetterlo al modello di visualizzazione esistente. Non è necessario sostituire l'architettura di navigazione, di archiviazione o delle app.
Cosa imparerai
- Aggiungere un SDK di intelligenza artificiale locale a un'app Windows esistente.
- Chiedere prima di scaricare un modello e mostrare lo stato di avanzamento della configurazione.
- Mantenere reattiva l'interfaccia utente durante la generazione di una risposta delimitata.
- Annullare la generazione senza sostituire il testo originale dell'utente.
- Verificare la qualità dell'output, il comportamento in caso di errore e l'inferenza offline.
La guida segue lo stesso approccio basato su compilazione e analisi del tutorial WinUI Notes e del tutorial WinUI con l'assistenza dell'IA. In questo caso, l'intelligenza artificiale è una funzionalità all'interno dell'app, non uno strumento che è necessario scrivere.
Prerequisiti
Completare Avvio rapido: creare prima la prima app WinUI 3 . Per questa esercitazione, usare:
- Windows 11 versione 24H2 (build 26100) o successiva in un PC x64 o Arm64.
- Modalità sviluppatore abilitata.
- I modelli .NET 10 SDK e WinUI per creare il progetto. Per modificarla ed eseguirla, usa Visual Studio 2026 con il carico di lavoro per lo sviluppo di applicazioni WinUI oppure il tuo editor e app di Windows Development CLI (
winapp). - Accesso a Internet per il ripristino NuGet e i download iniziali del modello e dei componenti di runtime.
- Spazio su disco e memoria sufficiente per il modello selezionato. Controllare le dimensioni di download e la licenza correnti nel catalogo dei modelli locali di Foundry.
Il tutorial usa la variante per CPU di Qwen2.5 0.5B, con circa 878 MB di file del modello nella cache nell'esecuzione validata. Consenti spazio aggiuntivo per le dipendenze dell'applicazione e del runtime. La scelta della CPU è intenzionale: è possibile provare la funzionalità senza una NPU o un acceleratore di intelligenza artificiale dedicato.
Un modello di piccole dimensioni è utile per apprendere l'integrazione, ma può omettere fatti o seguire le istruzioni di formattazione in modo non appropriato. Testare un modello rispetto al contenuto effettivo dell'app prima di sceglierlo per la produzione.
Importante
L'inferenza locale non significa zero attività di rete durante l'installazione. L'acquisizione del modello e il download dei componenti di runtime richiedono la rete. Questo esempio non carica note o riepiloghi e non esegue il fallback a un modello cloud. Esaminare le informazioni sulla privacy e la diagnostica locali di Foundry e sulle condizioni del modello selezionato prima di distribuire l'app.