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

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.

  • 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).

Privacidade por padrão

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.

Habilitando a Coleta de Feedback

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

1

Acesse o Portal de Administração

2

Abra Feedbacks

No menu lateral, clique em Feedbacks.

3

Ative a coleta

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

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

1

Selecione uma resposta ruim

Clique no botão Resposta ruim (👎).

2

Selecione o motivo

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

3

Adicione um comentário opcional

Opcionalmente, descreva sua experiência no campo Comentário (até 1.000 caracteres).

4

Envie o feedback

Clique em Enviar feedback. Uma mensagem de confirmação será exibida.

Motivos Disponíveis

Motivo
Quando utilizar

Incorreta ou incompleta

A resposta contém informações erradas ou deixou de fora partes importantes.

Não era o que eu pedi

O agente não entendeu a solicitação ou respondeu sobre outro assunto.

Lenta ou com erros

A resposta demorou demais ou apresentou falhas durante a execução.

Tom ou estilo inadequado

O conteúdo está correto, mas a linguagem, o formato ou o tom não são adequados.

Questão legal ou de segurança

A resposta apresenta conteúdo sensível, inadequado ou com possível risco legal ou de segurança.

Outro

Qualquer situação não coberta pelas opções anteriores. Recomenda-se detalhar no comentário.

Transparência para o usuário

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

Coluna
Descrição

Usuário

E-mail do usuário que realizou a avaliação e o total de tokens consumidos no turno avaliado.

Agente

Agente que gerou a resposta avaliada.

Modelo

Modelo de IA utilizado na execução.

Avaliação

Positivo ou Negativo. Em avaliações negativas, o motivo selecionado é exibido logo abaixo.

Comentário

Comentário informado pelo usuário, ou "Sem comentário" quando não preenchido.

Data

Data e hora em que a avaliação foi registrada.

Ações

Menu com as opções Ver detalhes e Ver turno avaliado.

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.

Apenas o turno avaliado

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.

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.

Atenção ao conteúdo dos comentários

Atualizado