Partager via


Référence d’API pour Phi Silicon dans le Kit de développement logiciel (SDK) d’application Windows

Important

Cette fonctionnalité n’est pas encore disponible. Il devrait être fourni dans une prochaine version de canal expérimental du Kit de développement logiciel (SDK) d’application Windows.

Le canal expérimental du SDK d’application Windows comprend des API et des fonctionnalités qui en sont aux premières phases de développement. Toutes les API du canal expérimental font l’objet de révisions approfondies et de changements cassants et peuvent être supprimées des versions ultérieures à tout moment. Elles ne sont pas prises en charge dans les environnements de production et les applications qui utilisent des fonctionnalités expérimentales ne peuvent pas être publiées dans Microsoft Store.

Découvrez les API du KIT de développement logiciel (SDK) d’application Windows qui peuvent accéder aux modèles de langage local tels que Phi Silicon, le modèle de langage local le plus puissant de Microsoft qui permet le traitement et la génération de conversation sur l’appareil, le raisonnement sur le texte, la résolution mathématique, la génération de code, etc.

Pour plus d’informations, consultez Prise en main de Phi Silicon dans le Kit de développement logiciel (SDK) d’application Windows.

Conseil

Fournissez des commentaires sur ces API et leurs fonctionnalités en créant un nouveau problème dans le dépôt GitHub du SDK d’application Windows. (Assurez-vous d’inclure Phi Silicon dans le titre !)


Espace de noms Microsoft.Windows.AI.Generative

Fournit des API pour le traitement et les réponses locales des invites d’IA génératives sur l’appareil.

Classe Microsoft.Windows.AI.Generative.ImageDescriptionGenerator

public sealed class ImageDescriptionGenerator : System.IDisposable

Méthode Microsoft.Windows.AI.Generative.ImageDescriptionGenerator.Close

// This member is not implemented in C#

Méthode Microsoft.Windows.AI.Generative.ImageDescriptionGenerator.CreateAsync

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

Méthode Microsoft.Windows.AI.Generative.ImageDescriptionGenerator.DescribeAsync(Microsoft.Windows.Imaging.ImageBuffer)

public Windows.Foundation.IAsyncOperationWithProgress<Microsoft.Windows.AI.Generative.LanguageModelResponse,string> DescribeAsync (Microsoft.Windows.Imaging.ImageBuffer image);

Méthode Microsoft.Windows.AI.Generative.ImageDescriptionGenerator.IsAvailable

public static bool IsAvailable ();

Méthode Microsoft.Windows.AI.Generative.ImageDescriptionGenerator.MakeAvailableAsync

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

Classe Microsoft.Windows.AI.Generative.LanguageModel

public sealed class LanguageModel : System.IDisposable

Représente un objet qui peut interagir avec un modèle de langage local pour générer des réponses à une invite fournie.

Méthode Microsoft.Windows.AI.Generative.LanguageModel.Close

Supprime l’objet et les ressources associées.

Notes

Non implémenté dans C#.

Méthode Microsoft.Windows.AI.Generative.LanguageModel.CreateAsync

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

Crée de manière asynchrone une nouvelle instance de la classe LanguageModel.

Retours

Une nouvelle instance de la classe TextRecognizer.

Méthode Microsoft.Windows.AI.Generative.LanguageModel.GenerateEmbeddingVector(System.String)

public System.Collections.Generic.IReadOnlyList<Microsoft.Windows.SemanticSearch.EmbeddingVector> GenerateEmbeddingVector (string prompt);

Méthode Microsoft.Windows.AI.Generative.LanguageModel.GenerateEmbeddingVectorAsync(System.String)

public Windows.Foundation.IAsyncOperation<System.Collections.Generic.IReadOnlyList<Microsoft.Windows.SemanticSearch.EmbeddingVector>> GenerateEmbeddingVectorAsync (string prompt);

Méthode Microsoft.Windows.AI.Generative.LanguageModel.GenerateResponseAsync(System.String)

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

Génère et renvoie une réponse complète pour une seule invite.

Paramètres
prompt

Une invite sous forme de question.

Retours

Une chaîne de réponse et un statut.

Exceptions

ArgumentException : l’invite spécifiée est plus longue que le nombre maximum de jetons que le modèle peut accepter.

Méthode Microsoft.Windows.AI.Generative.LanguageModel.GenerateResponseAsync(Microsoft.Windows.AI.Generative.LanguageModelOptions,System.String)

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

Méthode Microsoft.Windows.AI.Generative.LanguageModel.GenerateResponseFromEmbeddingsWithProgressAsync(Windows.Foundation.Collections.IVectorView{Microsoft.Windows.SemanticSearch.EmbeddingVector})

public Windows.Foundation.IAsyncOperationWithProgress<Microsoft.Windows.AI.Generative.LanguageModelResponse,string> GenerateResponseFromEmbeddingsWithProgressAsync (System.Collections.Generic.IReadOnlyList<Microsoft.Windows.SemanticSearch.EmbeddingVector> promptEmbedding);

Méthode Microsoft.Windows.AI.Generative.LanguageModel.GenerateResponseFromEmbeddingsWithProgressAsync(Microsoft.Windows.AI.Generative.LanguageModelOptions,Windows.Foundation.Collections.IVectorView{Microsoft.Windows.SemanticSearch.EmbeddingVector})

public Windows.Foundation.IAsyncOperationWithProgress<Microsoft.Windows.AI.Generative.LanguageModelResponse,string> GenerateResponseFromEmbeddingsWithProgressAsync (Microsoft.Windows.AI.Generative.LanguageModelOptions options, System.Collections.Generic.IReadOnlyList<Microsoft.Windows.SemanticSearch.EmbeddingVector> promptEmbedding);

Méthode Microsoft.Windows.AI.Generative.LanguageModel.GenerateResponseWithProgressAsync(System.String)

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

Génère et transmet une réponse par l’intermédiaire d’un gestionnaire de progression. Des résultats partiels peuvent être récupérés pendant que la génération est en cours.

Paramètres
prompt

L’invite de la réponse.

Retours

Une chaîne de réponse et un statut.

Le prochain élément de la chaîne de caractères qui est ajouté à la réponse complète au fur et à mesure que le modèle la renvoie. Il s’agit du delta par rapport à la réponse précédente de LanguageModelReponse définie comme le résultat OnProgress.

Exceptions

ArgumentException : l’invite spécifiée est plus longue que le nombre maximum de jetons que le modèle peut accepter.

Notes

Les événements OnProgress se produisent lors de la génération de chaque mot de la réponse.

Méthode Microsoft.Windows.AI.Generative.LanguageModel.IsAvailable

public static bool IsAvailable ();

Permet de savoir si le modèle IA requis est disponible.

Retours

True, si le modèle IA requis est disponible. Dans le cas contraire, la valeur est false.

Méthode Microsoft.Windows.AI.Generative.LanguageModel.IsPromptLargerThanContext(System.String)

public bool IsPromptLargerThanContext (string prompt);

Méthode Microsoft.Windows.AI.Generative.LanguageModel.MakeAvailableAsync

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

Garantit que le modèle de langage sous-jacent est installé et disponible pour être utilisé.

Retours

Une action asynchrone avec progression qui renvoie un PackageDeploymentResult à la fin.

Classe Microsoft.Windows.AI.Generative.LanguageModelOptions

public sealed class LanguageModelOptions

Constructeur Microsoft.Windows.AI.Generative.LanguageModelOptions.#ctor

public LanguageModelOptions ();

Constructeur Microsoft.Windows.AI.Generative.LanguageModelOptions.#ctor(Microsoft.Windows.AI.Generative.LanguageModelSkill,System.Single,System.UInt32)

public LanguageModelOptions (Microsoft.Windows.AI.Generative.LanguageModelSkill skill, float temp, float top_p, uint top_k);

Propriété Microsoft.Windows.AI.Generative.LanguageModelOptions.Skill

public Microsoft.Windows.AI.Generative.LanguageModelSkill Skill { get; set; }

Propriété Microsoft.Windows.AI.Generative.LanguageModelOptions.Temp

public float Temp { get; set; }

propriété Microsoft.Windows.AI.Generative.LanguageModelOptions.Top_k

public uint Top_k { get; set; }

propriété Microsoft.Windows.AI.Generative.LanguageModelOptions.Top_p

public float Top_p { get; set; }

Classe Microsoft.Windows.AI.Generative.LanguageModelResponse

public sealed class LanguageModelResponse

Représente une chaîne de réponse et un statut.

Propriété Microsoft.Windows.AI.Generative.LanguageModelResponse.Response

public string Response { get; }

Obtient la chaîne de réponse renvoyée par le modèle de langage en fonction de l’invite fournie.

Valeur de la propriété

La chaîne de réponse renvoyée par le modèle de langage en fonction de l’invite fournie.

Propriété Microsoft.Windows.AI.Generative.LanguageModelResponse.Status

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

Obtient le statut de la réponse en fonction de l’invite fournie.

Valeur de la propriété

La chaîne de réponse renvoyée par le modèle de langage en fonction de l’invite fournie.

Notes

Toute valeur autre que Succeeded ou InProgress est considérée comme un échec.

Enum Microsoft.Windows.AI.Generative.LanguageModelResponseStatus

public enum LanguageModelResponseStatus

Spécifie les valeurs possibles du statut de la réponse pour l’invite fournie.

Champs enum

Terminé : 0

La réponse est terminée.

InProgress : 1

La réponse est en cours.

BlockedByPolicy : 2

La réponse est bloquée par un paramètre de stratégie.

PromptLargerThanContext : 3

Énumération Microsoft.Windows.AI.Generative.LanguageModelSkill

public enum LanguageModelSkill

Champs enum

Général : 0
TextToTable : 1