Dify CSharp SDK

安装

Install-Package DifyAI

注册

services
    .AddDifyAI(x =>
    {
        x.BaseDomain = "http://127.0.0.1/v1";
        x.DefaultApiKey = "app-xxxxxxxxxxxxxxxx";
    });

使用

private readonly IDifyAIService _difyAIService;

聊天助手、Agent 应用消息、工作流编排对话型应用

// 阻塞模式
var rsp = await _difyAIService.ChatMessages.ChatAsync(req);

// 流式模式
await foreach (var rsp in _difyAIService.ChatMessages.ChatStreamAsync(req))
{
}

// 停止响应
await _difyAIService.ChatMessages.StopChatAsync(req);

流式模式下，可以根据 rsp.Event 来确定响应类型

Event	Type
message	ChunkCompletionMessageResponse
message_replace	ChunkCompletionMessageReplaceResponse
message_file	ChunkCompletionMessageFileResponse
message_end	ChunkCompletionMessageEndResponse
workflow_started	ChunkCompletionWorkflowStartedResponse
workflow_finished	ChunkCompletionWorkflowFinishedResponse
node_started	ChunkCompletionNodeStartedResponse
node_finished	ChunkCompletionNodeFinishedResponse
agent_message	ChunkCompletionAgentMessageResponse
agent_thought	ChunkCompletionAgentThoughtResponse
error	ChunkCompletionErrorResponse

工作流应用消息

// 阻塞模式
var rsp = await _difyAIService.Workflows.WorkflowAsync(req);

// 流式模式
await foreach (var rsp in _difyAIService.Workflows.WorkflowStreamAsync(req))
{
}

// 停止响应
await _difyAIService.Workflows.StopWorkflowAsync(req);

文本生成应用消息

// 阻塞模式
var req = new CompletionRequest
{
    ApiKey = "app-vvEU80qX2dGBbjKTQJTqr0HW",
    User = "user123",
    Inputs =
    {
        // 必填
        ["query"] = "hello!"
    }
};
var rsp = await _difyAIService.CompletionMessages.CompletionAsync(req);

// 流式模式
await foreach (var rsp in _difyAIService.CompletionMessages.CompletionStreamAsync(req))
{
}

// 停止响应
await _difyAIService.CompletionMessages.StopCompletionAsync(req);

文件

// 上传文件
await _difyAIService.Files.UploadAsync(req);

语音

// 语音转文字
await _difyAIService.Audios.AudioToTextAsync(req);

// 文字转语音
await _difyAIService.Audios.TextToAudioAsync(req);

会话

// 获取会话列表
await _difyAIService.Conversations.ListAsync(req);

// 会话重命名
await _difyAIService.Conversations.RenameAsync(req);

// 删除会话
await _difyAIService.Conversations.DeleteAsync(req);

消息

// 获取会话历史消息
await _difyAIService.Messages.HistoryAsync(req);

// 消息反馈（点赞）
await _difyAIService.Messages.FeedbackAsync(req);

// 获取下一轮建议问题列表
await _difyAIService.Messages.SuggestedAsync(req);

应用

// 获取应用配置信息
await _difyAIService.Applications.ParametersAsync(req);

// 获取应用Meta信息
await _difyAIService.Applications.MetaAsync(req);

知识库

await _difyAIService.Datasets...;

贡献者