Investigate
As visões By problem, All decisions e Token exchanges, a busca, os filtros e como abrir o detalhe de cada linha.
O Investigate responde à pergunta que vem depois de toda negação: por quê? Ele lista as decisões e as trocas de token do ambiente, e cada linha abre um inspetor com o passo que decidiu e a correção.
No topo ficam os sinais de token exchange do Inbox. Embaixo, a lista.
Quick incident
Toda recusa que o Xokepoint registra tem um código Reference, como k3f7-x2ab. A pessoa ou o desenvolvedor que foi recusado vê esse código: na página de login recusado, no erro de uma tool call negada, no error_description de uma troca de token recusada. O Quick incident vai desse código até a recusa em um passo.
- Em Overview, Access ou Investigate, clique em Quick incident, no canto superior direito da página, ou aperte
/. - Cole o código. Maiúsculas e a falta do traço são aceitas.
- Aperte Enter. Abre o inspetor da chamada negada ou da troca recusada.
O Quick incident procura no ambiente atual. Uma página de login recusado mostra o workspace e o ambiente junto com o código; escolha esse ambiente antes. Quando nada é encontrado, o código é de outro ambiente, foi digitado errado ou é mais antigo que o histórico guardado. Raramente, uma recusa não é guardada porque o buffer de registros estava cheio; o código dela também não encontra nada.
Um link com ?incident=<código> no fim de um endereço do Investigate abre a mesma recusa, por exemplo num chamado.
As três visões
By problem agrupa negações iguais: mesmo agente, mesmo sujeito, mesma tool e mesmo motivo. Cada linha mostra a contagem na janela ("×4 in window · last 14:22 UTC"). É a visão para começar: dez negações iguais viram um problema só.
All decisions lista cada chamada, permitida, negada ou would deny:
Token exchanges lista cada troca de token, emitida ou recusada:
As colunas das decisões
| Coluna | O que mostra |
|---|---|
| Result | ALLOW, DENY ou WOULD DENY, e o motivo da negação em uma frase. Uma linha would deny também diz "The call ran" |
| Agent | O agente verificado, e o chip Report-only quando o agente estava em Report-only naquele momento. Uma segunda linha aparece só para um agente excluído ou não encontrado |
| On behalf of | A pessoa ou o serviço por quem o agente agiu, com o chip Person ou Service e o provedor |
| MCP server / tool | O server e a tool, cada um com seu ícone, e a hora (ou a contagem na janela, em By problem) |
| Detail | Para uma chamada que não cumpriu uma regra, "Rule not met" e a regra como o rule builder a lê, como "amount is at most 500". Uma regra que não vira frase, como uma escrita em CEL avançado, aparece em CEL. Vazio nas outras linhas |
| Actions | View, que abre o inspetor |
As colunas das trocas de token
| Coluna | O que mostra |
|---|---|
| Result | ISSUED ou REFUSED, e o motivo curto, como "Subject token expired" ou "Agent key did not match" |
| Agent | O agente que pediu o token |
| Subject | O sujeito, quando a assinatura do token dele era válida; senão, "Not verified" |
| When | A hora, ou a contagem na janela |
| Actions | View, que abre o inspetor |
Busca e filtros
A busca procura por agente, sujeito, server, tool, valor conferido ou o código Reference de uma chamada negada; nas trocas, por agente, sujeito, provedor ou o código Reference de uma recusa. Para abrir uma recusa pelo código, use o Quick incident. All agents filtra por agente, e All reasons filtra pelo motivo: os cinco motivos de decisão ou os treze de troca de token, incluindo os de login de harness.
Would deny
O filtro de resultado de All decisions tem uma quarta opção, Would deny: as chamadas de um agente em Report-only que a política dele nega e que rodaram. O chip delas é tracejado, nas cores do Report-only. View report, no banner de Report-only, abre essa lista.
Uma chamada would deny nunca é uma negação: By problem e o filtro Deny não incluem essas chamadas.
Abrir uma linha
View, na coluna Actions, ou um clique na linha, abre o inspetor:
- Inspetor de decisão, para uma decisão;
- Inspetor de troca de token, para uma troca.
Back to the list volta à lista com os filtros como estavam.