- General — Modelo e instrucciones
- Tools — Herramientas nativas, personalizadas y MCP
- Knowledge — Documentos, imágenes y datastores
- Advanced — Modelo de respaldo, seguridad, expiración, DLP y más
General
La pestaña General contiene la configuración esencial del agente.Modelo
Selecciona el modelo de lenguaje (LLM) que utilizará el agente para generar respuestas. Considera latencia, costo y complejidad de las tareas antes de seleccionarlo. Los modelos disponibles incluyen: OpenAI- GPT 4.1 Mini: variante simplificada de GPT-4.1 optimizada para respuestas rápidas con menor demanda de recursos.
- GPT 4.1: evolución refinada de GPT-4, con mejor comprensión, razonamiento y precisión.
- GPT 4-o (Azure): versión de GPT 4-o alojada en Azure, enfocada en estabilidad y rendimiento en entornos empresariales. Soporta visión.
- GPT 4-o Mini: versión más rápida y ligera de GPT 4-o, orientada a casos donde prima la velocidad. Soporta visión.
- GPT 5.2: modelo de última generación de OpenAI con razonamiento avanzado, mayor contexto y alta precisión en tareas complejas.
- Claude 3.5 Sonnet: excelente para tareas complejas que requieren textos más elaborados y contextos extensos.
- Claude 4 Sonnet: alta capacidad de razonamiento y análisis.
- Claude 4.6 Sonnet: última generación de Claude, con razonamiento mejorado y mayor precisión.
- Gemini 2.5 Flash: procesamiento rápido con capacidades multimodales. Soporta visión.
- Gemini 2.5 Pro: razonamiento avanzado con capacidades multimodales. Soporta visión.
- Gemini 3 Flash: última generación de Gemini con procesamiento multimodal optimizado. Soporta visión.
- Llama 4 Scout: modelo ágil y de baja latencia, ideal para ideas rápidas e interacciones ligeras.
- Llama 4 Maverick: modelo de alto rendimiento diseñado para razonamientos exigentes y resolución multistep.
También puedes agregar modelos personalizados usando el botón “Agregar modelo”. Esto permite conectar modelos propios o de terceros que no estén en la lista predefinida.
Instrucciones
Define el comportamiento base del agente mediante un prompt de sistema. Las instrucciones determinan qué rol adopta, qué tono utiliza y qué pasos sigue antes de responder. Asegúrate de que sean breves, concretas y libres de ambigüedades. Las instrucciones soportan interpolación de variables usando la sintaxis{{$variable}}, lo que permite personalizar el comportamiento dinámicamente según el contexto de la conversación.
El campo incluye un contador de caracteres que se ajusta según el modelo seleccionado, ya que cada modelo tiene un límite máximo diferente.
Ver recomendaciones y ejemplos de prompting
Tools
La pestaña Tools permite agregar herramientas que amplían las capacidades del agente más allá de la generación de texto. El agente decide autónomamente cuándo invocar cada herramienta según el contexto de la conversación. Para agregar herramientas, haz clic en el botón ”+ Agregar tools” y selecciona las herramientas que necesites.Tools nativas
Son herramientas predefinidas e integradas en la plataforma. Están marcadas con el texto “(Nativa)” en el selector:| Herramienta | Descripción |
|---|---|
| Búsqueda de productos | Consulta el catálogo de productos configurado en el bot |
| Enviar mensaje interactivo | Renderiza botones, listas y quick replies al usuario |
| Enviar Call to Action | Envía botones CTA con URL, con soporte de WebView |
| Fecha y hora actual | Obtiene la fecha y hora del momento en una zona horaria específica |
| Día de la semana | Calcula el día correspondiente a una fecha |
| Transferir a asesor | Transfiere la conversación a un agente humano o cola de atención |
Tools personalizadas
Herramientas creadas por el usuario desde Brain Studio. Al agregar una tool personalizada puedes configurar:- Nombre y descripción que el modelo utiliza para decidir cuándo invocarla.
- Parámetros de entrada personalizados.
- Acción al ejecutar: comportamiento posterior a la ejecución de la herramienta.
Tools MCP (Model Context Protocol)
Integra servicios externos mediante el estándar MCP. Existen dos tipos de integración:Apps MCP nativas
Aplicaciones del marketplace de Jelou que se instalan directamente en la plataforma. Cada app MCP puede configurarse en dos modos:- Modo integración: habilita todas las herramientas de la app de una vez.
- Modo granular: permite seleccionar herramientas individuales de la app y configurar cada una por separado.
Servidores MCP externos
Conexiones a servidores MCP propios mediante URL personalizada.Agrega headers (opcional)
Configura headers personalizados (nombre y valor) para autenticación u otros metadatos.
Acciones de herramientas
Cada herramienta (nativa, personalizada o MCP) puede configurar una acción que se ejecuta tras su invocación:| Acción | Comportamiento |
|---|---|
| Ninguna | El agente continúa la conversación normalmente |
| Finalizar función | La ejecución del skill termina tras usar la herramienta |
| Pausar interacción | La conversación se pausa hasta que se reanude externamente |
Knowledge
La pestaña Knowledge permite agregar fuentes de información que el agente consulta para fundamentar sus respuestas, reduciendo significativamente el riesgo de alucinaciones. Desde esta pestaña gestionas documentos, imágenes y datastores en un único lugar.Bloque de carga
El bloque de carga unificado acepta documentos e imágenes en la misma interacción. Puedes agregar archivos de tres formas:- Arrastra y suelta archivos directamente sobre el bloque
- Haz clic en el bloque para abrir el selector de archivos
- Pega una URL en el campo de enlace ubicado en la parte inferior del bloque (soporta los mismos formatos de documentos e imágenes listados abajo)
| Tipo | Formatos soportados | Tamaño máximo |
|---|---|---|
| Documentos | .pdf, .xlsx, .md, .txt, .json, .csv | 2 MB por archivo |
| Imágenes | .jpg, .jpeg, .png | 10 MB por archivo |
Los documentos se procesan uno por uno. Si seleccionas o arrastras varios documentos simultáneamente, solo el primero se procesará y recibirás un aviso para cargar los restantes individualmente. Las imágenes, en cambio, se procesan en lote.
Documentos
Al cargar un documento se abre un panel donde defines su nombre (máximo 30 caracteres) y una descripción opcional que ayuda al agente a entender el contenido del archivo. Una vez cargado, puedes editar sus metadatos o eliminarlo desde la lista.Imágenes
Las imágenes se suben directamente sin pasos adicionales y aparecen como miniaturas debajo del bloque de carga. Puedes subir hasta 3 imágenes por agente.- Haz clic en una miniatura para verla en pantalla completa
- Pasa el cursor sobre una miniatura para ver el botón de eliminar
Datastores
Conecta bases de datos de Datum para que el agente consulte información estructurada en tiempo real:- Selecciona el datastore a conectar
- Configura las operaciones permitidas sobre la base de datos
Se recomienda activar siempre la sección de Knowledge para anclar las respuestas del agente a la documentación oficial de tu negocio. Asigna descripciones claras a cada archivo cargado para maximizar la efectividad. El modelo priorizará la información de tus archivos y datastores sobre su conocimiento general, reduciendo drásticamente el riesgo de alucinaciones.
Advanced
La pestaña Advanced contiene configuraciones adicionales para un control más fino del comportamiento del agente.Modelo de respaldo (Fallback)
Selecciona un modelo alternativo que se utilizará automáticamente si el modelo principal falla o no está disponible.Mensaje de inicio
Configura un mensaje opcional que el agente envía automáticamente al usuario al iniciar la conversación, antes de que el usuario escriba.- Máximo 100 caracteres
- Soporta interpolación de variables con
{{$variable}}
Reanudación externa
Cuando está habilitada, permite pausar y reanudar conversaciones mediante la API. Esto es útil para flujos que requieren procesamiento asíncrono externo, como validaciones, pagos o aprobaciones. Endpoint:POST /v1/skills/resume
El payload de la petición debe incluir el ID de ejecución de la conversación que se desea reanudar.
Opciones de procesamiento
Opciones independientes para habilitar capacidades adicionales sobre los mensajes que el usuario envía durante la conversación:| Opción | Descripción |
|---|---|
| Soporte PDF | Permite al agente leer y procesar documentos PDF enviados por el usuario durante la conversación (solo texto, no imágenes dentro del PDF) |
| Leer URLs de imagen | Habilita al agente para procesar imágenes que el usuario envía como URL con texto descriptivo durante la conversación |
| Soporte Quick Reply Payload | Permite al agente interpretar el payload de respuestas rápidas de mensajes interactivos |
Estas opciones aplican a los archivos que el usuario final envía durante la conversación. Las imágenes y documentos que tú configuras como contexto del agente se gestionan desde la pestaña Knowledge.
Seguridad (Guardrails)
Configura el nivel de protección del agente contra usos indebidos, inyecciones de prompt y solicitudes fuera de alcance.Seleccionar nivel de seguridad
Elige el preset que mejor se ajuste a tu caso de uso:
| Nivel | Descripción |
|---|---|
| Bajo | Protección mínima, mayor flexibilidad en respuestas |
| Medio | Balance entre seguridad y flexibilidad (recomendado) |
| Alto | Protección estricta, restringe respuestas fuera del alcance |
| Crítico | Máxima protección, ideal para contextos regulados |
Expiración
Configura un tiempo límite para la sesión del agente. Si el usuario no responde dentro del tiempo configurado, la sesión expira automáticamente.DLP (Prevención de pérdida de datos)
Habilita la detección y enmascaramiento automático de información sensible en las conversaciones del agente.Seleccionar tipos de datos sensibles
Elige qué tipos de información deben ser detectados y enmascarados automáticamente:
| Tipo de dato | Valor de reemplazo por defecto |
|---|---|
| Número de tarjeta de crédito | [CreditCardNumber] |
| Track de tarjeta de crédito | [CreditCardTrackNumber] |
| Correo electrónico | [EmailAddress] |
| Número de cuenta financiera | [FinancialAccountNumber] |
| Dirección IP | [IpAddress] |
| Ubicación | [Location] |
| Coordenadas geográficas | [LocationCoordinates] |
| Número de teléfono | [PhoneNumber] |
| Fecha | [Date] |
| Nombre de persona | [PersonName] |
Guardar respuesta
Permite almacenar la última respuesta del agente en una variable para usarla en nodos posteriores del flujo.
La variable estará disponible como
{{$context.ai_agent_response}} en los nodos siguientes del flujo.
Ejemplo de configuración
Un flujo típico de configuración para un agente de atención al cliente:Configura General
Selecciona GPT-4.1 como modelo y escribe instrucciones claras definiendo el rol, tono y alcance del agente.
Agrega Tools
Habilita Transferir a asesor para escalar conversaciones complejas, Búsqueda de productos si el agente gestiona consultas de catálogo, y Enviar mensaje interactivo para mostrar opciones al usuario.
Configura Knowledge
Sube el documento de preguntas frecuentes en formato PDF, agrega imágenes de referencia si el modelo soporta visión, y conecta el datastore de productos si aplica.