Habilita los registros de auditoría de acceso a los datos

Para obtener registros de auditoría sobre el uso de tus modelos generativos y extremos de modelos, habilita los registros de auditoría de acceso a los datos para Gemini Enterprise Agent Platform. Los registros de auditoría de acceso a los datos incluyen operaciones de ADMIN_READ que leen metadatos o información de configuración, así como operaciones de DATA_READ y DATA_WRITE que leen o escriben datos proporcionados por el usuario.

Después de habilitar los registros de auditoría de acceso a los datos para Agent Platform, otorga el rol de visualizador de registros privados (roles/logging.privateLogViewer) para ver el flujo de registros de data_access (projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Fdata_access) en Cloud Logging en la consola de Google Cloud .

Para obtener instrucciones sobre cómo habilitar y ver los registros de auditoría de acceso a los datos, consulta Información de registro de auditoría de Agent Platform.

Operaciones de modelos generativos auditadas

Cuando habilitas los registros de auditoría de DATA_READ para aiplatform.googleapis.com, Agent Platform registra las entradas de registro de auditoría de acceso a los datos para las siguientes operaciones de modelo generativo y predicción en los modelos de publicador (publishers.models.*) y los extremos implementados (endpoints.*):

  • Generación de contenido y chat: generateContent, streamGenerateContent y chatCompletions

  • Embeddings: embedContent y batchEmbedContents

  • Recuento de tokens: countTokens y computeTokens

  • Predicción y explicación en línea: predict, rawPredict, streamRawPredict, directPredict, directRawPredict, streamDirectPredict, streamDirectRawPredict, serverStreamingPredict, predictLongRunning, fetchPredictOperation y explain

Para obtener la lista completa de los métodos auditados en todas las categorías, consulta Información de los registros de auditoría de Agent Platform.

Autenticación y atribución del emisor

El método de autenticación que usa tu aplicación determina cómo los registros de auditoría de DATA_READ registran la identidad del emisor (protoPayload.authenticationInfo.principalEmail) y la dirección IP (protoPayload.requestMetadata.callerIp):

  • Principales de credenciales predeterminadas de la aplicación (ADC) y de Identity and Access Management (IAM): Las solicitudes autenticadas con ADC, credenciales de usuario o cuentas de servicio específicas de la carga de trabajo registran la dirección IP del emisor (callerIp) y la principal autenticada del emisor individual (principalEmail) en los registros de auditoría de DATA_READ. Usa ADC cuando necesites una atribución de auditoría por usuario o por carga de trabajo en producción.

  • Claves de API Google Cloud estándar: Las claves de API Google Cloud estándar autentican las llamadas a la API a través de una sola cuenta de servicio vinculada. Los registros de auditoría de DATA_READ registran la dirección IP del emisor (callerIp), pero atribuyen principalEmail a esa única cuenta de servicio vinculada para cada solicitud realizada con la clave de API, en lugar de a usuarios o cargas de trabajo individuales.

  • Claves de API del modo Exprés: Las solicitudes enviadas en el modo Exprés se dirigen a extremos sin proyecto y no generan registros de auditoría de DATA_READ accesibles para los clientes en Logging.

Compara los registros de auditoría y los registros de inferencia

Agent Platform proporciona varios mecanismos de registro para la inferencia de modelos. En la siguiente tabla, se comparan los registros de auditoría de acceso a los datos (DATA_READ) con otras opciones de registro de inferencia:

Función de registro Destino Campos grabados Cargas útiles de instrucciones y respuestas IP del emisor y principal de IAM
Registros de auditoría de acceso a los datos (DATA_READ) Registro (cloudaudit.googleapis.com%2Fdata_access) Nombre del método de la API, modelo de destino o recurso de extremo, y metadatos de la solicitud No se registró Registra callerIp y principalEmail (o la cuenta de servicio vinculada para las claves de API estándar).
Registros de metadatos de solicitudes de inferencia Registro (aiplatform.googleapis.com%2Finference_request) Recuentos de tokens (usageMetadata), latencia de solicitudes (requestDuration), opción de consumo (trafficType) y encabezados personalizados (httpHeaders) No se registró Registra la cuenta de servicio (principal, cuando está disponible); no registra callerIp
Registro de solicitud-respuesta Tabla de BigQuery Solicitudes de inferencia, respuestas, recuentos de tokens y metadatos de latencia muestreados Registra las cargas útiles full_request y full_response No se graban callerIp ni principalEmail
Registros de acceso y de contenedores de inferencia en línea Registro (prediction_access y prediction_container) Estado de acceso, latencia y transmisiones de stdout y stderr del contenedor del extremo para los modelos de AutoML y de entrenamiento personalizado Solo salida del contenedor No se graba callerIp

¿Qué sigue?

Descripción general

Aprende a ajustar un modelo proporcionando un conjunto de datos de entrenamiento que contenga un conjunto de ejemplos de tareas descendentes específicas.

Descripción general

Conocer algunas de las limitaciones de la IA generativa y las prácticas recomendadas para usarla