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

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.


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.


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.


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.

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.


Atualizado

Isto foi útil?