Data batch Agent

Data batch Agent recorre una lista de elementos y, para cada uno, encarga a un agente la misma tarea con los datos de ese elemento. El agente trabaja como siempre, con sus instrucciones y sus herramientas, y su respuesta se añade como un campo nuevo de cada elemento.

Se parece a Data Batch Chain, pero en lugar de enviar cada elemento directamente a un modelo de IA, se lo pasa a un agente. Úsalo cuando cada elemento necesite que el agente consulte algo o use una herramienta, por ejemplo buscar en la web o en tu sistema de pedidos.

Cuándo usarlo

Para cada empresa de una lista de clientes potenciales, que un agente con búsqueda web prepare un resumen de su actividad.
Para cada pedido retrasado, que un agente consulte su estado en el sistema de logística y redacte un aviso para el cliente.
Para cada candidatura recibida, que un agente revise el perfil frente a los requisitos del puesto y dé una valoración.

Configuración

Campo	Qué hace
prompt	La tarea que se encarga al agente para cada elemento. Marca con llaves dónde van los datos del elemento (ver más abajo). Debe tener al menos un hueco entre llaves.

Conexión	Qué conectar
Data	La lista de elementos que quieres procesar, por ejemplo la salida de CSV to Data List.
Worker Agent	El agente que hace la tarea: la salida Agent de un componente como Agent.

Huecos entre llaves en el prompt

{Data} se sustituye por el texto principal de cada elemento.
{Data.campo} se sustituye por el valor de un campo concreto de cada elemento. Por ejemplo, {Data.empresa} toma el campo empresa.
Cualquier otro nombre entre llaves, por ejemplo {idioma}, crea un campo nuevo en el componente. Su valor es el mismo para todos los elementos; puedes escribirlo o conectarlo.

Opciones avanzadas

Campo	Qué hace
Output key name	El nombre del campo nuevo donde se guarda la respuesta del agente. Por defecto: `chain_result`.
Max Concurrency	Cuántos elementos procesa el agente a la vez. Por defecto: 5.
JSON Mode	Interpreta la respuesta del agente como datos estructurados en formato JSON. Pide en prompt que responda en JSON. Por defecto: desactivado.
JSON Flatten	Con JSON Mode activado, guarda cada dato de la respuesta JSON como un campo propio del elemento. Por defecto: desactivado.

Resultado

Data es la misma lista que entró, en el mismo orden, con la respuesta del agente añadida a cada elemento. Conéctala a un componente que guarde o transforme datos, por ejemplo Data to CSV.

Ejemplo

Consultores Roble quiere preparar visitas comerciales a una lista de empresas:

Carga la lista con CSV to Data List y conecta su salida a Data.
Configura un Agent con una herramienta de búsqueda web y conecta su salida Agent a Worker Agent.
En prompt escribe: “Busca información reciente sobre la empresa {Data.empresa} de {Data.ciudad} y resume en tres frases su actividad y sus últimas noticias”.
En Output key name escribe resumen.

Cada empresa sale con un campo resumen que el equipo comercial lee antes de llamar.

Buenas prácticas

Prueba la tarea con dos o tres elementos antes de procesar una lista grande: cada elemento consume tiempo y uso del modelo.
Baja Max Concurrency si las herramientas del agente consultan un servicio que limita las peticiones.