Bitzsoft.Integrations.AgentFramework 1.0.0-alpha.2

Bitzsoft.Integrations.AgentFramework

AI Agent 框架 -- 基于 Semantic Kernel 的智能对话代理，提供开箱即用的聊天、流式输出和多轮对话能力。

功能特性

• 基于 Microsoft Semantic Kernel 构建，兼容 OpenAI API 端点
• 单轮对话与流式响应（IAsyncEnumerable<string>）
• 多轮对话支持，内置 ChatHistory 管理
• 可自定义系统提示词，内置法律助手、通用助手、文档分析等预设角色
• 依赖注入友好，一行代码完成服务注册
• 支持 Options 模式，可通过 appsettings.json 或代码配置

安装

dotnet add package Bitzsoft.Integrations.AgentFramework

或直接在项目文件中添加：

<PackageReference Include="Bitzsoft.Integrations.AgentFramework" Version="*" />

配置

在 appsettings.json 中添加以下配置节：

{
  "AgentOptions": {
    "Enabled": true,
    "Endpoint": "https://api.openai.com/v1",
    "ApiKey": "sk-your-api-key",
    "DefaultModel": "gpt-4",
    "DefaultSystemPrompt": "你是一个有帮助的 AI 助手。"
  }
}

注册服务

在 Program.cs 中注册 Agent 服务：

using Bitzsoft.Integrations.AgentFramework.Dto;
using Microsoft.Extensions.DependencyInjection;

var builder = WebApplication.CreateBuilder(args);

// 方式一：从 appsettings.json 绑定配置
builder.Services.AddAIAgent(options =>
    builder.Configuration.GetSection("AgentOptions").Bind(options));

// 方式二：代码内直接配置
builder.Services.AddAIAgent(options =>
{
    options.Enabled = true;
    options.Endpoint = "https://api.openai.com/v1";
    options.ApiKey = "sk-your-api-key";
    options.DefaultModel = "gpt-4";
});

使用示例

单轮对话

using Bitzsoft.Integrations.AgentFramework.Const;
using Bitzsoft.Integrations.AgentFramework.Interfaces;

public class LegalConsultationService
{
    private readonly IAgentService _agent;

    public LegalConsultationService(IAgentService agent)
    {
        _agent = agent;
    }

    public async Task<string> AskLegalQuestionAsync(string question, CancellationToken ct = default)
    {
        // 使用内置法律助手提示词
        var answer = await _agent.SendMessageAsync(
            message: question,
            systemPrompt: SystemPrompts.LegalAssistant,
            cancellationToken: ct);

        return answer;
    }
}

流式响应

using System.Runtime.CompilerServices;
using Bitzsoft.Integrations.AgentFramework.Const;
using Bitzsoft.Integrations.AgentFramework.Interfaces;

public class ChatStreamingService
{
    private readonly IAgentService _agent;

    public ChatStreamingService(IAgentService agent)
    {
        _agent = agent;
    }

    public async IAsyncEnumerable<string> StreamChatAsync(
        string userMessage,
        [EnumeratorCancellation] CancellationToken ct = default)
    {
        await foreach (var chunk in _agent.SendMessageStreamAsync(
            message: userMessage,
            systemPrompt: SystemPrompts.DocumentAnalyzer,
            cancellationToken: ct))
        {
            yield return chunk;
        }
    }
}

多轮对话（带历史记录）

using Bitzsoft.Integrations.AgentFramework.Const;
using Bitzsoft.Integrations.AgentFramework.Interfaces;

public class ConversationService
{
    private readonly IAgentService _agent;

    public ConversationService(IAgentService agent)
    {
        _agent = agent;
    }

    public async Task RunMultiTurnAsync(CancellationToken ct = default)
    {
        // 创建会话历史，指定系统提示词
        var history = _agent.CreateChatHistory(SystemPrompts.GeneralAssistant);

        // 第一轮
        var reply1 = await _agent.ChatWithHistoryAsync(history, "请介绍一下劳动合同法的基本原则", ct);
        Console.WriteLine($"助手: {reply1}");

        // 第二轮 -- 历史记录自动累积，模型可以理解上下文
        var reply2 = await _agent.ChatWithHistoryAsync(history, "那试用期最长是多少个月？", ct);
        Console.WriteLine($"助手: {reply2}");
    }
}

内置系统提示词

Bitzsoft.Integrations.AgentFramework.Const.SystemPrompts 提供了以下预设角色：

相关包

• Bitzsoft.Integrations.SemanticKernel -- Semantic Kernel 基础集成
• Bitzsoft.Integrations.RAG -- 检索增强生成（RAG）集成
• Bitzsoft.Integrations.Ocr -- OCR 文字识别集成
• Bitzsoft.Integrations.McpServer -- MCP 服务端集成，可将 Agent 工具暴露为 MCP 协议端点
• Bitzsoft.Integrations.All -- 所有集成包的统一引用