RoutingChatClient Classe

Définition

Espace de noms:

Microsoft.Extensions.AI

Assembly:

Microsoft.Extensions.AI.Abstractions.dll

Paquet:

Microsoft.Extensions.AI.Abstractions v10.9.0

Source:

RoutingChatClient.cs

Fournit un modèle pour un IChatClient qui sélectionne et appelle un autre client de conversation.

public ref class RoutingChatClient abstract : IDisposable, Microsoft::Extensions::AI::IChatClient

[System.Diagnostics.CodeAnalysis.Experimental("MEAI001", UrlFormat="https://aka.ms/dotnet-extensions-warnings/{0}")]
public abstract class RoutingChatClient : IDisposable, Microsoft.Extensions.AI.IChatClient

[<System.Diagnostics.CodeAnalysis.Experimental("MEAI001", UrlFormat="https://aka.ms/dotnet-extensions-warnings/{0}")>]
type RoutingChatClient = class
    interface IChatClient
    interface IDisposable

Public MustInherit Class RoutingChatClient
Implements IChatClient, IDisposable

Héritage

Object

RoutingChatClient

Dérivé

Microsoft.Extensions.AI.FailoverChatClient

Microsoft.Extensions.AI.SemanticRoutingChatClient

Attributs

ExperimentalAttribute

Implémente

IChatClient IDisposable

Remarques

Les classes dérivées implémentent SelectClientAsync(RoutingContext, CancellationToken) pour fournir un client pour chaque requête. Le client sélectionné est appelé une seule fois, et sa réponse ou son échec est propagé à l’appelant. L’instance cliente exacte représente l’identité de routage sélectionnée. Les options fournies par l’appelant peuvent varier par appel, mais elles sont éphémères et ne participent pas à cette identité. Les applications peuvent utiliser des wrappers clients configurés distincts lorsque les configurations nécessitent des identités de routage distinctes, tandis que les stratégies personnalisées peuvent conserver des clés de regroupement distinctes spécifiques à l’application.

ChatOptions contient les options de la demande et correspond à ce que le client sélectionné reçoit. Les options qui appartiennent à un itinéraire particulier sont configurées sur le client à la place, généralement avec un ConfigureOptionsChatClient wrapper, qui clone les options de requête et applique les propres valeurs de l’itinéraire au-dessus de celles-ci.

Constructeurs

Nom	Description
RoutingChatClient()	Fournit un modèle pour un IChatClient qui sélectionne et appelle un autre client de conversation.

Méthodes

Nom	Description
Create(Func<RoutingContext,CancellationToken,ValueTask<IChatClient>>)	Crée un client de routage qui sélectionne un client pour chaque requête.
Dispose()	Effectue des tâches définies par l’application associées à la libération, à la libération ou à la réinitialisation des ressources non managées.
Dispose(Boolean)	Fournit un mécanisme permettant de libérer des ressources appartenant à l’instance dérivée.
GetResponseAsync(IEnumerable<ChatMessage>, ChatOptions, CancellationToken)	Envoie des messages de conversation et retourne la réponse.
GetService(Type, Object)	Demande l’objet IChatClient du type serviceTypespécifié.
GetStreamingResponseAsync(IEnumerable<ChatMessage>, ChatOptions, CancellationToken)	Envoie des messages de conversation et diffuse la réponse.
SelectClientAsync(RoutingContext, CancellationToken)	Sélectionne le client à appeler pour la demande.

Méthodes d’extension

Nom	Description
AsBuilder(IChatClient)	Crée une nouvelle ChatClientBuilder utilisation innerClient en tant que client interne.
GetRequiredService(IChatClient, Type, Object)	Demande l’objet IChatClient du type serviceType spécifié et lève une exception si elle n’est pas disponible.
GetRequiredService<TService>(IChatClient, Object)	Demande l’objet IChatClient de type TService et lève une exception si un objet n’est pas disponible.
GetResponseAsync(IChatClient, ChatMessage, ChatOptions, CancellationToken)	Envoie un message de conversation et retourne les messages de réponse.
GetResponseAsync(IChatClient, String, ChatOptions, CancellationToken)	Envoie un sms de conversation utilisateur et retourne les messages de réponse.
GetResponseAsync<T>(IChatClient, ChatMessage, ChatOptions, Nullable<Boolean>, CancellationToken)	Envoie un message de conversation, en demandant une réponse correspondant au type T.
GetResponseAsync<T>(IChatClient, ChatMessage, JsonSerializerOptions, ChatOptions, Nullable<Boolean>, CancellationToken)	Envoie un message de conversation, en demandant une réponse correspondant au type T.
GetResponseAsync<T>(IChatClient, IEnumerable<ChatMessage>, ChatOptions, Nullable<Boolean>, CancellationToken)	Envoie des messages de conversation, en demandant une réponse correspondant au type T.
GetResponseAsync<T>(IChatClient, IEnumerable<ChatMessage>, JsonSerializerOptions, ChatOptions, Nullable<Boolean>, CancellationToken)	Envoie des messages de conversation, en demandant une réponse correspondant au type T.
GetResponseAsync<T>(IChatClient, String, ChatOptions, Nullable<Boolean>, CancellationToken)	Envoie un sms de conversation utilisateur, demandant une réponse correspondant au type T.
GetResponseAsync<T>(IChatClient, String, JsonSerializerOptions, ChatOptions, Nullable<Boolean>, CancellationToken)	Envoie un sms de conversation utilisateur, demandant une réponse correspondant au type T.
GetService<TService>(IChatClient, Object)	Demande l’objet IChatClient de type TService.
GetStreamingResponseAsync(IChatClient, ChatMessage, ChatOptions, CancellationToken)	Envoie un message de conversation et diffuse les messages de réponse.
GetStreamingResponseAsync(IChatClient, String, ChatOptions, CancellationToken)	Envoie un sms de conversation utilisateur et diffuse les messages de réponse.