Logi i zbiory danych

Z tego przewodnika dowiesz się, jak wyświetlać logi dotyczące korzystania z Gemini API na panelu Google AI Studio, aby lepiej zrozumieć zachowanie modelu i sposób, w jaki użytkownicy mogą wchodzić w interakcje z Twoimi aplikacjami. Używaj logowania do obserwowania, debugowania i opcjonalnego udostępniania opinii o użytkowaniu Google, aby pomóc w ulepszaniu Gemini w różnych przypadkach użycia przez deweloperów.^*

Obsługiwane są wszystkie wywołania interfejsu API GenerateContent, BatchGenerateContent, StreamGenerateContent oraz wywołania interfejsu Interactions API z wyłączeniem zarządzanych agentów. Obejmuje to wywołania wykonywane za pomocą punktów końcowych zgodnych z OpenAI.

*Uwaga: miejsce na logi Gemini API jest dostępne tylko w przypadku projektów w ramach płatnego abonamentu Gemini API.

Konfigurowanie logowania projektu

Domyślnie interfejs API przechowuje wszystkie obiekty interakcji (store=true), aby uprościć korzystanie z funkcji zarządzania stanem po stronie serwera. Natomiast interfejs Generate Content API domyślnie nie przechowuje żądań i wymaga włączenia przechowywania na poziomie żądania lub projektu w AI Studio.

W Google AI Studio możesz włączyć lub wyłączyć logowanie we wszystkich projektach lub w określonych projektach oraz w dowolnym momencie zmienić te ustawienia w panelu Ustawienia na stronie Logi i zbiory danych. Logowanie można włączać i wyłączać niezależnie w przypadku interfejsu generateContent API i Interactions API aby zmienić domyślne zachowanie przechowywania w projekcie.

Logowanie na poziomie żądania

Zachowanie związane z przechowywaniem i logowaniem różni się w zależności od interfejsu API:

• Interactions API: domyślnie przechowuje żądania (store=true), aby uprościć zarządzanie stanem po stronie serwera.
• Generate Content API (generateContent): domyślnie nie przechowuje żądań (store=false).

Oto jak możesz ustawić właściwość store:

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

Wyświetlanie logów projektu w AI Studio

1. Otwórz stronę Logi w AI Studio.
2. W menu wybierz projekt.
3. Jeśli istnieją logi dotyczące Interactions API, pojawią się w tabeli w odwrotnej kolejności chronologicznej.
4. Aby obserwować logi projektu dotyczące interfejsu Generate Content API, najpierw włącz tę opcję w panelu ustawień.

Kliknij wpis, aby wyświetlić podgląd ładunku. Możesz sprawdzić pełny prompt i odpowiedź z Gemini oraz kontekst z poprzednich tur. W przypadku żądań Interactions API logi zawierają też bezpośredni link do previous_interaction_id.

Konfigurowanie przechowywania logów projektu

Logi wygasną i zostaną oznaczone do usunięcia po domyślnym okresie przechowywania wynoszącym 55 dni (chyba że zostaną zapisane w zbiorze danych, który nie wygasa). Okres przechowywania logów projektu możesz skonfigurować na maksymalnie 7, 14, 28 lub 55 dni.

Tworzenie i udostępnianie zbiorów danych

Logi możesz zapisywać w zbiorach danych, aby je lepiej porządkować i eksportować.

• Na stronie Logi znajdź pasek filtrowania u góry, aby wybrać właściwość, według której chcesz filtrować.
• W przefiltrowanym widoku użyj pól wyboru, aby zaznaczyć wszystkie lub poszczególne logi.
• Kliknij przycisk Utwórz zbiór danych , który pojawi się u góry listy.
• Nadaj nowemu zbiorowi danych nazwę i opcjonalny opis.
• Zobaczysz utworzony zbiór danych z wybranym zestawem logów.
• Wyeksportuj zbiór danych do dalszej analizy jako pliki CSV lub JSONL albo do Arkuszy Google.

Zbiory danych mogą być przydatne w wielu różnych przypadkach użycia.

• Tworzenie zestawów wyzwań: wprowadzaj przyszłe ulepszenia w obszarach, w których chcesz, aby Twoja sztuczna inteligencja działała lepiej.
• Tworzenie zestawów próbek: na przykład próbka z rzeczywistego użycia do generowania odpowiedzi z innego modelu lub zbiór przypadków brzegowych do rutynowych kontroli przed wdrożeniem.
• Zestawy do oceny: zestawy reprezentujące rzeczywiste użycie w ważnych funkcjach, do porównania z innymi modelami lub iteracjami instrukcji systemowych.

Możesz przyczynić się do badań i rozwoju Gemini, udostępniając Google swoje zbiory danych jako przykłady demonstracyjne.

Ograniczenia

Logowanie nie jest obecnie obsługiwane w przypadku:

• modeli Imagen i Veo,
• modeli osadzania Gemini,
• modelu Gemini Robotics,
• danych wejściowych zawierających filmy, GIF-y lub pliki PDF,
• agentów w wersji testowej w Gemini API.

Co dalej?

• Prototypowanie z historią sesji: użyj AI Studio Build, aby tworzyć aplikacje z kodem i dodać klucz interfejsu API, który umożliwi korzystanie z historii logów Gemini API w funkcjach AI.
• Ponowne uruchamianie logów za pomocą Gemini Batch API: używaj zbiorów danych do próbkowania odpowiedzi i oceny modeli lub logiki aplikacji, ponownie uruchamiając logi za pomocą Gemini Batch API.