RoutingChatClient Classe

Definição

Espaço de Nomes:

Microsoft.Extensions.AI

Assemblagem:

Microsoft.Extensions.AI.Abstractions.dll

Pacote:

Microsoft.Extensions.AI.Abstractions v10.9.0

Origem:

RoutingChatClient.cs

Fornece um modelo que IChatClient seleciona e invoca outro cliente de 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

Herança

Object

RoutingChatClient

Derivado

Microsoft.Extensions.AI.FailoverChatClient

Microsoft.Extensions.AI.SemanticRoutingChatClient

Atributos

ExperimentalAttribute

Implementações

IChatClient IDisposable

Observações

As classes derivadas são implementadas SelectClientAsync(RoutingContext, CancellationToken) para fornecer um cliente para cada pedido. O cliente selecionado é invocado uma vez, e a sua resposta ou falha é propagada ao chamador. A instância exata do cliente representa a identidade de encaminhamento selecionada. As opções fornecidas pelo chamador podem variar consoante a invocação, mas são efémeras e não participam nessa identidade. As aplicações podem usar wrappers de cliente configurados distintos quando as configurações requerem identidades de encaminhamento distintas, enquanto as políticas personalizadas podem manter chaves de agrupamento específicas de cada aplicação.

ChatOptions detém as opções para o pedido e é o que o cliente selecionado recebe. As opções que pertencem a uma determinada rota são configuradas no cliente, normalmente com um ConfigureOptionsChatClient wrapper, que clona as opções de pedido e aplica os próprios valores da rota por cima delas.

Construtores

Name	Descrição
RoutingChatClient()	Fornece um modelo que IChatClient seleciona e invoca outro cliente de chat.

Métodos

Name	Descrição
Create(Func<RoutingContext,CancellationToken,ValueTask<IChatClient>>)	Cria um cliente de roteamento que seleciona um cliente para cada pedido.
Dispose()	Realiza tarefas definidas pela aplicação associadas à libertação, libertação ou reinício de recursos não geridos.
Dispose(Boolean)	Fornece um mecanismo para libertar recursos pertencentes à instância derivada.
GetResponseAsync(IEnumerable<ChatMessage>, ChatOptions, CancellationToken)	Envia mensagens no chat e responde.
GetService(Type, Object)	Pergunta a IChatClient um objeto do tipo serviceTypeespecificado .
GetStreamingResponseAsync(IEnumerable<ChatMessage>, ChatOptions, CancellationToken)	Envia mensagens no chat e transmite a resposta em streaming.
SelectClientAsync(RoutingContext, CancellationToken)	Seleciona o cliente a invocar para o pedido.

Métodos da Extensão

Name	Descrição
AsBuilder(IChatClient)	Cria um novo ChatClientBuilder uso innerClient como seu cliente interno.
GetRequiredService(IChatClient, Type, Object)	Pede IChatClient um objeto do tipo serviceType especificado e lança uma exceção caso não esteja disponível.
GetRequiredService<TService>(IChatClient, Object)	Pede um IChatClient objeto do tipo TService e lança uma exceção se não estiver disponível.
GetResponseAsync(IChatClient, ChatMessage, ChatOptions, CancellationToken)	Envia uma mensagem por chat e responde às respostas.
GetResponseAsync(IChatClient, String, ChatOptions, CancellationToken)	Envia uma mensagem de texto por chat de utilizador e responde às respostas.
GetResponseAsync<T>(IChatClient, ChatMessage, ChatOptions, Nullable<Boolean>, CancellationToken)	Envia uma mensagem por chat, pedindo uma resposta correspondente ao tipo T.
GetResponseAsync<T>(IChatClient, ChatMessage, JsonSerializerOptions, ChatOptions, Nullable<Boolean>, CancellationToken)	Envia uma mensagem por chat, pedindo uma resposta correspondente ao tipo T.
GetResponseAsync<T>(IChatClient, IEnumerable<ChatMessage>, ChatOptions, Nullable<Boolean>, CancellationToken)	Envia mensagens por chat, pedindo uma resposta correspondente ao tipo T.
GetResponseAsync<T>(IChatClient, IEnumerable<ChatMessage>, JsonSerializerOptions, ChatOptions, Nullable<Boolean>, CancellationToken)	Envia mensagens por chat, pedindo uma resposta correspondente ao tipo T.
GetResponseAsync<T>(IChatClient, String, ChatOptions, Nullable<Boolean>, CancellationToken)	Envia uma mensagem de texto por chat de utilizador, solicitando uma resposta correspondente ao tipo T.
GetResponseAsync<T>(IChatClient, String, JsonSerializerOptions, ChatOptions, Nullable<Boolean>, CancellationToken)	Envia uma mensagem de texto por chat de utilizador, solicitando uma resposta correspondente ao tipo T.
GetService<TService>(IChatClient, Object)	Pede a IChatClient um objeto do tipo TService.
GetStreamingResponseAsync(IChatClient, ChatMessage, ChatOptions, CancellationToken)	Envia uma mensagem por chat e transmite as respostas.
GetStreamingResponseAsync(IChatClient, String, ChatOptions, CancellationToken)	Envia uma mensagem de texto por chat de utilizador e transmite as mensagens de resposta.