Bitzsoft.Integrations.Translation.AI.OpenAI 1.0.0

Bitzsoft.Integrations.Translation.AI.OpenAI

OpenAI 兼容网关大模型翻译实现包 -- 通吃 OpenAI / 智谱 GLM / DeepSeek / Kimi / 通义千问等 compatible 端点（一个 chat/completions 走天下），复用既有 Bitzsoft.Integrations.AI.Abstractions 的 IChatClient 体系（端点 / 模型 / 密钥租户感知，密钥进凭据存储），实现 IAiTranslationProvider 契约。

功能特性

• 一套代码通吃兼容网关：端点差异由 AI 域内置 Profile（openai / zhipu / kimi / qwen / deepseek）吸收
• 法律术语约束提示词：内置法律与商务文书级系统提示词模板，Terms 逐行注入强约束译法
• 批量分段策略：长文本按 SegmentCharLimit（段落 → 句子 → 硬截断三级边界）切分、译文按原始分隔符回拼
• JSON 模式输出 + 失败回退：单译文 {"translation":...} / 批量 {"translations":[...]}，response_format=json_object 下发；解析失败自动回退纯文本重译，批量解析失败回退逐条
• 风格 / 温度 / 提示词模板：Style / Instructions / SystemPromptTemplate（占位符可自定义）/ Temperature 全量支持
• 语言检测：大模型 JSON 输出识别语种并归一化统一编码
• 健康探测：单次最小补全（限定 8 token）

与 AI 域抽象的关系（评审结论）

模型调用复用 AI.Abstractions 的 IAIChatClientFactory / IChatClient（密钥不落配置、租户凭据解析、审计遥测开箱即用）；翻译特有语义（术语注入、统一语言编码、分段回拼、JSON 回退、领域错误码）全部落在 Translation.Abstractions 与本包，两个抽象互不依赖。

安装

dotnet add package Bitzsoft.Integrations.Translation.AI.OpenAI

配置

appsettings.json（翻译编排参数）

{
  "Translation": {
    "OpenAI": {
      "ClientName": "translation",
      "ModelId": "glm-4.6",
      "SegmentCharLimit": 6000,
      "MaxBatchItems": 20,
      "EnableJsonMode": true,
      "DefaultTemperature": 0.2,
      "DefaultDomainHint": "法律合同"
    }
  }
}

注册服务

using Bitzsoft.Integrations.AI;
using Microsoft.Extensions.DependencyInjection;

// 1. 注册 AI 命名客户端（端点 + 模型 + 凭据存储，密钥不落配置）
builder.Services.AddInMemoryIntegrationCredentials();
builder.Services.AddBitzChatClient("translation", options =>
{
    options.ProviderId = "zhipu";
    options.ProfileId = "zhipu";
    options.ModelId = "glm-4.6";
    options.Endpoint = "https://open.bigmodel.cn/api/paas/v4";
});

// 2. 注册大模型翻译（引用上一步的命名客户端）
builder.Services.AddBitzsoftOpenAiTranslation(builder.Configuration);

DeepSeek / Kimi / Qwen / OpenAI 官方等兼容端点只需换 ProfileId + Endpoint + ModelId，翻译包零改动。

使用示例

// AI 契约：术语 + 风格 + 温度
var provider = factory.GetProvider(TranslationProviderCode.OpenAI);
var result = await ((IAiTranslationProvider)provider).TranslateAsync(new AiTranslationRequest
{
    Text = longContractText,          // 超长自动分段回拼
    SourceLanguage = "auto",
    TargetLanguage = "zh",
    Terms = new[]
    {
        new TranslationTerm("force majeure", "不可抗力"),
        new TranslationTerm("consideration", "对价"),
    },
    Style = "正式法律文书",
    Instructions = "保留条款编号不译",
    Temperature = 0.1
});

能力矩阵

错误码收敛

鉴权 / 配额类错误由 AI 域 IChatClient 底层抛出，经 OperationFailed 包装；需要细分时建议在 AI 域凭据与网关层排障。

相关包

• Bitzsoft.Integrations.Translation.Abstractions -- 抽象层契约
• Bitzsoft.Integrations.AI -- IChatClient 命名客户端注册
• Bitzsoft.Integrations.Translation.All -- 聚合包