アカウントモデル

Glossia は、リポジトリの指示とモデルプロバイダーの認証情報を分離します。リポジトリでは翻訳対象を定義し、アカウントではどの大規模言語モデルが処理を実行するかを決定します。

モデルをアカウントに設定する理由

チームでは、多くの場合、同じプロバイダー契約を使用して複数のリポジトリを翻訳します。アカウント単位のモデルを使用すると、管理者はすべてのリポジトリを編集することなく、プロバイダーキーのローテーションや基盤モデルの切り替えを一度の操作で実行できます。

この境界により、認証情報をソース管理の対象外に保つこともできます。リポジトリにはプロバイダーキーではなく、translation-default のような判読可能なハンドルが含まれます。

ハンドルによる意図の安定化

GLOSSIA.md の model フィールドは、アカウントのモデルハンドルを参照します。

model: translation-default

このハンドルは、リポジトリの意図を表します。管理者は、リポジトリの設定を維持したまま、後からそのハンドルが選択するプロバイダーモデルを更新できます。

複数のモデルの使用方法

Glossia は、各ドキュメントの翻訳に設定済みモデルを1つ使用します。複数のモデルを追加しても、アンサンブル、フォールバックチェーン、自動品質階層は作成されません。リポジトリの作成者は、translation-default、long-form、japanese-specialist などの安定したハンドルを使用して、その用途を選択します。

選択は、ドキュメントと対象ロケールのコンテキスト階層に従います。

1. そのロケールに対して model を宣言している最も近い GLOSSIA/<locale>.md ファイルが優先されます。
2. 該当しない場合、そのディレクトリに対して model を宣言している最も近い GLOSSIA.md ファイルが優先されます。
3. より近いファイルでモデルが宣言されていない場合、親の GLOSSIA.md 設定が継承されます。
4. 適用可能なコンテキストファイルでハンドルが宣言されていない場合、Glossia はアカウントのデフォルトを使用します。

明示的に設定されたハンドルは、実在している必要があります。Glossia は、不明なハンドルをアカウントのデフォルトへ暗黙的に切り替えず、エラーとして報告します。

デフォルトの選択

プロジェクトのセットアップでは、リポジトリに独自の GLOSSIA.md が作成される前にモデルが必要です。そのため、Glossia はアカウントのデフォルトを選択します。アカウントに最初に追加されたモデルがデフォルトになり、管理者は別のモデルの設定ページからそのモデルをデフォルトに変更できます。

リポジトリに GLOSSIA.md が作成された後は、明示的なハンドルを使用することで、選択内容がレビュー担当者にとって明確になります。model を省略すると、リポジトリではアカウントのデフォルトが引き続き使用されます。

人によるレビューとの境界

モデルの出力は提案された変更であり、自動的にマージされるものではありません。セットアップと翻訳のアクティビティは Glossia 上で確認でき、リポジトリへの変更はチームがレビューするプルリクエストとして公開されます。これにより、チームがコードに対してすでに採用している品質と所有責任の境界が維持されます。