> For the complete documentation index, see [llms.txt](https://help.hyperflow.global/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.hyperflow.global/docs/desk-hyperflow/inteligencia-artificial-supervisores.md).

# Inteligência artificial - Supervisores

Crie e gerencie os supervisores responsáveis pela análise das interações.

O Supervisor Inteligente é um recurso de Inteligência Artificial que analisa, automaticamente, os atendimentos já finalizados. Assim que uma conversa termina, seja ela atendida por um agente humano, por um Assistente Inteligente ou finalizada sem interação, o Supervisor lê o histórico e gera um relatório com resumo, sentimento do cliente, qualidade do atendimento e outros indicadores.

{% hint style="info" %}
O Supervisor Inteligente **não participa da conversa em tempo real** e não interfere no atendimento enquanto ele acontece. Toda a análise é feita depois que o protocolo é encerrado, funcionando como uma auditoria automática de qualidade.
{% endhint %}

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FCqQ99qF5NCTB1hjfq0tM%2Fimage.png?alt=media&amp;token=369a3bec-6075-4b63-91b2-fbeffdbf8c42" alt=""><figcaption><p>Imagem 1 - Tela principal com a lista de supervisores cadastrados</p></figcaption></figure>

***

### 📍 Como acessar

1. No menu lateral esquerdo, clique em **Supervisores** para ser direcionado à tela correta, dentro do menu de 'Inteligência Artificial'.

{% hint style="warning" %}
Este recurso é um item adicional (addon) do plano contratado. Caso sua conta ainda não tenha o Supervisor Inteligente liberado, a tela exibirá uma proposta de contratação em vez da lista de supervisores.
{% endhint %}

***

### 🧩 Conhecendo a tela

A tela de **Supervisores Inteligentes** é organizada em duas abas: **Supervisores** e **Parâmetros Customizados**.

#### 📋 Aba Supervisores

Nesta aba fica a lista de todos os supervisores já criados, com as seguintes colunas:

<table data-search="false"><thead><tr><th>Coluna</th><th>O que mostra</th></tr></thead><tbody><tr><td><strong>Avatar</strong></td><td>Imagem de identificação do supervisor</td></tr><tr><td><strong>Nome</strong></td><td>Nome cadastrado. Ao passar o mouse, aparece a descrição do supervisor</td></tr><tr><td><strong>Habilitado</strong></td><td>Indica se o supervisor está ativo (<strong>Habilitado</strong>) ou pausado (<strong>Desabilitado</strong>)</td></tr><tr><td><strong>Departamentos</strong></td><td>Departamentos que este supervisor cobre</td></tr><tr><td><strong>Parâmetros</strong></td><td>Quantidade de parâmetros de análise vinculados</td></tr><tr><td><strong>Criado por</strong></td><td>Usuário que criou o supervisor</td></tr><tr><td><strong>Atualizado em</strong></td><td>Data da última alteração</td></tr></tbody></table>

Cada linha também tem os botões de **Editar** e **Remover**.

{% hint style="info" %}
Se ainda não existir nenhum supervisor criado, a tela mostra uma mensagem de apresentação do recurso ("Tenha análises instantâneas de qualidade, sentimento e tempos de resposta com IA") com um botão para começar a criação.
{% endhint %}

#### 🎛️ Aba Parâmetros Customizados

Nesta aba fica o catálogo de **parâmetros de análise** que podem ser reaproveitados em qualquer supervisor. Veja os detalhes completos na seção 🎯 Parâmetros Customizados mais abaixo.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2Fnv1Ffp11VBGXY1BuGqhJ%2Fimage.png?alt=media&amp;token=8940e735-899d-4e1a-af6a-a381c8175968" alt=""><figcaption><p>Imagem 2 - Aba "Parâmetros Customizados" com a lista de parâmetros cadastrados</p></figcaption></figure>

***

### ➕ Como criar um novo Supervisor

**🎯 Propósito**

Cadastrar um novo supervisor para que ele passe a analisar automaticamente os atendimentos finalizados de um ou mais departamentos.

**✅ Como fazer na tela**

1. Na aba **Supervisores**, clique em **Criar Supervisor**.
2. Uma janela é aberta com um passo a passo de 4 etapas: **Geral**, **Departamentos**, **Indicadores gerais** e **Parâmetros**.
3. Preencha cada etapa (detalhadas logo abaixo) e avance clicando em **Próximo**.
4. Na última etapa, clique em **Criar Supervisor**.

**📌 Resultado esperado**

O supervisor é criado e passa a aparecer na lista da aba **Supervisores**. Uma mensagem de confirmação é exibida na tela.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FinDHcUGxulGO8baSqrMk%2Fimage.png?alt=media&amp;token=691640eb-af29-462e-8161-eb050e2d1c67" alt=""><figcaption><p>Imagem 3 - Janela de criação do supervisor mostrando as 4 etapas no topo</p></figcaption></figure>

{% hint style="warning" %}
Apenas **um supervisor pode estar habilitado por departamento** ao mesmo tempo. Ao selecionar departamentos na etapa 2, só aparecem como disponíveis aqueles que ainda não têm um supervisor ativo.
{% endhint %}

***

### 1️⃣ Etapa Geral

Nesta etapa você define as informações básicas e as condições de ativação do supervisor.

| Campo                      | O que preencher                                                                                                                                                                                     |
| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Avatar**                 | Imagem de identificação do supervisor. Aceita JPEG ou PNG, até 2 MB                                                                                                                                 |
| **Nome do Supervisor**     | Um nome claro e descritivo, por exemplo: "Supervisor de Atendimento ao Cliente". Campo obrigatório                                                                                                  |
| **Descrição**              | Um texto opcional explicando o propósito deste supervisor. Fica visível para outros usuários da conta. Você pode clicar no botão de melhoria com IA para gerar ou aprimorar o texto automaticamente |
| **Analisar Protocolos de** | Define quais tipos de atendimento finalizado este supervisor deve analisar (veja a tabela abaixo)                                                                                                   |
| **Habilitado**             | Ativa ou pausa o supervisor (veja o aviso sobre "um supervisor por departamento" acima)                                                                                                             |

#### 🧭 Opções de "Analisar Protocolos de"

Você pode marcar uma ou mais opções:

| Opção                                      | Quando o atendimento é analisado                                                                                                                      |
| ------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Protocolos de Agentes**                  | Atendimentos conduzidos por um agente humano                                                                                                          |
| **Protocolos de Assistentes Inteligentes** | Atendimentos conduzidos por um Assistente Inteligente (agente de IA que conversa com o cliente). Saiba mais na documentação do Assistente Inteligente |
| **Protocolos Automáticos**                 | Atendimentos finalizados automaticamente, sem nenhuma interação humana                                                                                |

#### 🎚️ Critérios para analisar

Ainda na etapa Geral, você pode definir um critério mínimo para que a análise seja feita:

| Campo                   | O que preencher                                                                                                                                     |
| ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Mínimo de mensagens** | Quantidade mínima de mensagens trocadas para que o protocolo seja analisado (de 0 a 500). Deixe vazio para analisar todos os protocolos, sem mínimo |
| **Contar em**           | Em qual direção contar as mensagens: **Qualquer direção**, **Cliente** ou **Agente**                                                                |

{% hint style="info" %}
Se um protocolo não atingir o mínimo de mensagens configurado, ele simplesmente não será analisado. Isso evita gastar análises com conversas muito curtas, como um "oi" sem continuidade.
{% endhint %}

#### 🔁 Análises anteriores como contexto

Você também pode habilitar o uso de análises anteriores do mesmo contato como contexto extra para a análise atual:

| Campo                                      | O que preencher                                                                             |
| ------------------------------------------ | ------------------------------------------------------------------------------------------- |
| **Usar análises anteriores como contexto** | Ativa ou desativa o uso do histórico de análises anteriores deste contato                   |
| **Máximo de análises anteriores**          | Quantas análises anteriores usar como referência (de 1 a 10, começando pelas mais recentes) |

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FQfzcYW5KE22vO44Xzrin%2Fimage.png?alt=media&amp;token=448b0547-f1fa-42f1-b42e-889931797b32" alt=""><figcaption><p>Imagem 4 - Etapa Geral com os campos de nome, descrição e avatar preenchidos</p></figcaption></figure>

{% hint style="info" %}
Essas análises anteriores servem apenas como contexto adicional para a IA entender o histórico do contato. A análise do protocolo atual continua sendo feita normalmente, de forma independente.
{% endhint %}

***

### 2️⃣ Etapa Departamentos

**🎯 Propósito**

Definir em quais departamentos este supervisor vai atuar.

**✅ Como fazer na tela**

1. Utilize o campo de busca para localizar um departamento pelo nome.
2. Marque um ou mais departamentos na lista de **Disponíveis**. Eles passam para a lista de **Selecionados**.
3. Use os botões **Selecionar todos** ou **Desmarcar todos** para agilizar a seleção.

**📌 Resultado esperado**

O contador no topo mostra quantos departamentos foram selecionados (por exemplo, "3 / 8 Selecionados"). É obrigatório escolher ao menos um departamento para avançar.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FK0wvXHQ5j5N6CwbiWbfZ%2Fimage.png?alt=media&amp;token=6b676c9d-8f74-4d79-ac10-2298f0be3545" alt=""><figcaption><p>Imagem 5 - Etapa Departamentos com as listas de "Selecionados" e "Disponíveis"</p></figcaption></figure>

{% hint style="warning" %}
Só aparecem na lista de disponíveis os departamentos que **ainda não têm** um supervisor habilitado. Se um departamento não aparecer, verifique se ele já está vinculado a outro supervisor ativo na aba **Supervisores**.
{% endhint %}

***

### 3️⃣ Etapa Indicadores gerais

Nesta etapa você personaliza os textos (prompts) que orientam a Inteligência Artificial a extrair cada indicador padrão da conversa. Todos os campos já vêm com um texto sugerido, que pode ser mantido ou personalizado.

#### 📝 Campos de resumo

| Campo        | O que define                                                          |
| ------------ | --------------------------------------------------------------------- |
| **Resumo**   | Como a IA deve resumir a interação                                    |
| **Problema** | Como a IA deve identificar o problema principal relatado pelo cliente |
| **Solução**  | Como a IA deve identificar a solução que foi oferecida                |
| **Dica**     | Como a IA deve gerar uma dica de melhoria para atendimentos futuros   |

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FVToRzdY9B0141rVIsE9k%2Fimage.png?alt=media&amp;token=d088858b-2223-4311-a780-3d5b5412dc0d" alt=""><figcaption><p>Imagem 6 - Bloco "Campos de resumo" com os quatro textos de prompt</p></figcaption></figure>

#### ✅ Resolutividade

| Campo                         | O que define                                                 |
| ----------------------------- | ------------------------------------------------------------ |
| **Prompt para resolvido**     | Quando a IA deve considerar que o problema foi resolvido     |
| **Prompt para não resolvido** | Quando a IA deve considerar que o problema não foi resolvido |

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FzY3RZlGBmnKADAXHwnIo%2Fimage.png?alt=media&amp;token=6874e7e2-bed6-4258-baef-955a1e44558f" alt=""><figcaption><p>Imagem 7 - Bloco "Resolutividade" com os dois prompts</p></figcaption></figure>

#### 😊 Sentimento do cliente e 🎯 Qualidade do atendimento

Estes dois blocos funcionam da mesma forma e definem como a IA vai classificar, em níveis, o sentimento do cliente durante a conversa e a qualidade percebida do atendimento. Para cada um, você pode configurar até **5 níveis**, cada um com:

| Campo do nível               | O que preencher                                                  |
| ---------------------------- | ---------------------------------------------------------------- |
| **Nome do nível**            | Por exemplo: Positivo, Neutro, Negativo                          |
| **Cor**                      | Cor usada para identificar visualmente o nível nos relatórios    |
| **Faixa de** / **Faixa até** | Intervalo de nota, de 1 a 10, que corresponde a este nível       |
| **Prompt**                   | Como a IA deve identificar que a conversa se encaixa neste nível |

Por padrão, já vêm 3 níveis pré-configurados (por exemplo, Negativo de 1 a 4, Neutro de 5 a 7 e Positivo de 8 a 10), que podem ser editados ou complementados com o botão **Adicionar nível**.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FGE7Rs3bQTOMeDd7fe8lb%2Fimage.png?alt=media&amp;token=a1e62af2-a2e5-4563-ace4-4dbed4f67bcb" alt=""><figcaption><p>Imagem 8 - Blocos "Sentimento do cliente" e "Qualidade do atendimento" com os níveis configurados</p></figcaption></figure>

{% hint style="info" %}
Todos os campos de prompt desta etapa possuem o botão de melhoria com IA, que ajuda a gerar um texto mais claro a partir do que você já escreveu.
{% endhint %}

***

### 4️⃣ Etapa Parâmetros

Esta é a etapa em que você escolhe quais **parâmetros de análise** (também chamados de parâmetros customizados) este supervisor vai extrair de cada conversa, além dos indicadores padrão já definidos na etapa anterior.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FD0wdK71P65L9FX7LuStH%2Fimage.png?alt=media&amp;token=322435bf-58b6-4840-b843-713ccb63e4c6" alt=""><figcaption><p>Imagem 9 - Etapa Parâmetros com a lista de parâmetros já adicionados ao supervisor</p></figcaption></figure>

**✅ Como adicionar um parâmetro já existente**

1. Clique em **Adicionar parâmetro**.
2. Uma lista com os parâmetros já cadastrados no catálogo (e ainda não usados neste supervisor) é exibida. Use o campo de busca para localizar pelo nome.
3. Clique no parâmetro desejado para adicioná-lo a este supervisor.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FbbudVMWB9VBUFdpppsVI%2Fimage.png?alt=media&amp;token=eb1e4bb3-aed0-4c1d-8131-1495cbde9773" alt=""><figcaption><p>Imagem 10 - Vinculando parâmetros criados no supervisor inteligente atual.</p></figcaption></figure>

**✅ Como criar um novo parâmetro direto por aqui**

1. Clique em **Criar parâmetro** (ou em **Criar novo parâmetro**, dentro da lista de adicionar).
2. Preencha os campos do parâmetro (veja a tabela completa na seção 🎯 Parâmetros Customizados abaixo).
3. Salve. O parâmetro é criado no catálogo geral e já fica vinculado a este supervisor automaticamente.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FApi3MwFvvsKAqs6jJIp4%2Fimage.png?alt=media&amp;token=44205078-ae14-4ac4-b9a6-f50c351be4b1" alt=""><figcaption><p>Imagem 11 - Criando um novo parâmetro pela modal de criação de supervisor inteligente.</p></figcaption></figure>

**📌 Resultado esperado**

O parâmetro passa a aparecer na lista de parâmetros deste supervisor, com um resumo do tipo e da configuração. É possível **editar** ou **remover** o vínculo a qualquer momento (remover aqui não apaga o parâmetro do catálogo geral, apenas desvincula deste supervisor).

{% hint style="info" %}
Além dos parâmetros customizados, a plataforma já identifica automaticamente alguns dados padrão de cada protocolo, como o identificador do protocolo, o departamento, o agente responsável e as datas de criação e finalização. Você não precisa criar parâmetros para esses dados.
{% endhint %}

Quando não há nenhum parâmetro adicionado, a tela mostra a mensagem "Nenhum parâmetro adicionado", convidando você a criar ou adicionar um.

***

### 🎯 Parâmetros Customizados

Um **parâmetro de análise** é uma instrução que você cria para que a Inteligência Artificial extraia uma informação específica de cada conversa analisada, além dos indicadores padrão (resumo, sentimento, qualidade, resolutividade). Os parâmetros ficam em um catálogo único e podem ser reaproveitados em quantos supervisores você quiser.

#### 📍 Como acessar o catálogo

1. Na tela de **Supervisores Inteligentes**, clique na aba **Parâmetros Customizados**.
2. Você verá a lista de todos os parâmetros já criados na conta.

A tabela mostra as colunas **Nome**, **Tipo**, **Criado por**, **Criado em** e **Atualizado em**, além dos botões de **Editar** e **Remover** em cada linha. Ao passar o mouse sobre o nome de um parâmetro, aparece uma prévia do texto de instrução configurado.

#### ➕ Como criar um parâmetro customizado

**🎯 Propósito**

Ensinar a IA a identificar e extrair uma informação específica de cada conversa, que passa a fazer parte do relatório de análise.

**✅ Como fazer na tela**

1. Na aba **Parâmetros Customizados**, clique em **Adicionar parâmetro**.
2. Preencha os campos da janela que abrir (veja a tabela abaixo).
3. Clique em **Criar parâmetro**.

**📌 Resultado esperado**

O parâmetro passa a existir no catálogo geral e fica disponível para ser adicionado a qualquer supervisor, na etapa **Parâmetros** da criação ou edição.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FghMJvFLnfAwwkeVJZkQ7%2Fimage.png?alt=media&amp;token=ffcaf215-b927-4da2-835f-24569ac23eca" alt=""><figcaption><p>Imagem 12 - Janela de criação de um parâmetro customizado</p></figcaption></figure>

#### 🧾 Campos do parâmetro customizado

| Campo                            | O que preencher                                                                                                                                                                                            |
| -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Nome do parâmetro de análise** | Um nome que identifique o que está sendo medido, por exemplo: "Aderência ao script". Campo obrigatório                                                                                                     |
| **Tipo do parâmetro**            | Define o formato do valor extraído pela IA (veja os tipos abaixo). Obrigatório                                                                                                                             |
| **Instruções**                   | O texto que orienta a IA sobre o que identificar ou medir na conversa. É esse texto que a Inteligência Artificial usa a cada análise para preencher este parâmetro. Limite de 1000 caracteres. Obrigatório |
| **Faixas de score**              | Aparece somente quando o tipo escolhido é **Score**. Define até 5 faixas de 1 a 10, cada uma com nome, cor e prompt, no mesmo formato dos níveis de Sentimento e Qualidade da etapa 3                      |

#### 🔢 Tipos de parâmetro disponíveis

| Tipo         | O que a IA retorna                                       |
| ------------ | -------------------------------------------------------- |
| **Texto**    | Um texto livre, descritivo                               |
| **Número**   | Um valor numérico                                        |
| **Booleano** | Verdadeiro ou falso                                      |
| **Data**     | Uma data identificada na conversa                        |
| **Score**    | Uma nota de 1 a 10, classificada nas faixas configuradas |

{% hint style="warning" %}
Escreva instruções claras e específicas no campo **Instruções**. Uma instrução vaga pode fazer a IA extrair valores inconsistentes entre uma análise e outra. Por exemplo, em vez de "avalie o atendimento", prefira algo como "avalie de 1 a 10 o quanto o agente seguiu o roteiro de abertura e encerramento definido no script de atendimento".
{% endhint %}

***

### 📊 Consultando os resultados das análises

Depois que os supervisores começam a analisar os protocolos finalizados, os resultados ficam disponíveis em duas telas dentro de **Histórico de Chats**.

{% hint style="warning" %}
**Antes de usar este recurso:** é preciso ter ao menos um supervisor **criado e habilitado** para um departamento, e já existirem protocolos finalizados nesse departamento depois da criação do supervisor. Volte para a aba **Supervisores** desta tela para criar ou habilitar um supervisor.
{% endhint %}

#### 🔍 Análise do atendimento (por protocolo)

Ao abrir um protocolo já analisado na tela de **Histórico de Chats**, é possível visualizar o relatório completo gerado pela IA, organizado em duas abas internas:

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2F9NoWdLb0qRbx5hzgbsBT%2Fimage.png?alt=media&amp;token=1c09b189-4d56-4afa-a083-d98466f3e430" alt=""><figcaption><p>Imagem 13 - Janela de "Análise do atendimento" aberta a partir de um protocolo</p></figcaption></figure>

| Aba            | O que mostra                                                                                                                                                                                                                                                                                                 |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Resumo**     | Cartões com **Sentimento do cliente** e **Qualidade do atendimento** (com a cor e o nível configurados no supervisor), o status de resolução (**Resolvido**, **Parcialmente resolvido** ou **Não resolvido**), o **Resumo da conversa**, o **Problema**, a **Solução** identificada e a **Dica** de melhoria |
| **Parâmetros** | Um bloco para cada parâmetro customizado configurado no supervisor, mostrando o valor identificado pela IA para aquela conversa                                                                                                                                                                              |

O cabeçalho da janela também mostra o número do protocolo, o agente que atendeu, o departamento, o supervisor responsável pela análise, o contato, o canal e as datas de início e finalização do atendimento.

#### 📊 Aba Métricas (painel visual de indicadores)

A aba **Métricas** reúne, em formato de painel visual, os principais números gerados pelas análises dos supervisores em um período. É a forma mais rápida de enxergar a qualidade do atendimento sem precisar abrir cada protocolo individualmente.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FoS0Ilqs7EqIc3J1bwimk%2Fimage.png?alt=media&amp;token=851e0697-26bd-4daf-bc65-2d7cf1597f44" alt=""><figcaption><p>Imagem 14 - Aba "Métricas" com os cartões de indicadores e os gráficos no topo</p></figcaption></figure>

**🎚️ Filtros disponíveis**

| Filtro              | O que faz                                                                                                                                                                                                         |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Departamento**    | Restringe o painel a um ou mais departamentos. Deixe vazio para ver todos                                                                                                                                         |
| **Agente**          | Restringe o painel a um ou mais agentes. Deixe vazio para ver todos                                                                                                                                               |
| **Intervalo**       | Define a granularidade dos dados exibidos: **5m**, **1h** ou **1d**. As opções disponíveis mudam de acordo com o período selecionado em "Data da análise": períodos mais longos liberam apenas intervalos maiores |
| **Data da análise** | Período que o painel deve considerar. Botões rápidos de **1h, 3h, 6h, 12h, 1d, 3d** ou a opção **Customizado**, para escolher um período específico                                                               |

Nenhum desses filtros é obrigatório. Ao abrir a aba, o painel já vem preenchido com os dados das últimas 6 horas. O botão com ícone de "X" limpa todos os filtros e volta para esse padrão.

{% hint style="info" %}
Você também pode clicar em um agente ou departamento dentro das tabelas de ranking (mais abaixo) para filtrar o painel inteiro por ele automaticamente.
{% endhint %}

**🔢 Cartões de indicadores**

| Cartão                          | O que mostra                                                                                                              |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| **Total de chats analisados**   | Quantidade de atendimentos analisados pelos supervisores no período selecionado                                           |
| **Satisfação do cliente**       | Medidor circular com a média de satisfação do cliente, classificada em faixas: Muito ruim, Ruim, Regular, Bom e Excelente |
| **Desempenho do agente**        | Medidor circular com a média de desempenho dos agentes no atendimento, nas mesmas faixas de classificação                 |
| **Média de mensagens por chat** | Quantidade média de mensagens trocadas por atendimento analisado                                                          |

**📉 Gráficos de tendência**

| Gráfico                                                | O que mostra                                                                                                     |
| ------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------- |
| **Tendências de desempenho ao longo do tempo**         | Evolução, dia a dia, da **Satisfação do cliente** e do **Desempenho do agente**                                  |
| **Tendências de volume e resolução ao longo do tempo** | Evolução, dia a dia, da quantidade de atendimentos **Resolvido**, **Parcialmente resolvido** e **Não resolvido** |

**🥧 Distribuição e comparativos**

| Gráfico/Tabela                               | O que mostra                                                                                                                                                                                                                     |
| -------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Distribuição de status de resolução**      | Gráfico de pizza com a proporção de atendimentos Resolvido, Parcialmente resolvido e Não resolvido no período                                                                                                                    |
| **Satisfação e desempenho por departamento** | Gráfico de barras comparando a satisfação do cliente e o desempenho do agente entre os departamentos                                                                                                                             |
| **Ranking de desempenho de agentes**         | Tabela com os agentes ordenados por desempenho, mostrando quantidade de atendimentos analisados, desempenho do agente, satisfação do cliente e a quantidade de atendimentos resolvidos, parcialmente resolvidos e não resolvidos |
| **Ranking de desempenho de departamentos**   | Mesma tabela do item anterior, agrupada por departamento em vez de agente                                                                                                                                                        |

{% hint style="info" %}
As abas **Análises inteligentes** e **Métricas** só ficam disponíveis para contas com o Supervisor Inteligente contratado. Sem a contratação, ao clicar nessas abas aparece uma proposta de contratação do recurso em vez do conteúdo.
{% endhint %}

***

### 💡 Dicas úteis

* Só é possível ter **um supervisor habilitado por departamento** ao mesmo tempo. Para trocar o supervisor de um departamento, desabilite o atual antes de habilitar outro.
* Os prompts dos indicadores gerais e dos parâmetros customizados já vêm com sugestões prontas. Use o botão de melhoria com IA sempre que quiser deixar as instruções mais claras.
* Quanto mais específica for a instrução de um parâmetro customizado, mais consistente será o valor extraído pela IA em cada análise.
* O campo **Mínimo de mensagens** ajuda a evitar o consumo de análises em conversas muito curtas, sem conteúdo relevante para avaliar.
* Remover um parâmetro de um supervisor não apaga o parâmetro do catálogo geral, apenas o desvincula. Ele continua disponível para ser usado em outros supervisores.

***

### 📝 Resumo

* O **Supervisor Inteligente** analisa automaticamente os atendimentos finalizados, gerando resumo, sentimento do cliente, qualidade do atendimento e status de resolução.
* Ele é configurado em 4 etapas: **Geral**, **Departamentos**, **Indicadores gerais** e **Parâmetros**, e só pode haver um supervisor habilitado por departamento.
* É possível escolher quais tipos de protocolo analisar: de **Agentes**, de **Assistentes Inteligentes** ou **Automáticos**.
* **Parâmetros Customizados** são instruções reutilizáveis que ensinam a IA a extrair informações específicas de cada conversa, nos tipos Texto, Número, Booleano, Data ou Score.
* Os resultados ficam disponíveis na **Análise do atendimento** de cada protocolo e nas abas **Análises inteligentes** e **Métricas**, dentro de **Histórico de chats**.