O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Ver períodos de trace do Model Armor

Este documento descreve os períodos do Model Armor nos traces e como visualizar os detalhes deles. Para mais informações sobre traces, consulte Ver traces do agente.

Sobre o Cloud Trace e a observabilidade do agente

Um trace representa o caminho de uma solicitação nas partes do aplicativo distribuído. Ou seja, cada trace representa uma única operação de ponta a ponta. Como os traces são compostos por períodos, que são registros de uma única função ou operação, eles permitem que você siga o fluxo de solicitações e examine os dados de latência. Essas informações podem ajudar a identificar a causa raiz de um problema.

O Cloud Trace é o sistema de rastreamento distribuído do Google Cloude oferece recursos para explorar traces ou analisar dados de trace com SQL. No entanto, muitos serviços doGoogle Cloud , como o Application Monitoring e o Agent Registry, podem exibir os dados gerenciados pelo Cloud Trace. Esses serviços permitem visualizar dados de trace no contexto do serviço que você está usando.

Antes de começar

Ative as APIs Cloud Trace, Cloud Logging, Telemetry e Model Armor, se ainda não estiverem ativadas.
Funções necessárias para ativar APIs
Para ativar APIs, você precisa da permissão serviceusage.services.enable. Se você criou o projeto, provavelmente já tem essa permissão pelo papel de proprietário (roles/owner). Caso contrário, é possível conseguir essa permissão pelo papel de administrador do Service Usage (roles/serviceusage.serviceUsageAdmin). Saiba como conceder papéis.
Ativar as APIs
Configure o rastreamento para seu agente.
Configure o Model Armor em um gateway ou em um Google Cloud servidor MCP.

Funções exigidas

Para receber as permissões necessárias para visualizar dados de trace, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto:

Usuário do Cloud Trace (roles/cloudtrace.user)
Visualizador de registros (roles/logging.viewer)

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.

Para informações sobre outros papéis que podem ser necessários, consulte Controle de acesso do Cloud Trace e Controle de acesso do Cloud Logging.

Payloads compatíveis

Para uma lista de payloads compatíveis, consulte Payloads compatíveis e não compatíveis.

Para uma solicitação que contém um payload não compatível, o Model Armor gera um período com um erro.

Nomes e atributos de período do Model Armor

Os seguintes períodos do Model Armor estão disponíveis:

Período pai: apply_guardrail "Google Cloud Model Armor"
Período filho: Request Path
Período filho: Response Path

As seções a seguir listam todos os atributos possíveis de um período do Model Armor. Nem todos os atributos estão presentes em todos os períodos. Esses nomes de atributos estão sujeitos a mudanças.

Atributos de período pai

O período pai, apply_guardrail "Google Cloud Model Armor", tem os seguintes atributos:

cloud.provider: o provedor de nuvem associado à operação.
cloud.region: a região do Google Cloud em que a operação ocorreu.
gcp.project_id: o ID do projeto em que a operação ocorreu.
rpc.system: o framework ou protocolo de chamada de procedimento remoto (RPC, na sigla em inglês) subjacente que foi usado para a operação, por exemplo, grpc.
service.name: o serviço do Google Cloud associado à operação. Para períodos do Model Armor, o valor desse campo é modelarmor.

Atributos de caminho de solicitação

O período filho Request Path tem os seguintes atributos:

gen_ai.security.target.type: o tipo de conteúdo ou ação a que a proteção é aplicada. No período Request Path, isso é sempre input.
gen_ai.security.decision.type: o veredito ou a ação que o Model Armor aplicou. Um valor de modify indica que o Model Armor encobriu (desidentificou) dados sensíveis do conteúdo de acordo com o modelo fornecido.
gen_ai.security.decision.code: um código numérico para a decisão de segurança.
gen_ai.security.decision.reason: um motivo legível para o usuário sobre a decisão.
gen_ai.security.policy.id: o nome completo do recurso do modelo do Model Armor no formato projects/PROJECT_ID/locations/LOCATION/templates/MODEL_ARMOR_TEMPLATE_ID.
gen_ai.security.policy.name: o nome do modelo do Model Armor que foi usado para a operação.
gcp.modelarmor.filter.match.state: se o conteúdo violou algum dos filtros do Model Armor (também chamados de detectores).
gcp.modelarmor.violations: os filtros do Model Armor que o conteúdo violou. Um valor de deidentified indica que o Model Armor encobriu dados sensíveis do conteúdo de acordo com o modelo fornecido.
gcp.modelarmor.rai.violations: as categorias de IA responsável que o conteúdo violou. Para mais informações, consulte Filtro de segurança de IA responsável.
gcp.modelarmor.sdp.info_types: os tipos de dados sensíveis (como EMAIL_ADDRESS ou PHONE_NUMBER) identificados pelos filtros da Proteção de Dados Sensíveis.
error.type: um identificador do erro encontrado.

Atributos de caminho de resposta

O período filho Response Path tem os seguintes atributos:

gen_ai.security.target.type: o tipo de conteúdo ou ação a que a proteção é aplicada. No período Response Path, esse valor é sempre output.
gen_ai.security.decision.type: o veredito ou a ação que o Model Armor aplicou. Um valor de modify indica que o Model Armor encobriu (desidentificou) dados sensíveis do conteúdo de acordo com o modelo fornecido.
gen_ai.security.decision.code: um código numérico para a decisão de segurança.
gen_ai.security.decision.reason: um motivo legível para o usuário sobre a decisão.
gen_ai.security.policy.id: o nome completo do recurso do modelo do Model Armor no formato projects/PROJECT_ID/locations/LOCATION/templates/MODEL_ARMOR_TEMPLATE_ID.
gen_ai.security.policy.name: o nome do modelo do Model Armor que foi usado para a operação.
gcp.modelarmor.filter.match.state: se o conteúdo violou algum dos filtros do Model Armor (também chamados de detectores).
gcp.modelarmor.violations: os filtros do Model Armor que o conteúdo violou. Um valor de deidentified indica que o Model Armor encobriu dados sensíveis do conteúdo de acordo com o modelo fornecido.
gcp.modelarmor.rai.violations: as categorias de IA responsável que o conteúdo violou. Para mais informações, consulte Filtro de segurança de IA responsável.
gcp.modelarmor.sdp.info_types: os tipos de dados sensíveis (como EMAIL_ADDRESS ou PHONE_NUMBER) identificados pelos filtros da Proteção de Dados Sensíveis.
error.type: um identificador do erro encontrado.

Ver os detalhes de um período do Model Armor

Para conferir um período do Model Armor e os detalhes dele, incluindo os atributos e o DAG, siga estas etapas:

No console do Google Cloud , acesse o Agent Registry.
Acessar o Agent Registry
Selecione o projeto.
Clique no nome do agente.
Clique na guia Traces.
Clique no ID de um trace que você quer visualizar. Se o trace envolver um período do Model Armor, ele vai incluir o período apply_guardrail "Google Cloud Model Armor".
Analise o trace:
- Para ver o trace como um gráfico acíclico dirigido (DAG), clique na visualização Gráfico. Essa visualização representa o rastro de execução de um agente como um diagrama de nó-link. Os DAGs enfatizam as relações causais e as dependências entre diferentes períodos de trace e mostram como uma operação aciona a próxima. Cada nó no gráfico é um período.
- Para ver o trace como uma linha do tempo, clique na visualização Linha do tempo. Cada barra na linha do tempo representa um período.
Clique em um período para ver os atributos dele.

Como alternativa, clique em Ver no Cloud Trace para conferir todos os períodos do projeto pelo Explorador de traces. Aplique filtros de período para pesquisar o período apply_guardrail "Google Cloud Model Armor".