> For the complete documentation index, see [llms.txt](https://docs.poweromni.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.poweromni.ai/administracao-e-configuracao/feedbacks.md).

# Feedbacks

A seção **Feedbacks** permite que os usuários avaliem as respostas dos Agentes diretamente no chat do Power Omni, e que os administradores acompanhem essas avaliações em um painel centralizado no Portal de Administração.

Com ela, a organização passa a ter um canal contínuo de melhoria: cada avaliação positiva ou negativa fica associada ao agente, ao modelo e à execução que gerou a resposta, permitindo identificar onde os Agentes acertam e onde precisam ser ajustados.

### Visão Geral

A funcionalidade é composta por duas partes:

* **Avaliação no chat (Portal do Usuário):** abaixo de cada resposta do agente, o usuário encontra os botões de **Resposta boa** (👍) e **Resposta ruim** (👎). Em avaliações negativas, é possível informar um motivo e um comentário.

<figure><img src="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FirARu9Okgj00qZzEzrWj%2Fimage.png?alt=media&amp;token=695b41f7-70ba-4e95-8b37-f215907bcefb" alt=""><figcaption></figcaption></figure>

* **Painel de Feedbacks (Portal de Administração):** o administrador visualiza todas as avaliações registradas, com filtros, detalhes técnicos da execução e acesso ao turno avaliado (pergunta e resposta).

{% hint style="info" %}

## <mark style="color:blue;">Privacidade por padrão</mark>

<mark style="color:blue;">**O Power Omni armazena apenas os identificadores e os metadados do turno avaliado (agente, modelo, tokens e etapas da execução), nunca o texto das mensagens. A pergunta e a resposta avaliadas são lidas diretamente do Microsoft Foundry no momento da consulta, e o restante da conversa não é exibido.**</mark>
{% endhint %}

### Habilitando a Coleta de Feedback

A coleta de feedback é controlada por uma chave de ativação no topo da tela de Feedbacks.

<figure><img src="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FKVxTdF2ay5apg3XMxJ6c%2Fimage.png?alt=media&amp;token=be18ee01-c725-489c-8292-03c02f844cee" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

#### Acesse o Portal de Administração

{% endstep %}

{% step %}

#### Abra Feedbacks

No menu lateral, clique em **Feedbacks**.
{% endstep %}

{% step %}

#### Ative a coleta

No card **Coleta de feedback**, ative a opção **Permitir que os usuários avaliem as respostas dos agentes**.
{% endstep %}
{% endstepper %}

### Comportamento com a coleta desativada

* As ações de avaliação (👍 e 👎) ficam **ocultas** no chat para todos os usuários.
* Nenhuma nova avaliação é registrada.
* As avaliações **já coletadas continuam disponíveis** no painel para consulta.

### Como o Usuário Avalia uma Resposta

Com a coleta ativada, os botões de avaliação aparecem abaixo de cada resposta do agente, ao lado das opções de copiar e de informações.

Ao passar o mouse sobre os botões, o usuário é informado de que, ao avaliar, os administradores da organização poderão ver a pergunta e a resposta para melhorar o agente.

### Avaliação Positiva

Clique no botão **Resposta boa** (👍). A avaliação é registrada imediatamente, sem necessidade de preencher informações adicionais.

### Avaliação Negativa

<figure><img src="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FcYI6LFNeJcDEgs2vQLki%2Fimage.png?alt=media&amp;token=85f16c5d-a8fe-4803-a592-99e8b6f98fa0" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

#### Selecione uma resposta ruim

Clique no botão **Resposta ruim** (👎).
{% endstep %}

{% step %}

#### Selecione o motivo

Na janela **O que houve de errado com esta resposta?**, selecione o **Motivo** (obrigatório).
{% endstep %}

{% step %}

#### Adicione um comentário opcional

Opcionalmente, descreva sua experiência no campo **Comentário** (até 1.000 caracteres).
{% endstep %}

{% step %}

#### Envie o feedback

Clique em **Enviar feedback**. Uma mensagem de confirmação será exibida.
{% endstep %}
{% endstepper %}

### Motivos Disponíveis

<table><thead><tr><th width="311">Motivo</th><th>Quando utilizar</th></tr></thead><tbody><tr><td><strong>Incorreta ou incompleta</strong></td><td>A resposta contém informações erradas ou deixou de fora partes importantes.</td></tr><tr><td><strong>Não era o que eu pedi</strong></td><td>O agente não entendeu a solicitação ou respondeu sobre outro assunto.</td></tr><tr><td><strong>Lenta ou com erros</strong></td><td>A resposta demorou demais ou apresentou falhas durante a execução.</td></tr><tr><td><strong>Tom ou estilo inadequado</strong></td><td>O conteúdo está correto, mas a linguagem, o formato ou o tom não são adequados.</td></tr><tr><td><strong>Questão legal ou de segurança</strong></td><td>A resposta apresenta conteúdo sensível, inadequado ou com possível risco legal ou de segurança.</td></tr><tr><td><strong>Outro</strong></td><td>Qualquer situação não coberta pelas opções anteriores. Recomenda-se detalhar no comentário.</td></tr></tbody></table>

{% hint style="warning" %}

## <mark style="color:$warning;">Transparência para o usuário</mark>

<mark style="color:$warning;">Ao avaliar, os administradores da organização poderão ver a pergunta, a resposta e o comentário do usuário. A avaliação fica associada ao usuário por até 12 meses, ou até que a conversa seja excluída. Depois disso, é anonimizada.</mark>
{% endhint %}

## Painel de Feedbacks (Administração)

Abaixo do card de Coleta de feedback, o administrador encontra a listagem de todas as avaliações registradas.

### Colunas da Listagem

<table><thead><tr><th width="178">Coluna</th><th>Descrição</th></tr></thead><tbody><tr><td><strong>Usuário</strong></td><td>E-mail do usuário que realizou a avaliação e o total de tokens consumidos no turno avaliado.</td></tr><tr><td><strong>Agente</strong></td><td>Agente que gerou a resposta avaliada.</td></tr><tr><td><strong>Modelo</strong></td><td>Modelo de IA utilizado na execução.</td></tr><tr><td><strong>Avaliação</strong></td><td><strong>Positivo</strong> ou <strong>Negativo</strong>. Em avaliações negativas, o motivo selecionado é exibido logo abaixo.</td></tr><tr><td><strong>Comentário</strong></td><td>Comentário informado pelo usuário, ou "Sem comentário" quando não preenchido.</td></tr><tr><td><strong>Data</strong></td><td>Data e hora em que a avaliação foi registrada.</td></tr><tr><td><strong>Ações</strong></td><td>Menu com as opções <strong>Ver detalhes</strong> e <strong>Ver turno avaliado</strong>.</td></tr></tbody></table>

### Recursos da Listagem

* **Filtros:** permite refinar a listagem para localizar avaliações específicas.
* **Atualizar** (ícone ↻): recarrega a listagem com as avaliações mais recentes.
* **Paginação:** navegue entre as páginas pelos botões **Anterior** e **Próxima**.

## Analisando uma Avaliação

Na coluna **Ações**, clique no ícone de menu para acessar as opções disponíveis.

### Ver Detalhes

Abre a janela **Detalhes do feedback**, dividida em duas seções:

* **Feedback:** Usuário, Avaliação (com motivo, quando negativa), Comentário e Data.
* **Execução:** Agente, Modelo, Tokens de **Entrada** e **Saída**, e o **Id da execução**, que identifica a execução no Microsoft Foundry.
* **Run Steps:** expanda esta seção (ícone **+**) para visualizar as etapas da execução, como chamadas a ferramentas e conectores. É o principal recurso para investigar a causa de uma resposta ruim.

### Ver Turno Avaliado

Exibe a pergunta do usuário e a resposta do agente que foram avaliadas, junto com o card **Feedback do usuário para esta resposta**. Essa opção também está disponível pelo botão **Ver turno avaliado** na janela de detalhes.

{% hint style="info" %}

## <mark style="color:blue;">Apenas o turno avaliado</mark>

<mark style="color:blue;">**Somente a pergunta e a resposta avaliadas são exibidas. O restante da conversa do usuário permanece privado e não pode ser acessado pelo painel.**</mark>
{% endhint %}

### Privacidade e Retenção de Dados

* **O que é armazenado:** identificadores e metadados do turno avaliado (agente, modelo, tokens e etapas da execução), além da avaliação, motivo e comentário.
* **O que não é armazenado:** o texto das mensagens. A pergunta e a resposta são lidas do Microsoft Foundry apenas no momento da visualização.
* **Prazo de retenção:** 12 meses por padrão.
* **Anonimização:** quando a conversa ou o usuário é excluído, ou quando o prazo de retenção é atingido, a avaliação é anonimizada. O usuário, o comentário e o vínculo com a conversa são removidos, preservando apenas os dados agregados.

{% hint style="danger" %}

## <mark style="color:$danger;">Atenção ao conteúdo dos comentários</mark>

<mark style="color:$danger;">Oriente os usuários a não incluir dados pessoais, credenciais ou informações sensíveis de clientes no campo de comentário, pois ele fica visível para os administradores da organização.</mark>
{% endhint %}