Freigeben über


API-Referenz für Phi Silica-APIs im Windows App SDK

Erfahren Sie mehr über die neuen Phi Silica-APIs der künstlichen Intelligenz (KI), die zum Lieferumfang des Windows App SDK gehören. Sie ermöglichen den Zugriff auf geräteinterne Sprachmodelle (einschließlich Phi Silica, unserem bisher leistungsstärksten, auf die NPU abgestimmten lokalen Sprachmodell) für die lokale Verarbeitung und Generierung von Chats, das Lösen von mathematischen Aufgaben, die Generierung von Code, das Ziehen von Schlussfolgerungen aus Texten und vieles mehr.

Weitere Informationen finden Sie unter Phi Silica im Windows App SDK.

Wichtig

Der experimentelle Kanal des Windows App SDK enthält APIs und Features in frühen Entwicklungsphasen. Alle APIs im experimentellen Kanal unterliegen umfangreichen Überarbeitungen und Breaking Changes und können jederzeit aus nachfolgenden Versionen entfernt werden. Sie werden nicht für die Verwendung in Produktionsumgebungen unterstützt, und Apps, die experimentelle Features verwenden, können nicht im Microsoft Store veröffentlicht werden.


Microsoft.Windows.AI.Generative Namespace

Stellt APIs für lokale, geräteinterne generative KI-Prompt-Verarbeitung und -Antworten bereit.

Microsoft.Windows.AI.Generative.LanguageModel-Klasse

public sealed class LanguageModel : System.IDisposable

Stellt ein Objekt dar, das mit einem lokalen Sprachmodell interagieren kann, um Antworten für eine bereitgestellte Eingabeaufforderung zu generieren.

Microsoft.Windows.AI.Generative.LanguageModel.Close-Methode

Entfernt das Objekt und die zugeordneten Ressourcen.

Hinweise

In nicht implementiert.

Microsoft.Windows.AI.Generative.LanguageModel.CreateAsync-Methode

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

Erstellt asynchron eine neue Instanz der LanguageModel-Klasse.

Gibt zurück

Eine neue Instanz der TextRecognizer-Klasse.

Microsoft.Windows.AI.Generative.LanguageModel.GenerateResponseAsync(System.String)-Methode

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

Generiert und gibt eine vollständige Antwort für eine einzelne Eingabeaufforderung zurück.

Parameter
prompt

Eine Eingabeaufforderung in Form einer Frage.

Gibt zurück

Eine Antwortzeichenfolge und ein Status.

Ausnahmen

ArgumentException: Die angegebene Eingabeaufforderung ist länger als die maximale Anzahl von Token, die das Modell akzeptieren kann.

Microsoft.Windows.AI.Generative.LanguageModel.GenerateResponseWithProgressAsync(System.String) -Methode

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

Generiert und streamt eine Antwort über einen Statushandler. Partielle Ergebnisse können abgerufen werden, während die Generierung ausgeführt wird.

Parameter
prompt

Die Aufforderung für die Antwort.

Gibt zurück

Eine Antwortzeichenfolge und ein Status.

Das nächste Token der Zeichenkette, die der vollständigen Antwort hinzugefügt wird, wenn das Modell sie zurückgibt. Dies ist das Delta der vorherigen LanguageModelReponse, die als Ergebnis von OnProgress festgelegt wurde.

Ausnahmen

ArgumentException: Die angegebene Eingabeaufforderung ist länger als die maximale Anzahl von Token, die das Modell akzeptieren kann.

Hinweise

OnProgress-Ereignisse treten bei der Generierung jedes einzelnen Worts in der Antwort auf.

Microsoft.Windows.AI.Generative.LanguageModel.IsAvailable-Methode

public static bool IsAvailable ();

Ruft ab, ob das erforderliche KI-Modell verfügbar ist.

Gibt zurück

True, wenn das erforderliche KI-Modell verfügbar ist. Andernfalls lautet der Wert false.

Microsoft.Windows.AI.Generative.LanguageModel.MakeAvailableAsync-Methode

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

Stellt sicher, dass das zugrunde liegende Sprachmodell installiert und zur Verwendung verfügbar ist.

Gibt zurück

Eine asynchrone Aktion mit Fortschritt, die ein PackageDeploymentResult nach Abschluss zurückgibt.

Microsoft.Windows.AI.Generative.LanguageModelResponse-Klasse

public sealed class LanguageModelResponse

Stellt eine Antwortzeichenfolge und einen Status dar.

Microsoft.Windows.AI.Generative.LanguageModelResponse.Response-Eigenschaft

public string Response { get; }

Ruft die Antwortzeichenfolge ab, die vom Sprachmodell basierend auf der bereitgestellten Eingabeaufforderung zurückgegeben wird.

Eigenschaftswert

Die Antwortzeichenfolge, die vom Sprachmodell basierend auf der bereitgestellten Eingabeaufforderung zurückgegeben wird.

Microsoft.Windows.AI.Generative.LanguageModelResponse.Status-Eigenschaft

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

Ruft den Antwortstatus basierend auf der bereitgestellten Eingabeaufforderung ab.

Eigenschaftswert

Die Antwortzeichenfolge, die vom Sprachmodell basierend auf der bereitgestellten Eingabeaufforderung zurückgegeben wird.

Hinweise

Ein anderer Wert als Succeeded oder InProgress gilt als Fehler.

Microsoft.Windows.AI.Generative.LanguageModelResponseStatus-Enumeration

public enum LanguageModelResponseStatus

Gibt die möglichen Antwortstatuswerte für die angegebene Eingabeaufforderung an.

Enumerationsfeld

Abgeschlossen: 0

Die Antwort ist abgeschlossen.

InProgress (In Bearbeitung): 1

Die Antwort wird ausgeführt.

BlockedByPolicy: 2

Die Antwort wird durch eine Richtlinieneinstellung blockiert.