Skip to main content
O Policy Engine define a política padrão de revisão para o workspace. Ele controla quais tipos de revisão ficam ativos, quais instruções adicionais devem orientar a análise e quais autores devem ser incluídos ou bloqueados. Use Console > Policy Engine para configurar o padrão do workspace. Use a configuração do repositório apenas para exceções.

​
Quem pode acessar

O Policy Engine requer um admin de workspace. Os papéis são conjuntos fixos de capacidades definidos pela Acrity, portanto esse acesso não é configurável por organização.

​
Quando usar

Use esta tela para:
  • ativar ou desativar tiers de revisão no workspace;
  • adicionar instruções gerais de revisão;
  • definir bots que podem ser revisados;
  • bloquear autores que não devem gerar revisão;
  • consultar ou rotacionar configuração de webhook quando a tela exibir essa opção;
  • alinhar a política padrão antes de conectar muitos repositórios.

​
Tiers de revisão

O workspace deve manter pelo menos um tier ativo. Se ambos estiverem ativos, a Acrity pode aplicar a política configurada conforme o contexto do review e as opções disponíveis no produto.
Não use tiers como substituto para regras de branch. Branch rules devem ficar em Console > Repositórios.

​
Instruções adicionais

As instruções adicionais permitem adaptar a revisão ao padrão da organização. Use para registrar diretrizes como:
  • padrões de arquitetura esperados;
  • critérios de qualidade relevantes para a organização;
  • cuidados com testes, segurança ou compatibilidade;
  • linguagem esperada nos comentários;
  • decisões de produto que devem ser consideradas.
Evite incluir:
  • segredos;
  • tokens;
  • informações confidenciais de clientes;
  • regras internas que não deveriam aparecer em saídas de revisão;
  • instruções específicas demais para um único repositório.
Para regras específicas de um repositório, use Console > Repositórios > Detalhe > Review.

​
Substituições de prompt de revisor

Cada papel de revisor tem seu próprio campo de substituição de prompt, permitindo ajustar com precisão como um revisor específico analisa mudanças em todo o workspace. Cada campo:
  • aceita até 2.000 caracteres;
  • indica se o texto atual é uma substituição do workspace ou o padrão global;
  • oferece uma ação Revert to global que descarta a substituição do workspace e restaura o padrão global.
Quando um campo exibe o padrão global, esse revisor usa a orientação nativa da Acrity. Quando você salva um texto em um campo, ele se torna uma substituição do workspace que se aplica às revisões em todo o workspace, substituindo o padrão global para esse revisor.
Use as substituições de prompt de revisor com cautela. Elas alteram o comportamento do revisor em todo o workspace, e é fácil esquecer que uma substituição está ativa. Para orientações duradouras e de longo prazo, prefira commitar um arquivo ARCHITECTURE.md no repositório, para que a orientação fique junto ao código e seja versionada com ele.

​
Política de autores

A política de autores ajuda a controlar quais mudanças devem ser revisadas. Use bots permitidos quando automações criam mudanças que devem receber revisão, como atualização de dependências. Use autores bloqueados para evitar ruído operacional ou excluir contas que não devem gerar análise.

​
Chave ou URL de webhook

Alguns workspaces podem exibir configuração de webhook vinculada ao fluxo de revisão. Quando a tela exibir essa opção:
  • copie a URL apenas para o provedor correto;
  • trate a chave como segredo;
  • rotacione a chave se houver suspeita de exposição;
  • atualize o provedor depois de rotacionar;
  • valide o webhook pelo Console ou pelo provedor.
Não compartilhe chaves de webhook em chats, tickets públicos, comentários de PR/MR ou documentação interna ampla.

​
Configurar política padrão

1

Abrir Policy Engine

Acesse Console > Policy Engine.
2

Revisar tiers

Ative Fast, Deep ou ambos, conforme a política do workspace.
3

Adicionar instruções

Preencha instruções adicionais gerais que se aplicam à maioria dos repositórios.
4

Ajustar prompts de revisor (opcional)

Defina uma substituição do workspace para o revisor Architect, Spec Validator ou QA Engineer apenas quando necessário e reverta ao padrão global quando não for mais preciso.
5

Configurar autores

Adicione bots permitidos e autores bloqueados quando necessário.
6

Salvar

Salve e confirme mensagens de validação.
7

Testar em repositório

Escolha um repositório representativo e acompanhe a próxima revisão no dashboard Ops para validar o comportamento esperado.

​
Relação com configuração do repositório

Mantenha a política do workspace simples e estável. Isso reduz divergência entre times e facilita auditoria.

​
Boas práticas

  • Escreva instruções curtas, claras e verificáveis.
  • Evite duplicar documentação longa dentro do campo de instruções.
  • Não inclua segredos ou dados confidenciais.
  • Revise a política após mudanças grandes de processo.
  • Use exceções por repositório com moderação.
  • Reverta as substituições de prompt de revisor ao padrão global assim que não forem mais necessárias e mantenha orientações duradouras no ARCHITECTURE.md do repositório.
  • Combine política de autores com branch rules para reduzir ruído.

​
Problemas comuns