O grafo de delegação e acesso

A aba Delegation and access de cada agente mostra num só lugar todas as relações e regras dele. O grafo é ao mesmo tempo o mapa e o editor: clicar numa caixa ou numa ligação abre o editor num side panel na borda direita da janela, e o grafo mantém a largura toda.

O cabeçalho do agenteCopiar link da seção

Acima das abas ficam o nome do agente, o estado (Active ou Disabled) e dois grupos de ações. O primeiro tem Report-only (Report-only), com um ícone de ajuda que explica o modo, e Edit. O segundo, separado, tem Disable agent, o kill switch (Publicar e desativar), e Delete; os dois pedem confirmação.

Logo abaixo, uma linha reúne as três visões do agente à esquerda e, em Delegation and access, os controles de visão à direita:

• Delegation and access: o grafo descrito nesta página.
• Identity: a chave do agente e o cartão de login do Harness (Identidade do agente).
• Harness sessions: as pessoas e máquinas conectadas por um harness de código (Sessões do Harness).

As colunasCopiar link da seção

O grafo se lê da esquerda para a direita, na ordem em que a autorização confere uma chamada:

1. Who can delegate. Um nó por identity provider, nunca um nó por pessoa. O subtítulo diz quantos sujeitos delegam: "2 of 7 people".
2. Agent. O nó em destaque no centro, com o nome do agente e "acts and is verified".
3. Servers and tools. Uma caixa tracejada por MCP server, com o nome e o tipo (Enterprise MCP ou Custom MCP). Dentro, um nó por tool que o agente pode chamar, com o número de regras: "No rules", "1 rule", "3 rules".
4. Context sources. Quando uma regra de uma tool lê trusted attributes, uma ligação tracejada sai da tool até a context source que os fornece, com o que as regras leem ("reads refund_limit, team"). Uma tool cujas regras só leem argumentos da chamada não tem essa ligação.

As ligaçõesCopiar link da seção

Cada ligação de delegação e de tool tem uma marca no meio. Um relógio indica que a relação expira. {} N indica que a ligação tem N regras. + aparece quando não há nenhum dos dois e abre o painel da tool numa regra nova.

O side panelCopiar link da seção

Todo editor abre no mesmo side panel: um identity provider, uma tool, o agente, a lista de identity providers ou as tools a adicionar. Um painel aberto a partir de outro, como um identity provider aberto da lista de identity providers, mostra Back to no topo; um painel aberto do grafo ou da lista não tem Back. Escape, o botão de fechar ou um clique na página fecham o painel.

Clicar no nó do agente abre um resumo: as permissões valem para toda instância do agente e para todo sujeito que delega a ele; o modo de enforcement; uma linha por identity provider com suas delegações; uma linha por tool com o server e as regras; e botões para as visões Identity e Harness sessions. Cada linha abre o próprio painel.

InteraçãoCopiar link da seção

• Arrastar uma caixa move a caixa; as ligações acompanham. Reset layout volta às posições originais. Posição é só preferência de visualização e não faz parte da configuração.
• Arrastar o fundo desloca o grafo; a roda do mouse aproxima no cursor; os botões do canto aproximam, afastam e encaixam o grafo.
• Full screen ocupa a janela, com o side panel e a barra de publicação. Escape sai.
• Um clique sem arrastar seleciona e abre o painel. O teclado também seleciona.

Barra de ferramentas e filtrosCopiar link da seção

• How this works abre a ajuda com o modelo completo (abaixo).
• Graph / List, dois ícones na linha das visões, alternam entre o grafo e as tabelas.
• Draft / Published alterna entre o rascunho em edição e a revisão publicada, só leitura.
• A busca procura identity provider, sujeito e tool. Cada coluna só é filtrada quando o texto encontra algo nela, então uma busca por tool continua mostrando quem pode delegar.
• All servers e All tools restringem o grafo a um server ou a uma tool. A lista de tools acompanha o server escolhido.
• With rules mostra só tools com regras.
• Com um filtro ativo, aparecem "N of M relations" e Clear filters.

Os filtros só mudam o que se vê. Toda edição vale para o rascunho inteiro. Não existe filtro por identity provider porque tools e regras são as mesmas para todos que delegam ao agente.

A barra de seçãoCopiar link da seção

Abaixo dos filtros, a barra mostra um ícone de pessoa com o número de sujeitos que delegam, Manage identity providers com o número de identity providers, o ícone de tool com o número de tools, e Manage tools. Ela é igual no grafo e na lista. Com um identity provider, Manage identity providers abre o painel dele; com nenhum ou vários, abre a lista de identity providers.

Colunas grandesCopiar link da seção

Um server com mais de 8 tools aparece como um único nó "N tools". Clicar nele abre o painel do grupo, com resumo, busca e páginas de 50. O resumo mostra o total, quantas expiram e quantas têm regras. Cada linha abre o painel daquela tool, com Back to para voltar ao grupo.

Visão em listaCopiar link da seção

List mostra as mesmas relações em duas tabelas, para uso pelo teclado e listas longas:

Cada linha tem Open, Add rule e Remove.

Revisão publicadaCopiar link da seção

Published mostra a revisão que vale agora, sem edição: os botões de gestão somem e os painéis ficam desabilitados. Um aviso diz qual revisão está na tela.

Ajuda: How this worksCopiar link da seção

O diálogo de ajuda resume o modelo com um exemplo fixo: as três verificações em ordem e o motivo de negação de cada uma, uma seção sobre regras em CEL com o que uma regra lê, chamadas de exemplo com o resultado e os pontos a lembrar.

As próximas páginas detalham cada coluna e o painel que ela abre.