Přejít na hlavní obsah
// 7 min četba

Deterministické překlady v reálném čase s Cloudflare Workers AI

Návrh pipeline internacionalizace i18n pro Portelcore: deterministická extrakce klíčů DJB2, inference s modely LLM na Edge a vícerovná cache v Cloudflare KV.

Tomàs Elias
@authorTomàs Elias
•7 MIN
0čtení
Portada de Traducciones Deterministas en Tiempo Real con Cloudflare Workers AI

Lokalizace webových aplikací pro více jazyků tradičně závisela na statických souborech .json ručně přeložených nebo na pomalých a nákladných voláních externích překladových rozhraní API. V Portelcore Web implementujeme plně automatizované potrubí, které kombinuje kryptografické hashování DJB2 s lokální inferencí jazykových modelů v Cloudflare Workers AI.

1. Deterministický překladový tok

Systém rozděluje proces do tří fází provedení:

[ 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. Extrahování v době kompilace / SSR: Texty jsou zabaleny do komponenty <AITranslate> nebo označeny v HTML.
  2. Generování unikátního klíče: Je vypočten deterministický hash DJB2 řetězce ve španělštině (např. msg-1085732109).
  3. Globální cache v KV: Před konzultací s modelem AI je prohledán namespace PORTELCORE_KV_CORE. Pokud klíč existuje pro cílový jazyk, odpověď je doručena za méně než 5 ms.

2. Implementace algoritmu DJB2

Rychlost výpočtu hash je nezbytná pro to, aby nebyl penalizován čas odpovědi serveru v 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. Inference s modely LLM v Workers AI

Pokud nová klíč neexistuje v okrajové cache, satelitní worker odešle požadavek na runtime 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. Závěr

Toto konstrukce umožňuje platformě podporovat 14 mezinárodních jazyků bez potřeby udržovat ručně nesynchronizované slovníky, přičemž je zachována hladká, rychlá a konzistentní zkušenost po celém světě.

[ SDÍLET ]
← ZPĚT NA JOURNAL

[ Pokračovat v prozkoumávání ]