Registros y conjuntos de datos

En esta guía, aprenderás a ver los registros del uso de la API de Gemini en el panel de Google AI Studio para comprender mejor el comportamiento del modelo y cómo los usuarios pueden interactuar con tus aplicaciones. Usa el registro para observar, depurar y compartir de forma opcional comentarios sobre el uso con Google para ayudar a mejorar Gemini en los casos de uso de los desarrolladores.^*

Se admiten todas las llamadas a las APIs de GenerateContent, BatchGenerateContent y StreamGenerateContent, y las llamadas a la API de Interactions, excepto las de los agentes administrados. Esto incluye las llamadas realizadas a través de los extremos de compatibilidad con OpenAI.

*Nota: El almacenamiento de los registros de la API de Gemini solo está disponible para los proyectos en el nivel pagado de la API de Gemini.

Configura el registro del proyecto

De forma predeterminada, la API almacena todos los objetos de interacción (store=true) para simplificar el uso de las funciones de administración de estados del servidor. Por el contrario, la API de Generate Content no almacena solicitudes de forma predeterminada y requiere que el almacenamiento se habilite por solicitud o a nivel del proyecto desde AI Studio.

En AI Studio de Google, puedes habilitar o inhabilitar el registro para todos los proyectos o para proyectos específicos, y cambiar estas preferencias en cualquier momento a través del panel Configuración en la página Registros y conjuntos de datos. El registro se puede activar o desactivar de forma independiente para la API de generateContent y la API de Interactions para cambiar el comportamiento de almacenamiento predeterminado de un proyecto.

Registro a nivel de la solicitud

El comportamiento de almacenamiento y registro varía según la API:

• API de Interactions: Almacena solicitudes de forma predeterminada (store=true) para simplificar la administración del estado del servidor.
• Generate Content API (generateContent): No almacena solicitudes de forma predeterminada (store=false).

Así puedes configurar la propiedad store:

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

Cómo ver los registros del proyecto en AI Studio

1. Ve a la página Registros en AI Studio.
2. Selecciona un proyecto en el menú desplegable.
3. Si existen, los registros aparecerán en la tabla en orden cronológico inverso para la API de Interactions.
4. Para observar los registros del proyecto de la API de Generate Content, primero habilita esta opción en el panel de configuración.

Haz clic en una entrada para obtener una vista previa de la carga útil. Puedes inspeccionar la instrucción y la respuesta completas de Gemini, así como el contexto de los turnos anteriores. En el caso de las solicitudes a la API de Interactions, los registros también incluyen un vínculo directo a previous_interaction_id.

Configura la retención del almacenamiento del proyecto

Los registros vencerán y se marcarán para su eliminación después de un período de retención predeterminado de 55 días (a menos que se guarden en un conjunto de datos, en cuyo caso no vencerán). Puedes configurar el período de retención de los registros de un proyecto en un máximo de 7, 14, 28 o 55 días.

Crea y comparte conjuntos de datos

Puedes guardar los registros en conjuntos de datos para organizarlos y exportarlos de manera más eficaz.

• En la página Registros, busca la barra de filtros en la parte superior para seleccionar una propiedad por la que filtrar.
• En la vista filtrada, usa las casillas de verificación para seleccionar todos los registros o registros individuales.
• Haz clic en el botón Crear conjunto de datos que aparece en la parte superior de la lista.
• Asigna un nombre y una descripción opcional a tu nuevo conjunto de datos.
• Verás el conjunto de datos que acabas de crear con el conjunto seleccionado de registros.
• Exporta tu conjunto de datos para realizar un análisis más detallado como archivos CSV, JSONL o a Hojas de cálculo de Google.

Los conjuntos de datos pueden ser útiles para varios casos de uso diferentes.

• Selecciona conjuntos de desafíos: Impulsa mejoras futuras que se enfoquen en las áreas en las que deseas que mejore tu IA.
• Selecciona conjuntos de muestras: Por ejemplo, una muestra del uso real para generar respuestas a partir de otro modelo o una colección de casos extremos para las verificaciones de rutina antes de la implementación.
• Conjuntos de evaluación: Son conjuntos representativos del uso real en las capacidades importantes, para la comparación entre otros modelos o iteraciones de instrucciones del sistema.

Puedes contribuir a la investigación y el desarrollo de Gemini compartiendo tus conjuntos de datos con Google como ejemplos de demostración.

Limitaciones

Por el momento, no se admite el registro para lo siguiente:

• Modelos de Imagen y Veo
• Modelos de incorporación de Gemini
• Modelo de Gemini Robotics
• Entradas que contienen videos, GIFs o PDFs
• Agentes en versión preliminar pública en la API de Gemini

¿Qué sigue?

• Crea prototipos con el historial de sesiones: Usa AI Studio Build para crear apps con vibe coding y agrega tu clave de API para habilitar un historial de registros de la API de Gemini para las funciones basadas en IA.
• Vuelve a ejecutar los registros con la API de Gemini Batch: Usa conjuntos de datos para el muestreo de respuestas y la evaluación de modelos o la lógica de la aplicación. Para ello, vuelve a ejecutar los registros con la API de Gemini Batch.