Inizia a utilizzare l'IA integrata

Alexandra Klepper
Alexandra Klepper
GitHub Bluesky

Pubblicato: 12 dicembre 2024, ultimo aggiornamento: 20 maggio 2025

Con le API di AI integrate, la tua applicazione web può eseguire attività basate sull'AI senza dover eseguire il deployment o gestire i propri modelli di AI. Stiamo lavorando per standardizzare queste API su tutti i browser.

Requisiti

Per utilizzare l'AI integrata, esistono requisiti di modello e hardware.

Modelli

Le API Translator e Language Detector utilizzano modelli esperti. Tutte le altre API utilizzano un modello linguistico progettato per essere eseguito localmente su computer desktop e laptop.

Le API Summarizer, Writer, Rewriter e Proofreader supportano solo la modalità da testo a testo. L'API Prompt ha funzionalità multimodali.

Gemini Nano in Chrome

Chrome utilizza i modelli linguistici Gemini Nano. Gemini Nano non è disponibile sui dispositivi mobili.

A partire da Chrome 140, Gemini Nano supporta inglese, spagnolo e giapponese per l'input e l'output di testo.

Prima di utilizzare le API AI integrate, accetta le Norme relative all'uso vietato dell'AI generativa di Google.

Hardware

Per gli sviluppatori e gli utenti che utilizzano le funzionalità che si servono di queste API in Chrome esistono i seguenti requisiti. Altri browser potrebbero avere requisiti di funzionamento diversi.

Le API Language Detector e Translator funzionano in Chrome su computer. Queste API non funzionano sui dispositivi mobili. Le API Prompt, Summarizer, Writer, Rewriter e Proofreader funzionano in Chrome quando sono soddisfatte le seguenti condizioni:

  • Sistema operativo: Windows 10 o 11; macOS 13+ (Ventura e versioni successive); Linux; o ChromeOS (dalla piattaforma 16389.0.0 e versioni successive) su dispositivi Chromebook Plus. Chrome per Android, iOS e ChromeOS su dispositivi non Chromebook Plus non sono ancora supportati dalle API che utilizzano Gemini Nano.
  • Spazio di archiviazione: almeno 22 GB di spazio libero sul volume che contiene il tuo profilo Chrome.
  • GPU o CPU: i modelli integrati possono essere eseguiti con GPU o CPU.
    • GPU: rigorosamente più di 4 GB di VRAM.
    • CPU: 16 GB di RAM o più e 4 core CPU o più.
  • Rete: dati illimitati o una connessione non misurata.

Le dimensioni esatte di Gemini Nano possono variare man mano che il browser aggiorna il modello. Per determinare le dimensioni attuali, visita la pagina chrome://on-device-internals.

Inizia a creare

Sono disponibili diverse API AI integrate in diverse fasi di sviluppo. Alcune sono disponibili nella versione stabile di Chrome, altre per i partecipanti alle prove di origine e altre ancora solo per i partecipanti al programma Early Preview.

Ogni API ha il proprio insieme di istruzioni per iniziare e scaricare il modello, sia per la prototipazione locale sia negli ambienti di produzione con le prove di origine.

Tutte queste API possono essere utilizzate durante la creazione di estensioni di Chrome.

Download modello

Le API sono integrate in Chrome, così come i modelli. La prima volta che un utente interagisce con queste API, il modello deve essere scaricato nel browser.

Per determinare se un'API è utilizzabile e pronta, chiama la funzione asincrona availability(), che restituisce una promessa con uno dei seguenti valori:

  • "unavailable": Il dispositivo dell'utente o le opzioni di sessione richieste non sono supportati. Il dispositivo potrebbe non avere alimentazione o spazio su disco sufficienti.
  • "downloadable": Per creare una sessione sono necessari download aggiuntivi, che possono includere un modello esperto, un modello linguistico o un perfezionamento. Per chiamare create() potrebbe essere necessaria l'attivazione dell'utente.
  • "downloading": i download sono in corso e devono essere completati prima di poter utilizzare una sessione.
  • "available": puoi creare una sessione immediatamente.

Alcune API richiedono opzioni aggiuntive quando chiamano la disponibilità. Ad esempio, l'API Prompt richiede la dichiarazione del supporto linguistico:

// Makes sure the model is available for English and Japanese.
await LanguageModel.availability({ languages: ["en", "ja"] });

Attivazione utente

Se il dispositivo supporta le API AI integrate, ma il modello non è ancora stato scaricato, l'utente deve interagire in modo significativo con la tua pagina affinché la tua applicazione avvii una sessione con create().

Utilizza la proprietà UserActivation.isActive per confermare che un utente ha interagito direttamente con la pagina dopo che il caricamento è terminato. Questi possono includere un tocco, un clic, la pressione di un tasto, mousedown o altri eventi di attivazione persistente.

// Check for user activation.
if (navigator.userActivation.isActive) {
  // Create an instance of a built-in API
}

Ad esempio, con l'API Summarizer, potresti chiedere agli utenti di interagire con un pulsante con il testo "Riepiloga" per attivare Summarizer.create() oppure puoi creare il riepilogo quando un utente inizia a digitare, un evento keydown.

Utilizzare le API su localhost

Tutte le API sono disponibili su localhost in Chrome.

  1. Vai a chrome://flags/#optimization-guide-on-device-model.
  2. Seleziona Attivata.
  3. Fai clic su Riavvia o riavvia Chrome.

Per le API che utilizzano Gemini Nano, devi anche impostare chrome://flags/#prompt-api-for-gemini-nano su Attivato o Attivato multilingue. Puoi verificare che il modello sia stato scaricato e funzioni come previsto nella console DevTools. Esegui await LanguageModel.availability(); nella console.

Risolvere i problemi relativi a localhost

Se i flag non vengono visualizzati in chrome://flags, assicurati di aver scaricato l'ultima versione di Chrome.

Se il modello non funziona come previsto, segui questi passaggi:

  1. Riavvia Chrome.
  2. Vai a chrome://on-device-internals.
  3. Seleziona la scheda Stato modello e assicurati che non siano presenti errori.
  4. Apri DevTools e digita LanguageModel.availability(); nella console. La query dovrebbe restituire available.

Se necessario, attendi un po' di tempo e ripeti questi passaggi.

Procedura per gli standard

Stiamo lavorando per standardizzare queste API, in modo che funzionino su tutti i browser. Ciò significa che abbiamo proposto le API alla community delle piattaforme web e le abbiamo trasferite al W3C Web Incubator Community Group per ulteriori discussioni.

Stiamo richiedendo feedback a W3C, Mozilla e WebKit per ogni API.

Partecipare e condividere feedback

Se provi l'AI integrata e hai un feedback, ci farebbe piacere riceverlo.