Cómo ver los intervalos de seguimiento de Model Armor

En este documento, se describen los intervalos de Model Armor dentro de los seguimientos y cómo ver sus detalles. Para obtener más información sobre los registros, consulta Cómo ver los registros del agente.

Acerca de Cloud Trace y la observabilidad del agente

Un seguimiento representa la ruta de una solicitud en las partes de tu aplicación distribuida. Es decir, cada registro representa una sola operación de extremo a extremo. Dado que los registros se componen de intervalos, que son registros de una sola función u operación, te permiten seguir el flujo de solicitudes y examinar los datos de latencia. Esta información puede ayudarte a identificar la causa raíz de un problema.

Cloud Trace es el sistema de seguimiento distribuido para Google Cloud, y proporciona funciones para explorar seguimientos o analizar datos de seguimiento con SQL. Sin embargo, muchos servicios deGoogle Cloud , como Application Monitoring y Agent Registry, pueden mostrar los datos que administra Cloud Trace. Estos servicios te permiten ver los datos de seguimiento en el contexto del servicio que estás usando.

Antes de comenzar

  1. Habilita las APIs de Cloud Trace, Cloud Logging, Telemetry y Model Armor si alguna aún no está habilitada.

    Roles necesarios para habilitar las APIs

    Para habilitar APIs, necesitas el permiso serviceusage.services.enable. Si creaste el proyecto, es probable que ya tengas este permiso a través del rol de propietario (roles/owner). De lo contrario, puedes obtener este permiso a través del rol de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin). Obtén más información para otorgar roles.

    Habilitar las API

  2. Configura el registro de seguimiento para tu agente.
  3. Configura Model Armor en una puerta de enlace o en un Google Cloudservidor de MCP.

Roles obligatorios

Para obtener los permisos que necesitas y ver los datos de seguimiento, pídele a tu administrador que te otorgue los siguientes roles de IAM en tu proyecto:

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Para obtener información sobre otros roles que podrías necesitar, consulta Control de acceso de Cloud Trace y Control de acceso de Cloud Logging.

Cargas útiles admitidas

Para obtener una lista de las cargas útiles admitidas, consulta Cargas útiles admitidas y no admitidas.

En el caso de una solicitud que contiene una carga útil no admitida, Model Armor genera un intervalo con un error.

Nombres y atributos de los tramos de Model Armor

Los siguientes tramos de Model Armor están disponibles:

  • Intervalo principal: apply_guardrail "Google Cloud Model Armor"
  • Intervalo secundario: Request Path
  • Intervalo secundario: Response Path

En las siguientes secciones, se enumeran todos los atributos posibles de un intervalo de Model Armor. No todos los atributos están presentes en cada intervalo. Estos nombres de atributos están sujetos a cambios.

Atributos del tramo principal

El intervalo principal, apply_guardrail "Google Cloud Model Armor", tiene los siguientes atributos:

  • cloud.provider: Es el proveedor de servicios en la nube asociado con la operación.
  • cloud.region: Es la Google Cloud región en la que se produjo la operación.
  • gcp.project_id: Es el ID del proyecto en el que se produjo la operación.
  • rpc.system: Es el framework o protocolo subyacente de llamada de procedimiento remoto (RPC) que se usó para la operación, por ejemplo, grpc.
  • service.name: Es el servicio de Google Cloud asociado con la operación. En el caso de los intervalos de Model Armor, el valor de este campo es modelarmor.

Atributos de la ruta de la solicitud

El tramo secundario Request Path tiene los siguientes atributos:

  • gen_ai.security.target.type: Es el tipo de contenido o acción al que se aplica la protección. En el intervalo Request Path, siempre es input.
  • gen_ai.security.decision.type: Es el veredicto o la acción que aplicó Model Armor. Un valor de modify indica que Model Armor redactó (anonimizó) los datos sensibles del contenido según la plantilla proporcionada.
  • gen_ai.security.decision.code: Es un código numérico para la decisión de seguridad.
  • gen_ai.security.decision.reason: Es un motivo de la decisión que el usuario puede leer.
  • gen_ai.security.policy.id: Es el nombre completo del recurso de la plantilla de Model Armor en el formato projects/PROJECT_ID/locations/LOCATION/templates/MODEL_ARMOR_TEMPLATE_ID.
  • gen_ai.security.policy.name: Es el nombre de la plantilla de Model Armor que se usó para la operación.
  • gcp.modelarmor.filter.match.state: Indica si el contenido incumplió alguno de los filtros de Model Armor (también llamados detectores).
  • gcp.modelarmor.violations: Son los filtros de Model Armor que incumplió el contenido. Un valor de deidentified indica que Model Armor ocultó los datos sensibles del contenido según la plantilla proporcionada.
  • gcp.modelarmor.rai.violations: Son las categorías de IA responsable que incumplió el contenido. Para obtener más información, consulta Filtro de seguridad de la IA responsable.
  • gcp.modelarmor.sdp.info_types: Son los tipos de datos sensibles (como EMAIL_ADDRESS o PHONE_NUMBER) que identifican los filtros de Sensitive Data Protection.
  • error.type: Es un identificador del error encontrado.

Atributos de la ruta de respuesta

El tramo secundario Response Path tiene los siguientes atributos:

  • gen_ai.security.target.type: Es el tipo de contenido o acción al que se aplica la protección. En el intervalo Response Path, siempre es output.
  • gen_ai.security.decision.type: Es el veredicto o la acción que aplicó Model Armor. Un valor de modify indica que Model Armor redactó (anonimizó) los datos sensibles del contenido según la plantilla proporcionada.
  • gen_ai.security.decision.code: Es un código numérico para la decisión de seguridad.
  • gen_ai.security.decision.reason: Es un motivo de la decisión que el usuario puede leer.
  • gen_ai.security.policy.id: Es el nombre completo del recurso de la plantilla de Model Armor en el formato projects/PROJECT_ID/locations/LOCATION/templates/MODEL_ARMOR_TEMPLATE_ID.
  • gen_ai.security.policy.name: Es el nombre de la plantilla de Model Armor que se usó para la operación.
  • gcp.modelarmor.filter.match.state: Indica si el contenido incumplió alguno de los filtros de Model Armor (también llamados detectores).
  • gcp.modelarmor.violations: Son los filtros de Model Armor que incumplió el contenido. Un valor de deidentified indica que Model Armor ocultó los datos sensibles del contenido según la plantilla proporcionada.
  • gcp.modelarmor.rai.violations: Son las categorías de IA responsable que incumplió el contenido. Para obtener más información, consulta Filtro de seguridad de la IA responsable.
  • gcp.modelarmor.sdp.info_types: Son los tipos de datos sensibles (como EMAIL_ADDRESS o PHONE_NUMBER) que identifican los filtros de Sensitive Data Protection.
  • error.type: Es un identificador del error encontrado.

Cómo ver los detalles de un intervalo de Model Armor

Para ver un intervalo de Model Armor y sus detalles, incluidos sus atributos y su DAG, sigue estos pasos:

  1. En la consola de Google Cloud , ve a Agent Registry.

    Ir a Agent Registry

  2. Elige tu proyecto.
  3. Haz clic en el nombre del agente.
  4. Haz clic en la pestaña Seguimientos.
  5. Haz clic en el ID del registro de seguimiento que deseas ver. Si el registro incluye un intervalo de Model Armor, se incluye el intervalo apply_guardrail "Google Cloud Model Armor".

  6. Explora el registro:

    • Para ver el registro como un grafo acíclico dirigido (DAG), haz clic en la vista Gráfico. En esta vista, se representa el registro de ejecución de un agente como un diagrama de nodos y vínculos. Los DAG enfatizan las relaciones causales y las dependencias entre los diferentes intervalos de seguimiento, y muestran cómo una operación activa la siguiente. Cada nodo del gráfico es un intervalo.
    • Para ver el registro como una línea de tiempo, haz clic en la vista Cronograma. Cada barra de la línea de tiempo representa un intervalo.

  7. Haz clic en un intervalo para ver sus atributos.

Como alternativa, haz clic en Ver en Cloud Trace para ver todos los intervalos de tu proyecto en el Explorador de Trace. Aplica filtros de intervalo para buscar el intervalo apply_guardrail "Google Cloud Model Armor".

¿Qué sigue?