ConfigureOptionsChatClient Classe

Definição

public ref class ConfigureOptionsChatClient sealed : Microsoft::Extensions::AI::DelegatingChatClient

public sealed class ConfigureOptionsChatClient : Microsoft.Extensions.AI.DelegatingChatClient

type ConfigureOptionsChatClient = class
    inherit DelegatingChatClient

Public NotInheritable Class ConfigureOptionsChatClient
Inherits DelegatingChatClient

Herança

Object

DelegatingChatClient

ConfigureOptionsChatClient

Observações

O callback de configuração é invocado com a instância fornecida ChatOptions pelo chamador. Para sobrepor as opções fornecidas pelo chamador com uma nova instância, o callback pode simplesmente devolver essa nova instância, por _ => new ChatOptions() { MaxTokens = 1000 }exemplo. Para fornecer uma nova instância apenas se a instância fornecida pelo chamador for null, o callback pode devolver condicionalmente uma nova instância, por exemplo options => options ?? new ChatOptions() { MaxTokens = 1000 }. Quaisquer alterações à instância de opções fornecidas pelo chamador persistirão na instância original, pelo que o callback deve ter cuidado para o fazer apenas quando tais mutações forem aceitáveis, como ao clonar a instância original e mutar o clone, por exemplo: options => { var newOptions = options?.Clone() ?? new(); newOptions.MaxTokens = 1000; return newOptions; }

O callback pode devolver null, caso em que uma null opção será passada ao próximo cliente no pipeline.

A implementação fornecida de IChatClient é thread-safe para uso concorrente, desde que o callback de configuração empregado também seja thread-safe para pedidos concorrentes. Se os chamadores utilizarem uma instância de opções partilhadas, deve ter-se cuidado no callback de configuração, pois múltiplas chamadas podem acabar por correr em paralelo com a mesma instância de options.