Rilevamento della lingua con l'AI integrata

Thomas Steiner

Pubblicato: 24 settembre 2024, ultimo aggiornamento: 20 maggio 2025

Spiegazione	Web	Estensioni	Stato di Chrome	Intenzione
GitHub	Chrome 137 beta	Chrome 137 beta	Visualizza	Intent to Ship

Prima di tradurre un testo da una lingua all'altra, devi prima determinare la lingua utilizzata nel testo in questione. In precedenza, la traduzione richiedeva il caricamento del testo su un servizio cloud, l'esecuzione della traduzione sul server e il download dei risultati.

L'API Language Detector funziona lato client, il che significa che puoi proteggere la privacy degli utenti. Sebbene sia possibile inviare una libreria specifica che lo faccia, il download richiederebbe risorse aggiuntive.

Nota: partecipa al programma Early Preview per dare un'occhiata in anteprima alle nuove API di IA integrate e accedere alla discussione sulla nostra mailing list.

Quando utilizzare il rilevamento della lingua

L'API Language Detector è utile principalmente nei seguenti scenari:

• Determina la lingua del testo inserito in modo che possa essere tradotto.
• Determina la lingua del testo di input, in modo che il modello corretto possa essere caricato per attività specifiche per lingua, come il rilevamento del linguaggio tossico.
• Determina la lingua del testo inserito in modo che possa essere etichettato correttamente, ad esempio nei siti di social network online.
• Determina la lingua del testo inserito, in modo che l'interfaccia di un'app possa essere modificata di conseguenza. Ad esempio, su un sito belga per mostrare solo l'interfaccia pertinente agli utenti che parlano francese.

Inizia

L'API Language Detector è disponibile a partire dalla versione stabile 138 di Chrome. Esegui il rilevamento delle funzionalità per verificare se il browser supporta l'API Language Detector.

if ('LanguageDetector' in self) {
  // The Language Detector API is available.
}

Esamina i requisiti hardware

Le API Language Detector e Translator funzionano su computer solo in Chrome.

Le API Prompt, Summarizer, Writer e Rewriter funzionano in Chrome se vengono soddisfatte le seguenti condizioni:

• Sistema operativo: Windows 10 o 11; macOS 13 o versioni successive (da Ventura in poi); o Linux. Chrome per Android, iOS e ChromeOS non è ancora supportato dalle nostre API basate su Gemini Nano.
• Spazio di archiviazione: almeno 22 GB sul volume contenente il tuo profilo Chrome.
• GPU: almeno 4 GB di VRAM.
• Rete: dati illimitati o una connessione senza limiti di traffico.

Nota: anche se il modello richiede molto meno spazio di archiviazione (circa un paio di GB), questo requisito esiste per assicurarti di avere un ampio margine di spazio di archiviazione. Se lo spazio di archiviazione disponibile scende a meno di 10 GB dopo il download, il modello verrà rimosso dal dispositivo e ricaricato quando i requisiti saranno nuovamente soddisfatti.

• GPU: almeno 4 GB di VRAM.
• Rete: dati illimitati o una connessione senza limiti di traffico.

Termine chiave: una connessione con misuratore è una connessione a internet con dati limitati. Le connessioni Wi-Fi ed Ethernet tendono a non essere misurate per impostazione predefinita, mentre le connessioni cellulari spesso lo sono.

Questi requisiti sono previsti per te nel processo di sviluppo e per gli utenti che lavorano con le funzionalità che crei.

Download modello

Il rilevamento della lingua dipende da un modello ottimizzato per l'attività specifica di rilevamento delle lingue. Sebbene l'API sia integrata nel browser, il modello viene scaricato on demand la prima volta che un sito tenta di utilizzare l'API. In Chrome, questo modello è molto piccolo rispetto ad altri modelli. Potrebbe essere già presente, poiché questo modello viene utilizzato da altre funzionalità di Chrome.

Per verificare se il modello è pronto per l'uso, chiama la funzione asincrona LanguageDetector.availability() e controlla la promessa risultante. Esistono tre possibili risposte:

• "unavailable": le opzioni richieste non sono supportate o non è possibile chiedere al modello di rispondere.
• "downloadable": la richiesta è supportata, ma sono necessari download aggiuntivi prima di poter creare una sessione. Questi download possono includere il modello linguistico o la messa a punto fine.
• "downloading": la richiesta è supportata ed è in corso un download che deve essere completato prima di creare una sessione.
• "available": la richiesta è supportata e puoi creare una sessione.

Per attivare il download e creare un'istanza del rilevatore di lingua, chiama la funzione LanguageDetector.create() asincrona. Se la risposta a availability() è stata 'downloadable' o 'downloading', è buona prassi ascoltare lo stato di avanzamento del download in modo da poter informare l'utente nel caso in cui il download richieda tempo.

L'esempio seguente mostra come inizializzare il rilevatore di lingua.

const availability = await LanguageDetector.availability();

let detector;
if (availability === 'unavailable') {
  // The language detector isn't usable.
  return;
}
if (availability === 'available') {
  // The language detector can immediately be used.
  detector = await LanguageDetector.create();
} else {
  // The language detector can be used after model download.
  detector = await LanguageDetector.create({
    monitor(m) {
      m.addEventListener('downloadprogress', (e) => {
        console.log(`Downloaded ${e.loaded * 100}%`);
      });
    },
  });
  await detector.ready;
}

Esegui il rilevatore della lingua

L'API Language Detector utilizza un modello di ranking per determinare la lingua più probabile utilizzata in un determinato testo. Il ranking è un tipo di apprendimento automatico il cui scopo è ordinare un elenco di elementi. In questo caso, l'API Language Detector assegna un ranking alle lingue dalla probabilità più alta a quella più bassa.

Nota: l'API Language Detector viene addestrata su un insieme di lingue, che non include tutte le lingue esistenti. Ciò significa che l'API non può rilevare ogni lingua con assoluta precisione. A partire da Chrome 132, puoi verificare se un determinato linguaggio è disponibile per il rilevamento.

La funzione detect() può restituire il primo risultato, la risposta più probabile o eseguire l'iterazione sui candidati classificati con il livello di confidenza. Viene restituito sotto forma di elenco di oggetti {detectedLanguage, confidence}. Il livelloconfidence è espresso come un valore compreso tra 0.0 (confidenza minima) e 1.0 (confidenza massima).

const someUserText = 'Hallo und herzlich willkommen!';
const results = await detector.detect(someUserText);
for (const result of results) {
  // Show the full list of potential languages with their likelihood, ranked
  // from most likely to least likely. In practice, one would pick the top
  // language(s) that cross a high enough threshold.
  console.log(result.detectedLanguage, result.confidence);
}
// (Output truncated):
// de 0.9993835687637329
// en 0.00038279531872831285
// nl 0.00010798392031574622
// ...

Attenzione: è preferibile evitare frasi molto brevi e parole singole, in quanto la precisione dei risultati sarà bassa. Se di solito lavori con testi più brevi, fai esperimenti con le lingue di priorità, controlla l'affidabilità indicata e restituisci il risultato come sconosciuto quando l'affidabilità è troppo bassa.

Playground API

Fai esperimenti con l'API Language Detector nel nostro sandbox API. Inserisci il testo scritto in lingue diverse nell'area di testo.

Impegno di standardizzazione

Il team di Chrome ha richiesto un feedback al W3C Technical Architecture Group e a Mozilla e WebKit per conoscere le loro opinioni sugli standard.

Condividi il tuo feedback

Vogliamo vedere cosa stai creando con l'API Language Detector. Condividi con noi i tuoi siti web e le tue applicazioni web su X, YouTube e LinkedIn.

Se hai un feedback sull'implementazione di Chrome, segnala un bug di Chromium.