Bahasa

Tutorial: Membangun aplikasi obrolan dengan Phi Silica dan .NET MAUI

Penting

API Phi Silica adalah bagian dari Fitur Akses Terbatas (lihat kelas LimitedAccessFeatures). Untuk informasi selengkapnya atau untuk meminta token pembuka kunci, silakan gunakan Formulir Permintaan Token Akses LAF.

Tutorial singkat ini menelusuri sampel WINDOWS AI API untuk .NET MAUI.

Nota

Fitur Phi Silica tidak tersedia di Tiongkok.

Prasyarat

  • Copilot+ PC dengan NPU — diperlukan untuk Phi Silica. Lihat panduan pengembang Copilot+ PC.
  • Windows 11 build 26100 atau yang lebih baru (25H2) — periksa dengan winver.
  • Mode Pengembang diaktifkan — Pengaturan Windows → → Sistem Untuk pengembang → Mode Pengembang.
  • Visual Studio 2022 dengan beban kerja pengembangan aplikasi Windows .
  • SDK Aplikasi Windows 2.0.0-preview1 — instal melalui NuGet (Microsoft.WindowsAppSDK versi 2.0.0-preview1).

Selesaikan langkah-langkah khusus platform untuk .NET MAUI yang dijelaskan dalam Mulai membangun aplikasi dengan WINDOWS AI API.

Pendahuluan

Sampel ini menunjukkan cara menggunakan berbagai API AI Windows, termasuk LanguageModel untuk pembuatan teks dan ImageScaler untuk penskalaan dan penajaman gambar.

Sampel mencakup empat file berikut:

  1. MauiWindowsAISample.csproj: Menambahkan referensi paket SDK Aplikasi Windows yang diperlukan untuk API AI Windows dan menetapkan TargetFramework yang diperlukan untuk Windows.
  2. Platform/Windows/MainPage.cs: Menerapkan metode parsial dari kelas MainPage bersama yang menampilkan dan menangani fungsionalitas pembuatan teks dan penskalaan gambar.
  3. MainPage.xaml: Menentukan kontrol untuk menampilkan pembuatan teks dan penskalaan gambar.
  4. MainPage.xaml.cs: Menentukan metode parsial yang MainPage.cs terapkan.

Dalam file kedua yang tercantum di atas, Anda akan menemukan fungsi berikut, yang menunjukkan fungsionalitas ringkasan teks.

  1. Buat instans LanguageModel (languageModel).
  2. Buat perintah ringkasan dengan menambahkan instruksi sebelumnya ke teks input.
  3. Teruskan perintah ke metode GenerateResponseAsync dan cetak hasilnya.
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;

Nota

Enum LanguageModelSkill (Summarize, Rewrite) tidak tersedia di pratinjau SDK Aplikasi Windows 2.0. Contoh di atas menggunakan rekayasa permintaan — menambahkan instruksi pada teks masukan — untuk mencapai hasil yang sama. Saat Skill API dirilis, Anda dapat mengganti konstruksi prompt dengan new LanguageModelOptions { Skill = LanguageModelSkill.Summarize }.

Bangun dan jalankan sampel

  1. Kloning repositori WindowsAppSDK-Samples dan lihat cabang.release/experimental
  2. Navigasikan ke folder Samples/WindowsAIFoundry/cs-maui .
  3. Buka MauiWindowsAISample.sln di Visual Studio 2022.
  4. Pastikan toolbar debug memiliki "Windows Machine" yang ditetapkan sebagai perangkat target.
  5. Tekan F5 atau pilih "Mulai Penelusuran Kesalahan" dari menu Debug untuk menjalankan contoh uji coba (contoh uji coba juga dapat dijalankan tanpa penelusuran kesalahan dengan memilih "Mulai Tanpa Penelusuran Kesalahan" dari menu Debug atau Ctrl+F5).
  6. Klik salah satu tombol "Skala" untuk menskalakan gambar, atau masukkan perintah teks dan klik tombol "Hasilkan" untuk menghasilkan respons teks.

Lihat juga