Logs und Datasets

In dieser Anleitung erfahren Sie, wie Sie Protokolle zur Nutzung der Gemini API im Google AI Studio-Dashboard aufrufen können, um das Modellverhalten und die Interaktion von Nutzern mit Ihren Anwendungen besser nachzuvollziehen. Mit der Protokollierung können Sie die Nutzung beobachten, Fehler beheben und optional Feedback zur Nutzung an Google senden, um Gemini für Entwickleranwendungsfälle zu verbessern.^*

Alle GenerateContent-, BatchGenerateContent- und StreamGenerateContent-API-Aufrufe sowie Interactions-API-Aufrufe mit Ausnahme von Managed Agents werden unterstützt. Dazu gehören auch Aufrufe über Endpunkte mit OpenAI-Kompatibilität.

*Hinweis: Speicher für Gemini API-Logs ist nur für Projekte mit dem kostenpflichtigen Gemini API-Tarif verfügbar.

Projekt-Logging konfigurieren

Standardmäßig werden alle Interaktionsobjekte (store=true) in der API gespeichert, um die Verwendung serverseitiger Funktionen zur Statusverwaltung zu vereinfachen. Im Gegensatz dazu werden Anfragen an die Generate Content API standardmäßig nicht gespeichert. Die Speicherung muss pro Anfrage oder auf Projektebene in AI Studio aktiviert werden.

In AI Studio können Sie die Protokollierung für alle oder bestimmte Projekte aktivieren oder deaktivieren und diese Einstellungen jederzeit über den Bereich Einstellungen auf der Seite Logs und Datasets ändern. Die Protokollierung kann für die generateContent API und die Interactions API unabhängig voneinander aktiviert oder deaktiviert werden, um das standardmäßige Speicherverhalten für ein Projekt zu ändern.

Logging auf Anfrageebene

Das Speicher- und Logging-Verhalten unterscheidet sich je nach API:

• Interactions API:Anfragen werden standardmäßig gespeichert (store=true), um die serverseitige Statusverwaltung zu vereinfachen.
• Generate Content API (generateContent): Anfragen werden standardmäßig nicht gespeichert (store=false).

So legen Sie die Property store fest:

generateContent API

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);

Interactions API

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);

Projektlogs in AI Studio ansehen

1. Rufen Sie in AI Studio die Seite „Logs“ auf.
2. Wählen Sie ein Projekt aus dem Drop-down-Menü aus.
3. Logs für die Interactions API werden in der Tabelle in umgekehrter chronologischer Reihenfolge angezeigt, sofern sie vorhanden sind.
4. Wenn Sie Projektlogs für die Generate Content API aufrufen möchten, müssen Sie diese zuerst im Einstellungsfeld aktivieren.

Klicken Sie auf einen Eintrag, um eine Vorschau der Nutzlast aufzurufen. Sie können sich den vollständigen Prompt und die Antwort von Gemini sowie den Kontext aus den vorherigen Zügen ansehen. Bei Anfragen an die Interactions API enthalten die Logs auch einen direkten Link zu previous_interaction_id.

Projektspeicheraufbewahrung konfigurieren

Logs laufen nach einem standardmäßigen Aufbewahrungszeitraum von 55 Tagen ab und werden zum Löschen markiert, sofern sie nicht in einem Dataset gespeichert wurden. In diesem Fall laufen sie nicht ab. Sie können das Aufbewahrungsfenster für die Logs eines Projekts auf maximal 7, 14, 28 oder 55 Tage konfigurieren.

Datasets erstellen und freigeben

Sie können Logs in Datasets speichern, um sie besser zu organisieren und zu exportieren.

• Suchen Sie auf der Seite Logs oben nach der Filterleiste, um ein Attribut auszuwählen, nach dem gefiltert werden soll.
• Wählen Sie in der gefilterten Ansicht mit den Kästchen alle oder einzelne Logs aus.
• Klicken Sie oben in der Liste auf den Button Dataset erstellen.
• Geben Sie einen Namen und optional eine Beschreibung für das neue Dataset ein.
• Sie sehen das gerade erstellte Dataset mit der kuratierten Gruppe von Logs.
• Sie können Ihr Dataset für die weitere Analyse als CSV- oder JSONL-Datei oder in Google Tabellen exportieren.

Datasets können für eine Reihe verschiedener Anwendungsfälle hilfreich sein.

• Herausforderungssätze zusammenstellen:Damit können Sie zukünftige Verbesserungen in Bereichen vorantreiben, in denen Sie die KI optimieren möchten.
• Beispielsets zusammenstellen:Sie können beispielsweise ein Beispiel aus der tatsächlichen Nutzung verwenden, um Antworten von einem anderen Modell zu generieren, oder eine Sammlung von Grenzfallbeispielen für Routineprüfungen vor der Bereitstellung.
• Evaluierungssätze:Sätze, die die tatsächliche Nutzung wichtiger Funktionen repräsentieren und für den Vergleich mit anderen Modellen oder Systemanweisungsiterationen verwendet werden.

Sie können zur Forschung und Entwicklung von Gemini beitragen, indem Sie Ihre Datasets als Demonstrationsbeispiele mit Google teilen.

Beschränkungen

Logging wird derzeit für Folgendes nicht unterstützt:

• Imagen- und Veo-Modelle
• Gemini-Einbettungsmodelle
• Gemini Robotics-Modell
• Eingaben mit Videos, GIFs oder PDFs
• KI-Agenten in der öffentlichen Vorschau in der Gemini API

Nächste Schritte

• Prototyp mit Sitzungsverlauf erstellen:Mit AI Studio Build können Sie Apps per Vibe Coding erstellen und Ihren API-Schlüssel hinzufügen, um einen Verlauf von Gemini API-Logs für KI-Funktionen zu aktivieren.
• Logs mit der Gemini Batch API noch einmal ausführen:Mit Datasets können Sie Antworten stichprobenartig erfassen und Modelle oder Anwendungslogik bewerten, indem Sie Logs mit der Gemini Batch API noch einmal ausführen.