Agent Studio se usa para mantener tus agentes de flujo existentes. Los agentes nuevos se crean como agentes gestionados.
Los cinco elementos del nodo
Indicación
La indicación le dice al nodo cómo comportarse. Una buena indicación incluye:- El rol del agente y el objetivo del nodo.
- Qué debe hacer y qué no.
- El tono o estilo.
- Cuándo usar cada herramienta.
- Qué información debe capturar.
- Qué resultado debe pasar al siguiente nodo.
Modelo
Los modelos de mayor capacidad (como GPT-5 o GPT-4.1) razonan mejor. Los modelos Mini y Nano son más rápidos y livianos, y GPT-4o ofrece baja latencia. Por ejemplo, ante “estoy viendo opciones para mi negocio”, un modelo potente detecta mejor que se trata de un posible cliente, mientras que uno liviano puede responder de forma más genérica.Modo
- Conversacional: el nodo responde al usuario y maneja la interacción. Ideal para contestar preguntas sobre precios o servicios.
- Basado en tareas: el nodo trabaja en silencio, sin enviar respuestas. Ideal para extraer el correo del usuario y actualizar el CRM en segundo plano.
Herramientas
Según la indicación y el contexto, el nodo decide cuándo necesita una herramienta y cuál usar:Variables
- Las variables de entrada dan contexto al nodo (datos del disparador o de nodos anteriores).
- Las variables de ejecución capturan datos estructurados durante la conversación. Por ejemplo, si alguien escribe “Hola, soy Rahul y quiero una demo”, el nodo puede guardar Nombre = Rahul y Requerimiento = Demo para usarlos después.
Cuándo usar el nodo Agente de IA
Úsalo cuando la decisión depende del contexto: respuestas conversacionales, calificación de prospectos, clasificación de solicitudes de soporte, consultas a la base de conocimiento, búsquedas web, extracción de datos, actualizaciones del CRM o enrutamiento dinámico. Si los pasos siempre deben ejecutarse en el mismo orden, usa el nodo secuencial.Cómo configurar el nodo
1
Agrega el nodo
Desde el panel de nodos, agrega Agente de IA al lienzo y conéctalo al disparador de inicio o al nodo anterior.
2
Escribe la indicación
En el panel de configuración, describe el rol, las responsabilidades, el tono y cuándo usar herramientas. Para insertar datos dinámicos, usa el ícono de variables del campo. Por ejemplo, con
{{contact.name}} el nodo puede saludar “Hola Rahul, ¿en qué te ayudo?”. Agrega solo las variables necesarias para que la indicación siga siendo clara.3
Mejora la indicación (opcional)
Usa Mejorar indicación para obtener una versión más clara y estructurada. Revisa la sugerencia y acéptala o recházala para conservar la tuya.
4
Elige el modelo
Usa un modelo potente para razonamientos complejos y uno liviano para tareas simples y rápidas.
5
Elige el modo
Conversacional si el nodo debe responder al usuario, o Basado en tareas si debe trabajar en segundo plano.
6
Conecta solo las herramientas necesarias
Agrega las herramientas que tu caso requiere, como base de conocimiento, enrutador o búsqueda web. Menos herramientas hacen que el nodo elija mejor.
7
Define las variables de ejecución
Para cada dato que quieras capturar, define el Nombre (por ejemplo,
user_name o email), el Tipo y una Descripción clara de qué debe extraer. El nodo usa el nombre y la descripción para encontrar el dato en la conversación.8
Conecta el siguiente paso
Une el nodo con el siguiente paso del flujo para que su respuesta, acción o datos extraídos continúen.
Tipos de variable
Fuentes de variables disponibles
- Configuración global: valores compartidos por todo el agente.
- Variables de entrada: datos que llegan de nodos anteriores o del disparador.
- Variables de ejecución: datos extraídos durante la conversación.
- Cuenta: datos de tu negocio.
- Valores personalizados: constantes que defines tú.
- Ahora mismo: fecha y hora actuales.
- Contacto: nombre, correo, teléfono y otros datos del contacto.
Preguntas frecuentes
¿Conviene que un nodo haga muchas tareas?
¿Conviene que un nodo haga muchas tareas?
Es mejor que cada nodo Agente de IA tenga un rol principal. Demasiadas tareas distintas lo hacen más difícil de controlar y de probar.
¿Cómo decide qué herramienta usar?
¿Cómo decide qué herramienta usar?
Según la indicación, las herramientas conectadas, lo que escribe el usuario y el contexto. Unas instrucciones claras sobre cuándo usar cada herramienta mejoran la elección.
¿Puede usar mi base de conocimiento?
¿Puede usar mi base de conocimiento?
Sí, si conectas la herramienta Buscar en la base de conocimiento y la indicación explica cuándo usarla.
¿Puede conectarse con sistemas externos?
¿Puede conectarse con sistemas externos?
Sí, con las herramientas de llamada a API o servidor MCP.
¿Por qué mi variable de ejecución queda vacía?
¿Por qué mi variable de ejecución queda vacía?
Puede que el usuario no haya dado ese dato, que la descripción de la variable sea confusa o que la indicación no le pida capturarlo. Ajusta la indicación y la descripción y vuelve a probar.
¿Debo probar después de cada cambio?
¿Debo probar después de cada cambio?
Sí. Prueba cada vez que cambies la indicación, el modelo, el modo, las herramientas, las variables o las conexiones.
Artículos relacionados
Nodo secuencial
Ejecuta pasos en un orden fijo.
Nodo enrutador
Divide la conversación por intención o por reglas.
Agentes de flujo en Agent Studio
Conoce el constructor y sus nodos.
Prueba y depura agentes
Revisa cada paso antes de salir en vivo.