Las "Entradas de Usuario" son un recurso esencial en Agent Studio para crear agentes de IA más interactivos y personalizables. En vez de depender de una única instrucción en texto, puedes construir formularios y campos estructurados para recopilar exactamente la información que tu agente necesita para ejecutar una tarea.
En esta guía, vamos a explorar los cinco tipos de entrada de usuario disponibles en la plataforma Tess AI, mostrando cómo y cuándo usar cada uno de ellos para potenciar tus creaciones.
Cómo Configurar una Entrada de Usuario
Antes de explorar los tipos de entrada, el proceso para añadirlas es siempre el mismo y ocurre en el panel de configuración de tu agente:
En Agent Studio, está la opción "Entrada del Usuario".

Haz clic ahí para crear un nuevo campo de entrada.

Para cada variable, vas a configurar (al menos) tres campos principales:
TIPO: El formato de la entrada que el usuario va a completar (texto, lista, archivo, etc.).
NOMBRE: El nombre interno de la variable, que se va a usar en la instrucción (prompt). Usa nombres cortos, sin acentos ni caracteres especiales.
DESCRIPCIÓN: El texto que se va a mostrar al usuario final, orientando cómo completarlo.
Explorando los Tipos de Entrada
Ahora vamos a detallar cada uno de los tipos de entradas que puedes configurar.
1. Campo de Texto Corto
Ideal para recopilar información breve y directa. Usa este campo cuando el usuario necesite completar una palabra, una frase o un dato específico.
Para qué sirve: Recopilar nombres, correos electrónicos, números de pedido, términos de búsqueda, títulos de documentos, etc.
Ejemplo de uso: Puedes crear un agente que genere saludos personalizados. La variable Nombre del Cliente (Texto Corto) pediría el nombre del cliente:

Y la instrucción sería: "Crea un saludo amigable para **nome-do-cliente**"

2. Campo de Texto Largo
Perfecto para situaciones en las que el usuario necesita proporcionar un gran volumen de información, como un texto completo, un párrafo detallado o un bloque de código.
Para qué sirve: Permitir que el usuario pegue un correo electrónico para que sea resumido, un artículo para que sea analizado, una descripción de problema para que sea diagnosticada, o un código para que sea depurado.
Ejemplo de uso: Un agente revisor de textos. La variable Texto Completo (Texto Largo) le pediría al usuario que pegara el texto.

Y la instrucción sería: "Revisa el siguiente texto y corrige los errores gramaticales: **texto-completo**"
3. Dropdown (Seleção Única)
Usa el dropdown para asegurarte de que la respuesta del usuario esté estandarizada. Muestra una lista de opciones predefinidas, de la cual el usuario solo puede elegir una.
Para qué sirve: Limitar la elección a un conjunto de opciones, como seleccionar un idioma (Portugués, Inglés), un departamento (Ventas, Soporte), un tono de voz (Formal, Informal) o una acción específica (Traducir, Resumir).
Ejemplo de uso: Un agente traductor. La variable idioma_alvo ropdown) ofrecería opciones como "Inglés", "Español" y "Francés". La instrucción sería: "Traduce el siguiente texto al idioma **idioma_alvo**."
4. Múltipla Escolha
Similar al dropdown, pero con la flexibilidad de permitir que el usuario seleccione varias opciones de una lista predefinida.
Para qué sirve: Cuando el usuario puede elegir más de una alternativa válida, como seleccionar los temas de interés para un informe, las redes sociales donde publicar un post o las funcionalidades de un producto que se incluirán en una descripción.
Ejemplo de uso: Un agente de creación de campañas. La variable redes_sociais (Múltipla Escolha) listaría "Facebook", "Instagram" y "LinkedIn". La instrucción sería: "Crea un post sobre IA para las siguientes redes: **redes_sociais**."
5. Subida de archivo
Este tipo de entrada convierte a tu agente en un poderoso analista de documentos, permitiendo que el usuario adjunte archivos para su procesamiento.
Para qué sirve: Analizar contratos en PDF, extraer datos de hojas de cálculo en XLSX o CSV, resumir informes en DOCX o interpretar el contenido de cualquier archivo de texto.
Ejemplo de uso: Un agente que analiza hojas de cálculo. La variable planilha_vendas (Archivo) pediría la subida del archivo, y la instrucción sería: "Con base en la hoja de cálculo **planilha_vendas**, calcula el total de ventas del último trimestre."