Prejsť na hlavný obsah
// 7 min čítanie

Deterministické preklady v reálnom čase s Cloudflare Workers AI

Návrh potrubia internacionalizácie i18n pre Portelcore: deterministická extrakcia kľúčov DJB2, inferencia s modelmi LLM na okraji a viacúrovňová cache v Cloudflare KV.

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

Lokalizácia webových aplikácií pre viac jazykov tradične závisela od statických súborov .json manuálne preložených alebo od pomalých a nákladných volaní externých prekladateľských API. V Portelcore Web implementujeme plne automatizovaný pipeline, ktorý kombinuje kryptografické hashovanie DJB2 s lokálnou inferenciou modelov jazyka v Cloudflare Workers AI.

1. Deterministický prekladateľský tok

Systém rozdeľuje proces na tri fázy vykonávania:

[ 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. Extrakcia v čase kompilácie / SSR: Texty sú zabalené do komponentu <AITranslate> alebo označené v HTML.
  2. Vytvorenie unikálneho kľúča: Vypočítaný je deterministický hash DJB2 reťazca v španielčine (napr. msg-1085732109).
  3. Globálna cache v KV: Pred konzultáciou s modelom AI sa kontroluje namespace PORTELCORE_KV_CORE. Ak kľúč existuje pre cieľový jazyk, odpoveď je doručená za menej ako 5 ms.

2. Implementácia algoritmu DJB2

Rýchlosť výpočtu hash je nevyhnutná pre to, aby sa neznížila doba odozvy servera 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. Inferencia s modelmi LLM v Workers AI

Keď nový kľúč neexistuje v okrajovej cache, satelitný pracovník pošle požiadavku 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áver

Tento dizajn umožňuje platforme podporovať 14 medzinárodných jazykov bez potreby udržiavať manuálne nesynchronizované slovníky, pričom sa zachová plynulý, rýchly a konzistentný zážitok po celom svete.

[ ZDIELIŤ ]
← SPÄŤ NA JOURNAL

[ Pokračovať v skúmaní ]