Transformación por lotes

Herramienta de agente integrada que procesa un archivo CSV fila por fila y añade columnas generadas por IA en función de una tarea que definas.

Lo que hace

Transformación por lotes es una herramienta integrada que procesa un archivo CSV fila por fila y le añade columnas generadas por IA. Le das un CSV de origen, una tarea que describe qué hacer para cada fila y las columnas que deseas añadir. Devuelve un nuevo archivo con esas columnas rellenadas.

Adjuntas Transformación por lotes a un agente autónomo como herramienta. El agente llama a la herramienta mientras razona, pasándole el archivo de origen y la tarea, y utiliza el archivo transformado en el resto de su trabajo.

El nodo está etiquetado como Transformación por lotes en la paleta, en la categoría de herramientas integradas.

Cuándo usarlo

Usa Transformación por lotes cuando un agente necesite enriquecer o clasificar las filas de un CSV de forma masiva, y cada fila necesite el mismo tratamiento impulsado por IA.

Tareas típicas:

• Clasifica cada fila en una categoría y escribe la etiqueta en una nueva columna.
• Extrae un valor de un campo de texto libre en su propia columna.
• Puntúe, resuma o etiquete cada fila en función de sus columnas existentes.

Para extraer datos estructurados de un solo documento en lugar de transformar filas tabulares, conecta un recurso de extracción de documentos en su lugar. Para analizar el contenido de los archivos que no son CSV orientados a filas, utiliza la herramienta integrada Analizar archivos .

Añadir la herramienta

Añade la herramienta al lienzo y luego conéctala a un agente.

1. Selecciona un nodo de agente autónomo o añade uno si tu flujo aún no lo tiene.
2. Abre la paleta de nodos y selecciona la categoría Herramientas integradas .
3. Selecciona Transformación por lotes. El flujo añade el nodo al lienzo.
4. Dibuja un borde desde el nodo Transformación por lotes hasta el identificador de la herramienta del agente.
5. Selecciona el nodo Transformación por lotes para abrir su panel de propiedades y configurarlo.

Resultado: la herramienta Transformación por lotes está conectada al agente. El agente ahora puede llamarlo mientras razona.

Referencia de configuración

Configura estos campos en la sección Configuración de transformación por lotes del panel de propiedades.

Campo	Obligatorio	Predeterminado	Descripción
Origen (archivo)	Sí	Ninguno	Archivo CSV para transformar. Haz referencia a un archivo producido anteriormente en el flujo, o uno que el agente proporciona cuando llama a la herramienta.
Tarea de transformación por lotes	Sí	Ninguno	Instrucciones que la herramienta aplica a cada fila. Describe qué analizar, qué extraer y cómo rellenar las columnas de salida.
Columnas de salida	Sí	Ninguno	Columnas que la herramienta añade al archivo. Defina al menos una columna con un nombre y una descripción, y añada hasta 10 columnas.
Nombre de columna	Sí	Ninguno	Encabezado para la nueva columna en el archivo de salida.
Descripción	Sí	Ninguno	Contenido que debe contener la columna. La herramienta utiliza este valor para decidir qué escribir para cada fila, así que sé específico sobre el formato esperado.
Fundamentación con búsqueda web	No	Habilitada	Si la herramienta puede utilizar la búsqueda web para fundamentar o enriquecer sus resultados. Selecciona Deshabilitado para utilizar solo el archivo y la tarea de origen.

Entradas y salidas

Entrada

La Transformación por lotes toma su entrada de los campos que configuras: el CSV de origen, la tarea, las columnas de salida y la configuración de búsqueda web. Como se ejecuta como herramienta, el agente que llama proporciona estos valores cuando invoca la herramienta durante una ejecución.

Salida

Transformación por lotes devuelve un archivo: el CSV de origen con las columnas de salida anexadas y rellenadas. Accede a ella en $vars.<nodeName>.output, donde <nodeName> es el nombre del nodo Transformación por lotes.

$vars.batchTransform1.output

Si la herramienta falla, el nodo rellena un objeto error en su lugar. Consulta Gestión de errores para ver la forma de error y cómo enrutar en ella.

{
  "output": "file. The source CSV with the configured output columns added and populated.",
  "error": "object. Populated only on failure. See Error handling."
}

Ejemplo

Clasificar un CSV de tickets de soporte

Un agente recibe un CSV de tickets de soporte y necesita que cada ticket se categorice y priorice antes de enrutarlos.

Conecta una herramienta de Transformación por lotes al agente y configúrala de la siguiente manera.

Origen (archivo): el CSV de los tickets, por ejemplo, un archivo pasado desde el inicio del flujo.

Tarea de transformación por lotes:

For each ticket, read the Subject and Body columns. Classify the ticket into exactly one category: billing, technical, or account. Then assign a priority of high, medium, or low based on the urgency expressed in the text.

Columnas de salida:

• Category: uno de facturación, técnico o cuenta, en función del asunto y el cuerpo del ticket.
• Priority: uno de alta, media o baja, que refleja la urgencia del ticket.

Cuando el agente llama a la herramienta, Transformación por lotes devuelve el CSV original con una columna Category y una columna Priority añadida para cada fila. A continuación, el agente utiliza ese archivo enriquecido, disponible en $vars.batchTransform1.output, en el resto de su tarea.

Páginas relacionadas

• Agente
• Extracción de documentos
• Administración de errores