Log e set di dati

Questa guida contiene tutto il necessario per iniziare ad abilitare la registrazione per le applicazioni API Gemini esistenti. In questa guida imparerai a visualizzare i log di un'applicazione esistente o nuova nella dashboard di Google AI Studio per comprendere meglio il comportamento del modello e il modo in cui gli utenti potrebbero interagire con le tue applicazioni. Utilizza la registrazione per osservare, eseguire il debug e facoltativamente condividere il feedback sull'utilizzo con Google per contribuire a migliorare Gemini in tutti i casi d'uso degli sviluppatori.*

Sono supportate tutte le chiamate API GenerateContent e StreamGenerateContent, incluse quelle effettuate tramite gli endpoint di compatibilità di OpenAI.

1. Abilitare la registrazione in Google AI Studio

Prima di iniziare, assicurati di avere un progetto di tua proprietà con la fatturazione abilitata.

  1. Apri la pagina dei log in Google AI Studio.
  2. Scegli il progetto dal menu a discesa e premi il pulsante di attivazione per abilitare la registrazione per tutte le richieste per impostazione predefinita.

Puoi attivare o disattivare la registrazione per tutti i progetti o per progetti specifici e modificare queste preferenze in qualsiasi momento tramite Google AI Studio.

2. Visualizzare i log in AI Studio

  1. Vai ad AI Studio.
  2. Seleziona il progetto per cui hai abilitato la registrazione.
  3. Dovresti vedere i log visualizzati nella tabella in ordine cronologico inverso.

Fai clic su una voce per visualizzare la coppia richiesta-risposta in una visualizzazione di pagina intera. Puoi esaminare il prompt completo, la risposta completa di Gemini e il contesto del turno precedente. Tieni presente che ogni progetto ha un limite di spazio di archiviazione predefinito di un massimo di 1000 log e che i log non salvati nei set di dati scadranno dopo 55 giorni. Se il tuo progetto raggiunge il limite di spazio di archiviazione, ti verrà chiesto di eliminare i log.

3. Selezionare e condividere i set di dati

  • Nella tabella dei log, individua la barra dei filtri in alto per selezionare una proprietà in base alla quale filtrare.
  • Nella visualizzazione filtrata dei log, utilizza le caselle di controllo per selezionare tutti o alcuni log.
  • Fai clic sul pulsante "Crea set di dati" visualizzato nella parte superiore dell'elenco.
  • Assegna al nuovo set di dati un nome descrittivo e una descrizione facoltativa.
  • Verrà visualizzato il set di dati appena creato con il set di log selezionato.
  • Esporta il set di dati per ulteriori analisi come file CSV, JSONL o in Fogli Google.

I set di dati possono essere utili per diversi casi d'uso.

  • Selezionare set di sfide: promuovi miglioramenti futuri che riguardano le aree in cui vuoi che la tua AI migliori.
  • Selezionare set di esempi: ad esempio, un campione di utilizzo reale per generare risposte da un altro modello o una raccolta di casi limite per i controlli di routine prima del deployment.
  • Set di valutazione: set rappresentativi dell'utilizzo reale in tutte le funzionalità importanti, per il confronto tra altri modelli o iterazioni delle istruzioni di sistema.

Puoi contribuire a promuovere i progressi nella ricerca sull'AI, nell'API Gemini e in Google AI Studio scegliendo di condividere i tuoi set di dati come esempi dimostrativi. In questo modo possiamo perfezionare i nostri modelli in contesti diversi e creare sistemi di AI che rimangano utili agli sviluppatori in molti campi e applicazioni.

Passaggi successivi e cosa testare

Ora che hai abilitato la registrazione, ecco alcune cose da provare:

  • Creare prototipi con la cronologia delle sessioni: utilizza AI Studio Build per creare app di codice e aggiungi la chiave API per abilitare una cronologia dei log utente.
  • Eseguire di nuovo i log con l'API Gemini Batch: utilizza i set di dati per il campionamento delle risposte e la valutazione dei modelli o della logica dell'applicazione eseguendo di nuovo i log tramite l'API Gemini Batch.

Compatibilità

Al momento, la registrazione non è supportata per:

  • Modelli Imagen e Veo
  • Modello di incorporamento Gemini
  • Input contenenti video, GIF o PDF