RoutingChatClient 類別

定義

命名空間:

Microsoft.Extensions.AI

組件:

Microsoft.Extensions.AI.Abstractions.dll

套件:

Microsoft.Extensions.AI.Abstractions v10.9.0

來源:

RoutingChatClient.cs

提供一個範本， IChatClient 用來選擇並呼叫另一個聊天客戶端。

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

繼承

Object

RoutingChatClient

衍生

Microsoft.Extensions.AI.FailoverChatClient

Microsoft.Extensions.AI.SemanticRoutingChatClient

屬性

ExperimentalAttribute

實作

IChatClient IDisposable

備註

衍生類別實作 SelectClientAsync(RoutingContext, CancellationToken) 為每個請求提供一個客戶端。 所選客戶端會被呼叫一次，其回應或失敗會傳達給呼叫者。 精確的用戶端實例代表所選的路由身份。 呼叫者提供的選項可能因呼叫而異，但它們是短暫的，不參與該身份。 當配置需要不同路由身份時，應用程式可以使用不同設定的用戶端包裝器，而自訂政策則可能維持獨立的應用程式專屬群組金鑰。

ChatOptions 包含請求的選項，且是被選中客戶所獲得的。 屬於特定路由的選項則會在用戶端設定，通常使用 ConfigureOptionsChatClient 包裝器，將請求選項克隆，並在其上套用路由自身的值。

建構函式

名稱	Description
RoutingChatClient()	提供一個範本， IChatClient 用來選擇並呼叫另一個聊天客戶端。

方法

名稱	Description
Create(Func<RoutingContext,CancellationToken,ValueTask<IChatClient>>)	建立一個路由客戶端，為每個請求選擇一個客戶端。
Dispose()	執行與釋放、釋放或重設非受控資源相關聯的應用程式定義工作。
Dispose(Boolean)	提供釋放衍生實例擁有資源的機制。
GetResponseAsync(IEnumerable<ChatMessage>, ChatOptions, CancellationToken)	發送聊天訊息並回覆。
GetService(Type, Object)	請求 給 IChatClient 指定類型的 serviceType物件。
GetStreamingResponseAsync(IEnumerable<ChatMessage>, ChatOptions, CancellationToken)	發送聊天訊息並直播回覆。
SelectClientAsync(RoutingContext, CancellationToken)	選擇要呼叫的客戶端。

擴充方法

名稱	Description
AsBuilder(IChatClient)	創造一個新的 ChatClientBuilder 使用 innerClient ，作為其內在客戶。
GetRequiredService(IChatClient, Type, Object)	會要求 需要 IChatClient 指定類型的 serviceType 物件，若無法使用則拋出例外。
GetRequiredService<TService>(IChatClient, Object)	會請求 一個 IChatClient 類型的 TService 物件，若無法使用則拋出例外。
GetResponseAsync(IChatClient, ChatMessage, ChatOptions, CancellationToken)	發送聊天訊息並回覆訊息。
GetResponseAsync(IChatClient, String, ChatOptions, CancellationToken)	發送用戶聊天簡訊並回覆訊息。
GetResponseAsync<T>(IChatClient, ChatMessage, ChatOptions, Nullable<Boolean>, CancellationToken)	發送聊天訊息，請求回應類型為 T。
GetResponseAsync<T>(IChatClient, ChatMessage, JsonSerializerOptions, ChatOptions, Nullable<Boolean>, CancellationToken)	發送聊天訊息，請求回應類型為 T。
GetResponseAsync<T>(IChatClient, IEnumerable<ChatMessage>, ChatOptions, Nullable<Boolean>, CancellationToken)	發送聊天訊息，請求符合 的回應 T類型。
GetResponseAsync<T>(IChatClient, IEnumerable<ChatMessage>, JsonSerializerOptions, ChatOptions, Nullable<Boolean>, CancellationToken)	發送聊天訊息，請求符合 的回應 T類型。
GetResponseAsync<T>(IChatClient, String, ChatOptions, Nullable<Boolean>, CancellationToken)	發送用戶聊天簡訊，請求符合類型 T的回應。
GetResponseAsync<T>(IChatClient, String, JsonSerializerOptions, ChatOptions, Nullable<Boolean>, CancellationToken)	發送用戶聊天簡訊，請求符合類型 T的回應。
GetService<TService>(IChatClient, Object)	請求 一個 IChatClient 類型的 TService物件。
GetStreamingResponseAsync(IChatClient, ChatMessage, ChatOptions, CancellationToken)	發送聊天訊息並串流回覆訊息。
GetStreamingResponseAsync(IChatClient, String, ChatOptions, CancellationToken)	發送用戶聊天簡訊並串流回應訊息。