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

# Usar Datatalk IA

> Haz preguntas sobre los datos de tu empresa en lenguaje natural y recibe respuestas con números, tablas y gráficos.

Datatalk IA responde preguntas sobre los datos de tu empresa. Preguntas como le preguntarías a un colega, por ejemplo “¿Cuál fue la facturación por sucursal en mayo de 2026?”, y él consulta los datos y responde con texto, tablas y gráficos.

## Antes de empezar

* El administrador debe habilitarte el módulo **Datatalk IA** y al menos un [agente](https://ajuda.head.dataguvi.com.br/es/glossary.md#agente).
* Revisa la empresa seleccionada en el selector del menú lateral. Las conversaciones y los datos son de cada empresa.

## Cómo funciona Datatalk

* **Agentes.** Cada agente conoce un conjunto de datos de la empresa, como las tablas de una base de datos o un modelo de Power BI. El administrador configura los agentes y elige quién puede usar cada uno.
* **Tú no eliges el agente.** En cada pregunta, Datatalk decide qué agentes consultar, y puede consultar más de uno al mismo tiempo. Solo usa los agentes habilitados para ti.
* **Memoria de la conversación.** Dentro de una conversación, Datatalk recuerda las últimas 15 preguntas y respuestas. Por eso puedes seguir con “¿Y en junio?” después de preguntar por mayo.
* **Idioma.** Responde en el idioma en que preguntaste.

## Hacer una pregunta

**1. Abre Datatalk**

En el menú lateral, haz clic en **Inteligencia › Datatalk IA**.

**2. Escribe la pregunta**

Escribe en el campo **Pregunta algo sobre tus datos...** y presiona `Enter` para enviar. Para hacer un salto de línea sin enviar, usa `Shift` + `Enter`. En la pantalla inicial, también puedes hacer clic en una de las sugerencias: completa el campo para que lo ajustes antes de enviar.

**3. Sigue el avance**

Mientras trabaja, Datatalk muestra lo que está haciendo, como **Evaluando la pregunta**, **Consultando** un agente y **Sintetizando respuesta**. Una pregunta puede tardar algunos minutos. Para interrumpirla, haz clic en **Detener generación**.

**4. Lee la respuesta**

Cuando termina, aparece **Procesado en**, con el tiempo que tardó. Haz clic ahí para ver los pasos que siguió Datatalk, como qué agentes consultó.

## Cómo preguntar para obtener mejores respuestas

La regla de oro: di **qué**, **de cuándo** y **cómo lo quieres ver**.

| En lugar de | Pregunta |
| - | - |
| ¿Cómo van las ventas? | ¿Cuál fue el total de ventas en mayo de 2026, comparado con abril? |
| Muéstrame los clientes | ¿Cuáles son los 10 clientes con mayor facturación en 2026? |
| ¿Y el inventario? | ¿Cuál es el inventario actual de cada producto de la categoría Bebidas? |
| Haz un gráfico | Muestra en un gráfico de líneas la facturación mensual de 2026. |

* **Usa los nombres que usa tu empresa**, los mismos de los informes y dashboards.
* **Una pregunta por mensaje.** Las preguntas largas, con varios pedidos juntos, tardan más y fallan más.
* **Empieza una conversación nueva al cambiar de tema.** Haz clic en **Nueva conversación**. Lo que se dijo antes puede confundir la respuesta sobre un tema distinto.
* **En conversaciones largas, repite el contexto.** Datatalk solo recuerda las últimas 15 preguntas. Si la conversación es larga, repite el período y el filtro en la pregunta.
* **Desconfía y verifica.** Si un número parece extraño, pregunta “¿Qué filtros y qué período usaste?”.

## Entender la respuesta

* **Tablas y gráficos.** Datatalk arma un gráfico cuando hay al menos 3 valores para comparar, como en tendencias, rankings y participaciones. En los demás casos, usa una tabla. Si quieres un gráfico, pídelo en la pregunta.
* **En los gráficos**, alterna entre **Gráfico** y **Tabla**, usa **Descargar imagen** para guardarlo en PNG y **Expandir** para verlo en pantalla completa.
* **Cuando no hay datos**, Datatalk dice que no encontró la información y qué le falta a la pregunta. Esto también pasa cuando los datos están en un agente que no se habilitó para ti.

Debajo de cada respuesta están las acciones:

| Acción | Qué hace |
| - | - |
| **Copiar** | Copia el texto de la respuesta. |
| **Preguntar de nuevo** | Envía la misma pregunta otra vez, como un mensaje nuevo al final de la conversación. La respuesta anterior se mantiene. |
| **Más › Exportar como Markdown** | Descarga la respuesta en un archivo de texto. |
| **Buena respuesta** | Registra que la respuesta fue útil. |
| **Reportar un problema o sugerir una mejora** | Abre un campo para que cuentes qué está mal. |

Para cambiar una pregunta que ya hiciste, pasa el mouse sobre ella y usa **Editar y reenviar**. La pregunta editada se envía como un mensaje nuevo al final de la conversación.

## Evaluar una respuesta

Las evaluaciones ayudan a mejorar Datatalk.

* **Buena respuesta**: haz clic cuando la respuesta te resuelva. Para deshacer, haz clic de nuevo.
* **Reportar un problema o sugerir una mejora**: describe qué está mal en **¿Cómo podemos mejorar esta respuesta?** y haz clic en **Enviar**. El comentario es obligatorio y tiene hasta 500 caracteres.

> [!TIP]
>
> Un buen comentario dice qué esperabas. Por ejemplo: “La facturación de mayo dio 1,2 millones, pero el dashboard de Ventas muestra 1,5 millones.”

## Conversaciones

* Las conversaciones están en el panel de la izquierda. El título se crea a partir de la primera pregunta.
* Cada persona ve solo sus propias conversaciones, y cada empresa tiene las suyas. Al cambiar de empresa en el menú lateral, la lista cambia.
* Para eliminar una, pasa el mouse sobre la conversación, haz clic en **Más opciones** y en **Eliminar conversación**. La eliminación no se puede deshacer.

> [!NOTE]
>
> El Administrador de la Empresa y el Administrador del Conglomerado pueden leer las conversaciones en **Seguridad y Gobernanza › Auditoría y Uso**, para seguir el uso y la calidad de las respuestas. Las conversaciones eliminadas dejan de aparecer ahí.

## Problemas comunes

> [accordion] “Datatalk aún no está disponible”
>
> La empresa todavía no tiene un agente activo. El administrador debe configurar uno en **Administración › Agentes**.

> [accordion] “No tienes acceso a Datatalk. Habla con el administrador de tu empresa.”
>
> Falta el permiso en el módulo **Datatalk IA**. Pídeselo al administrador.

> [accordion] Datatalk dice que no tiene la información
>
> * Reescribe la pregunta con el indicador, el período y el filtro.
> * Usa los nombres que aparecen en los dashboards de la empresa.
> * Si aun así no funciona, los datos pueden estar en un agente que no se habilitó para ti. Pídeselo al administrador.

> [accordion] “La consulta tardó más que el tiempo límite y fue interrumpida.”
>
> La pregunta pasó de 20 minutos y la respuesta no se guardó. Divídela en preguntas más pequeñas o usa un período más corto.

> [accordion] La conexión se cayó mientras Datatalk respondía
>
> Espera: la pantalla intenta recuperar la respuesta sola durante unos 2 minutos. Si no aparece, abre la conversación de nuevo más tarde, porque la respuesta puede haberse guardado.

> [accordion] “El servicio de IA no está disponible en este momento.”
>
> El servicio que genera las respuestas está caído. Inténtalo de nuevo en unos minutos.

> [accordion] “Lo sentimos, hubo un error al procesar su pregunta. Inténtelo de nuevo.”
>
> Haz clic en **Preguntar de nuevo**. Si el error se repite, reformula la pregunta o empieza una **Nueva conversación**.

> [accordion] “Tu sesión ha expirado. Recarga la página e inicia sesión de nuevo.”
>
> La sesión dura 12 horas desde que inicias sesión. Recarga la página e inicia sesión de nuevo. Mira [Acceder a la plataforma](https://ajuda.head.dataguvi.com.br/es/getting-started/sign-in.md).

> [accordion] “Esta conversación ya no está disponible. Inicia una nueva.”
>
> La conversación se eliminó, por ejemplo en otra pestaña. Haz clic en **Nueva conversación**.

> [accordion] “Ninguna empresa seleccionada”
>
> Elige una empresa en el selector del menú lateral.

> [accordion] “No fue posible confirmar tu identidad”
>
> Revisa tu conexión y haz clic en **Intentar de nuevo**. Si continúa, cierra sesión y vuelve a entrar a la plataforma.

> [accordion] El número no coincide con el dashboard
>
> Pregunta a Datatalk qué filtros y qué período usó y compáralos con los del dashboard. Si la diferencia sigue, usa **Reportar un problema o sugerir una mejora** e incluye los dos valores.

> [accordion] El administrador habilitó un agente, pero sigue igual
>
> La habilitación de agentes tarda hasta 5 minutos en aplicarse. Espera y recarga la página.

## Para administradores

* **Quién usa qué.** Habilita el módulo **Datatalk IA** en **Seguridad y Gobernanza › Control de Acceso**. Después, en **Administración › Agentes**, elige quién puede usar cada agente. Mira [Gestionar usuarios, grupos y permisos](https://ajuda.head.dataguvi.com.br/es/access/manage-users-groups-permissions.md).
* **Los administradores usan todos los agentes activos** de la empresa, sin necesidad de habilitación.

> [!WARNING]
>
> Datatalk no aplica las reglas de [RLS](https://ajuda.head.dataguvi.com.br/es/glossary.md#rls-reglas-de-acceso-a-los-datos) de los dashboards. Quien puede usar un agente puede preguntar sobre todos los datos que ese agente consulta. Habilita cada agente solo para quien puede ver todos sus datos.

## Quién puede ayudar

* **El administrador de tu empresa** habilita Datatalk y los agentes.
* **Respuestas incorrectas o incompletas**: usa **Reportar un problema o sugerir una mejora** en la propia respuesta.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.