ConfigureOptionsChatClient Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Rappresenta un client di chat di delega che configura un'istanza ChatOptions usata dal resto della pipeline.
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
- Ereditarietà
Commenti
Il callback di configurazione viene richiamato ChatOptions con l'istanza fornita dal chiamante. Per eseguire l'override delle opzioni fornite dal chiamante con una nuova istanza, il callback può semplicemente restituire tale nuova istanza, ad esempio _ => new ChatOptions() { MaxTokens = 1000 }. Per fornire una nuova istanza solo se l'istanza fornita dal chiamante è null, il callback può restituire in modo condizionale una nuova istanza, ad esempio options => options ?? new ChatOptions() { MaxTokens = 1000 }. Le modifiche apportate all'istanza delle opzioni fornite dal chiamante verranno mantenute nell'istanza originale, pertanto il callback deve prestare attenzione solo quando tali mutazioni sono accettabili, ad esempio clonando l'istanza originale e modificando il clone, ad esempio: options => { var newOptions = options?.Clone() ?? new(); newOptions.MaxTokens = 1000; return newOptions; }
Il callback può restituire null, nel qual caso un'opzione null verrà passata al client successivo nella pipeline.
L'implementazione fornita di IChatClient è thread-safe per l'uso simultaneo, purché il callback di configurazione impiegato sia thread-safe anche per le richieste simultanee. Se i chiamanti usano un'istanza di opzioni condivise, è necessario prestare attenzione al callback di configurazione, perché più chiamate potrebbero finire in esecuzione in parallelo con la stessa istanza di opzioni.
Costruttori
| Nome | Descrizione |
|---|---|
| ConfigureOptionsChatClient(IChatClient, Action<ChatOptions>) |
Inizializza una nuova istanza della ConfigureOptionsChatClient classe con il callback specificato |
Proprietà
| Nome | Descrizione |
|---|---|
| InnerClient |
Ottiene l'oggetto interno IChatClient. (Ereditato da DelegatingChatClient) |
Metodi
| Nome | Descrizione |
|---|---|
| Dispose() |
Esegue attività definite dall'applicazione associate alla liberazione, al rilascio o alla reimpostazione di risorse non gestite. (Ereditato da DelegatingChatClient) |
| Dispose(Boolean) |
Fornisce un meccanismo per il rilascio di risorse non gestite. (Ereditato da DelegatingChatClient) |
| GetResponseAsync(IEnumerable<ChatMessage>, ChatOptions, CancellationToken) |
Rappresenta un client di chat di delega che configura un'istanza ChatOptions usata dal resto della pipeline. |
| GetService(Type, Object) |
Richiede un IChatClient oggetto del tipo |
| GetStreamingResponseAsync(IEnumerable<ChatMessage>, ChatOptions, CancellationToken) |
Rappresenta un client di chat di delega che configura un'istanza ChatOptions usata dal resto della pipeline. |