> ## Documentation Index > Fetch the complete documentation index at: /docs/llms.txt > Use this file to discover all available pages before exploring further. # Regras de guardrail > Configure regras de guardrail no AI Gateway para validar e controlar solicitações e respostas de LLMs com evaluators acionados por condições CEL. As Guardrail Rules (regras de guardrail) definem as condições em que **Evaluators** (verificações automatizadas que inspecionam uma solicitação ou resposta) são executados nas solicitações que passam pelo [**AI Gateway**](/docs/pt-BR/ai-gateway/get-started/introduction.md). As condições são escritas como expressões CEL, criadas visualmente com o Rule Builder na seção Conditions, descrita abaixo. Um guardrail só é acionado quando as condições da regra são atendidas, e não em todas as solicitações. As Guardrail Rules são executadas apenas em solicitações e respostas de LLMs. Elas não são executadas em chamadas de ferramentas servidas por um **MCP Gateway**; vincule Guardrails e plugins ao MCP Gateway para verificar o tráfego de ferramentas. ## Casos de uso As regras de guardrail são mais úteis quando a mesma verificação de segurança ou de compliance precisa ser aplicada de forma consistente em muitas solicitações. > [accordion] Adicionar proteção contra jailbreak a todo o tráfego bancário voltado ao cliente > > Executa um **Evaluator** de detecção de jailbreak em todas as solicitações voltadas ao cliente no nível do gateway, adicionando uma camada extra de segurança em todo o tráfego do **AI Gateway**. > [accordion] Aplicar verificações de PII do GDPR em todo o workspace > > Garante a conformidade com o GDPR executando a detecção de PII em todas as solicitações correspondentes de todo o workspace a partir de uma única regra. > [accordion] Validar o acesso a dados de clientes pela equipe de vendas > > Valida o acesso a dados de clientes pela equipe de vendas chamando um **Evaluator** externo em cada solicitação correspondente antes que ela chegue ao modelo. > [accordion] Monitorar o tom de voz em todo o tráfego da empresa > > Aplica um **Evaluator** de tom de voz no nível do gateway para que cada resposta seja verificada em relação às diretrizes de tom da empresa. > [accordion] Aplicar verificações de conformidade com o EU AI Act a solicitações roteadas para a UE > > Executa um **Evaluator** de compliance apenas em solicitações roteadas para a UE, com escopo definido pelo Rule Builder para que o guardrail se aplique exatamente onde é necessário, sem afetar o restante do tráfego. > [accordion] Executar verificações de segurança e qualidade em tráfego específico usando metadados > > Executa **Evaluators** de detecção de jailbreak e de relevância da resposta com taxa de amostragem de 50% cada, restritos a um tráfego específico por meio de uma condição de metadados no Rule Builder. ## Visibilidade * Visível apenas para administradores do workspace. ## Criar uma regra de guardrail Na lista **Guardrail Rules**, clique em Guardrail Rule. O formulário é aberto em página inteira, com um controle para voltar e três seções: General, Guardrails e Conditions. Sair da página com alterações não salvas exige confirmação. ### General | Campo | Descrição | | - | - | | **Rule name** | Um nome descritivo para a regra de guardrail. | | **Description** | Contexto opcional para administradores. | | **Enable rule** | Regras desativadas permanecem salvas, mas não são avaliadas nas solicitações. | ### Guardrails Selecione as verificações a executar e configure onde e com que frequência elas são executadas. Clique em Guardrail para vincular uma. O menu agrupa as opções em **System** e **Workspace**: os guardrails System são as verificações predefinidas descritas abaixo; os guardrails Workspace são os criados no workspace como [**Guardrails**](/docs/pt-BR/ai-gateway/configuration/guardrails.md). Cada guardrail vinculado é uma linha com os controles abaixo. | Controle | Descrição | | - | - | | **Execute on** | Alterna entre **Input**, **Output** e **Both**, definido de forma independente para cada guardrail. | | **Blocking** | Exibido em guardrails configurados para bloquear tráfego. Alterna o guardrail entre bloqueio e apenas monitoramento: um escudo preenchido bloqueia as solicitações reprovadas na verificação e, no estado de escudo desativado, a verificação continua sendo executada e seu resultado continua sendo registrado, mas uma correspondência não bloqueia mais a solicitação. | | **Sample Rate** | A parcela das solicitações correspondentes em que o guardrail é executado, ajustável a partir de 1%. | | **Configure** | Abre as configurações do próprio guardrail, nos guardrails que as possuem. Consulte **PII Detection** abaixo. | | **Actions** | **Go to guardrail** abre a página do próprio guardrail, nos guardrails Workspace. **Remove** desvincula o guardrail da regra e é a única ação disponível nos guardrails System. | #### System Guardrails Os System Guardrails são as verificações predefinidas que o **Toqan Router** mantém no grupo System do menu **Guardrail**. Vincule um e ele passa a ser executado imediatamente como uma verificação de aprovação/reprovação que pode bloquear uma solicitação; ele nunca reescreve o conteúdo. | System Guardrail | O que verifica | Configurável | | - | - | - | | **PII Detection** | Detecta informações de identificação pessoal em solicitações ou respostas e, por padrão, bloqueia a solicitação em vez de ocultar as informações. | Sim. Depois de adicionado, um botão aparece na linha. Clique nele para definir `language`, `regions`, `entities`, `threshold` e `entity_thresholds`. | | **Secret Detection** | Detecta chaves de API, tokens, credenciais e outros segredos em solicitações ou respostas e, por padrão, bloqueia a solicitação. | Sem opções configuráveis. | O catálogo de entidades detectáveis do **PII Detection** é compartilhado com o plugin [**PII Redaction**](/docs/pt-BR/ai-gateway/features/plugins/pii-redaction.md#supported-entity-types) e é organizado por região, e não por idioma. `GET /v2/pii/capabilities` é a fonte oficial e atualizada das regiões compatíveis, dos tipos de entidade base e regionais e do mapeamento `region_entities`. Alguns [nomes de tipos de entidade mudaram](/docs/pt-BR/ai-gateway/features/plugins/pii-redaction.md#entity-type-names-that-changed) quando o catálogo passou a ser organizado por regiões; as chaves antigas são rejeitadas no momento da gravação. Uma regra não pode definir um `timeout` por guardrail. Os guardrails injetados por uma regra são executados com o tempo limite definido no evaluator ou, se ele não tiver um, com o padrão de 60 segundos; consulte [Tempo limite do guardrail](/docs/pt-BR/ai-gateway/configuration/guardrails.md#timeout). > [!WARNING] > > Os System Guardrails sempre falham fechados: se a verificação subjacente apresentar erro (por exemplo, o serviço de detecção estiver indisponível ou a própria chamada falhar), o guardrail bloqueia a solicitação em vez de deixá-la passar sem verificação. ### Conditions A seção Conditions cria as condições de correspondência que determinam quando o guardrail é acionado. O **Rule Builder** cria a expressão CEL exibida em modo somente leitura em **CEL Expression Preview**; deixar a seção vazia aplica a regra a todas as solicitações. Selecione **Add rule** para escolher um tipo de condição: | Condição | Descrição | | - | - | | **Header** | Corresponde ao nome e ao valor de um cabeçalho da solicitação. | | **Model** | Corresponde ao modelo chamado. | | **Identity** | Corresponde à identidade que faz a solicitação. | | **Metadata** | Corresponde aos metadados anexados à solicitação. | | **Project** | Corresponde ao escopo de projeto da solicitação. | Cada **Add rule** cria um grupo de condições com o título **Rule 1 · N conditions**. Dentro de um grupo, selecione **Condition** para adicionar outra condição e para remover uma. Arraste uma condição pela alça para reordená-la. As condições de um grupo são combinadas com `and` por padrão; selecione o botão **AND** entre duas condições para mudar o grupo para `or`. **Delete** remove o grupo inteiro. Os grupos de regras são combinados com `or` por padrão; selecione o botão entre dois grupos para mudá-los para `and`. A expressão gerada aciona o guardrail somente quando é avaliada como verdadeira. ## Editar e excluir uma regra de guardrail Clique no nome de uma regra na lista **Guardrail Rules** para abri-la no mesmo formulário. Uma regra existente exibe **Delete Rule** no rodapé do formulário, ao lado de **Save Changes**. A exclusão exige confirmação. O menu de ações das linhas da lista oferece **Edit**, **Enable** ou **Disable** e **Delete**. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.