Dapr AI 客户端

Mon, 01 Jan 0001 00:00:00 +0000

Dapr AI 客户端包使您能够与 Dapr sidecar 提供的 AI 功能进行交互。

生命周期的管理

DaprConversationClient 是专门用于与 Dapr conversation API 交互的客户端版本。它可以与 DaprClient 和其他 Dapr 客户端一起注册而不会出现问题。

它通过 TCP 套接字与 Dapr sidecar 通信，以便访问网络资源。

为了获得最佳性能，建议创建一个长期存在的 DaprConversationClient 实例，并在整个应用程序中共享使用。DaprConversationClient 实例是线程安全的，适合共享。

这可以通过依赖注入来实现。注册方法支持以单例、作用域实例或瞬态（每次注入时重新创建）的方式进行注册，但也可以利用 IConfiguration 或其他注入服务中的值进行注册，这在每个类中从头创建客户端时是不切实际的。

避免为每个操作都创建一个新的 DaprConversationClient。

通过 DaprConversationClientBuilder 配置 DaprConversationClient

可以通过在 DaprConversationClientBuilder 类上调用方法来配置 DaprConversationClient，然后调用 .Build() 来创建客户端。每个 DaprConversationClient 的设置是独立的，并且在调用 .Build() 后无法更改。

var daprConversationClient = new DaprConversationClientBuilder()
 .UseDaprApiToken("abc123") // 指定用于验证到其他 Dapr sidecar 的 API 令牌
 .Build();

DaprConversationClientBuilder 包含以下设置：

Dapr sidecar 的 HTTP 端点
Dapr sidecar 的 gRPC 端点
用于配置 JSON 序列化的 JsonSerializerOptions 对象
用于配置 gRPC 的 GrpcChannelOptions 对象
用于验证请求到 sidecar 的 API 令牌
用于创建 SDK 使用的 HttpClient 实例的工厂方法
用于在向 sidecar 发出请求时使用的 HttpClient 实例的超时

SDK 将读取以下环境变量来配置默认值：

如何在 .NET SDK 中创建和使用 Dapr AI 会话

Mon, 01 Jan 0001 00:00:00 +0000

前提条件

注意事项

.NET 6 是此版本中 Dapr .NET SDK 包的最低支持版本。仅 .NET 8 和 .NET 9 将在 Dapr v1.16 及更高版本中得到支持。

安装

要开始使用 Dapr AI .NET SDK 客户端，请从 NuGet 安装 Dapr.AI 包：

dotnet add package Dapr.AI

DaprConversationClient 通过 TCP 套接字形式维护对网络资源的访问，用于与 Dapr sidecar 通信。

依赖注入

AddDaprAiConversation() 方法将注册 Dapr 客户端到 ASP.NET Core 的依赖注入中，这是使用此包的推荐方法。此方法接受一个可选的选项委托，用于配置 DaprConversationClient，以及一个 ServiceLifetime 参数，允许您为注册的服务指定不同的生命周期，而不是默认的 Singleton 值。

以下示例假设所有默认值均可接受，并足以注册 DaprConversationClient：

services.AddDaprAiConversation();

可选的配置委托用于通过在 DaprConversationClientBuilder 上指定选项来配置 DaprConversationClient，如下例所示：

Dapr AI .NET SDK on Dapr 文档库