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 seguimientos, consulta Visualiza los seguimientos del agente.

Acerca de Cloud Trace y la observabilidad de agentes

Un seguimiento representa la ruta de una solicitud en las partes de tu aplicación distribuida. Es decir, cada seguimiento representa una sola operación de extremo a extremo. Debido a que los seguimientos se componen de intervalos, que son registros de una sola función o operación, te permiten seguir el flujo de las 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, Telemetría y Model Armor, si aún no están habilitadas.

    Roles necesarios para habilitar las APIs

    Para habilitar las 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 obtenerlo 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 seguimiento para tu agente.
  3. Configura Model Armor en una puerta de enlace o en un servidor de MCP de Google Cloud.

Roles obligatorios

Para obtener los permisos que necesitas para 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 compatibles, consulta Cargas útiles compatibles y no compatibles.

Para una solicitud que contiene una carga útil no compatible, Model Armor genera un intervalo con un error.

Nombres y atributos de los intervalos de Model Armor

Están disponibles los siguientes intervalos de Model Armor:

  • Intervalo superior: 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 intervalo superior

El intervalo superior, 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 región de Google Cloud 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 de llamada de procedimiento remoto (RPC) subyacente que se usó para la operación, por ejemplo, grpc.
  • service.name: Es el servicio de Google Cloud asociado con la operación. Para los intervalos de Model Armor, el valor de este campo es modelarmor.

Atributos de la ruta de acceso de la solicitud

El intervalo 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 barandilla. 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 ocultó (desidentificó) 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 legible para el usuario sobre la decisión.
  • 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 infringió alguno de los filtros de Model Armor (también llamados detectores).
  • gcp.modelarmor.violations: los filtros de Model Armor que incumplió el contenido. Un valor de deidentified indica que Model Armor ocultó datos sensibles del contenido según la plantilla proporcionada.
  • gcp.modelarmor.rai.violations: son las categorías de IA responsable que infringió el contenido. Para obtener más información, consulta Filtro de seguridad de IA responsable.
  • gcp.modelarmor.sdp.info_types: Son los tipos de datos sensibles (como EMAIL_ADDRESS o PHONE_NUMBER) identificados por los filtros de Sensitive Data Protection.
  • error.type: Es un identificador del error que se produjo.

Atributos de Response Path

El intervalo 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 barandilla. 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 ocultó (desidentificó) 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 legible para el usuario sobre la decisión.
  • 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 infringió alguno de los filtros de Model Armor (también llamados detectores).
  • gcp.modelarmor.violations: los filtros de Model Armor que incumplió el contenido. Un valor de deidentified indica que Model Armor ocultó datos sensibles del contenido según la plantilla proporcionada.
  • gcp.modelarmor.rai.violations: son las categorías de IA responsable que infringió el contenido. Para obtener más información, consulta Filtro de seguridad de IA responsable.
  • gcp.modelarmor.sdp.info_types: Son los tipos de datos sensibles (como EMAIL_ADDRESS o PHONE_NUMBER) identificados por los filtros de Sensitive Data Protection.
  • error.type: Es un identificador del error que se produjo.

Visualiza los detalles de un intervalo de Model Armor

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

  1. En la consola de Google Cloud , ve a Registro de agentes.

    Ir al registro de agentes

  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 de un seguimiento que quieras ver. Si el seguimiento involucra un tramo de Model Armor, el seguimiento incluye el tramo apply_guardrail "Google Cloud Model Armor".
  6. Explora el seguimiento:

    • Para ver el seguimiento como un grafo acíclico dirigido (DAG), haz clic en la vista Grafo. Esta vista representa el seguimiento de ejecución de un agente como un diagrama de vínculos de nodos. 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 grafo es un intervalo.
    • Para ver el seguimiento como una línea de tiempo, haz clic en la vista Línea de tiempo. 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 con el Explorador de Trace. Aplica filtros de intervalo para buscar el intervalo apply_guardrail "Google Cloud Model Armor".

¿Qué sigue?