RoutingChatClient Classe

Definizione

Spazio dei nomi:

Microsoft.Extensions.AI

Assembly:

Microsoft.Extensions.AI.Abstractions.dll

Pacchetto:

Microsoft.Extensions.AI.Abstractions v10.9.0

Origine:

RoutingChatClient.cs

Fornisce un modello per un oggetto IChatClient che seleziona e richiama un altro client di chat.

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

Ereditarietà

Object

RoutingChatClient

Derivato

Microsoft.Extensions.AI.FailoverChatClient

Microsoft.Extensions.AI.SemanticRoutingChatClient

Attributi

ExperimentalAttribute

Implementazioni

IChatClient IDisposable

Commenti

Le classi derivate implementano SelectClientAsync(RoutingContext, CancellationToken) per fornire un client per ogni richiesta. Il client selezionato viene richiamato una volta e la risposta o l'errore viene propagato al chiamante. L'istanza client esatta rappresenta l'identità di routing selezionata. Le opzioni fornite dal chiamante possono variare per ogni chiamata, ma sono temporanee e non partecipano a tale identità. Le applicazioni possono usare wrapper client configurati distinti quando le configurazioni richiedono identità di routing distinte, mentre i criteri personalizzati possono mantenere chiavi di raggruppamento specifiche dell'applicazione separate.

ChatOptions contiene le opzioni per la richiesta ed è ciò che riceve il client selezionato. Le opzioni che appartengono a una route specifica vengono invece configurate nel client, in genere con un ConfigureOptionsChatClient wrapper, che clona le opzioni di richiesta e applica i propri valori della route.

Costruttori

Nome	Descrizione
RoutingChatClient()	Fornisce un modello per un oggetto IChatClient che seleziona e richiama un altro client di chat.

Metodi

Nome	Descrizione
Create(Func<RoutingContext,CancellationToken,ValueTask<IChatClient>>)	Crea un client di routing che seleziona un client per ogni richiesta.
Dispose()	Esegue attività definite dall'applicazione associate alla liberazione, al rilascio o alla reimpostazione di risorse non gestite.
Dispose(Boolean)	Fornisce un meccanismo per il rilascio di risorse di proprietà dell'istanza derivata.
GetResponseAsync(IEnumerable<ChatMessage>, ChatOptions, CancellationToken)	Invia messaggi di chat e restituisce la risposta.
GetService(Type, Object)	Richiede un IChatClient oggetto del tipo serviceTypespecificato.
GetStreamingResponseAsync(IEnumerable<ChatMessage>, ChatOptions, CancellationToken)	Invia messaggi di chat e trasmette la risposta.
SelectClientAsync(RoutingContext, CancellationToken)	Seleziona il client da richiamare per la richiesta.

Metodi di estensione

Nome	Descrizione
AsBuilder(IChatClient)	Crea un nuovo ChatClientBuilder oggetto utilizzando innerClient come client interno.
GetRequiredService(IChatClient, Type, Object)	Chiede l'oggetto IChatClient per un oggetto del tipo serviceType specificato e genera un'eccezione se non ne è disponibile uno.
GetRequiredService<TService>(IChatClient, Object)	Chiede l'oggetto IChatClient per un oggetto di tipo TService e genera un'eccezione se non ne è disponibile uno.
GetResponseAsync(IChatClient, ChatMessage, ChatOptions, CancellationToken)	Invia un messaggio di chat e restituisce i messaggi di risposta.
GetResponseAsync(IChatClient, String, ChatOptions, CancellationToken)	Invia un SMS di chat utente e restituisce i messaggi di risposta.
GetResponseAsync<T>(IChatClient, ChatMessage, ChatOptions, Nullable<Boolean>, CancellationToken)	Invia un messaggio di chat, richiedendo una risposta corrispondente al tipo T.
GetResponseAsync<T>(IChatClient, ChatMessage, JsonSerializerOptions, ChatOptions, Nullable<Boolean>, CancellationToken)	Invia un messaggio di chat, richiedendo una risposta corrispondente al tipo T.
GetResponseAsync<T>(IChatClient, IEnumerable<ChatMessage>, ChatOptions, Nullable<Boolean>, CancellationToken)	Invia messaggi di chat, richiedendo una risposta corrispondente al tipo T.
GetResponseAsync<T>(IChatClient, IEnumerable<ChatMessage>, JsonSerializerOptions, ChatOptions, Nullable<Boolean>, CancellationToken)	Invia messaggi di chat, richiedendo una risposta corrispondente al tipo T.
GetResponseAsync<T>(IChatClient, String, ChatOptions, Nullable<Boolean>, CancellationToken)	Invia un SMS di chat utente, richiedendo una risposta corrispondente al tipo T.
GetResponseAsync<T>(IChatClient, String, JsonSerializerOptions, ChatOptions, Nullable<Boolean>, CancellationToken)	Invia un SMS di chat utente, richiedendo una risposta corrispondente al tipo T.
GetService<TService>(IChatClient, Object)	Chiede all'oggetto IChatClient di tipo TService.
GetStreamingResponseAsync(IChatClient, ChatMessage, ChatOptions, CancellationToken)	Invia un messaggio di chat e trasmette i messaggi di risposta.
GetStreamingResponseAsync(IChatClient, String, ChatOptions, CancellationToken)	Invia un SMS di chat utente e trasmette i messaggi di risposta.