Entradas y salidas de escenarios
Nota de alcance: reconstrucción editorial basada en la documentación oficial, capturada el 2026-05-14. Describe esa versión histórica; no acredita funciones, límites ni disponibilidad actuales. Consulta la fuente vigente antes de configurar un flujo nuevo.
Las entradas definen los datos que recibe un escenario al iniciarse. Las salidas definen los datos que devuelve. Este contrato permite que quien llama al escenario sepa qué enviar y cómo interpretar el resultado.
La captura sitúa su configuración en el icono Scenario inputs and outputs de la barra de herramientas del editor.
El recorrido de los datos
En una llamada entre escenarios, la aplicación Scenarios organiza el intercambio:
- El escenario principal utiliza Call a scenario y selecciona el escenario que quiere ejecutar.
- El subescenario empieza con Start scenario, desde donde se mapean las entradas.
- Los módulos intermedios realizan el trabajo.
- Return output devuelve los valores definidos como salidas cuando la llamada necesita un resultado.
Definir una salida no sustituye su mapeo: hay que indicar de dónde procede el valor que se devolverá.
Usos descritos en la fuente
- Subescenarios: separar una tarea reutilizable del flujo principal y documentar qué datos intercambian.
- API: definir la información que una aplicación externa envía al ejecutar el escenario y la estructura de la respuesta.
- Agentes de IA: describir parámetros y resultados de un escenario usado como herramienta.
- MCP: permitir que un cliente compatible aporte parámetros y reciba datos estructurados.
Estos usos pertenecen a la documentación capturada. La configuración de acceso, autenticación y disponibilidad de cada integración debe verificarse por separado.
Tipos de datos
| Tipo | Uso |
|---|---|
| Array | Lista de elementos, como archivos adjuntos |
| Collection | Campos relacionados de un objeto, como nombre y correo de un contacto |
| Dynamic collection | Objeto mapeado o cadena JSON válida según el campo |
| Date | Fecha y hora en formato ISO 8601 |
| Text | Nombres, descripciones y mensajes |
| Number | Valores numéricos, incluidos los que tienen decimales |
| Integer | Enteros sin parte decimal |
| Uinteger | Enteros sin signo para valores que no deben ser negativos |
| Boolean | Valores verdadero/falso |
| Select | Elección entre opciones definidas |
| Dirección de correo | |
| URL | Dirección web |
| UUID | Identificador universal único |
| Color | Valor de color |
| Any | Datos cuyo tipo no se puede definir de forma más precisa |
Ejemplo de contrato
Un escenario que consulta el menú de un restaurante puede recibir un identificador de restaurante y una fecha. Puede devolver una lista de platos y la fecha de actualización de la información.
Nombra los campos de forma inequívoca y explica su significado. «Fecha solicitada» y «Fecha de actualización» son conceptos distintos, aunque ambos sean fechas. Para herramientas de IA, los nombres y descripciones también ayudan a interpretar qué datos se necesitan.
Verificar cambios
Prueba el escenario con valores válidos y con una entrada ausente o de tipo incorrecto. Comprueba la salida que recibe realmente el llamador. Si cambias nombres o tipos en un subescenario compartido, revisa todos los escenarios que lo utilizan: reutilizar una lógica también comparte el impacto de sus cambios.