LlamaCloud Component Extract

El LlamaCloud Component Extract permite a los usuarios de Nappai enviar archivos a LlamaCloud, ejecutar agentes de extracción y recuperar los textos procesados. El componente se integra directamente con la API de LlamaCloud, lo que significa que todo el procesamiento ocurre en la nube y el resultado se devuelve al flujo de trabajo de Nappai.

¿Cómo funciona?

Cuando activas el componente, Nappai envía una solicitud HTTP a la API de LlamaCloud con los parámetros que hayas configurado (archivo, agente, organización, etc.). LlamaCloud procesa el archivo con el agente seleccionado y devuelve el texto extraído o la lista de trabajos en curso. El componente recibe esa respuesta y la entrega como Result (datos) o como Tool (herramienta) para que un agente de IA la utilice.

Operaciones

Este componente ofrece varias operaciones que puedes seleccionar según lo que necesites hacer. Solo puedes usar una operación a la vez:

Run on file: Envía un archivo a LlamaCloud para que sea procesado por el agente de extracción seleccionado y devuelve el texto extraído.
List Alls Jobs: Recupera la lista de todos los trabajos de extracción que se han iniciado en tu proyecto.
Get Parsed Text: Obtiene el texto ya procesado de un archivo previamente enviado y analizado.

Para usar el componente, primero selecciona la operación que necesitas en el campo “Operation” (Operación).

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

Los siguientes campos están disponibles para configurar este componente. Cada campo puede estar visible en diferentes operaciones:

Records: El archivo o archivos que deseas que LlamaCloud analice. Se utiliza el componente Binary para subir los archivos.
- Visible en: Run on file
Parse Action: Acción de análisis que se ejecutará en LlamaCloud.
- Visible en: Run on file, List Alls Jobs, Get Parsed Text
Access Token: El token de acceso para tu cuenta de LlamaCloud.
- Visible en: Run on file, List Alls Jobs, Get Parsed Text
Extraction Agent Name: Selecciona uno de los agentes de extracción que has declarado en tu proyecto.
- Visible en: Run on file
Job Name: Selecciona uno de los archivos que ya han sido analizados en tu proyecto.
- Visible en: Get Parsed Text
Last Access Token: El último token de acceso utilizado por LlamaCloud.
- Visible en: Run on file, List Alls Jobs, Get Parsed Text
Mapping Mode: Habilita el modo de mapeo para procesar múltiples registros en lote.
- Visible en: Run on file, List Alls Jobs, Get Parsed Text
Organization Name: Selecciona el nombre de la organización después de introducir el primer token de acceso.
- Visible en: Run on file, List Alls Jobs, Get Parsed Text
Project Name: Selecciona el nombre del proyecto después de introducir el token de acceso y la organización.
- Visible en: Run on file, List Alls Jobs, Get Parsed Text
Tool Name: El nombre de la herramienta que se mostrará al agente cuando este elija usarla.
- Visible en: Run on file, List Alls Jobs, Get Parsed Text
Tool Description: Descripción detallada de lo que hace esta herramienta para que el agente la comprenda.
- Visible en: Run on file, List Alls Jobs, Get Parsed Text
Tools arguments metadata: Define los metadatos de los argumentos que la herramienta aceptará.
- Visible en: Run on file, List Alls Jobs, Get Parsed Text

Nota sobre credenciales
Este componente requiere una credencial de tipo LlamaCloud API.

Configura la credencial en la sección de credenciales de Nappai.

Selecciona esa credencial en el campo Credential del componente.
Los campos de la credencial (token, URL de conexión) no aparecen en la lista de entradas.

Salidas

Result: Devuelve los datos procesados por LlamaCloud (por ejemplo, el texto extraído).
Tool: Devuelve una herramienta que puede ser utilizada por un agente de IA para ejecutar la operación seleccionada.

Ejemplo de Uso

Escenario: Un usuario quiere extraer información de un PDF y luego usar ese texto en un flujo de conversación con un agente.

Agregar el componente al flujo y seleccionar la operación Run on file.
Conectar el componente Binary que contiene el PDF al campo Records.
Seleccionar el agente de extracción adecuado en Extraction Agent Name.
Proveer el Access Token y la Organization Name / Project Name.
Ejecutar el flujo.
El resultado aparecerá en la salida Result, que puede ser conectado a un componente de texto o a un agente que utilice la herramienta generada.

Plantillas

(Esta sección se omite porque no hay plantillas que utilicen este componente.)

Componentes Relacionados

Binary – Permite subir archivos que luego se pueden enviar a LlamaCloud.
Agent – Puede consumir la salida Tool para ejecutar la operación dentro de un flujo de conversación.
Credential Manager – Gestiona la credencial LlamaCloud API necesaria para este componente.

Consejos y Mejores Prácticas

Usa el modo de mapeo cuando necesites procesar varios archivos en lote; así puedes conectar la salida de un componente de lista de archivos directamente a Records.
Guarda los trabajos: Si quieres revisar trabajos anteriores, utiliza la operación List Alls Jobs y luego Get Parsed Text para extraer el resultado.
Mantén tu token seguro: No lo compartas en el flujo; confía en el gestor de credenciales de Nappai.
Revisa los límites de LlamaCloud: Cada cuenta tiene un número máximo de peticiones por minuto; evita enviar demasiados archivos simultáneamente.

Consideraciones de Seguridad

La comunicación con LlamaCloud se realiza sobre HTTPS, garantizando que los datos y tokens estén cifrados en tránsito.
Los tokens de acceso se almacenan de forma segura en el gestor de credenciales de Nappai y no se exponen en el flujo.
Asegúrate de revocar cualquier token que ya no necesites y de generar nuevos tokens con los permisos mínimos requeridos.