> For the complete documentation index, see [llms.txt](https://docs.skyone.cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.skyone.cloud/astro/admin/guardrails.md).

# Guardrails

Os **Guardrails** previnem o vazamento de dados no workspace: detectam segredos, dados pessoais e conteúdo proibido em conversas e uploads.

<figure><img src="https://2406186417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGHvosl2xodpQaXzCzxY%2Fuploads%2FpTzrgNjnic3r7Se3YNOB%2FCaptura%20de%20Tela%202026-10-09%20a%CC%80s%2019.23.56.png?alt=media&amp;token=5459760f-d5a0-4272-a55e-f568d7fa5027" alt=""><figcaption></figcaption></figure>

Acompanhe, a seguir, os recursos disponíveis:

### Navegar pelas abas <a href="#navegar-pelas-abas" id="navegar-pelas-abas"></a>

* **Guardrails:** lista de detectores disponíveis e suas configurações.
* **Alertas:** ocorrências detectadas pelos guardrails. O número ao lado indica os alertas não lidos.

### Guardrails disponíveis <a href="#guardrails-disponiveis" id="guardrails-disponiveis"></a>

* **Chaves de API:** formatos conhecidos (AWS, OpenAI, GitHub, Google, Slack), JWTs e chaves privadas PEM.
* **Senhas e credenciais:** senhas explícitas, connection strings e headers de autorização.
* **Segredos por entropia:** tokens de alta entropia sem formato conhecido.
* **Dados pessoais (LGPD):** CPF, CNPJ e cartão com validação real; telefone e chave PIX opcionais.
* **Extensões de arquivo:** bloqueia uploads pela extensão do arquivo (ex.: .env, .pem, .key).
* **Conteúdo de arquivos:** aplica os detectores de texto ao conteúdo dos arquivos enviados.
* **Termos proibidos:** lista do workspace com nomes de clientes, codinomes e temas vetados.
* **Informação sensível (IA):** detecção de informações sensíveis com apoio de IA.

### Ativar e configurar um guardrail <a href="#ativar-e-configurar-um-guardrail" id="ativar-e-configurar-um-guardrail"></a>

Para ativar um guardrail, siga os seguintes passos:

1. Na aba **Guardrails**, ative a chave ao lado do guardrail desejado.
2. Clique em **Configurar** para ajustar o comportamento.
3. Salve as alterações.

O selo ao lado do nome indica o modo de ação configurado:

* **Somente auditar:** registra a ocorrência, sem interromper o usuário.
* **Notificar e bloquear:** avisa o usuário e impede o envio do conteúdo.

{% hint style="info" %}
**Importante:** comece pelo modo **Somente auditar** para avaliar o volume de ocorrências antes de bloquear o conteúdo.
{% endhint %}

### Criar um guardrail personalizado <a href="#criar-um-guardrail-personalizado" id="criar-um-guardrail-personalizado"></a>

Para detectar um padrão específico da sua empresa, siga os seguintes passos:

1. No topo da página, clique em **+ Criar guardrail**.
2. No campo **Nome**, digite um nome para o guardrail.
3. No campo **Expressão regular**, informe o padrão a ser detectado. Exemplo: `MAT-\d{6}` para identificar números de matrícula no formato MAT-123456.
4. Clique em **Salvar**.

### Consultar os alertas <a href="#consultar-os-alertas" id="consultar-os-alertas"></a>

A aba **Alertas** lista as ocorrências detectadas pelos guardrails. O número na aba e o indicador no topo da página mostram quantos alertas ainda não foram lidos.

Para consultar os alertas, siga os seguintes passos:

1. Clique na aba **Alertas**.
2. Se desejar, selecione um guardrail em **Todos os guardrails** para filtrar a lista.
3. Quando disponível, clique no ícone de link externo, ao final da linha, para abrir a conversa em que a ocorrência aconteceu.
4. Depois de revisar os alertas, clique em **Marcar como lidos**.

Cada alerta exibe as seguintes informações:

* **Quando:** data e hora da ocorrência.
* **Guardrail:** guardrail que detectou a ocorrência, o tipo de dado e a quantidade de vezes que ele apareceu (ex.: **cnpj · ×4**).
* **Usuário:** nome e e-mail do usuário da conversa.
* **Ação:** modo aplicado e onde o dado apareceu (ex.: **Somente auditar · Resposta do modelo** ou **Notificar e bloquear · Mensagem**).
* **Trecho:** conteúdo detectado, mascarado para proteger o dado.

{% hint style="success" %}
**Importante:** revise os alertas com frequência. Ocorrências repetidas podem indicar a necessidade de orientar os usuários ou de mudar o guardrail para **Notificar e bloquear**.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.skyone.cloud/astro/admin/guardrails.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
