Conecta-seEntrar na plataforma

Guardrails

Validar conteúdo segundo regras de segurança e conformidade antes de o fluxo continuar.

Lógica e processamentoRecurso internoConexão: OAuth

O que faz

Valide conteúdo com guardrails. Verifique se o conteúdo é um JSON válido ou corresponde a um padrão regex, detecte alucinações com RAG + pontuação por LLM ou detecte dados pessoais (PII).

Quando usar: Use quando o seu fluxo precisar validar conteúdo segundo regras de segurança e conformidade antes de o fluxo continuar.

Exemplo de situação: Processar os dados antes de seguir para a próxima etapa.

Antes de começar

Conexão necessária: OAuth.

Conecte a conta pelo botão de autorização do campo de credencial e confira qual usuário ou organização foi escolhido.

Passo a passo

  1. Adicione Guardrails ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
  2. Conecte a conta pelo botão de autorização do campo de credencial e confira qual usuário ou organização foi escolhido.
  3. Revise a ação principal descrita no cartão do bloco.
  4. Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
  5. Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
  6. Só publique depois de conferir o resultado da execução de teste.

Campos

  • Entrada

    Obrigatório

    Informe o conteúdo a validar.

  • Tipo de validação

    Obrigatório

    Escolhe uma das opções aceitas por este campo.

    Opções:
    JSON válido · Corresponde a regex · Verificação de alucinação · Detecção de dados pessoais (PII)
    Padrão:
    JSON válido

  • Padrão regex

    Obrigatório conforme a operação

    Expressão regular que o conteúdo precisa seguir para passar na validação (ex.: ^\d{5}-?\d{3}$ para um CEP).

    Quando aparece:
    Quando o campo “Tipo de validação” for “Corresponde a regex”
    Exemplo:
    ^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$

  • Base de conhecimento

    Obrigatório conforme a operação

    Selecione a base de conhecimento.

    Quando aparece:
    Quando o campo “Tipo de validação” for “Verificação de alucinação”
    Exemplo:
    (escolha na lista do campo)

  • Modelo

    Obrigatório conforme a operação

    Escolhe o modelo de inteligência artificial que processará a solicitação.

    Quando aparece:
    Quando o campo “Tipo de validação” for “Verificação de alucinação”
    Padrão:
    claude-sonnet-4-6

  • Confiança

    Nota mínima de confiança, de 0 a 10, que a resposta precisa tirar na verificação de alucinação; notas abaixo desse valor reprovam (padrão 3).

    Quando aparece:
    Quando o campo “Tipo de validação” for “Verificação de alucinação”
    Padrão:
    3

  • Quantidade de resultados

    Em campos adicionais

    Quantos trechos da base de conhecimento são buscados para conferir a resposta, de 1 a 20 (padrão 5); mais trechos dão mais contexto, mas deixam a verificação mais lenta.

    Quando aparece:
    Quando o campo “Tipo de validação” for “Verificação de alucinação”
    Padrão:
    5

  • Conta do Google Cloud

    Obrigatório conforme a operação

    Selecione a conta do Google Cloud.

    Quando aparece:
    Quando o campo “Tipo de validação” for “Verificação de alucinação” e o campo “Modelo” for “__no_model_selected__”
    Exemplo:
    (escolha a conta conectada)

  • Conta do Google Cloud

    Obrigatório conforme a operaçãoEm campos adicionais

    Informe o ID da credencial.

    Quando aparece:
    Quando o campo “Tipo de validação” for “Verificação de alucinação” e o campo “Modelo” for “__no_model_selected__”

  • Chave de API

    Obrigatório conforme a operaçãoDado protegido

    Informe a sua chave de API.

    Quando aparece:
    Quando o campo “Tipo de validação” for “Verificação de alucinação” e o campo “Modelo” for “__no_model_selected__”
    Padrão:
    Segredo protegido

  • Endpoint do Azure

    Dado protegido

    Informa o endereço seguro do serviço ou recurso que será acessado.

    Quando aparece:
    Quando o campo “Tipo de validação” for “Verificação de alucinação” e o campo “Modelo” for “__no_model_selected__”
    Padrão:
    Segredo protegido

  • Versão da API do Azure

    Informe a versão da API.

    Quando aparece:
    Quando o campo “Tipo de validação” for “Verificação de alucinação” e o campo “Modelo” for “__no_model_selected__”

  • Projeto do Vertex AI

    Obrigatório conforme a operaçãoDado protegido

    ID do projeto do Google Cloud em que o Vertex AI está ativado, usado quando o modelo da verificação de alucinação roda pelo Vertex AI (ex.: minha-empresa-ia).

    Quando aparece:
    Quando o campo “Tipo de validação” for “Verificação de alucinação” e o campo “Modelo” for “__no_model_selected__”
    Padrão:
    Segredo protegido

  • Localização do Vertex AI

    Obrigatório conforme a operação

    Região do Google Cloud em que o Vertex AI vai executar o modelo da verificação de alucinação (ex.: us-central1); confira se o modelo está disponível nessa região.

    Quando aparece:
    Quando o campo “Tipo de validação” for “Verificação de alucinação” e o campo “Modelo” for “__no_model_selected__”
    Exemplo:
    us-central1

  • ID da chave de acesso da AWS

    Obrigatório conforme a operaçãoDado protegido

    Informe o ID da chave de acesso da AWS.

    Quando aparece:
    Quando o campo “Tipo de validação” for “Verificação de alucinação” e o campo “Modelo” for “__no_model_selected__”
    Padrão:
    Segredo protegido

  • Chave de acesso secreta da AWS

    Obrigatório conforme a operaçãoDado protegido

    Informe a chave de acesso secreta da AWS.

    Quando aparece:
    Quando o campo “Tipo de validação” for “Verificação de alucinação” e o campo “Modelo” for “__no_model_selected__”
    Padrão:
    Segredo protegido

  • Região da AWS

    Região da AWS em que o Amazon Bedrock vai executar o modelo da verificação de alucinação (ex.: us-east-1 ou sa-east-1, São Paulo); o modelo precisa estar liberado no Bedrock nessa região.

    Quando aparece:
    Quando o campo “Tipo de validação” for “Verificação de alucinação” e o campo “Modelo” for “__no_model_selected__”
    Exemplo:
    us-east-1

  • Tipos de dados pessoais a detectar

    Marque quais tipos de dado pessoal procurar no conteúdo, como nome, e-mail, telefone ou cartão de crédito; sem nenhum marcado, todos são verificados.

    Quando aparece:
    Quando o campo “Tipo de validação” for “Detecção de dados pessoais (PII)”
    Opções:
    Nome de pessoa · Endereço de e-mail · Número de telefone · Número de cartão de crédito · Endereço IP · Local · Data ou hora · URL · Número de conta bancária internacional (IBAN) · Endereço de carteira de criptomoeda · Nacionalidade, grupo religioso ou político · Número de registro médico · Número de identificação do veículo (VIN) · Número do Seguro Social (EUA) · Número do passaporte (EUA) · Carteira de motorista (EUA) · Número de conta bancária (EUA) · Número de identificação de contribuinte, ITIN (EUA) · Número do NHS (Reino Unido) · Número do National Insurance (Reino Unido) · Número NIF (Espanha) · Número NIE (Espanha) · Código fiscal (Itália) · Carteira de motorista (Itália) · Código de IVA (Itália) · Passaporte (Itália) · Carteira de identidade (Itália) · Número PESEL (Polônia) · NRIC/FIN (Singapura) · Número único de entidade, UEN (Singapura) · Número de empresa, ABN (Austrália) · Número de companhia, ACN (Austrália) · Número de registro fiscal, TFN (Austrália) · Número do Medicare (Austrália) · Número de conta permanente, PAN (Índia) · Número Aadhaar (Índia) · Placa de veículo (Índia) · Título de eleitor (Índia) · Passaporte (Índia) · Código de identidade pessoal (Finlândia)
    Exemplo:
    Nome de pessoa

  • Ação

    Obrigatório conforme a operação

    Escolhe uma das opções aceitas por este campo.

    Quando aparece:
    Quando o campo “Tipo de validação” for “Detecção de dados pessoais (PII)”
    Opções:
    Bloquear a requisição · Mascarar dados pessoais
    Padrão:
    Bloquear a requisição

  • Idioma

    Escolhe uma das opções aceitas por este campo.

    Quando aparece:
    Quando o campo “Tipo de validação” for “Detecção de dados pessoais (PII)”
    Opções:
    Inglês · Espanhol · Italiano · Polonês · Finlandês
    Padrão:
    Inglês

  • Padrões personalizados

    Padrões extras de dado pessoal para detectar, um por linha: nome, expressão regular e texto que entra no lugar ao mascarar (ex.: CPF, \d{3}\.\d{3}\.\d{3}-\d{2} e [CPF]).

    Quando aparece:
    Quando o campo “Tipo de validação” for “Detecção de dados pessoais (PII)”

Saídas

Para usar um resultado deste bloco em uma etapa seguinte, digite < no campo e escolha o bloco e o campo. A referência tem o formato <guardrails.input>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.

ReferênciaTipoO que contém
<guardrails.input>stringEntrada original que foi validada.
<guardrails.maskedText>stringTexto com os dados pessoais mascarados (só na detecção de PII no modo mascarar).
<guardrails.validationType>stringTipo de validação executada.
<guardrails.passed>booleanIndica se a validação foi aprovada (true/false).
<guardrails.score>numberNota de confiança (0-10; 0 = alucinação, 10 = fundamentado; só na verificação de alucinação).
<guardrails.reasoning>stringJustificativa da nota de confiança (só na verificação de alucinação).
<guardrails.detectedEntities>arrayDados pessoais detectados (só na detecção de PII).
<guardrails.error>stringMensagem de erro se a validação falhar.

Exemplo de uso

Objetivo: Processar os dados antes de seguir para a próxima etapa.

InícioGuardrailspróxima etapa
Tipo de validação
JSON válido
Padrão regex
^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$
Base de conhecimento
(escolha na lista do campo)
Modelo
claude-sonnet-4-6
Confiança
3

Os valores são ilustrativos. Teste primeiro com dados fictícios ou de homologação.

Erros comuns e como resolver

O bloco não executa
Confira se existe um caminho de setas que parte do gatilho (ou do Início) até este bloco. Blocos soltos no desenho são ignorados.
Aparece “Validação do fluxo” no terminal
Há campo obrigatório vazio. Clique no aviso, abra o bloco indicado e preencha o campo marcado.
Um campo chega vazio na etapa seguinte
Confira se a referência aponta para um bloco que já executou e para um campo que existe, como <guardrails.input>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
Erro de autorização ou permissão (401/403)
A conta conectada perdeu o acesso ou não tem permissão para esta operação. Reconecte a conta no campo de credencial e confirme as permissões pedidas.

Blocos relacionados