Saltearse al contenido
Nappai Documentation

Data to TOON

El componente Data to TOON actúa como un traductor inteligente dentro de tu sistema de automatización Nappai. Su propósito principal es tomar información compleja y organizada (como listas, diccionarios o configuraciones de datos) y convertirla en una cadena de texto simple y legible llamada “TOON”.

Esta transformación es fundamental cuando necesitas que un Asistente de IA entienda y procese tus datos. Mientras que las computadoras manejan bien las estructuras complejas, los modelos de lenguaje funcionan mejor con texto claro. Este componente prepara tu información para que sea “leída” correctamente por las herramientas de inteligencia artificial en tus flujos de trabajo.

¿Cómo funciona?

Piensa en este componente como una caja de empaque inteligente.

  1. Entrada: Tú proporcionas un objeto de datos estructurado. Esto puede ser cualquier tipo de información organizada, como una lista de contactos, un perfil de usuario, o una configuración de tarea.
  2. Procesamiento: Internamente, el componente toma esa estructura y la serializa en el formato TOON. Este formato organiza los datos de una manera que preserva la jerarquía y los valores de tus datos originales, pero en una forma de texto continuo.
  3. Salida: Obtienes un texto plano (TOON Text). Este texto ya no es una estructura de datos compleja, sino una secuencia de caracteres que puedes enviar fácilmente a otros componentes, como un Asistente de IA, para que lo analice, responda o tome acciones basadas en él.

No necesitas realizar ninguna operación manual adicional; simplemente conectas tus datos y el componente se encarga de la conversión automáticamente.

Conexión y Credenciales

Este componente no requiere credenciales externas ni configuraciones de API específicas. Funciona de manera interna dentro del motor de automatización de Nappai, por lo que puedes usarlo directamente sin configurar cuentas de servicios de terceros.

Entradas

Modo de Mapeo (Mapping Mode)

Este componente cuenta con un modo especial llamado “Mapping Mode” (Modo de Mapeo). Este modo es esencial en el entorno de automatización de Nappai, ya que te permite conectar la salida de un componente previo con la entrada de este componente.

Cuando activas el modo de mapeo (conectando el nodo a otros anteriores), cada campo de entrada te ofrece flexibilidad total para determinar qué datos se procesarán:

  • Fixed (Fijo): Puedes escribir un valor directo si es constante.
  • Mapped (Mapeado): Conectas la salida de otro componente (por ejemplo, la respuesta de un formulario o un dato de una base de datos) para que los datos fluyan automáticamente desde allí.
  • Javascript: Puedes escribir código pequeño para transformar los datos antes de que se conviertan a TOON.

Campos de Entrada

Los siguientes campos están disponibles para configurar este componente:

  • Data: [REQUERIDO] Representa el objeto de datos estructurado que deseas convertir. Puede ser un diccionario, una lista o cualquier objeto complejo. Aquí es donde “inyectas” la información que será traducida al formato TOON.

Salidas

Una vez que el componente ha procesado tus datos, genera la siguiente salida:

  • Data: Produce una cadena de texto (str) en formato TOON. Esta salida representa la versión textual codificada de tus datos de entrada.

Puedes conectar esta salida (toon_text) directamente a componentes como “Asistente de IA”, “Analizador de Texto” o cualquier otro nodo que espere recibir instrucciones o contexto en formato de texto plano.

Ejemplo de Respuesta JSON

A continuación se muestra un ejemplo de cómo se vería el flujo de datos cuando este componente se conecta a un componente de IA. Nota cómo el campo de entrada complejo se convierte en una sola cadena de texto en la salida: json { “input_example”: { “user_id”: 12345, “profile”: { “name”: “Ana García”, “role”: “Admin” }, “active_tasks”: [ “Revisar informe”, “Actualizar base de datos” ] }, “output_toon_text”: “user_id: 12345\nprofile: {name: ‘Ana García’, role: ‘Admin’}\nactive_tasks: [‘Revisar informe’, ‘Actualizar base de datos’]” } Nota: El formato exacto del texto TOON puede variar ligeramente dependiendo de la complejidad de los datos, pero siempre mantendrá una estructura legible basada en llaves y valores.

Conectividad

Este componente es el puente ideal entre la estructura de datos y la inteligencia artificial.

  • Conéctalo DESPUÉS de: Componentes que generan o obtienen datos estructurados, como Obtener Registro, Crear Objeto, Formularios o Transformadores de Datos.
  • Conéctalo ANTES DE: Componentes que necesitan entender el contexto de los datos, principalmente el componente AI Assistant (Asistente de IA), Generador de Texto o Analizadores de Sentimiento.

Por qué tiene sentido: La IA no “lee” objetos JSON o diccionarios directamente en el mismo formato nativo; necesita instrucciones claras. Al convertir tus datos en texto TOON primero, aseguras que el Asistente de IA reciba una representación precisa y completa de la información, mejorando la calidad de sus respuestas.

Ejemplo de Uso

Escenario: Quieres que un Asistente de IA analice una lista de tareas pendientes de un empleado para priorizarlas.

  1. Obtienes una lista de tareas usando un componente de Base de Datos (esto crea un objeto estructura).
  2. Conectas esa salida al campo Data del componente Data to TOON.
  3. El componente convierte esa lista en texto TOON.
  4. Conectas la salida TOON al componente AI Assistant.
  5. El Asistente lee el texto y responde: “La tarea más urgente es X porque…”.

Sin este componente, tendr que explicar manualmente a la IA cómo interpretar la estructura compleja, lo cual a menudo resulta en errores.

Consejos y Mejores Prácticas

  • Usa siempre para IA: Si planeas enviar datos a un Asistente de IA, usa Data to TOON en lugar de enviar el objeto directo. Esto reduce confusiones en los resultados de la IA.
  • Datos simples vs. Complejos: Funciona igual de bien con una sola palabra que con una estructura de datos anidada compleja. La salida será más larga y detallada cuanto más complejos sean tus datos de entrada.
  • Depuración: Si el Asistente de IA no responde bien, revisa el texto TOON generado. Asegúrate de que todos los campos importantes estén presentes y bien formados.

Consideraciones de Seguridad

Asegúrate de no incluir datos sensibles o confidenciales (como contraseñas o números de tarjetas de crédito) en el campo Data antes de pasarlo a componentes de IA, ya que el texto TOON resultante será texto plano y legible. La automatización de Nappai debe cumplir con las políticas de privacidad de tu organización; utiliza filtros de limpieza de datos antes de llegar a este nodo si es necesario.