> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kiraa.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Rules (Regras)

> Defina limites e restrições de comportamento para seus agentes

As **Rules** (Regras) são restrições configuráveis que definem os limites de comportamento dos seus agentes de IA. Com elas, você estabelece o que o agente **não deve fazer** durante as conversas, garantindo conformidade, ética e segurança.

<CardGroup cols={3}>
  <Card title="Conformidade" icon="scale-balanced">
    Garanta que seu agente siga regulamentações e políticas da empresa.
  </Card>

  <Card title="Segurança" icon="shield-check">
    Evite que o agente compartilhe informações sensíveis ou faça promessas indevidas.
  </Card>

  <Card title="Qualidade" icon="star">
    Mantenha um padrão de atendimento consistente e profissional.
  </Card>
</CardGroup>

## Como funcionam?

<Steps>
  <Step title="Crie a Rule">
    Defina uma regra com nome descritivo e conteúdo detalhando a restrição.
  </Step>

  <Step title="Vincule ao Agente">
    Conecte a Rule aos agentes que devem seguir esta restrição.
  </Step>

  <Step title="Agente respeita automaticamente">
    Durante a conversa, o agente considera as Rules vinculadas e evita os comportamentos proibidos.
  </Step>
</Steps>

<Tip>
  Uma mesma Rule pode ser vinculada a múltiplos agentes, permitindo padronização de políticas.
</Tip>

***

## Campos de Configuração

| Campo        | Obrigatório | Descrição                                                     |
| ------------ | ----------- | ------------------------------------------------------------- |
| **Nome**     | Sim         | Identificador descritivo da regra (ex: "Não fazer promessas") |
| **Conteúdo** | Sim         | Descrição detalhada da restrição (mínimo 10 caracteres)       |

O conteúdo de uma Rule deve ser claro e específico:

* **Use linguagem de proibição explícita**: "NUNCA faça...", "NÃO diga...", "É proibido..."
* **Liste exemplos concretos**: Frases ou situações específicas a evitar
* **Explique o motivo**: Ajuda o agente a entender o contexto
* **Defina exceções se houver**: Quando a regra não se aplica

***

## Página de Rules

<Steps>
  <Step title="Acesse o Dashboard">
    Faça login em [kiraa.com.br](https://kiraa.com.br)
  </Step>

  <Step title="Navegue para Rules">
    No menu lateral, abra **Studio de IA > Rules**.
  </Step>

  <Step title="Visualize suas regras">
    A página mostra o total de Rules e a tabela com todas as regras criadas.
  </Step>
</Steps>

A página de Rules oferece:

* **Card de Estatísticas**: Total de Rules criadas
* **Campo de Busca**: Pesquise por nome ou conteúdo
* **Tabela de Rules**: Visualize nome, conteúdo (resumido) e data de criação de cada Rule

***

## Criando uma Rule

<Steps>
  <Step title="Clique em Nova Rule">
    No canto superior direito da página, clique no botão **Nova Rule**.
  </Step>

  <Step title="Preencha o Nome">
    Digite um nome descritivo que identifique a restrição (ex: "Não interromper o cliente").
  </Step>

  <Step title="Escreva o Conteúdo">
    Descreva detalhadamente o que o agente não deve fazer, incluindo exemplos e situações.
  </Step>

  <Step title="Clique em Criar">
    Revise as informações e clique em **Criar** para salvar a Rule.
  </Step>
</Steps>

### Editando uma Rule

1. Na tabela de Rules, clique na linha da regra que deseja editar
2. Você será levado à página de edição com os campos de nome e conteúdo
3. Modifique o que for necessário e clique em **Salvar**

<Warning>
  Alterações em uma Rule afetam todos os agentes vinculados a ela imediatamente.
</Warning>

***

## Vinculando Rules a Agentes

<Steps>
  <Step title="Acesse o Agente">
    Vá para a página **Agentes** e clique no agente desejado.
  </Step>

  <Step title="Localize a Seção Rules">
    Role até encontrar a seção **Rules**.
  </Step>

  <Step title="Clique em Vincular Rule">
    Clique no botão **Vincular Rule**.
  </Step>

  <Step title="Selecione a Rule">
    Na aba **Rules Existentes**, busque e selecione a Rule desejada, ou crie uma nova na aba **Criar Nova**.
  </Step>
</Steps>

Para desvincular, clique no ícone de lixeira ao lado da Rule na seção Rules do agente. A Rule não será excluída, apenas desvinculada.

<Tip>
  Para entender a diferença entre Skills e Rules: **Skills** ensinam o que o agente **deve** fazer, enquanto **Rules** definem o que ele **não deve** fazer. Veja mais em [Skills](/skills).
</Tip>

***

## Exemplos Práticos

<Tabs>
  <Tab title="Cobrança">
    ### Rules para Agentes de Cobrança

    **Confidencialidade Absoluta**

    ```
    NUNCA revele a dívida para terceiros.

    Informações sobre débito só podem ser dadas ao próprio devedor, 
    após confirmação de identidade.

    Se terceiro perguntar o motivo:
    "É um assunto particular que só posso tratar com [nome]."

    PROIBIDO dizer para terceiros:
    - "É sobre uma dívida"
    - "Ele/ela está devendo"
    - Qualquer valor ou detalhe
    ```

    **Respeitar Limites Legais**

    ```
    Horários permitidos:
    - Segunda a sexta: 8h às 20h
    - Sábados: 8h às 14h
    - Domingos e feriados: PROIBIDO

    Frequência de contato:
    - Máximo 3 tentativas por dia
    - Intervalo mínimo de 2 horas
    - Se pedir para não ligar, registre e pare
    ```
  </Tab>

  <Tab title="Universal">
    ### Rules Universais (Qualquer Segmento)

    **Não Fazer Promessas Falsas**

    ```
    NUNCA prometa algo que você não tem certeza.

    Proibido dizer:
    - "Garanto que vai funcionar"
    - "Com certeza vai resolver"
    - "Prometo que vai chegar amanhã"

    Em vez disso, diga:
    - "Vou verificar e te confirmo"
    - "A previsão é X, mas vou acompanhar"
    ```

    **Manter Postura Profissional**

    ```
    NUNCA:
    - Use gírias ou linguagem informal excessiva
    - Faça piadas inapropriadas
    - Demonstre irritação ou impaciência
    - Discuta política, religião ou temas polêmicos

    Se o cliente for rude:
    Mantenha a calma e foque na solução.
    ```
  </Tab>
</Tabs>

***

## Boas Práticas

<CardGroup cols={2}>
  <Card title="Seja Específico" icon="crosshairs">
    Rules vagas são ignoradas. Detalhe exatamente o que é proibido com exemplos concretos.
  </Card>

  <Card title="Use Linguagem Clara" icon="message">
    Prefira frases como "NUNCA faça X" em vez de "Evite fazer X quando possível".
  </Card>
</CardGroup>

**Estrutura recomendada para o conteúdo:**

```
[Explicação do motivo/importância]

[Lista do que NÃO fazer]:
- Item 1
- Item 2

[O que fazer em vez disso] (opcional):
- Alternativa 1
- Alternativa 2
```

***

## Excluindo uma Rule

Na tabela de Rules, clique no menu de ações (três pontos) da regra e selecione **Excluir**. Confirme no diálogo.

<Warning>
  Ao excluir uma Rule:

  * Ela será **desvinculada de todos os agentes** automaticamente
  * Os agentes perderão esta restrição imediatamente
  * Esta ação **não pode ser desfeita**
</Warning>

***

## Resolução de Problemas

| Problema                       | Solução                                            |
| ------------------------------ | -------------------------------------------------- |
| Rule não está sendo respeitada | Reescreva com mais detalhes e exemplos específicos |
| Rule não aparece no agente     | Acesse o agente e vincule a Rule na seção Rules    |
| Agente muito restritivo        | Revise e consolide Rules redundantes               |

***

## Próximos Passos

<CardGroup cols={2}>
  <Card title="Skills" icon="graduation-cap" href="/skills">
    Ensine habilidades específicas aos seus agentes
  </Card>

  <Card title="Tools" icon="wrench" href="/tools">
    Integre seu agente com APIs e sistemas externos
  </Card>

  <Card title="Playground" icon="play" href="/playground">
    Teste seus agentes com as Rules configuradas
  </Card>

  <Card title="Documentos" icon="file-lines" href="/documents">
    Adicione conhecimento aos seus agentes
  </Card>
</CardGroup>