ローカライゼーションの変更をエージェントに任せる

アシスタントには具体的な目標と範囲を限定した権限を与え、第三者が検証できる結果を求めましょう。

エージェントはコンテンツの確認、指針の作成、対応するローカライゼーションツールの操作を行えます。的確に依頼するには、必要な結果、変更してよい範囲、提出すべき根拠を明示することが大切です。「ローカライゼーションを改善して」だけでは、これらの判断が曖昧なままです。

選択した翻訳、新しいロケール一つ、報告された不具合一件、用語集の項目案一件など、レビューしやすく、問題があっても元に戻せる規模のタスクを選びましょう。MCPのセットアップを通じて接続し、書き込み操作を任せる前に、実際に使えるツールと操作対象となる組織の範囲を確認してください。

タスクに合ったツールと権限を選ぶ #

MCPツールは、アクセスが許可された組織のレコードを操作します。チェックアウト内のファイルを翻訳するには、CLIワークフローを使います。

セキュリティ上の境界を定めるのは権限です。確認だけを求めるプロンプトを書いても、接続に使った認証情報の書き込み権限がなくなるわけではありません。明確な指示とあわせて、適切な範囲に限定したアクセス権を使ってください。

たとえば、次のように依頼できます。

記録されたソースリビジョンの選択済みメッセージを、対象ロケールdeについて確認してください。該当するカタログとエンジンの指針を読んでください。ファイルや設定の変更案を示し、承認を求めてください。その後、選択済みメッセージだけを変更し、結果を取得して、変数と意味を確認してください。無関係な翻訳とそのベースラインは変更せずに維持してください。レビュー待ちの作業や完了できなかった作業を報告してください。共有の指針を変更する場合や公開する場合は、事前に確認してください。

依頼には、関連する言語の追加、モデルの比較、または診断の手順を含めてください。

設定は新しく作成する前に既存のものを確認する #

製品の対象箇所、対象ロケール、このサービスでの使用が許可されたソース資料を指定します。非公開の情報は非公開のまま扱い、手軽だからといって公開URLにしないでください。新しいローカライゼーションエンジンを提案する前に、既存のエンジンを確認するようエージェントに依頼しましょう。

ウェブサイトを基に、エンジンのリソースを作成できます。アシスタントは、新しいエンジンを作成し、用語集、ルールセット、ブランドボイスを設定できます。既存のエンジンに不足している種類のリソースだけを追加することも、現在の用語集やルールセットを残したまま新しいものを追加することも可能です。ソースには、ウェブサイトまたは提供したテキストを使います。

アシスタントはジョブの実行中に進捗を確認し、終了時には各処理の結果を完了、スキップ、失敗に分けて報告できます。失敗した処理のうち、エンジンに該当するリソースがまだないものは再試行できます。ウェブサイトからリソースを作成するをご覧ください。

チェックアウトでそのエンジンを使う場合は、CLIワークフローで該当するエンジンの正確なIDを紐付けます。設定を承認する前に、代表的な翻訳例と反例を確認してください。

翻訳では依頼内容と結果を保存する #

アプリケーションデータやアップロードしたファイルには、翻訳ジョブを使います。エンジン、ソースロケール、対象ロケール、ドキュメントキーを指定します。不足しているファイルをアップロードしてジョブを開始する前に、返されたジョブIDを保存してください。

曖昧なテキストには文脈やヒントを添え、想定するソース言語を明示します。ジョブの状態を定期的に確認し、失敗やレビュー待ちの状況を調べ、完了した対象ロケールの翻訳をそれぞれダウンロードしてください。送信済み、レビュー待ち、翻訳のダウンロード済みは、それぞれ異なる結果です。

ローカルのカタログは、ソースと承認済みの翻訳を確認してから、紐付けたエンジンを使うCLIワークフローで翻訳します。継続して使える成果として、リポジトリで繰り返し実行できるワークフローを残したい場合は、CLIまたはCIを使います。次の担当者が必要とするソースリビジョン、実行状態、出力を保存してください。

レビューでは委ねる判断を明示する #

貼り付けたソースと訳文をその場で確認すれば、問題が疑われる箇所を見つけられます。ただし、それによって保留中の人間によるレビューのレコードが承認されるわけではありません。測定への回答、提案の適用、人間による判断では、それぞれ変更される対象が異なります。

対応している保留中のレビューについては、該当するコンテンツとロケール、関連する指針、未解決の作業を確認し、必要なレビュー担当者権限がある場合にのみ操作してください。訳文の承認と、再利用できる指針の変更は、別々に扱います。

作業の完了を裏付ける根拠を求める #

ソースリビジョン、変更したファイルやレコードID、保存した設定、取得した出力、実施した確認、未解決の失敗や追加で必要なアクセス権を報告するよう、エージェントに依頼します。タスクの範囲を広げる前に、選択した作業の結果を確認してください。

明示的に許可しない限り、マージと公開は依頼の範囲に含めません。必要な機能がなくタスクを続行できない場合は、完了した調査の結果と変更案を保存し、収集済みの根拠を基に人が作業を引き継げるようにしてください。