Pular para o conteúdo principal
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. 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.
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.
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.
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.
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.
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.
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

​
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. Cada guardrail vinculado é uma linha com os controles abaixo.

​
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. O catálogo de entidades detectáveis do PII Detection é compartilhado com o plugin PII Redaction 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 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.
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: 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.