Argumentos
Define las entradas y salidas del agente para controlar qué información recibe y qué devuelve.
Argumentos
La página Argumentos define qué necesita recibir el agente para funcionar (argumentos de entrada) y qué devuelve una vez procesada una solicitud (argumentos de salida).
Accede desde el icono Argumentos de la navegación lateral del editor.
Argumentos de entrada
Los argumentos de entrada son lo que el agente necesita para funcionar. Un agente del tiempo, por ejemplo, podría tener un argumento de entrada Ubicación.
De cada argumento defines su tipo, si es obligatorio y si debe aparecer en la interfaz de usuario.
El formulario, generado automáticamente
Cuando uno o más argumentos de entrada tienen Mostrar en la UI activado, el agente genera un formulario para que el usuario lo rellene antes de empezar la conversación. Si ningún argumento está marcado para mostrarse en la UI, el usuario interactúa con el agente solo por chat o por prompt.
Haz clic en Previsualizar el formulario (disponible cuando al menos un argumento tiene Mostrar en la UI activo) para ver cómo quedará.
Argumentos de salida
Los argumentos de salida son lo que el agente devuelve una vez procesada una solicitud. Un agente que revisa currículums, por ejemplo, podría devolver Puntuación y Recomendación.
Los argumentos de salida los usan las ejecuciones por workflow y por webhook, y se devuelven en formato JSON.
La columna Mostrar en la UI solo existe en la pestaña Argumentos de entrada. Los argumentos de salida nunca aparecen en un formulario.
Las columnas de la tabla
| Columna | Qué es |
|---|---|
| Nombre | El identificador del argumento. Se usa como variable en el prompt con la sintaxis {NombreDelArgumento}. Edítalo haciendo clic en el campo. |
| Descripción | Le explica al modelo de IA para qué sirve el argumento. Cuanto más precisa, mejor entiende el agente cómo usarlo. Edítala en el campo de debajo del nombre. |
| Tipo | El formato del valor esperado. Ver los tipos más abajo. |
| Requerido | Con esto activado, el argumento es obligatorio: la ejecución no arranca sin él. |
| Mostrar en la UI | (Solo entrada) Con esto activado, el argumento aparece en el formulario generado para el usuario. |
Tipos de argumento
| Tipo | Icono | Para qué sirve |
|---|---|---|
| Texto | Aa | Cualquier valor textual |
| Número | 123 | Números enteros o decimales |
| Fecha | Un calendario | Fechas en formato ISO |
| Booleano | Un interruptor | Verdadero o falso |
| Archivo | Un clip | Un archivo que sube el usuario |
| JSON | {} | Un objeto JSON estructurado |
Añadir un argumento
- Elige la pestaña Argumentos de entrada o Argumentos de salida.
- Haz clic en + Añadir argumento.
- Aparece un argumento nuevo con nombre por defecto (
Argumento1,Argumento2…), tipo Texto y no obligatorio. - Haz clic en el campo Nombre para renombrarlo.
- Haz clic en el campo de descripción para detallar para qué sirve.
- Ajusta el Tipo, Requerido y —si es de entrada— Mostrar en la UI.
Los cambios se guardan solos.
Eliminar argumentos
Selecciona uno o varios con la casilla de la izquierda de cada fila y haz clic en Eliminar seleccionados. Se te pide confirmación antes.