> For the complete documentation index, see [llms.txt](https://academy.vambe.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.vambe.ai/asistentes-ia/asistentes-ia-pt-br/configuracao-do-assistente/como-controlar-las-respuestas-de-tu-asistente-con-el-juez.md).

# Como controlar as respostas do seu assistente com o Juiz

Por mais completa que seja a configuração de um assistente, em algum momento ele pode mencionar a concorrência, revelar informações sensíveis ou responder fora do tema que lhe corresponde. O **Juiz** é um segundo assistente que revisa cada resposta antes de ela chegar ao usuário e, se detectar que viola uma política definida, corrige-a na hora.

Os Juízes são criados a partir de modelos: escolhe-se o que se quer proteger e preenche-se uma lista simples com as informações relevantes (endereços, dados confidenciais, temas, concorrentes etc.). Um mesmo assistente pode ter vários Juízes atribuídos ao mesmo tempo, cada um revisando uma política diferente de forma independente.

***

### O que se pode alcançar com os Juízes?

* Evitar que o assistente mencione marcas da concorrência
* Evitar que revele endereços ou locais que não coincidam com os oficiais
* Prevenir que revele informações sensíveis do negócio, como valores ou critérios internos
* Manter o assistente dentro de um tema específico, como agendamento ou suporte
* Evitar que confirme ações —uma consulta agendada, um pagamento, um envio— sem que exista uma execução real por trás
* Evitar que forneça preços sem respaldo no catálogo, na base de conhecimento ou nas funções do assistente
* Detectar respostas que contradizem as instruções do assistente, especialmente suas proibições explícitas (Do Not)
* Medir quantas vezes uma correção teria sido aplicada, antes de ativar o Juiz de forma definitiva

***

### Os 7 tipos de Juiz disponíveis

Cada Juiz é criado a partir de um modelo. O nome e o comportamento do Juiz ficam definidos pelo modelo escolhido; basta preencher as informações específicas solicitadas por cada um.

| Tipo                          | O que bloqueia                                                                                  |
| ----------------------------- | ----------------------------------------------------------------------------------------------- |
| **Endereços oficiais**        | Endereços ou locais que não coincidam com os oficiais definidos                                 |
| **Informação confidencial**   | Respostas que revelam valores, limites ou critérios internos definidos como confidenciais       |
| **Tópicos fora de escopo**    | Respostas que desenvolvem temas definidos como proibidos                                        |
| **Menção a concorrente**      | Menções aos concorrentes definidos na lista                                                     |
| **Confirmações sem execução** | Confirmar ações (consulta agendada, pagamento, envio) sem que exista uma execução real por trás |
| **Preços inventados**         | Preços sem respaldo no catálogo, na base de conhecimento ou nas funções do assistente           |
| **Contradição de instruções** | Respostas que contradizem as instruções do assistente ou quebram uma proibição explícita        |

> 💡 O modelo **Contradição de instruções** não requer configuração adicional: avalia cada resposta usando automaticamente o contexto do assistente.

<figure><img src="https://273591867-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjZ46rFloLOG1hJ2JQGi0%2Fuploads%2FMUVR51H2UpX2JLEMsPlk%2Fimage%20(21).png?alt=media&amp;token=c0272745-0d47-4c9d-9c34-f2af8f5c0d16" alt=""><figcaption></figcaption></figure>

***

### Como criar um Juiz

1. Entrar no assistente em que se deseja configurar.
2. Clicar no botão **Juiz** na visualização do assistente.
3. Clicar em **Criar novo** (ou em **Atribuir** se o assistente já tiver outros Juízes).
4. Selecionar o tipo de Juiz entre os 7 modelos disponíveis.
5. Se o modelo exigir, preencher a lista correspondente: endereços oficiais, dados confidenciais, temas proibidos, concorrentes etc.
6. Clicar em **Criar juiz**.

> 💡 O nome do Juiz é definido pelo modelo escolhido; não é necessário escrevê-lo nem redigir a política em texto livre.

***

### Como atribuir Juízes a um assistente

Um assistente pode ter **vários Juízes atribuídos ao mesmo tempo**, um por política, e cada um revisa as respostas de forma independente.

1. Dentro do assistente, clicar em **Juiz** para ver os Juízes já atribuídos e, mais abaixo, os disponíveis na biblioteca.
2. Clicar em **Atribuir** para adicionar outro Juiz da biblioteca a este assistente.
3. Para cada Juiz atribuído, é possível ver a política aplicada e o estado (Ativo / Inativo) correspondente a este assistente em particular.
4. Para editar a configuração de um Juiz de modelo, clicar em **Configurar**.

> ⚠️ Ao atribuir um Juiz, ele fica **Ativo imediatamente** e começa a revisar as respostas a partir desse momento. Pode ser pausado a qualquer momento no mesmo painel, sem necessidade de desatribuí-lo.

<figure><img src="https://273591867-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjZ46rFloLOG1hJ2JQGi0%2Fuploads%2F2AliyX46lZrMDjsmjjGZ%2Fimage%20(22).png?alt=media&amp;token=7092f491-a406-4ba8-9a79-c6c5f154a288" alt=""><figcaption></figcaption></figure>

***

### Ativo vs. Inativo

O estado de cada Juiz é controlado por um interruptor e é configurado de forma independente por assistente:

* **Ativo:** quando o assistente gera uma resposta que viola a política, o Juiz a interrompe e solicita que ela seja reformulada antes de enviá-la ao usuário. Se o assistente voltar a violá-la, isso fica registrado como um incidente.
* **Inativo:** o Juiz detecta e registra as infrações, mas não intervém na conversa.

> 💡 Recomenda-se começar no modo **Inativo** para validar que a política está bem definida e observar com que frequência ela seria ativada, antes de habilitá-la de forma definitiva. O indicador de ativações mostra quantas vezes o Juiz foi ativado nos últimos 30 dias, o que permite avaliar seu impacto e ajustar a configuração se necessário.

As infrações detectadas podem ser revisadas nos logs do assistente, assim como com os guardrails.

<figure><img src="https://1176996256-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjZ46rFloLOG1hJ2JQGi0%2Fuploads%2FUetO7TZyQHePewt69kqh%2Fimage.png?alt=media&#x26;token=9ca9d65e-3f5c-4cf8-98a6-a7af5c18ffba" alt=""><figcaption></figcaption></figure>

***

### Quantos Juízes atribuir

Cada Juiz atribuído representa uma revisão adicional de IA sobre cada resposta do assistente, antes de ela chegar ao usuário. Recomenda-se atribuir apenas os que a operação realmente precisa: adicionar Juízes desnecessários aumenta a latência e o custo sem um benefício adicional.

***

### Como funciona o Juiz entre vários assistentes

* Um mesmo Juiz de modelo pode estar **compartilhado entre vários assistentes**: é criado uma vez na biblioteca e atribuído aos que precisarem.
* Se a configuração de um Juiz compartilhado for editada, a mudança se aplica a todos os assistentes que o tiverem atribuído.
* O estado Ativo / Inativo é configurado **por assistente**: o mesmo Juiz pode estar ativo em um e inativo em outro.

***

### Juízes personalizados existentes (modo somente leitura)

Os Juízes personalizados com regras em texto livre que já existirem na biblioteca continuam funcionando exatamente igual: não são excluídos nem migrados de forma obrigatória. Na biblioteca, aparecem marcados com a etiqueta **Somente leitura**: podem continuar sendo usados e pausados, mas não podem ser editados nem podem ser criados novos Juízes desse tipo.

<figure><img src="https://273591867-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjZ46rFloLOG1hJ2JQGi0%2Fuploads%2Fl6xk4RQWFcob7dODwdRX%2Fimage%20(14).png?alt=media&amp;token=f4552539-7fee-4568-ab5b-1542c167cdf4" alt=""><figcaption></figcaption></figure>

Para modificar a política de um Juiz personalizado existente, o caminho é criar um ou mais Juízes de modelo equivalentes, atribuí-los ao assistente e depois desvincular o Juiz personalizado.

***

### Diferença entre o Juiz e o "Do not"

O **Do not** atua antes de o assistente gerar sua resposta: indica o que ele não deve fazer no momento de construí-la.

O **Juiz** atua depois: revisa a resposta já gerada e a corrige se ela violar uma política. São complementares e podem ser usados juntos —na verdade, o modelo **Contradição de instruções** foi pensado especificamente para reforçar os Do Not do assistente.

***


---

# 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 dynamically by asking a question.

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

```
GET https://academy.vambe.ai/asistentes-ia/asistentes-ia-pt-br/configuracao-do-assistente/como-controlar-las-respuestas-de-tu-asistente-con-el-juez.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
