Journaux et ensembles de données

Ce guide explique comment afficher les journaux d'utilisation de l'API Gemini dans le tableau de bord Google AI Studio pour mieux comprendre le comportement du modèle et la façon dont les utilisateurs peuvent interagir avec vos applications. Utilisez la journalisation pour observer, déboguer et partager éventuellement des commentaires sur l'utilisation avec Google afin d'améliorer Gemini dans les cas d'utilisation des développeurs.^*

Tous les appels d'API GenerateContent, BatchGenerateContent, StreamGenerateContent et les appels d'API Interactions sont compatibles, à l'exception des Managed Agents. Cela inclut les appels effectués via des points de terminaison de compatibilité OpenAI.

*Remarque : Le stockage des journaux de l'API Gemini n'est disponible que pour les projets du niveau payant de l'API Gemini.

Configurer la journalisation du projet

Par défaut, l'API stocke tous les objets d'interaction (store=true) afin de simplifier l'utilisation des fonctionnalités de gestion de l'état côté serveur. En revanche, l'API Generate Content ne stocke pas les requêtes par défaut et nécessite que le stockage soit activé par requête ou au niveau du projet à partir d'AI Studio.

Dans Google AI Studio, vous pouvez activer ou désactiver la journalisation pour tous les projets ou pour des projets spécifiques, et modifier ces préférences à tout moment via le panneau Paramètres de la page Journaux et ensembles de données. La journalisation peut être activée ou désactivée indépendamment pour l'API generateContent et l' API Interactions afin de modifier le comportement de stockage par défaut d'un projet.

Journalisation au niveau de la requête

Le comportement de stockage et de journalisation diffère selon l'API :

• API Interactions: stocke les requêtes par défaut (store=true) pour simplifier la gestion de l'état côté serveur.
• API Generate Content (generateContent) : ne stocke pas les requêtes par défaut (store=false).

Voici comment définir la propriété store :

API generateContent

from google import genai

client = genai.Client()

response = client.models.generate_content(
    model='gemini-3.5-flash',
    contents='Explain quantum entanglement in simple terms.',
    config={'store': False} # Set to True to enable logging of this request
)

print(response.text)

import { GoogleGenAI } from '@google/genai';

const client = new GoogleGenAI({});

const response = await client.models.generateContent({
    model: 'gemini-3.5-flash',
    contents: 'Explain quantum entanglement in simple terms.',
    config: {
        store: false // Set to true to enable logging of this request
    }
});

console.log(response.text);

API Interactions

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    model="gemini-3.5-flash",
    input="Explain quantum entanglement in simple terms.",
    store=True # Set to False to disable logging of this request
)

print(interaction.outputs[-1].text)

import { GoogleGenAI } from '@google/genai';

const client = new GoogleGenAI({});

const interaction = await client.interactions.create({
    model: 'gemini-3.5-flash',
    input: 'Explain quantum entanglement in simple terms.',
    store: true // Set to false to disable logging of this request
});

console.log(interaction.outputs[interaction.outputs.length - 1].text);

Afficher les journaux du projet dans AI Studio

1. Accédez à la page "Journaux" dans AI Studio.
2. Sélectionnez un projet dans la liste déroulante.
3. Les journaux s'affichent dans le tableau dans l'ordre chronologique inverse pour l'API Interactions, s'ils existent.
4. Pour observer les journaux du projet pour l'API Generate Content, activez-la d'abord dans le panneau des paramètres.

Cliquez sur une entrée pour obtenir un aperçu de la charge utile. Vous pouvez inspecter le prompt et la réponse complets de Gemini, ainsi que le contexte des tours précédents. Pour les requêtes de l'API Interactions, les journaux incluent également un lien direct vers le previous_interaction_id.

Configurer la durée de conservation du stockage du projet

Les journaux expirent et sont marqués pour suppression après une période de conservation par défaut de 55 jours (sauf s'ils sont enregistrés dans un ensemble de données, qui n'expire pas). Vous pouvez configurer la période de conservation des journaux d'un projet sur 7, 14, 28 ou 55 jours maximum.

Créer et partager des ensembles de données

Vous pouvez enregistrer des journaux dans des ensembles de données pour les organiser et les exporter plus efficacement.

• Sur la page Journaux, recherchez la barre de filtre en haut de la page pour sélectionner une propriété à filtrer.
• Dans la vue filtrée, cochez les cases pour sélectionner tous les journaux ou des journaux individuels.
• Cliquez sur le bouton Créer un ensemble de données qui s'affiche en haut de la liste.
• Attribuez un nom et éventuellement une description à votre nouvel ensemble de données.
• L'ensemble de données que vous venez de créer s'affiche avec l'ensemble de journaux organisé.
• Exportez votre ensemble de données pour une analyse plus approfondie au format CSV, JSONL ou dans Google Sheets.

Les ensembles de données peuvent être utiles dans de nombreux cas d'utilisation différents.

• Organiser des ensembles de défis : générez des améliorations futures ciblant les domaines dans lesquels vous souhaitez que votre IA s'améliore.
• Organiser des ensembles d'exemples : par exemple, un échantillon d'utilisation réelle pour générer des réponses à partir d'un autre modèle, ou une collection de cas extrêmes pour des vérifications de routine avant le déploiement.
• Ensembles d'évaluation : ensembles représentatifs de l'utilisation réelle dans des fonctionnalités importantes, pour la comparaison entre d'autres modèles ou itérations d'instructions système.

Vous pouvez contribuer à la recherche et au développement de Gemini en choisissant de partager vos ensembles de données avec Google en tant qu'exemples de démonstration.

Limites

La journalisation n'est actuellement pas compatible avec les éléments suivants :

• Modèles Imagen et Veo
• Modèles d'embedding Gemini
• Modèle Gemini Robotics
• Entrées contenant des vidéos, des GIF ou des PDF
• Agents en aperçu public dans l'API Gemini

Étape suivante

• Créer un prototype avec l'historique des sessions : utilisez AI Studio Build pour coder des applications et ajoutez votre clé API afin d'activer un historique des journaux de l'API Gemini pour les fonctionnalités d'IA.
• Réexécuter les journaux avec l'API Gemini Batch : utilisez des ensembles de données pour l'échantillonnage des réponses et l'évaluation des modèles ou de la logique d'application en réexécutant les journaux avec l' API Gemini Batch.