# Moderação

A tela "Moderação", dividida em "Conjuntos de regras" e "Regras", destina-se à proteção, ocultação e bloqueio de dados. Também estão disponíveis modos de mascaramento de informações, esclarecimento e correção de dados dentro do modelo.

Na seção "Conjuntos de regras" são exibidos grupos de regras relacionadas, e na seção "Regras" as configurações ou instruções específicas que fazem parte desses grupos.

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-9ea529406d4b994e8caf9c33f5bcdef8e7d08263%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(25).png?alt=media" alt=""><figcaption></figcaption></figure>

<table data-header-hidden><thead><tr><th width="51.333251953125"></th><th></th><th valign="top"></th></tr></thead><tbody><tr><td><strong>№ p/p</strong></td><td><strong>Elemento da interface</strong></td><td valign="top"><strong>Descrição</strong></td></tr><tr><td></td><td><strong>Tabela "Conjuntos de regras"</strong></td><td valign="top"></td></tr><tr><td>1.</td><td>botão “Criar“</td><td valign="top">Permite criar um novo conjunto de regras.</td></tr><tr><td>2.</td><td>botão "Atualizar"</td><td valign="top">Permite atualizar forçadamente a tabela "Conjuntos de regras".</td></tr><tr><td>3.</td><td>botão "Duplicar"</td><td valign="top">Permite duplicar um conjunto de regras criado anteriormente.</td></tr><tr><td>4.</td><td>botão "Excluir selecionado"</td><td valign="top">Permite excluir os conjuntos de regras selecionados do Sherpa AI Server. Conjuntos de regras individuais também podem ser excluídos clicando no botão na linha correspondente da tabela "Conjuntos de regras". Ao excluir um conjunto de regras, uma janela de confirmação de exclusão aparece.</td></tr><tr><td>5.</td><td>botão "Exportar para CSV"</td><td valign="top">Gera um arquivo de dados dos conjuntos de regras no formato CSV para importação em planilhas e sistemas de contabilidade.</td></tr><tr><td>6.</td><td>botão "Exportar para XLSX"</td><td valign="top">Gera um arquivo de dados dos conjuntos de regras no formato Microsoft Excel (XLSX) para importação em planilhas e sistemas de contabilidade.</td></tr><tr><td>7.</td><td>coluna "Ativo"</td><td valign="top">Data e hora da última alteração da pasta de acesso.</td></tr><tr><td>8.</td><td>coluna "Nome"</td><td valign="top">Nome do conjunto de regras.</td></tr><tr><td>9.</td><td>coluna "Descrição"</td><td valign="top">Texto de descrição do conjunto de regras.</td></tr><tr><td>10.</td><td>coluna "Modo de aplicação das regras"</td><td valign="top"><p>Ordem de processamento de várias regras acionadas para um único objeto.</p><p>Opções de valores:</p><ol><li>Aplicar apenas a primeira regra acionada: O processamento é interrompido após a primeira regra (prioridade pela ordem na lista).</li><li>Aplicar todas as regras acionadas: Todas as regras que atendem às condições são processadas sequencialmente (execução em cascata).</li></ol></td></tr><tr><td>11.</td><td>coluna "Criado"</td><td valign="top">Data e hora de criação do conjunto de regras.</td></tr><tr><td>12.</td><td>coluna "Alterado"</td><td valign="top">Data e hora da última alteração do conjunto de regras.</td></tr><tr><td></td><td><strong>Tabela "Regras"</strong></td><td valign="top"></td></tr><tr><td>1.</td><td>botão "Criar"</td><td valign="top">Permite criar uma nova regra.</td></tr><tr><td>2.</td><td>botão "Atualizar"</td><td valign="top">Permite atualizar forçadamente a tabela "Regras".</td></tr><tr><td>3.</td><td>botão "Excluir selecionado"</td><td valign="top">Permite excluir as regras selecionadas do Sherpa AI Server. Regras individuais também podem ser excluídas clicando no botão na linha correspondente da tabela "Regras". Ao excluir uma regra, uma janela de confirmação de exclusão aparece.</td></tr><tr><td>4.</td><td>botão "Exportar para CSV"</td><td valign="top">Gera um arquivo de dados da regra no formato CSV para importação em planilhas e sistemas de contabilidade.</td></tr><tr><td>5.</td><td>botão "Exportar para XLSX"</td><td valign="top">Gera um arquivo de dados da regra no formato Microsoft Excel (XLSX) para importação em planilhas e sistemas de contabilidade.</td></tr><tr><td>6.</td><td>coluna "Ativo"</td><td valign="top">Indica se a regra está em aplicação.</td></tr><tr><td>7.</td><td>coluna "Nome"</td><td valign="top">Nome da regra.</td></tr><tr><td>8.</td><td>coluna "Descrição"</td><td valign="top">Texto de descrição da regra.</td></tr><tr><td>9.</td><td>coluna "Tipo de gatilho"</td><td valign="top">Condições sob as quais esta regra é acionada.</td></tr><tr><td>10.</td><td>coluna "Ações"</td><td valign="top">Modos de processamento da regra acionada (mascaramento, reescrita, redirecionamento, notificação, resposta fixa).</td></tr><tr><td>11.</td><td>coluna "Criado"</td><td valign="top">Data e hora de criação da regra.</td></tr><tr><td>12.</td><td>coluna "Alterado"</td><td valign="top">Data e hora da última alteração da regra.</td></tr></tbody></table>

## Criar conjunto de regras

Para criar um novo conjunto de regras, é necessário clicar no botão "Criar" na tabela "Conjuntos de regras" e preencher o formulário que se abre.

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-d6bad4c48f1b07f080841353dfa516210144ed50%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(22).png?alt=media" alt=""><figcaption></figcaption></figure>

* **Nome \*** — nome do conjunto de regras.
* **Descrição** — descrição do conjunto de regras.
* **Modo de aplicação das regras \*** — lista suspensa que determina a ordem de processamento de várias regras acionadas para um único objeto. Opções de valores:
  * **Aplicar apenas a primeira regra acionada**: O processamento é interrompido após a primeira regra (prioridade pela ordem na lista).
  * **Aplicar todas as regras acionadas**: Todas as regras que atendem às condições são processadas sequencialmente (execução em cascata).

## Criar regra

Para criar uma nova regra, é necessário clicar no botão “Criar” na tabela “Regras” e preencher o formulário que se abre.

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-9fca89b82f9c45fc6d3ca99726ef13cfefbd2768%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(23).png?alt=media" alt=""><figcaption></figcaption></figure>

* **Nome \*** – campo obrigatório para inserir o nome do conjunto de regras.
* **Descrição** – campo para inserir a descrição do conjunto de regras.

### Gatilho

* **Tipo de gatilho \*** – campo obrigatório com uma lista suspensa para selecionar a condição sob a qual esta regra é acionada. Valores possíveis:

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-2fcc2abbaac7d22283f8747f5c9da4e573140d0e%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(522).png?alt=media" alt=""><figcaption></figcaption></figure>

#### **Dicionário**

**Dicionário** – é um conjunto de frases ou palavras específicas que é usado para reconhecer e processar dados de entrada.

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-fd6cf91c8429ce6a8be1ea1e661203b1f1bd8312%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(523).png?alt=media" alt=""><figcaption></figcaption></figure>

* **Lista de palavras** – campo para inserir frases e palavras que compõem o dicionário. Cada frase ou palavra deve ser colocada em uma linha separada (todas as palavras devem ser escritas uma por linha, cada uma em sua própria linha).

#### **Expressão regular**

**Expressão regular** – são símbolos especiais que permitem descrever determinados padrões ou padrões que precisam ser procurados no texto.

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-748248e7a1a1ef5f4d8135266c670f7df772626e%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(524).png?alt=media" alt=""><figcaption></figcaption></figure>

* **Lista de expressões regulares** – campo para inserir expressões regulares que serão verificadas na solicitação. Em uma linha da lista deve haver apenas uma expressão regular.

#### **Modelo local**

**Modelo local** – um gatilho que é usado para que a regra seja acionada ao usar uma instância específica do modelo. Dentro da configuração, todos os parâmetros necessários são definidos: modelo, prompt, Regex para validação da resposta e temperatura.

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-46e06cf88ef27e652ae90490fcb2464d66f26fc4%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(525).png?alt=media" alt=""><figcaption></figcaption></figure>

* **Modelo** – campo para selecionar o modelo de IA para geração ou processamento da resposta;
* **Prompt** – modelo de solicitação ao modelo de IA;
* **Regexp para validação da resposta** – expressão regular para validação da resposta do modelo;
* **Temperatura** – parâmetro numérico de geração do modelo (de 0 a 1) que influencia a criatividade da resposta.

#### **Serviço externo**

**Serviço externo** – URL que é usada ao chamar uma API externa específica pelo URL fornecido. Quando é necessário iniciar um evento ou obter informações, o sistema envia uma solicitação para o URL do serviço externo.

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-0d36a64e9b28db620797c1b6ddd8eb8605ded3b0%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(526).png?alt=media" alt=""><figcaption></figcaption></figure>

* **URL do serviço externo** – endereço da API externa ou serviço para moderação de dados.

### Ações

**Ações** – modos de processamento da regra acionada (mascaramento, reescrita, redirecionamento, notificação, resposta fixa).

#### **Bloqueio**

**Bloqueio** – ação, ao escolher a qual a mensagem será bloqueada, e a rede neural responderá com uma simples notificação de erro.

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-8f18f619ac3dc853ddf349bcb169b26689ae5aa5%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(527).png?alt=media" alt=""><figcaption></figcaption></figure>

#### **Mascaramento**

**Mascaramento** – ação para ocultar dados. Se for necessário substituir ou ocultar certas palavras, elas são borradas na resposta (e também borradas na solicitação). Isso é especialmente importante para que a função de moderação evite a vazamento de informações sensíveis do contorno interno da empresa para o serviço de rede neural externo.

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-74038786885400ce400e3d5d9d0903bd8369f142%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(528).png?alt=media" alt=""><figcaption></figcaption></figure>

* **Texto de substituição** – campo de texto de uma linha que define a string para substituir palavras sensíveis.

#### **Reescrever**

**Reescrever** – ação que permite enviar uma solicitação adicional para o próprio modelo com um determinado prompt, cujo objetivo é parafrasear ou substituir palavras indesejadas. Essa abordagem ajuda a evitar o uso de conteúdo indesejado sem bloquear ou remover a mensagem original.

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-6ccebb6c4ef299f1a4bce51518779f6ed532f7e5%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(529).png?alt=media" alt=""><figcaption></figcaption></figure>

* **Modelo** – lista suspensa para selecionar o modelo interno de IA para parafrasear.
* **Prompt** – campo de várias linhas que representa um modelo de instrução para reescrever a solicitação.
* **Temperatura** – campo numérico (de 0 a 1) que avalia o nível de criatividade da geração.

#### **Redirecionamento**

**Redirecionamento** – ação que permite enviar a solicitação para outro modelo ou serviço, permitindo gerenciar flexivelmente o processamento de dados.

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-1193cd61dc4ef4d220c6bddadef7737406341d85%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(530).png?alt=media" alt=""><figcaption></figcaption></figure>

* **Modelo** – lista suspensa para selecionar o modelo interno de IA para redirecionar a solicitação.

#### **Notificação**

**Notificação** – ação que permite que o sistema não bloqueie a própria mensagem, mas simplesmente registre o fato da solicitação, enviando a notificação correspondente ao administrador. Nos logs ou auditoria, é mantida a informação de que o Usuário fez uma pergunta contendo conteúdo inadequado ou sensível, o que ajuda o serviço de segurança a reagir a tempo.

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-511926cec167f12ff45199d75fad6cc0ce00abaf%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(531).png?alt=media" alt=""><figcaption></figcaption></figure>

#### **Resposta fixa**

**Resposta fixa** – ação que permite ao Usuário receber uma resposta pré-definida sem recorrer à rede neural externa. Essa resposta pode servir como uma notificação de erro ou restrições (por exemplo, sobre palavras ou expressões inaceitáveis). Ela pode ser ampliada, adicionando à mensagem uma explicação mais informativa sobre o que é especificamente inaceitável no sistema.

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-86d46385b67b124e99d96f4e1897f08477903ec0%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(532).png?alt=media" alt=""><figcaption></figcaption></figure>

* **Resposta fixa** – campo de texto de várias linhas que permite definir o texto pronto da resposta.

### Texto de teste

Para verificar se a ação escolhida está funcionando corretamente, você pode usar o campo "Texto de teste". Digite o texto nele e clique no botão "Executar teste".

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-db08e8761ac27f6e1c979a9761c42a0e2ce0a5d2%2Fimage%20(277).png?alt=media" alt=""><figcaption></figcaption></figure>

### Editar conjunto de regras

Para visualizar e editar as propriedades de um conjunto de regras específico, é necessário selecioná-lo na lista e clicar no botão ![](https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-dc74b7a07745f14c6ce68ae542872c3b70988ebe%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20\(70\).png?alt=media). Depois disso, um formulário com as configurações do conjunto de regras será aberto, onde você pode fazer as alterações necessárias. Não há novos campos no conjunto de regras criado anteriormente.

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-3153c22236bb73314bd6d07f5d87d0e5de65bce7%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20(24).png?alt=media" alt=""><figcaption></figcaption></figure>

### Editar regra

Para visualizar e editar as propriedades de uma regra específica, é necessário selecioná-la na lista e clicar no botão ![](https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-dc74b7a07745f14c6ce68ae542872c3b70988ebe%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20\(70\).png?alt=media). Depois disso, um formulário com as configurações da regra será aberto, onde você pode fazer as alterações necessárias. Não há novos campos na regra criada anteriormente.

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-08e7bd22160833bacac3b955baea58eef22a32d2%2F2025-08-06_22-55-48.png?alt=media" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sherparpa.ru/pt/sherpa-ai/sherpa-ai-server/rabota-v-sherpa-ai-server/moderaciya.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
