better-i18nのHuman-in-the-Loop対応AI翻訳ツール：翻訳品質を高める23のAgent Tools

Better i18nのAI翻訳エージェント

Better i18nは単純なAI翻訳を超えた存在です。ダッシュボードには、Google Geminiを搭載した本格的な会話型AIエージェントが組み込まれており、プロジェクトのコンテキストを理解しながら、自然言語で翻訳タスクを実行します。名前空間の翻訳、不整合のレビュー、新しい言語の追加をリクエストすれば、毎ステップであなたの承認を得ながらエンドツーエンドでワークフローを処理します。

これは「生成して後は任せる」アプローチではありません。エージェントは23の専用ツール、すべての書き込み操作に対するHuman-in-the-Loop承認、そして実際のデータに基づいた30秒のプロジェクトコンテキストキャッシュを備えて動作します。

AIエージェントのアーキテクチャ

AIチャットシステムは、単純なプロンプト応答インターフェースではなく、ツール使用型エージェントとして構築されています。リクエストを入力すると、エージェントは以下を行います：

1. プロジェクトコンテキストを読み取る — 言語、キー、翻訳、Syncステータス、コンテンツモデル
2. 操作を計画する — どのツールをどの順序で呼び出すか決定
3. 承認を得て実行する — 読み取り操作は自動実行、書き込み操作はあなたの明示的な確認が必要
4. 結果をプログレッシブにストリーミング — 翻訳テーブルが結果の到着とともにリアルタイムでレンダリング

エージェントは1会話あたり最大50ステップをサポートし、大規模な操作でのトークンオーバーフローを防ぐコンテキストストリッピング（slimToolResults）を備えています。

23の専用ツール

エージェントは、読み取りツールと書き込みツールに分かれた23の専用ツールにアクセスできます。

読み取りツール（自動実行）

これらのツールは承認なしで実行され、エージェントがプロジェクトを完全に把握できます：

• getTranslations — 特定のキー、名前空間、または言語の翻訳を取得
• getKeyDetails — 個々のキーのメタデータ、コンテキストノート、翻訳ステータスを検査
• getLanguages — 設定済み言語とその完了率を一覧表示
• getProjectStats — プロジェクト全体の翻訳カバレッジ、キー数、言語統計
• getDoctorReport — 欠落翻訳、未使用キー、不整合を特定する診断レポート
• getSyncs — 設定済みのSync連携（GitHub、GitLabなど）を一覧表示
• getSyncDetails — 特定のSyncの設定と最近のアクティビティを検査
• getContentModels — コンテンツモデルとそのフィールド構造を一覧表示
• getContentEntries — モデル全体のコンテンツエントリを閲覧
• createPlan — 複雑なマルチステップ操作の実行プランを生成

書き込みツール（Human-in-the-Loop承認）

すべての書き込みツールは、実行前にあなたの明示的な承認が必要です。エージェントが変更を提案し、あなたがレビューして、初めて反映されます：

• proposeTranslations — 未翻訳の言語ペアに対して新しい翻訳を生成
• proposeTranslationEdits — 既存翻訳の改善案を提案
• translateBatch — 複数言語にまたがるキーを一括翻訳するBatch Operations
• proposeKeys — コードベースのパターンに基づいて新しい翻訳キーを提案
• proposeDeleteKeys — 未使用または重複キーの削除を特定・提案
• proposeLanguages — ユーザーの人口統計に基づいて追加する言語を提案
• proposeLanguageEdits — 言語設定（表示名、フォールバック）を変更
• publishChanges — 承認済み翻訳をCDNにライブ公開
• proposeContentEntries — CMSコンテンツエントリを作成または更新
• proposeContentModel — コンテンツモデルのスキーマ変更を提案
• proposePublishEntries — コンテンツエントリをPublishキューに追加

Human-in-the-Loop：重要な差別化要因

ほとんどのAI翻訳ツールは「生成して配信」モデルで動作します。Better i18nはHuman-in-the-Loop（HITL）承認という根本的に異なるアプローチを採用しています。

実際のHITLの動作：

1. あなたがエージェントに依頼：「settingsネームスペースの欠落しているキーをすべてドイツ語とフランス語に翻訳して」
2. エージェントがプロジェクトを読み取り、47件の未翻訳を特定し、翻訳を生成
3. チャットに構造化されたプロポーザルが表示 — 各ソース文字列、AI翻訳、適用されたグロッサリー用語を表示
4. プロポーザルをレビュー：全て承認、個別承認、または変更リクエスト
5. 承認された翻訳のみがプロジェクトに書き込まれる

このワークフローにより、AI翻訳品質が本番環境に到達する前にあなたの基準を満たすことを保証します。エージェントはあなたの同意なしにデータを書き込みません。

なぜ重要なのか：

• サイレントエラーなし — すべてのAI生成翻訳はライブ公開前にレビュー
• グロッサリーの適用 — AIが用語定義を尊重し、あなたが検証
• 監査証跡 — すべての承認が誰がいつ承認したかとともに記録
• 元に戻せる — 各変更を承認するため、未知の品質のバッチが本番に潜むことがない

プログレッシブレンダリング

エージェントが翻訳を生成する際、結果はリアルタイムでチャットインターフェースにストリーミングされます。翻訳テーブルはプログレッシブにレンダリングされ、AIが出力を生成するにつれて各言語カラムが埋まっていく様子を確認できます。バッチ全体が完了するまで待つ必要はありません。

これは大規模な操作で特に効果的です。8言語にわたって200キーを翻訳する場合、エージェントがまだ残りを生成している間に最初の結果のレビューを始めることができます。

チャット履歴と永続化

エージェントはデュアルストレージシステムで会話履歴を維持します：

• IndexedDB（ローカル） — ゼロレイテンシで最近の会話に即座にアクセス
• Postgres（サーバー） — すべてのエージェントインタラクションの永続的な監査証跡を維持

これにより、ダッシュボードに戻った際に会話が即座に読み込まれ、チームの監査やコンプライアンス目的にも利用できます。

実践的な使用例

新しい言語の追加

あなた：「プロジェクトに日本語を追加して、既存のキーをすべて翻訳して」

エージェントはgetLanguagesで現在の設定を確認し、proposeLanguagesで日本語を追加し、translateBatchですべての既存キーの翻訳を生成します。各ステップで何が起きているかを表示し、書き込み操作はあなたの承認を待ちます。

翻訳の問題を発見

あなた：「フランス語の翻訳に不整合はありますか？」

エージェントはgetDoctorReportとgetTranslationsを呼び出し、用語の不整合、複数形の欠落、未翻訳キーを分析します。注意が必要な具体的なキーとともにサマリーを提示します。

一括翻訳レビュー

あなた：「checkoutネームスペースのスペイン語で未翻訳のキーをすべて表示して」

エージェントは適切なフィルターでgetTranslationsを呼び出し、未翻訳の一覧テーブルを表示します。その後すべての翻訳を生成するよう依頼し、プロポーザルをレビューして一括承認できます。

モデルとコンテキスト管理

エージェントは、優れた多言語能力とコンテキストウィンドウサイズが評価されたGoogle Geminiを基盤モデルとして使用しています。主な技術的詳細：

• 1会話あたり50ステップ — 複雑なマルチステップ操作に十分
• コンテキストストリッピング — slimToolResultsシステムが大きなAPIレスポンスを必要なデータにトリミングしてトークン使用量を自動削減
• 30秒プロジェクトキャッシュ — マルチステップ操作中の冗長なAPIコールを防ぐためプロジェクトコンテキストを30秒キャッシュ

AIエージェントを使ってみる

1. Better i18nダッシュボードを開き、AIチャットアイコンをクリック
2. 読み取り操作から始める：「このプロジェクトの翻訳ステータスを教えて」
3. 翻訳タスクを試す：「commonネームスペースの欠落しているキーをすべてスペイン語に翻訳して」
4. エージェントのプロポーザルをレビューして承認または編集
5. 翻訳をライブ公開する準備ができたら*「Publish changes」*を使用

AIエージェントはすべてのプランで利用可能です。アカウントを作成してあなたのプロジェクトでお試しください。