Inspetor de decisão
A anatomia do detalhe de uma decisão, o caminho de autorização, a regra que falhou, os fatos e o que cada motivo de negação pede para corrigir.
O inspetor explica uma decisão inteira: qual passo decidiu, por quê, quem pediu, por qual agente, e o que fazer.
Anatomia
Barra. Back to the list volta ao Investigate com os filtros como estavam. Quick incident abre outra recusa pelo código.
Cabeçalho. A hora da decisão em UTC. Quando o problema tem um sinal na Inbox, o cabeçalho também mostra Inbox item com o estado e Mark resolved (Inbox).
O caminho de autorização. Vem primeiro, um passo depois do outro, cada um com o estado e o que conferiu:
| Passo | O que mostra | Estados possíveis |
|---|---|---|
| Delegation | Rafael Souza → refunds-assistant | Passed, Failed |
| Agent | refunds-assistant | Passed |
| MCP server | Acme Billing | Passed, Not evaluated |
| Tool | refund_order | Passed, Failed, Not evaluated |
| Rules | O nome da regra que falhou, como Refund up to 500 | Passed, Failed, Not applicable, Not evaluated |
"Not evaluated" quer dizer que um passo anterior já negou. "Not applicable" quer dizer que a tool não tem regras.
O resultado. Denied, Allowed ou Would deny, a tool e a causa em uma frase. Quando uma regra negou, a causa diz "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. O ícone de ajuda ao lado lembra que os valores da chamada e das fontes de atributos nunca são registrados: a regra mostra o que foi conferido, não o valor que falhou.
A ação. Open the rule, embaixo do resultado, em toda negação produzida por uma regra do agente: a delegação, a tool, os allowed values ou uma regra da chamada. Ela abre o lugar do grafo onde essa regra está. Só abre: muitas vezes a negação é a regra cumprindo o papel dela, e o botão não sugere liberar nada. Uma tool que não foi revisada mostra Review the tool no lugar.
Os fatos. Duas colunas. À esquerda, quem e onde: Identity provider, On behalf of (nome e ID do sujeito), Agent (nome e ID do agente), MCP server e Tool. À direita, como foi decidido: Mode (Enforce ou Report-only naquele momento), Reference (o código que quem chamou recebeu com a chamada negada; cole no Quick incident), Permission revision (abre o histórico de revisões) e Decided at (UTC).
Decisions in this problem. "Decisions in this problem · 3 denied", com a janela de uma hora embaixo: mesmo agente, server, tool, motivo e resultado. Cada linha mostra a hora, o sujeito e o código de referência daquela chamada; um clique na linha mostra essa chamada no inspetor. Uma decisão que não faz parte de um problema mostra "Repeated in this window" com a contagem e a janela.
Cada motivo e a correção
condition: uma regra deu falso
O caso acima. Rafael Souza pediu ao refunds-assistant para reembolsar um pedido. Delegação, agente, server e tool passaram; a regra Refund up to 500 falhou, e o resultado diz "Rule not met: amount is at most 500". Open the rule leva ao painel da tool no grafo, onde a regra pode ser revista. Muitas vezes a correção não é mudar a regra: a negação era o comportamento esperado.
no_resource: o valor não é um allowed value do agente
Essa negação só acontece numa tool cujo server declara um allowed values parameter no schema da tool (x-authzen-mapping). O resultado diz "The value of the call is not one of the allowed values of the agent", e as regras ficam "Not evaluated". O Admin não adiciona allowed values: peça ao dono do MCP server para tirar a declaração e limite a tool com uma regra, como queue is one of [tier-1].
no_delegation: o sujeito não delegou ao agente
Bruno Costa pediu um ticket ao support-assistant, mas não delega a esse agente. A delegação falhou; o server, a tool e as regras ficaram "Not evaluated". Open the rule leva ao painel do provedor, com quem pode delegar ao agente. Esse caso aparece quando a delegação foi revogada depois que o token foi emitido; normalmente, a troca de token já teria sido recusada.
no_grant: o agente não pode chamar a tool
Júlia Mendes delegou ao issues-manager, mas o agente não tem merge_pull_request. O passo da tool falhou e as regras ficaram "Not evaluated". Open the rule leva às tools do agente nesse server.
Uma chamada would deny
O agente issues-manager estava em Report-only quando Júlia pediu para ele fazer merge de um pull request. O passo da tool falhou, então em Enforce a chamada teria parado ali; em Report-only ela rodou. O resultado diz Would deny e que a chamada rodou porque o agente estava em Report-only, e o aviso Not blocked diz que a chamada chegou ao server. O passo que falhou mostra "Failed · not enforced", Mode mostra Report-only, e Reference diz "None: the caller was not refused". A ação é a mesma de uma negação, para corrigir a política antes de colocar o agente em Enforce.
Uma decisão permitida
Todos os passos passaram. A tool list_issues não tem regras, então o passo de regras mostra "Not applicable", e o resultado diz "Every check passed." O inspetor de uma decisão permitida serve à auditoria: mostra que Júlia Mendes, pelo issues-manager, listou issues naquela hora, e quais relações permitiram.