Human-in-the-Loop AI翻译工具：23个代理工具保障翻译质量

Better i18n中的AI驱动翻译代理

Better i18n超越了简单的AI翻译。仪表板包含一个完整的对话式AI代理——由Google Gemini驱动——它理解您的项目上下文，并通过自然语言执行翻译任务。要求它翻译命名空间、审查不一致性或添加新语言，它将在每一步获得您的批准后端到端地处理工作流。

这不是"生成并祈祷"的方法。代理使用23个专业工具运行，每个写入操作都需要Human-in-the-Loop批准，还有30秒的项目上下文缓存，使其始终基于您的实际数据。

AI代理架构

AI聊天系统构建为使用工具的代理，而非简单的提问-回答界面。当您输入请求时，代理会：

1. 读取您的项目上下文 — 语言、键、翻译、同步状态、内容模型
2. 规划操作 — 确定调用哪些工具以及调用顺序
3. 经批准后执行 — 读取操作自动进行；写入操作需要您的明确确认
4. 逐步流式传输结果 — 翻译表格在结果到达时实时渲染

代理支持每次对话最多50个步骤，并具有上下文精简（slimToolResults）功能，防止大型操作中的令牌溢出。

23个专业工具

代理可以访问23个专门构建的工具，分为读取工具和写入工具。

读取工具（自动执行）

这些工具无需批准即可运行，为代理提供对项目的完全可见性：

• getTranslations — 获取特定键、命名空间或语言的翻译
• getKeyDetails — 检查单个键的元数据、上下文注释和翻译状态
• getLanguages — 列出所有已配置的语言及其完成百分比
• getProjectStats — 项目范围的翻译覆盖率、键数量和语言统计
• getDoctorReport — 识别缺失翻译、未使用的键和不一致性的诊断报告
• getSyncs — 列出所有已配置的同步集成（GitHub、GitLab等）
• getSyncDetails — 检查特定同步的配置和最近活动
• getContentModels — 列出内容模型及其字段结构
• getContentEntries — 跨模型浏览内容条目
• createPlan — 为复杂的多步骤操作生成执行计划

写入工具（Human-in-the-Loop批准）

每个写入工具在执行前都需要您的明确批准。代理提出更改建议，您审核，然后才会生效：

• proposeTranslations — 为缺失的语言对生成新翻译
• proposeTranslationEdits — 建议改进现有翻译
• translateBatch — 在一次操作中跨多种语言批量翻译键
• proposeKeys — 根据代码库模式建议新的翻译键
• proposeDeleteKeys — 识别并建议删除未使用或重复的键
• proposeLanguages — 根据用户人口统计建议新语言
• proposeLanguageEdits — 修改语言配置（显示名称、回退）
• publishChanges — 将已批准的翻译推送至CDN上线
• proposeContentEntries — 创建或更新CMS内容条目
• proposeContentModel — 建议内容模型架构更改
• proposePublishEntries — 将内容条目排入发布队列

Human-in-the-Loop：关键差异化因素

大多数AI翻译工具采用"生成并发送"模式运营。Better i18n通过Human-in-the-Loop（HITL）批准采取了根本不同的方法。

HITL在实践中的工作方式：

1. 您向代理请求："将设置命名空间中所有缺失的键翻译成德语和法语"
2. 代理读取您的项目，识别47个缺失翻译并生成它们
3. 结构化提案出现在聊天中——显示每个源字符串、AI翻译和应用的术语表术语
4. 您审核提案：全部批准、选择性批准或要求更改
5. 只有获批准的翻译才会写入您的项目

这个工作流确保AI翻译质量在任何内容到达生产环境之前满足您的标准。代理从不在未经您同意的情况下写入数据。

为什么这很重要：

• 没有隐性错误 — 每个AI生成的翻译都在上线前经过审核
• 术语表执行 — AI遵守您的术语定义，您来验证
• 审计跟踪 — 每次批准都记录了谁批准以及何时批准
• 可逆性 — 由于您批准每一项更改，生产环境中不存在质量未知的批次

渐进式渲染

当代理生成翻译时，结果实时流式传输到聊天界面。翻译表格渐进式渲染——您可以看到每个语言列在AI产生输出时逐步填充，而无需等待整个批次完成。

这对于大型操作尤其有价值。在将200个键翻译成8种语言时，您可以在代理仍在生成其余内容的同时开始审核第一批结果。

聊天历史和持久化

代理通过双存储系统维护对话历史：

• IndexedDB（本地） — 提供对最近对话的即时零延迟访问
• Postgres（服务器） — 维护所有代理交互的持久审计跟踪

这意味着当您返回仪表板时，对话会即时加载，同时也可用于团队审计和合规目的。

实际示例

添加新语言

您： "将日语添加到项目中并翻译所有现有的键"

代理调用getLanguages检查当前配置，proposeLanguages添加日语，然后translateBatch为所有现有键生成翻译。每一步都显示正在发生什么，写入操作等待您的批准。

查找翻译问题

您： "法语翻译中是否有不一致之处？"

代理调用getDoctorReport和getTranslations，然后分析结果中的术语不一致、缺失的复数形式或未翻译的键。它呈现一份摘要，其中包含需要关注的特定键。

批量翻译审核

您： "显示结账命名空间中所有西班牙语未翻译的键"

代理使用适当的过滤器调用getTranslations并呈现缺失翻译的表格。然后您可以要求它为所有键生成翻译，审核提案并批量批准。

模型和上下文管理

代理使用Google Gemini作为其底层模型，选择它是因为其强大的多语言能力和上下文窗口大小。关键技术细节：

• 每次对话50个步骤 — 足够应对复杂的多步骤操作
• 上下文精简 — slimToolResults系统通过将大型API响应修剪为基本数据来自动减少令牌使用
• 30秒项目缓存 — 项目上下文缓存30秒，防止多步骤操作期间的冗余API调用

开始使用AI代理

1. 打开Better i18n仪表板并点击AI聊天图标
2. 从读取操作开始："显示此项目的翻译状态"
3. 尝试翻译任务："将common命名空间中所有缺失的键翻译成西班牙语"
4. 审核代理的提案并根据需要批准或编辑
5. 准备好将翻译推送上线时使用*"发布更改"*

AI代理在所有计划中可用。创建您的帐户，在您的项目中试用。