Journaux et ensembles de données

Dans ce guide, vous allez apprendre à afficher les journaux d'utilisation de l'API Gemini dans le tableau de bord Google AI Studio. Vous pourrez ainsi mieux comprendre le comportement des modèles et la façon dont les utilisateurs interagissent 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 pour les cas d'utilisation des développeurs^*.

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

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. Le stockage doit être activé pour chaque requête ou au niveau du projet depuis 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 dans le panneau Paramètres de la page Journaux et ensembles de données. Vous pouvez activer ou désactiver la journalisation 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.
• Générer du contenu API (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 le menu déroulant.
3. Le cas échéant, les journaux s'affichent dans le tableau dans l'ordre chronologique inverse pour l'API Interactions.
4. Pour observer les journaux du projet pour l'API Generate Content, commencez par l'activer dans le panneau des paramètres.

Cliquez sur une entrée pour obtenir un aperçu de la charge utile. Vous pouvez inspecter l'intégralité du prompt et de la réponse 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 previous_interaction_id.

Configurer la durée de conservation du stockage d'un 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, auquel cas ils n'expirent 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 les journaux dans des ensembles de données pour les organiser et les exporter plus efficacement.

• Sur la page "Journaux", recherchez la barre de filtres en haut de la page et sélectionnez une propriété à filtrer.
• Dans votre vue filtrée, utilisez les cases à cocher pour sélectionner tous les journaux ou certains d'entre eux.
• 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 sélectionnés.
• Exportez votre ensemble de données pour une analyse plus approfondie au format CSV ou JSONL, ou vers Google Sheets.

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

• Organisez des ensembles de défis : favorisez les améliorations futures dans les domaines où vous souhaitez que votre IA progresse.
• Organisez des ensembles d'échantillons : 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 les vérifications de routine avant le déploiement.
• Ensembles d'évaluation : ensembles représentatifs de l'utilisation réelle des fonctionnalités importantes, permettant de comparer les modèles ou les 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 à titre d'exemples.

Limites

La journalisation n'est actuellement pas disponible pour 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 version Preview publique dans l'API Gemini

Étape suivante

• Prototyper 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.