# Feedbacks

La sección **Feedbacks** permite a los usuarios calificar las respuestas de los Agentes directamente en el chat de Power Omni, y permite a los administradores seguir estas calificaciones en un panel centralizado en el Portal de Administración.

Esto ofrece a su organización un canal de mejora continua: cada calificación positiva o negativa está vinculada al agente, al modelo y a la ejecución que generó la respuesta, lo que facilita identificar dónde los Agentes tienen buen desempeño y dónde necesitan ajustes.

## Visión General

La funcionalidad consta de dos partes:

* **Calificación en el chat (Portal del Usuario):** debajo de cada respuesta del agente, los usuarios encontrarán los botones **Buena respuesta** (👍) y **Mala respuesta** (👎). En las calificaciones negativas, los usuarios pueden indicar un motivo y un comentario.

<figure><img src="../.gitbook/assets/pt-image (237).png" alt=""><figcaption></figcaption></figure>
* **Panel de Feedbacks (Portal de Administración):** los administradores pueden ver todas las calificaciones registradas, con filtros, detalles técnicos de la ejecución y acceso al turno calificado (pregunta y respuesta).

{% hint style="info" %}
## <mark style="color:blue;">Privacidad por defecto</mark>

<mark style="color:blue;">**Power Omni solo almacena los identificadores y metadatos del turno calificado (agente, modelo, tokens y pasos de la ejecución), nunca el texto de los mensajes. La pregunta y la respuesta calificadas se leen directamente desde Microsoft Foundry en el momento de visualizarlas, y el resto de la conversación nunca se muestra.**</mark>
{% endhint %}

### Habilitación de la Recopilación de Feedback

La recopilación de feedback se controla mediante un interruptor en la parte superior de la pantalla de Feedbacks.

<figure><img class="only-light" src="../.gitbook/assets/telas/feedbacks-coleta-light.png" alt=""><img class="only-dark" src="../.gitbook/assets/telas/feedbacks-coleta-dark.png" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}
#### Vaya al Portal de Administración
{% endstep %}

{% step %}
#### Abra Feedbacks

En el menú lateral, haga clic en **Feedbacks**.
{% endstep %}

{% step %}
#### Habilite la recopilación de feedback

En la tarjeta **Recopilación de feedback**, habilite la opción **Permitir que los usuarios califiquen las respuestas de los agentes**.
{% endstep %}
{% endstepper %}

### Comportamiento cuando la recopilación está deshabilitada

* Las acciones de calificación (👍 y 👎) quedan **ocultas** en el chat para todos los usuarios.
* No se registran nuevas calificaciones.
* Las calificaciones **ya recopiladas permanecen disponibles** en el panel para su revisión.

### Cómo los Usuarios Califican una Respuesta

Cuando la recopilación está habilitada, los botones de calificación aparecen debajo de cada respuesta del agente, junto a las opciones de copiar e información.

Al pasar el cursor sobre los botones, se informa a los usuarios que, al calificar, los administradores de la organización podrán ver la pregunta y la respuesta con el fin de mejorar el agente.

### Calificación Positiva

Haga clic en el botón **Buena respuesta** (👍). La calificación se registra de inmediato, sin necesidad de información adicional.

### Calificación Negativa

<figure><img src="../.gitbook/assets/pt-image (239).png" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}
#### Haga clic en Mala respuesta

Haga clic en el botón **Mala respuesta** (👎).
{% endstep %}

{% step %}
#### Seleccione un motivo

En la ventana **¿Qué salió mal con esta respuesta?**, seleccione un **Motivo** (obligatorio).
{% endstep %}

{% step %}
#### Agregue un comentario opcional

Opcionalmente, describa su experiencia en el campo **Comentario** (hasta 1000 caracteres).
{% endstep %}

{% step %}
#### Envíe el feedback

Haga clic en **Enviar feedback**. Se mostrará un mensaje de confirmación.
{% endstep %}
{% endstepper %}

### Motivos Disponibles

<table><thead><tr><th width="281">Motivo</th><th>Cuándo usarlo</th></tr></thead><tbody><tr><td><strong>Incorrecta o incompleta</strong></td><td>La respuesta contiene información errónea o deja fuera partes importantes.</td></tr><tr><td><strong>No es lo que pedí</strong></td><td>El agente no entendió la solicitud o respondió sobre un tema diferente.</td></tr><tr><td><strong>Lenta o con errores</strong></td><td>La respuesta tardó demasiado o falló durante la ejecución.</td></tr><tr><td><strong>Tono o estilo inapropiado</strong></td><td>El contenido es correcto, pero el lenguaje, el formato o el tono no son adecuados.</td></tr><tr><td><strong>Problema legal o de seguridad</strong></td><td>La respuesta contiene contenido sensible o inapropiado, o representa un posible riesgo legal o de seguridad.</td></tr><tr><td><strong>Otro</strong></td><td>Cualquier situación no cubierta por las opciones anteriores. Recomendamos agregar detalles en el comentario.</td></tr></tbody></table>

{% hint style="warning" %}
## <mark style="color:$warning;">Transparencia para los usuarios</mark>

<mark style="color:$warning;">Al calificar una respuesta, los administradores de la organización podrán ver la pregunta, la respuesta y el comentario del usuario. La calificación permanece vinculada al usuario por hasta 12 meses, o hasta que se elimine la conversación. Después de ese plazo, se anonimiza.</mark>
{% endhint %}

### Panel de Feedbacks (Administración)

Debajo de la tarjeta de Recopilación de feedback, los administradores encontrarán la lista de todas las calificaciones registradas.

### Columnas de la Lista

<table><thead><tr><th width="171">Columna</th><th>Descripción</th></tr></thead><tbody><tr><td><strong>Usuario</strong></td><td>Correo electrónico del usuario que envió la calificación y total de tokens consumidos en el turno calificado.</td></tr><tr><td><strong>Agente</strong></td><td>Agente que generó la respuesta calificada.</td></tr><tr><td><strong>Modelo</strong></td><td>Modelo de IA utilizado en la ejecución.</td></tr><tr><td><strong>Calificación</strong></td><td><strong>Positiva</strong> o <strong>Negativa</strong>. En las calificaciones negativas, el motivo seleccionado se muestra justo debajo.</td></tr><tr><td><strong>Comentario</strong></td><td>Comentario proporcionado por el usuario, o "Sin comentario" cuando se deja vacío.</td></tr><tr><td><strong>Fecha</strong></td><td>Fecha y hora en que se registró la calificación.</td></tr><tr><td><strong>Acciones</strong></td><td>Menú con las opciones <strong>Ver detalles</strong> y <strong>Ver turno calificado</strong>.</td></tr></tbody></table>

### Funcionalidades de la Lista

* **Filtros:** refine la lista para encontrar calificaciones específicas.
* **Actualizar** (ícono ↻): recarga la lista con las calificaciones más recientes.
* **Paginación:** navegue entre las páginas usando los botones **Anterior** y **Siguiente**.

### Revisión de una Calificación

En la columna **Acciones**, haga clic en el ícono de menú para acceder a las opciones disponibles.

### Ver Detalles

Abre la ventana **Detalles del feedback**, dividida en dos secciones:

* **Feedback:** Usuario, Calificación (con el motivo, cuando es negativa), Comentario y Fecha.
* **Ejecución:** Agente, Modelo, Tokens de **Entrada** y **Salida**, y el **Run Id**, que identifica la ejecución en Microsoft Foundry.
* **Pasos de la Ejecución:** expanda esta sección (ícono **+**) para ver los pasos de la ejecución, como las llamadas a herramientas y conectores. Este es el principal recurso para investigar la causa de una mala respuesta.

### Ver Turno Calificado

Muestra la pregunta del usuario y la respuesta del agente que fueron calificadas, junto con la tarjeta **Feedback del usuario para esta respuesta**. Esta opción también está disponible mediante el botón **Ver turno calificado** en la ventana de detalles.

{% hint style="info" %}
## <mark style="color:blue;">Solo el turno calificado</mark>

<mark style="color:blue;">**Solo se muestran la pregunta y la respuesta calificadas. El resto de la conversación del usuario permanece privado y no se puede acceder a él mediante el panel.**</mark>
{% endhint %}

### Privacidad y Retención de Datos

* **Qué se almacena:** identificadores y metadatos del turno calificado (agente, modelo, tokens y pasos de la ejecución), además de la calificación, el motivo y el comentario.
* **Qué no se almacena:** el texto de los mensajes. La pregunta y la respuesta se leen desde Microsoft Foundry solo cuando se visualizan.
* **Período de retención:** 12 meses por defecto.
* **Anonimización:** cuando se elimina la conversación o el usuario, o cuando se alcanza el período de retención, la calificación se anonimiza. Se eliminan el usuario, el comentario y el vínculo con la conversación, preservando únicamente los datos agregados.

{% hint style="danger" %}
## <mark style="color:$danger;">Tenga cuidado con el contenido de los comentarios</mark>

<mark style="color:$danger;">Instruya a los usuarios a no incluir datos personales, credenciales ni información sensible de clientes en el campo de comentario, ya que es visible para los administradores de la organización.</mark>
{% endhint %}