Cómo viaja la información
En un flujo, cada conexión lleva información de un componente al siguiente. Saber qué tipo de información viaja por cada conexión te ayuda a elegir los componentes adecuados y a entender por qué dos puntos se pueden conectar o no.
Los tipos de información
| Tipo | Qué es | Ejemplos |
|---|---|---|
| Mensaje o texto | Un texto, como una pregunta o una respuesta. | Lo que escribe el usuario en el chat, la respuesta de un agente, el cuerpo de un correo. |
| Registro | Un conjunto de datos con nombre, como una ficha. Cada dato es un campo con su valor. | Un cliente con nombre, email y ciudad; un pedido con numero, importe y estado. |
| Lista | Varios registros juntos. | Los correos sin leer, las filas de una hoja de cálculo, los pedidos de hoy. |
| Archivo | Un documento, una imagen o un audio. | Un PDF adjunto, una foto, la grabación de una llamada. |
Los componentes de modelos y agentes trabajan sobre todo con texto. Los de servicios externos, como hojas de cálculo, CRM o bases de datos, suelen devolver registros o listas.
Conexiones compatibles
Cada punto de conexión acepta ciertos tipos. Mientras arrastras una conexión, el editor atenúa los puntos que no admiten lo que sale del componente de origen, y una conexión no válida no se crea.
Si necesitas pasar de un tipo a otro, hay componentes para ello. Por ejemplo, Parse Data convierte registros en texto con una plantilla, y Prompt compone un texto con los datos que le llegan.
Los campos de un registro
Para usar un dato concreto de un registro, indicas el nombre de su campo. Cuando un campo está dentro de otro, se separan con un punto: cliente.ciudad es la ciudad dentro de los datos del cliente.
Varios componentes usan esta forma de nombrar los campos, por ejemplo Switch para decidir el camino según un campo o Parse Data para escribir {nombre} en su plantilla.
Procesar listas
Cuando a un componente le llega una lista y quieres tratar cada elemento por separado, activa Batch Mode en sus ajustes:
- Conecta la lista al punto Batch Input del componente.
- Con Batch Mode activado, cada campo del componente tiene tres modos:
- Fixed: el mismo valor para todos los elementos.
- Mapped: el valor sale de un campo de cada elemento. Eliges o arrastras el campo, por ejemplo
email. - Javascript: el valor se calcula con una pequeña fórmula a partir de cada elemento.
- El componente procesa cada elemento de la lista y devuelve una sola lista con todos los resultados.
Ejemplo: a un componente de modelo le llega la lista de correos sin leer. Con Batch Mode activado y el campo del texto en Mapped sobre el cuerpo de cada correo, el modelo resume todos los correos de una vez y devuelve la lista de resúmenes.
Algunos componentes, como Agent, tienen Batch Mode activado al añadirlos. Si el componente debe recibir un solo mensaje, como en un chat, desactívalo: aparecerá su punto de conexión normal, por ejemplo Input en el agente. Ver Tu primer flujo.
Si en vez de un solo componente necesitas repetir varios pasos en orden con cada elemento, usa Loop y Loop End. Ver Lógica de un flujo.
Archivos
Los componentes que leen o reciben archivos, como un adjunto de correo o un documento de una carpeta compartida, los pasan al siguiente paso para que otro componente extraiga su contenido, por ejemplo el texto de un PDF. No tienes que convertir nada a mano: basta con conectar la salida del archivo a un componente que lo acepte.
Los archivos que guardan tus flujos se pueden consultar y descargar en el almacenamiento. Ver Tu almacenamiento.
Cómo pasa la información por un agente
Un agente con herramientas sigue siempre el mismo ciclo:
- Recibe la petición, por ejemplo “¿Cuál es el último correo de Juan?”.
- Decide qué herramienta necesita y con qué datos, por ejemplo buscar en Gmail los correos de Juan.
- La herramienta se ejecuta y devuelve su resultado al agente.
- Si hace falta, el agente usa otra herramienta con lo que ha obtenido.
- Con toda la información, redacta una respuesta en lenguaje natural.
Ver lo que viaja en cada paso
Para saber qué recibió y qué devolvió cada componente:
- En el lienzo, el icono del ojo de cada componente muestra lo que devolvió en la última ejecución.
- En el playground, Ejecuciones lista los pasos de cada ejecución: selecciona uno para ver su detalle.
- En Reg. de Ejecuciones tienes el mismo detalle para todas las ejecuciones del flujo, también las que llegan desde otras aplicaciones.