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

# Chat con tutor IA

> Conversación con el tutor de IA desde cualquier pantalla: dudas sobre los contenidos asignados, imágenes, diagramas e interactivos, lectura en voz alta, historial y reporte de respuestas

## Descripción

El chat es la vía principal de acceso al tutor de IA. El estudiante pregunta lo que necesita sobre las materias que tiene asignadas y el tutor responde apoyándose únicamente en esos contenidos, guiándole para que llegue a la respuesta por sí mismo en lugar de dársela hecha.

El tutor está pensado para estudiantes de entre 10 y 18 años: responde en el idioma del alumno, con un tono cercano y mensajes breves, y cierra cada respuesta con un siguiente paso concreto. Cómo razona y qué límites tiene se explica en [Cómo ayuda en el estudio el tutor](/estudiantes/tutor-ia/como-ayuda-en-el-estudio).

<Info>
  **Rol requerido:** Estudiante con Tangerine AI activo en su cuenta y matriculado en al menos un curso con Tangerine AI habilitado. El chat es exclusivo del alumnado: el docente no lo ve.
</Info>

## Cómo acceder

El tutor se abre desde el **botón flotante con la mascota** que aparece en la esquina de cualquier pantalla de la plataforma: inicio, curso, lección, visor de contenidos, Hoy o Mi progreso. El botón no lleva texto; su nombre accesible es "Abrir asistente de chat".

Al pulsarlo se despliega un **panel lateral derecho** sobre la pantalla actual, que el alumno puede ensanchar arrastrando su borde. El panel se cierra con el botón **Cerrar** de la cabecera.

<Note>
  Si el alumno abre el chat dentro de un curso o de una lección, el tutor recibe ese curso como contexto y prioriza sus contenidos. Desde la pantalla de inicio, Hoy o Mi progreso, la conversación no está ligada a ningún curso concreto.
</Note>

El botón no aparece en las pantallas de acceso y legales ni en la pantalla de resumen de una práctica. En los resultados de un quiz el chat se abre solo, en modo repaso.

## Guía de uso

### Iniciar una conversación

<Steps>
  <Step title="Leer la bienvenida y escribir">
    El tutor saluda con "¡Hola! cuenta conmigo para ayudarte en lo que necesites ¿Con qué empezamos?". El alumno escribe su duda en la caja **Escribe...** y la envía con el botón **Enviar mensaje**.

    Cuanto más concreta es la pregunta, más precisa es la ayuda. Si la pregunta es vaga, el tutor pide una aclaración antes de buscar en el material.
  </Step>

  <Step title="Seguir la respuesta en directo">
    Mientras el tutor trabaja aparecen indicadores como "Buscando en los materiales del curso...", "Generando diagrama..." o "Creando interactivo...". La respuesta se escribe a medida que se genera. El tutor no resuelve el ejercicio: explica el concepto, propone una pista o formula una pregunta para que el alumno dé el siguiente paso.

    Cuando la respuesta se apoya en material, muestra el bloque **Fuentes:** con los chips **Curso** o **Web**, que indican de dónde procede la información.
  </Step>

  <Step title="Empezar otra conversación o retomar una anterior">
    El botón **Nuevo chat** de la cabecera abre una conversación vacía. El botón **Recientes** despliega el historial.
  </Step>
</Steps>

Debajo de la caja de texto, siempre visible, el tutor recuerda su naturaleza: **"Soy una IA y a veces me equivoco. ¡Revísalo!"**

<Tip>
  El tutor funciona mejor cuando el alumno le cuenta qué ha intentado ya. "He probado a multiplicar los denominadores y me sale 12, ¿voy bien?" produce una ayuda mucho más útil que "¿cuánto da?".
</Tip>

### Adjuntar una imagen

El botón **Adjuntar imagen** de la caja de texto, o arrastrar un archivo sobre el panel, permite enviar una fotografía junto con el mensaje: un ejercicio del libro, una página del cuaderno o un esquema. Con una imagen adjunta la caja pasa a decir **Escribe para poder enviar...**: hace falta escribir algo para enviarla.

| Aspecto              | Detalle                                                                  |
| -------------------- | ------------------------------------------------------------------------ |
| Imágenes por mensaje | Una                                                                      |
| Formatos aceptados   | JPG, PNG, WebP y HEIC                                                    |
| Tamaño máximo        | 5 MB. Si se supera aparece el aviso "La imagen no puede superar los 5MB" |

<Note>
  Las imágenes pasan por el mismo filtro de contenido que los mensajes de texto.
</Note>

### Escribir fórmulas y dictar por voz

* **Teclado científico**: abre un editor de fórmulas para escribir expresiones matemáticas e insertarlas en el mensaje con **Insertar fórmula**.
* **Grabar mensaje de voz**: dicta el mensaje con el micrófono del dispositivo. El texto reconocido se escribe en la caja y el alumno lo revisa antes de enviarlo. El dictado se detiene solo a los dos minutos y requiere conexión y permiso de micrófono en el navegador.

### Pedir diagramas e interactivos

Cuando el alumno lo pide de forma explícita, el tutor genera apoyos visuales dentro de la conversación:

| Tipo            | Cómo aparece                                                                                             | Ejemplos                                                                                                                 |
| --------------- | -------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| **Diagrama**    | Tarjeta con el botón **Ver**, que abre el esquema a pantalla completa con la opción **Descargar imagen** | Diagramas de flujo, mapas conceptuales, líneas de tiempo, gráficos de sectores                                           |
| **Interactivo** | Tarjeta con el botón **Ver**, que abre una visualización manipulable                                     | Recta numérica, probabilidad, gráficas de funciones, construcciones geométricas, modelos 3D como órbitas o fases lunares |

Una vez generado el apoyo visual, el tutor retoma la guía con una pregunta para comprobar la comprensión.

<Note>
  Cada tipo de diagrama o interactivo puede activarse o desactivarse por la editorial. Si un tipo no está disponible, el tutor no lo ofrece.
</Note>

### Acciones sobre cada respuesta

Bajo cada respuesta del tutor aparecen estas acciones:

| Acción                                       | Qué hace                                                                                                                        |
| -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| **Copiar mensaje**                           | Copia el texto de la respuesta y confirma con "¡Copiado!"                                                                       |
| **Leer en voz alta**                         | Reproduce la respuesta en audio. Mientras suena, el botón pasa a **Pausar audio**. Útil para alumnado con dificultades lectoras |
| **Me ha sido útil** / **No me ha sido útil** | Valoración rápida de la respuesta, que el equipo del tutor usa para mejorarlo                                                   |
| **Reportar mensaje**                         | Abre el formulario de reporte descrito a continuación                                                                           |

Estas acciones no aparecen en el mensaje de bienvenida ni mientras la respuesta se está generando.

### Reportar una respuesta

Si una respuesta es incorrecta, no funciona o resulta inadecuada, el alumno pulsa **Reportar mensaje** y se abre el diálogo **Reportar problema con la respuesta**, con un único motivo a elegir:

* La respuesta contiene información incorrecta
* El interactivo no funciona correctamente
* Contenido inapropiado
* Respuesta fuera de tema
* Otro motivo

Puede añadir un comentario en **Describe el problema (opcional)** y pulsar **Enviar reporte**. El sistema confirma con "¡Enviado! Muchas gracias por ayudarnos a mejorar" y el mensaje queda marcado como reportado. El reporte llega al equipo responsable del tutor junto con la identificación de la editorial.

### Consultar el historial

El botón **Recientes** despliega las diez conversaciones más recientes del alumno, con su título y fecha. Al pulsar una se recuperan todos los mensajes y las imágenes adjuntas, y el alumno puede continuar donde la dejó. Si no hay ninguna, muestra "No hay conversaciones aún. ¡Comienza un nuevo chat para empezar!".

<Note>
  Solo el chat general se guarda en el historial. Las conversaciones de [ayuda durante una actividad](/estudiantes/tutor-ia/ayuda-durante-una-actividad) y de repaso de quiz están ligadas a la actividad o a la pregunta y no aparecen en esta lista. Las conversaciones no se pueden borrar desde la interfaz.
</Note>

### Enviar sugerencias sobre el tutor

El formulario de feedback no está en el chat, sino al pie del menú lateral de **Mi espacio**, en las pantallas Hoy y Mi progreso: el bloque "¿Echas algo en falta? Cuéntanoslo." con el botón **Dar feedback** abre el diálogo **Comparte tu feedback**, con la categoría **Sugerencia de mejora**, **Error** u **Otro** y el campo **Cuéntanos más**. Mi espacio se describe en [Prácticas](/estudiantes/tutor-ia/practicas).

## El tutor en los resultados de un quiz

Cuando el alumno abre los resultados de un quiz de un curso con Tangerine AI, la pantalla muestra **Mis respuestas:** con una bolita por pregunta, verde o roja, y el botón **Ver mis resultados**. Mientras el tutor prepara el repaso aparece la mascota con mensajes como "Revisando tus respuestas una por una...".

Al entrar en una pregunta, el chat se abre solo en modo repaso con un feedback personalizado sobre esa respuesta, y el alumno puede seguir preguntando sobre ella. En este modo la cabecera del chat solo tiene el botón de cerrar y la conversación queda ligada a la pregunta.

<Note>
  Si el docente pide al alumno rehacer el quiz, el repaso anterior deja de estar disponible hasta que vuelva a entregarlo.
</Note>

## Configuración y variantes

<Note>
  El tutor solo está disponible cuando la editorial ha activado Tangerine AI para el alumno y para el programa digital. La opción **Activar Tangerine AI** se configura al [crear el programa digital](/backoffice/programas-digitales/crear-programa) en el Backoffice.
</Note>

| Capacidad                | Comportamiento                                                                                                                                                                   |
| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Búsqueda ampliada        | Si no encuentra la respuesta en el curso del alumno, el tutor puede buscar en los materiales de cursos cercanos de la misma asignatura.                                          |
| Fuentes web              | Solo si la editorial lo permite, y como último recurso cuando el material propio no cubre la pregunta. Las respuestas que la usan lo indican con el chip **Web** en las fuentes. |
| Diagramas e interactivos | Cada tipo puede activarse o desactivarse de forma independiente.                                                                                                                 |
| Mascota                  | La imagen del botón flotante cambia según la marca de la editorial.                                                                                                              |

## Situaciones especiales

<AccordionGroup>
  <Accordion title="El tutor no da la respuesta aunque el alumno insista">
    Es el comportamiento esperado. El tutor está diseñado para guiar, no para resolver. Reconoce la frustración del alumno y mantiene la guía con pistas. La explicación completa está en [Cómo ayuda en el estudio el tutor](/estudiantes/tutor-ia/como-ayuda-en-el-estudio).
  </Accordion>

  <Accordion title="El tutor dice que no tiene contenido sobre ese tema">
    El tutor solo responde con el material asignado al alumno. Si el tema no aparece en sus programas, lo indica y sugiere consultarlo con el docente. Si la pregunta no es académica, redirige la conversación hacia las asignaturas.
  </Accordion>

  <Accordion title="El mensaje del alumno ha sido bloqueado por el filtro de contenido">
    La interfaz no muestra ningún aviso especial: es el propio tutor quien, en su respuesta, indica que el mensaje no es apropiado y propone seguir con otro tema. El mensaje queda registrado y es visible para el docente en [Alertas y revisión de conversaciones](/frontoffice-docentes/panel-ia/alertas-y-revision-de-conversaciones).
  </Accordion>

  <Accordion title="Aparece un error al generar la respuesta">
    El chat muestra "Ha ocurrido un error al generar la respuesta. Inténtalo de nuevo en unos instantes." o "¡Vaya! Parece que ha ocurrido un error. ¿Quieres reintentarlo?", junto con la píldora **Sí, vuelve a intentarlo.** que reenvía el mensaje. La conversación no se pierde.
  </Accordion>

  <Accordion title="La imagen no se adjunta">
    Solo se admite una imagen por mensaje, en formato JPG, PNG, WebP o HEIC y de hasta 5 MB. Al arrastrar un archivo que no es una imagen, el panel avisa con "Este archivo no es una imagen".
  </Accordion>

  <Accordion title="No aparece el botón flotante">
    El alumno no tiene Tangerine AI activo en su cuenta o ninguno de sus cursos lo tiene habilitado. También se oculta, por diseño, en la pantalla de resumen de una práctica y en los resultados de un quiz, donde el chat se abre solo.
  </Accordion>

  <Accordion title="La conversación es muy larga">
    En conversaciones extensas el tutor mantiene el hilo mediante un resumen interno de los mensajes más antiguos. Puede no recordar detalles literales del inicio de la conversación.
  </Accordion>
</AccordionGroup>

## Relacionado

<CardGroup cols={2}>
  <Card title="Cómo ayuda en el estudio el tutor" icon="compass" href="/estudiantes/tutor-ia/como-ayuda-en-el-estudio">
    Principios de funcionamiento: guía sin respuestas, solo contenido asignado, idioma, privacidad y moderación.
  </Card>

  <Card title="Prácticas" icon="dumbbell" href="/estudiantes/tutor-ia/practicas">
    Mi espacio, la pantalla Hoy y las sesiones de actividades que genera el tutor.
  </Card>

  <Card title="Ayuda durante una actividad" icon="life-buoy" href="/estudiantes/tutor-ia/ayuda-durante-una-actividad">
    El tutor acompaña al alumno mientras resuelve una actividad, con pistas graduales.
  </Card>
</CardGroup>
