Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.crewai.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Visão Geral

As Regras permitem aplicar políticas — hoje: PII Redaction — em muitas automações de uma só vez, em vez de configurar cada deployment individualmente. Abra a aba Regras no Agent Control Plane para gerenciá-las.
Lista de regras
Cada card de regra mostra o nome, a descrição, o escopo ao qual a regra se aplica (ferramentas e tags selecionadas) e a contagem de automações engajadas — deployments que atualmente correspondem ao escopo. O toggle à direita ativa ou desativa a regra sem excluí-la.

​
Requisitos

Plano Enterprise ou Ultra é necessário para criar ou editar regras de PII Redaction. Organizações em planos inferiores ainda podem abrir a aba Regras e visualizar regras existentes, mas o editor é renderizado em modo somente leitura, com um selo “Enterprise” de bloqueio e o alerta “PII Redaction rules require an Enterprise plan.” — entre em contato com o owner da sua conta ou com vendas para fazer upgrade.
  • O recurso Agent Control Plane precisa estar habilitado para sua organização. Veja Visão Geral — Requisitos.
  • A permissão manage no RBAC sobre o Agent Control Plane é necessária para criar, editar, ligar/desligar ou excluir regras. A permissão read é suficiente para visualizá-las.
  • Todas as mudanças de regras são versionadas para auditoria.

​
Tipos de regra disponíveis

TipoO que faz
PII RedactionAplica PII redaction às execuções de cada automação correspondente, usando o mesmo catálogo de entidades e recognizers customizados documentados em PII Redaction para Traces.
Mais tipos de regras serão adicionados ao longo do tempo.

​
Criando uma regra

Painel lateral de edição de regra com condições e tipo de máscara de PII
1

Abra o editor

Clique em + Create new no canto superior direito da aba Regras, ou em View Details em um card de regra existente.
2

Dê um nome e descreva a regra

Dê à regra um nome claro (ex.: Mask PII (CC)) e uma descrição explicando quando ela se aplica. Ambos aparecem no card da regra e no modal de Automações Engajadas.
3

Escolha o tipo

Hoje só PII Redaction está disponível.
4

Defina as condições

As condições decidem quais automações a regra engaja. Ambas são opcionais e usam a semântica de igualdade de conjuntos:
  • Tools — apenas automações cujo conjunto de ferramentas corresponde exatamente às ferramentas selecionadas serão engajadas. Selecione entre apps do Studio, MCPs, ferramentas OSS e ferramentas do Tool Repository.
  • Automations — apenas automações cujo conjunto de tags corresponde exatamente às tags selecionadas serão engajadas.
Deixar um seletor vazio significa “sem filtro nesta dimensão”. Deixar ambos vazios significa que a regra se aplica a todas as automações da organização.
5

Configure a tabela PII Mask Type

Marque cada tipo de entidade que deseja cobrir e escolha Mask (substitui pelo rótulo da entidade, ex.: <CREDIT_CARD>) ou Redact (remove o texto correspondente por completo). Veja PII Redaction para Traces para o catálogo completo de entidades e como adicionar recognizers customizados em nível de organização.
6

Salve

A regra se aplica a futuras execuções de cada automação engajada assim que você salva. Nenhuma re-implantação é necessária.

​
Automações engajadas

Clique em Engaged N automations em qualquer card de regra para ver exatamente quais deployments a regra está correspondendo no momento, junto com a última execução de cada um.
Modal de automações engajadas
Esta é a forma mais rápida de validar o escopo de uma regra antes de habilitá-la — por exemplo, para confirmar que uma regra com escopo na tag production não está acidentalmente correspondendo a um deployment de staging.

​
Regras em nível de organização vs configurações por deployment

A PII Redaction pode ser configurada em dois lugares:
  • Por deployment — em Settings → PII Protection em cada deployment individual (guia)
  • Em nível de organização — como uma Regra nesta página
Quando o escopo de uma regra habilitada em nível de organização corresponde a um deployment, a configuração de entidades da regra sobrescreve as configurações de PII pertencentes ao deployment para as execuções daquele deployment — a regra se torna a fonte única da verdade enquanto está vinculada. Desabilite ou desvincule a regra (ou altere o escopo para que ela não corresponda mais) e o deployment volta às suas próprias configurações de PII Protection. Prefira regras em nível de organização quando quiser impor uma política consistente em muitos deployments; reserve a configuração por deployment para exceções pontuais.

​
Relacionados

Agent Control Plane — Visão Geral

O que é o ACP, requisitos, planos suportados e RBAC.

Agent Control Plane — Monitoramento

Acompanhe automações e consumo de LLM em toda a sua frota.

PII Redaction para Traces

Catálogo de entidades, recognizers customizados e configuração por deployment.

RBAC

Gerencie quem pode criar ou editar regras.

Precisa de ajuda?

Entre em contato com nosso time de suporte para ajudar a desenhar regras para a sua organização.