Saltearse al contenido
Nappai Documentation

LlamaCloud Component Parse

LlamaCloud Component Parse es un componente de Nappai que permite enviar archivos a LlamaCloud para que sean analizados y transformados. El resultado se devuelve como datos estructurados que pueden ser usados en el resto del flujo de trabajo o como una herramienta que un agente de IA puede invocar.

¿Cómo funciona?

Cuando activas el componente, Nappai toma los archivos que subiste (en formato Base64) y los envía a la API de LlamaCloud usando el token de acceso que has configurado en la credencial LlamaCloud API. LlamaCloud procesa los archivos y devuelve los datos extraídos o transformados. El componente simplemente pasa esa respuesta a la siguiente etapa del flujo, ya sea como datos o como una herramienta que el agente puede usar.

Entradas

Modo de Mapeo (Mapping Mode)

Este componente cuenta con un modo especial llamado “Mapping Mode” (Modo de Mapeo). Cuando activas este modo mediante el interruptor, se habilita una entrada adicional llamada “Mapping Data” y cada campo de entrada te ofrece tres formas diferentes de proporcionar datos:

  • Fixed (Fijo): Escribes el valor directamente en el campo.
  • Mapped (Mapeado): Conectas la salida de otro componente para usar su resultado como valor.
  • Javascript: Escribes código Javascript para calcular el valor dinámicamente.

Esta flexibilidad te permite crear flujos de trabajo más dinámicos y conectados.

Campos de Entrada

  • Base 64 input: El archivo o archivos que quieres que LlamaCloud analice. Se sube usando el componente Binario y se envía como Base64.
  • Access Token: El token de acceso que permite autenticarte con LlamaCloud. Se obtiene de la credencial configurada.
  • Last Access Token: El token de acceso anterior, útil para mantener la sesión activa.
  • Mapping Mode: Interruptor que habilita el modo de mapeo para procesar múltiples registros en lote.
  • Organization Name: Nombre de la organización dentro de LlamaCloud donde se ejecutará la operación.
  • Project Name: Nombre del proyecto dentro de la organización donde se enviarán los archivos.
  • Tool Name: Nombre que aparecerá cuando el componente se use como herramienta en un agente.
  • Tool Description: Descripción detallada de la herramienta para que el agente sepa cuándo usarla.
  • Tools arguments metadata: Metadatos que definen los argumentos que la herramienta aceptará.

Credencial requerida
Este componente necesita una credencial de tipo LlamaCloud API.

  1. Ve a la sección de credenciales de Nappai y crea una nueva credencial llamada LlamaCloud API.
  2. Ingresa tu Access Token y la LlamaCloud Server Connection URL que puedes encontrar en la sección Account de tu cuenta LlamaCloud.
  3. En el componente, selecciona la credencial que acabas de crear en el campo Credential.

Salidas

  • Result: Los datos procesados por LlamaCloud, disponibles para ser usados en el siguiente paso del flujo.
  • Tool: Una representación de la herramienta que el agente puede invocar, con el nombre y la descripción que configuraste.

Ejemplo de Uso

  1. Subir un archivo: Conecta el componente Binary al campo Base 64 input.
  2. Configurar credencial: Selecciona la credencial LlamaCloud API en el campo Credential.
  3. Activar Modo de Mapeo (opcional): Si quieres procesar varios archivos a la vez, activa el interruptor Mapping Mode y conecta una lista de archivos al campo Mapping Data.
  4. Ejecutar: Haz clic en Run y espera a que LlamaCloud devuelva los resultados.
  5. Usar el resultado: Conecta la salida Result a un componente de visualización o a otro proceso que necesite los datos extraídos.

Componentes Relacionados

  • Binary Component – Permite subir archivos y convertirlos a Base64.
  • LlamaCloud Parse Custom – Versión base del componente que maneja la lógica de conexión a LlamaCloud.
  • Tool Builder – Permite crear herramientas personalizadas que los agentes pueden usar.

Consejos y Mejores Prácticas

  • Mantén tu token seguro: No lo compartas públicamente y usa la credencial de Nappai para gestionarlo de forma centralizada.
  • Usa el Modo de Mapeo para grandes volúmenes: Si necesitas procesar cientos de archivos, activa el modo de mapeo y envía una lista en lugar de archivos individuales.
  • Revisa la documentación de LlamaCloud: Asegúrate de que el formato de tus archivos sea compatible con la API de LlamaCloud.
  • Prueba con archivos pequeños primero: Verifica que la respuesta sea la esperada antes de pasar a archivos más grandes.

Consideraciones de Seguridad

  • La credencial LlamaCloud API contiene información sensible; solo usuarios autorizados deben tener acceso a ella.
  • Los archivos enviados se transmiten a través de HTTPS, pero siempre revisa que la URL de conexión sea la correcta y segura.
  • Si el componente se usa como herramienta en un agente, limita el acceso a la herramienta a los agentes que realmente necesiten procesar datos sensibles.