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,streamGenerateContentychatCompletionsEmbeddings:
embedContentybatchEmbedContentsRecuento de tokens:
countTokensycomputeTokensPredicción y explicación en línea:
predict,rawPredict,streamRawPredict,directPredict,directRawPredict,streamDirectPredict,streamDirectRawPredict,serverStreamingPredict,predictLongRunning,fetchPredictOperationyexplain
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 deDATA_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_READregistran la dirección IP del emisor (callerIp), pero atribuyenprincipalEmaila 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_READaccesibles 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?
Introducción al ajuste
Aprende a ajustar un modelo proporcionando un conjunto de datos de entrenamiento que contenga un conjunto de ejemplos de tareas descendentes específicas.
IA responsable
Conocer algunas de las limitaciones de la IA generativa y las prácticas recomendadas para usarla