Tutoriel : Créer une application de conversation avec Phi Silicon et .NET MAUI

Important

Les API Phi Silicon font partie d’une fonctionnalité d’accès limité (voir la classe LimitedAccessFeatures). Pour plus d’informations ou pour demander un jeton de déverrouillage, utilisez le formulaire de demande de jeton d’accès LAF.

Ce tutoriel court décrit l’exemple d’API d’IA Windows pour .NET MAUI.

Note

Les caractéristiques de Phi Silicon ne sont pas disponibles en Chine.

Conditions préalables

  • Pc Copilot+ avec NPU — requis pour Phi Silicon. Consultez le guide du développeur des PC Copilot+.
  • Windows 11 build 26100 ou version ultérieure (25H2) - vérifiez avec winver.
  • Mode développeur activé : paramètres Windows → système → pour les développeurs → mode développeur.
  • Visual Studio 2022 avec la charge de travail de développement d’applications Windows .
  • Kit de développement logiciel (SDK) d’application Windows 2.0.0-preview1 — installer via NuGet (Microsoft.WindowsAppSDK version 2.0.0-preview1).

Suivez les étapes spécifiques à la plateforme pour .NET MAUI décrites dans la procédure de création d’une application avec des API Windows AI.

Présentation

Cet exemple montre comment utiliser différentes API Windows AI, notamment LanguageModel pour la génération de texte et ImageScaler pour la mise à l’échelle et l'amélioration des images.

L’exemple inclut les quatre fichiers suivants :

  1. MauiWindowsAISample.csproj : ajoute la référence de package du Kit de développement logiciel (SDK) d’application Windows requise pour les API d’IA Windows et définit le TargetFramework nécessaire pour Windows.
  2. Plateformes/Windows/MainPage.cs : implémente des méthodes partielles à partir de la classe MainPage partagée qui affichent et gèrent les fonctionnalités de génération de texte et de mise à l’échelle d’images.
  3. MainPage.xaml : définit les contrôles permettant d’afficher la génération de texte et la mise à l’échelle d’images.
  4. MainPage.xaml.cs : définit des méthodes partielles qui MainPage.cs implémentent.

Dans le deuxième fichier répertorié ci-dessus, vous trouverez la fonction suivante, qui illustre la fonctionnalité de synthèse de texte.

  1. Créez une instance LanguageModel (languageModel).
  2. Passez ce LanguageModel au constructeur TextSummarizer .
  3. Passez du texte à la méthode SummarizeAsync et imprimez le résultat.
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;

Note

L’énumération LanguageModelSkill (Summarize, Rewrite) n’est pas disponible dans la préversion du Kit de développement logiciel (SDK) d’application Windows 2.0. Les exemples ci-dessus utilisent l’ingénierie de l’invite ( prééditation d’une instruction au texte d’entrée) pour obtenir le même résultat. Lorsque l’API Skill est publiée, vous pouvez remplacer la façon dont l’invite est construite par new LanguageModelOptions { Skill = LanguageModelSkill.Summarize }.

Création et exécution de l’exemple

  1. Clonez le référentiel WindowsAppSDK-Samples .
  2. Accédez au dossier Samples/WindowsAIFoundry/cs-maui .
  3. Ouvrez MauiWindowsAISample.sln dans Visual Studio 2022.
  4. Vérifiez que la barre d’outils de débogage a défini « Machine Windows » comme appareil cible.
  5. Appuyez sur F5 ou sélectionnez « Démarrer le débogage » dans le menu Débogage pour exécuter l’exemple (l’exemple peut également être exécuté sans débogage en sélectionnant « Démarrer sans débogage » dans le menu Débogage ou Ctrl+F5).
  6. Cliquez sur l’un des boutons « Mettre à l’échelle » pour mettre à l’échelle l’image, ou entrez une invite de texte, puis cliquez sur le bouton « Générer » pour générer une réponse de texte.

Voir aussi