Inizia a utilizzare l'IA integrata

AI_USAGE=false

Alexandra Klepper

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, esistono requisiti di modello e hardware.

Modelli

Le API Prompt, Summarizer, Writer e Rewriter scaricano un modello linguistico di grandi dimensioni progettato per essere eseguito localmente su computer desktop e laptop. Queste API non funzionano sui dispositivi mobili. Prima di utilizzare queste API, accetta le Norme relative all'uso vietato dell'AI generativa di Google.

Le API Summarizer, Writer e Rewriter supportano solo la modalità da testo a testo. L'API Prompt ha funzionalità multimodali disponibili per la prototipazione locale per i partecipanti al programma di anteprima iniziale.

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. L'API Prompt, l'API Summarizer, l'API Writer e l'API Rewriter funzionano in Chrome quando sono soddisfatte le seguenti condizioni:

  • Sistema operativo: Windows 10 o 11; macOS 13+ (Ventura e versioni successive); o Linux. Chrome per Android, iOS e ChromeOS non è ancora supportato 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 chrome://on-device-internals e vai a Stato modello. Apri il Percorso file elencato per determinare le dimensioni del modello.

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

Per scaricare i modelli e le configurazioni necessari nel browser è necessaria un'interazione dell'utente. Se il tuo sito web o la tua applicazione web è il primo incontro di un utente con una specifica API AI integrata, è necessaria un'interazione utente temporanea 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 "Riassumi" 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.
  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://components.
  3. Verifica che sia presente la Guida all'ottimizzazione sul modello di dispositivo. Ciò significa che Gemini Nano è disponibile o in fase di download.
    • Se non è elencato alcun numero di versione, fai clic su Controlla aggiornamenti per forzare il download.
  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.