Bitzsoft.Integrations.SemanticKernel 1.1.0

Bitzsoft.Integrations.SemanticKernel

Semantic Kernel 插件兼容编排层仅用于尚待改造的历史项目过渡。它不再创建厂商客户端或持有 API Key，而是复用 Microsoft.Extensions.AI.IChatClient。

迁移至现代 Agent 框架对照表

安装与兼容性

# 新项目推荐：
dotnet add package Bitzsoft.Integrations.AI
dotnet add package Bitzsoft.Integrations.AgentFramework

# 历史过渡期（已标注 Obsolete，将在后续主版本移除）：
dotnet add package Bitzsoft.Integrations.SemanticKernel

• 目标框架：net8.0;net10.0；
• 全部公开成员与 DI 扩展已标记 [Obsolete(..., false)]（编译提示 CS0618，将在后续主版本移除）；
• 不提供 ApiKey、Endpoint、ProviderId 或 ModelId 配置。

迁移最小示例

完整最小示例

以下示例展示脱离 SemanticKernel 兼容层后，直接使用统一 Microsoft.Extensions.AI.IChatClient 与 AIFunctionFactory 完成租户隔离工具调用的最小迁移方式（无 CS0618 过时警告；如需完整会话持久化、技能目录、HITL 审批与循环编排，请进一步接入 Bitzsoft.Integrations.AgentFramework）：

using System.ComponentModel;
using Bitzsoft.Integrations.AI;
using Bitzsoft.Integrations.Core;
using Microsoft.Extensions.AI;
using Microsoft.Extensions.DependencyInjection;

var services = new ServiceCollection();

// 仅开发/测试：生产环境应注册对接 Vault、KMS 或云密钥服务的解析器。
services.AddInMemoryIntegrationCredentials();

// 直接注册租户感知 IChatClient，无需 SemanticKernel 包装层。
services.AddBitzChatClient(options =>
{
    options.ProviderId = "deepseek-dev";
    options.ProfileId = "deepseek";
    options.ModelId = "deepseek-flash";
});

await using var provider = services.BuildServiceProvider(
    new ServiceProviderOptions { ValidateScopes = true });

// 写入 tenant-a 的开发密钥；using 确保调用方持有的密钥快照被清理。
var credentialStore = provider.GetRequiredService<
    InMemoryIntegrationCredentialStore>();
using (var credential = new IntegrationCredential(
[
    new(AICredentialFieldNames.ApiKey, "<从 User Secrets 读取的开发密钥>")
]))
{
    credentialStore.Set(
        new IntegrationCredentialKey(
            tenantId: "tenant-a",
            providerKey: "AI:deepseek-dev",
            environment: IntegrationEnvironments.Development),
        credential);
}

// 每个业务请求建立自己的 Scope 和 IntegrationContext。
await using var scope = provider.CreateAsyncScope();
var contextAccessor = scope.ServiceProvider
    .GetRequiredService<IIntegrationContextAccessor>();
using var contextScope = contextAccessor.Push(
    new IntegrationContext(
        tenantId: "tenant-a",
        region: "cn-east",
        environment: IntegrationEnvironments.Development));

var chatClient = scope.ServiceProvider.GetRequiredService<IChatClient>();
var timeTool = AIFunctionFactory.Create(
    ([Description("IANA 或系统时区")] string? _) =>
        TimeProvider.System.GetUtcNow().ToString("O"),
    name: "get_utc_now",
    description: "获取当前 UTC 时间");

var chatOptions = new ChatOptions
{
    Instructions = "只回答当前租户已授权的业务问题。",
    Tools = [timeTool],
};

Console.WriteLine($"Ready for tenant {contextAccessor.Current?.TenantId}: {chatClient.GetType().Name} with {chatOptions.Tools.Count} tool(s).");

历史兼容层行为说明（退场参考）

存量代码在完成迁移前如需暂留兼容层，请知悉以下既有约束将在移除前保持不变：

1. Scope 与插件隔离：旧版 AddBitzSemanticKernel(name, ...) 通过命名 Key 解析 IChatClient，并通过 AddBitzSemanticKernelPlugin<TPlugin> 将包含 [KernelFunction] 的插件绑定到对应命名管道，不自动扫描程序集。
2. 工具调用护栏：SemanticKernelOptions 默认限制 MaximumFunctionInvocationIterations = 5 与 MaximumConsecutiveFunctionErrors = 1，不提供模型厂商密钥字段。
3. 退场计划：所有公开类型 ISemanticKernelClient、SemanticKernelOptions、DateTimePlugin 与 SemanticKernelServiceCollectionExtensions 均已标注 CS0618 过时警告，后续主版本将正式移除本包及 Microsoft.SemanticKernel 传递依赖。