メインコンテンツへスキップ
// 7 分で読める

Cloudflare Workers AIを用いたリアルタイム決定論的翻訳

Portelcore向けi18n国際化パイプラインの設計:DJB2キーの決定論的抽出、EdgeでのLLMモデル推論、Cloudflare KVでの多層キャッシュ。

Tomàs Elias
@authorTomàs Elias
•7 MIN
0閲覧数
Portada de Traducciones Deterministas en Tiempo Real con Cloudflare Workers AI

多言語 Web アプリのローカリゼーションは、従来、手動で翻訳された静的ファイル .json や、遅くて高価な外部翻訳 API の呼び出しに依存してきました。Portelcore Web では、DJB2 暗号ハッシュと Cloudflare Workers AI 上のローカル言語モデル推論を組み合わせた完全自動化パイプラインを実装しました。

1. 決定論的翻訳フロー

システムはプロセスを3つの実行段階に分割します:

[ HTML con Textos ] ---> [ Hash DJB2 de 64 bits ] ---> [ ¿Existe en KV? ]
│
┌────────────────────────────────────────┴───────────────────┐
▼ SÍ ▼ NO
[ Cache Hit: 0 ms ] [ Workers AI LLM ]
[ Guarda en KV ]
[ Entrega Traducción ]
  1. Compile-Time / SSR での抽出:テキストは <AITranslate> コンポーネントでラップされるか、HTML にタグ付けされます。
  2. 一意キーの生成:スペイン語の文字列から決定論的 DJB2 ハッシュが計算されます(例:msg-1085732109)。
  3. KV グローバルキャッシュ:AI モデルに問い合わせる前に、PORTELCORE_KV_CORE 名前空間を確認します。対象言語のキーが存在する場合、応答は 5 ms 未満で返されます。

2. DJB2 アルゴリズムの実装

Astro SSR においてサーバー応答時間を損なわないため、ハッシュ計算速度が不可欠です:

/**
* Calcula el hash DJB2 optimizado para cadenas de texto.
* Produce un identificador numérico determinista e inmutable.
*/
export function djb2Hash(str: string): string {
let hash = 5381;
for (let i = 0; i < str.length; i++) {
hash = ((hash << 5) + hash) + str.charCodeAt(i);
hash |= 0; // Conversión forzada a entero de 32 bits con signo
}
return Math.abs(hash).toString(36);
}

3. Workers AI での LLM モデル推論

新しいキーが周辺キャッシュに存在しない場合、衛星 Worker はリクエストを Workers AI のランタイムにディスパッチします:

/**
* Invoca el modelo Llama 3.3 en Workers AI con un prompt de sistema rígido.
*/
export async function translateText(text, targetLanguage, env) {
const systemPrompt = `Eres un traductor técnico profesional.
Traduce el siguiente texto técnico exactamente al idioma '${targetLanguage}'.
Conserva términos técnicos de programación (ej: WAF, Cloudflare, KV, SSR, TypeScript).
Devuelve ÚNICAMENTE la traducción limpia sin explicaciones ni comillas.`;
const response = await env.AI.run("@cf/meta/llama-3.3-70b-instruct-fp8-fast", {
messages: [
{ role: "system", content: systemPrompt },
{ role: "user", content: text }
],
temperature: 0.1
});
return response.response.trim();
}

4. 結論

この設計により、プラットフォームは同期が取れていない手動辞書を管理することなく14の国際言語をサポートでき、世界中で滑らかで高速かつ一貫した体験を維持します。

[ 共有 ]
← ジャーナルに戻る

[ さらに探索する ]