Inizia a utilizzare l'IA integrata

Alexandra Klepper
Alexandra Klepper
GitHub Bluesky

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

Grazie alle 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, sono necessari 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 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

Su Chrome, il modello linguistico è Gemini Nano. Gemini Nano non è disponibile sui dispositivi mobili.

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

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: rigorosamente più di 4 GB di VRAM.
  • 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 nella versione stabile di Chrome, altre sono disponibili 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.

Attivazione utente

Se il dispositivo potrebbe supportare le API AI integrate, ma il modello non è ancora disponibile, è necessaria un'interazione dell'utente per avviare una sessione con create().

Utilizza la proprietà UserActivation.isActive per confermare l'attivazione di un utente, che potrebbe essere un clic, un tocco o la pressione di un tasto.

// 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 il pulsante "Riepiloga" per attivare Summarizer.create().

Utilizzare le API su localhost

Tutte le API sono disponibili su localhost in Chrome.

  1. Vai a chrome://flags/#prompt-api-for-gemini-nano-multimodal-input.
  2. Seleziona Attivata.
  3. Fai clic su Riavvia o riavvia Chrome.

Per verificare che Gemini Nano sia stato scaricato e funzioni come previsto, apri DevTools e digita await LanguageModel.availability(); nella console. Questa operazione dovrebbe restituire available.

Risolvere i problemi relativi a localhost

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, saremo felici di riceverlo.