Bagikan melalui


API ref untuk API Phi Silica di SDK Aplikasi Windows

Pelajari tentang API Phi Silica Kecerdasan Buatan (AI) baru yang akan dikirim dengan SDK Aplikasi Windows dan dapat digunakan untuk mengakses model bahasa pada perangkat (termasuk Phi Silica, model bahasa lokal kami yang paling kuat yang disetel NPU) untuk pemrosesan lokal dan pembuatan obrolan, pemecahan matematika, pembuatan kode, penalaran teks, dan banyak lagi.

Untuk detail selengkapnya, lihat Phi Silica di SDK Aplikasi Windows.

Penting

Saluran eksperimental SDK Aplikasi Windows mencakup API dan fitur pada tahap awal pengembangan. Semua API di saluran eksperimental tunduk pada revisi yang luas dan melanggar perubahan dan dapat dihapus dari rilis berikutnya kapan saja. Mereka tidak didukung untuk digunakan di lingkungan produksi, dan aplikasi yang menggunakan fitur eksperimental tidak dapat diterbitkan ke Microsoft Store.


Namespace Microsoft.Windows.AI.Generative

Menyediakan API untuk pemrosesan dan respons permintaan AI generatif lokal di perangkat.

Kelas Microsoft.Windows.AI.Generative.LanguageModel

public sealed class LanguageModel : System.IDisposable

Mewakili objek yang dapat berinteraksi dengan model bahasa lokal untuk menghasilkan respons untuk permintaan yang disediakan.

Metode Microsoft.Windows.AI.Generative.LanguageModel.Close

Membuang objek dan sumber daya terkait.

Keterangan

Tidak diimplementasikan dalam C#.

Metode Microsoft.Windows.AI.Generative.LanguageModel.CreateAsync

public static Windows.Foundation.IAsyncOperation<Microsoft.Windows.AI.Generative.LanguageModel> CreateAsync ();

Secara asinkron membuat instans baru kelas LanguageModel.

Mengembalikan

Instans baru kelas TextRecognizer.

Metode Microsoft.Windows.AI.Generative.LanguageModel.GenerateResponseAsync(System.String)

public Windows.Foundation.IAsyncOperation<Microsoft.Windows.AI.Generative.LanguageModelResponse> GenerateResponseAsync (string prompt);

Menghasilkan dan mengembalikan respons lengkap untuk satu perintah.

Parameter
perintah

Permintaan dalam bentuk pertanyaan.

Mengembalikan

String dan status respons.

Pengecualian

ArgumentException: Perintah yang ditentukan lebih panjang dari jumlah maksimum token yang dapat diterima model.

Metode Microsoft.Windows.AI.Generative.LanguageModel.GenerateResponseWithProgressAsync(System.String)

public Windows.Foundation.IAsyncOperationWithProgress<Microsoft.Windows.AI.Generative.LanguageModelResponse, 
string> GenerateResponseWithProgressAsync (string prompt);

Menghasilkan dan mengalirkan respons melalui handler kemajuan. Hasil parsial dapat diambil saat pembuatan sedang berlangsung.

Parameter
perintah

Perintah untuk respons.

Mengembalikan

String dan status respons.

Token berikutnya dari string yang ditambahkan ke respons penuh saat model mengembalikannya, ini adalah delta dari languageModelReponse sebelumnya yang ditetapkan sebagai hasil OnProgress.

Pengecualian

ArgumentException: Perintah yang ditentukan lebih panjang dari jumlah maksimum token yang dapat diterima model.

Keterangan

Peristiwa OnProgress terjadi pada pembuatan setiap kata tunggal dalam respons.

Metode Microsoft.Windows.AI.Generative.LanguageModel.IsAvailable

public static bool IsAvailable ();

Mengambil apakah Model AI yang diperlukan tersedia.

Mengembalikan

Benar, jika Model AI yang diperlukan tersedia. Jika tidak, salah.

Metode Microsoft.Windows.AI.Generative.LanguageModel.MakeAvailableAsync

public static Windows.Foundation.IAsyncOperationWithProgress<Microsoft.Windows.Management.Deployment.PackageDeploymentResult, 
Microsoft.Windows.Management.Deployment.PackageDeploymentProgress> MakeAvailableAsync ();

Memastikan model bahasa yang mendasar diinstal dan tersedia untuk digunakan.

Mengembalikan

Tindakan asinkron dengan kemajuan yang mengembalikan PackageDeploymentResult setelah selesai.

Kelas Microsoft.Windows.AI.Generative.LanguageModelResponse

public sealed class LanguageModelResponse

Mewakili string respons dan status.

Properti Microsoft.Windows.AI.Generative.LanguageModelResponse.Response

public string Response { get; }

Mendapatkan string respons yang dikembalikan oleh model bahasa berdasarkan perintah yang disediakan.

Nilai properti

String respons yang dikembalikan oleh model bahasa berdasarkan perintah yang disediakan.

Properti Microsoft.Windows.AI.Generative.LanguageModelResponse.Status

public Microsoft.Windows.AI.Generative.LanguageModelResponseStatus Status { get; }

Mendapatkan status respons berdasarkan perintah yang disediakan.

Nilai properti

String respons yang dikembalikan oleh model bahasa berdasarkan perintah yang disediakan.

Keterangan

Nilai apa pun selain Succeeded atau InProgress dianggap gagal.

Enum Microsoft.Windows.AI.Generative.LanguageModelResponseStatus

public enum LanguageModelResponseStatus

Menentukan kemungkinan nilai status respons untuk perintah yang disediakan.

Bidang Enum

Selesai: 0

Respons selesai.

InProgress: 1

Respons sedang berlangsung.

BlockedByPolicy: 2

Respons diblokir oleh pengaturan kebijakan.