For the complete documentation index, see llms.txt. This page is also available as Markdown.

Guardrails

Os Guardrails são recursos de governança e segurança utilizados para controlar as interações entre usuários, agentes e modelos de IA.

No Power Omni, o Guardrail é associado ao modelo utilizado pelo agente e funciona como uma camada de proteção para analisar entradas e respostas.

Os Guardrails utilizam recursos do Azure AI Content Safety para detectar conteúdos de risco e aplicar controles de segurança.

Principais objetivos:

  • Bloquear conteúdos inadequados.

  • Reduzir riscos de Prompt Injection e Jailbreak.

  • Aplicar regras corporativas.

  • Controlar informações que podem ser enviadas pelos agentes.

Acesso: Configurações → Artefatos → Guardrails


Aplicação do Guardrail no modelo

O Guardrail é configurado no momento da criação do modelo.

Também é possível editar um modelo existente e alterar o Guardrail associado.

Fluxo:


Políticas

As políticas definem regras de segurança aplicadas ao modelo.

Criar:

Campos:

  • Projeto.

  • Nome.

  • Categorias de segurança.

  • Prompt Shield.

  • Blocklists associadas.


Categorias de segurança

Níveis disponíveis:

Ódio

Controla conteúdos relacionados a discriminação, ataques ou mensagens ofensivas.

Violência

Controla conteúdos envolvendo ameaças, incentivo ou instruções de violência.

Sexual

Controla conteúdos sexualmente explícitos.

Autoagressão

Controla conteúdos relacionados a automutilação ou danos pessoais.


Prompt Shield

O Prompt Shield protege contra tentativas de manipulação do modelo.

Ele analisa a entrada do usuário antes do processamento.

Protege contra:

  • Prompt Injection.

  • Jailbreak.

  • Tentativas de ignorar instruções do sistema.

Exemplo:

Resposta bloqueada:

As mensagens retornadas pelo bloqueio do Guardrail são apresentadas em inglês.


Blocklists

As Blocklists permitem criar regras personalizadas de bloqueio.

Possuem dois tipos de validação:

  • Termos.

  • Padrões Regex.

Exemplo suportado:

Não suportado:


Criando uma Blocklist

Acesso:

Campos:

  • Projeto.

  • Nome.

  • Descrição.

  • Termos.

  • Padrões Regex.


Termos

São bloqueios por correspondência exata.

Exemplo:


Padrões Regex

Permitem bloquear padrões dinâmicos.

Exemplo CPF:

Detecta:


Associação entre Política e Blocklist

Fluxo:

Uma política pode utilizar uma ou mais Blocklists.


Exemplo corporativo

Modelo:

Guardrail:

Configuração:

Blocklist:

Termos:

Regex:


Boas práticas

Criar políticas por cenário

Exemplo:

Ativar Prompt Shield

Recomendado para agentes utilizados por usuários finais.

Usar Blocklists para regras internas

Categorias padrão:

Blocklists:


Resumo

Recurso
Objetivo

Política

Define regras de segurança

Categorias

Controlam conteúdos de risco

Prompt Shield

Protege contra ataques de prompt

Blocklist

Bloqueia termos personalizados

Regex

Bloqueia padrões específicos

Modelo

Local onde o Guardrail é aplicado

Os Guardrails permitem aplicar governança e segurança aos agentes criados no Power Omni.

Atualizado