Configurar un agente
Tras crear un agente, necesitas configurar su comportamiento para que se ajuste a las necesidades de tu negocio.
Acceder a la configuración
- Ve a Agents en la barra lateral
- Haz clic en el agente que quieres configurar
- Selecciona la pestaña Configuration
Tipo de agente y alcance de proyectos
Tipo de agente
Elige qué tipo de propiedades gestiona el agente:
| Tipo | Ideal para |
|---|---|
| Off-plan — Multiple projects | Promociones de obra nueva. Trabaja con todos tus proyectos, o puede limitarse a algunos concretos (consulta Alcance de proyectos más abajo). |
| Ready properties — Sale & Rent | Propiedades de segunda mano en venta o alquiler. |
| Automatic router | Un asistente general que detecta qué quiere cada lead y entrega la conversación al especialista adecuado. |
Alcance de proyectos
Cuando el tipo de agente es Off-plan — Multiple projects, aparece un selector de Project scope. Controla de qué proyectos puede hablar el agente:
| Selección | Resultado |
|---|---|
| Ningún proyecto seleccionado (opción por defecto) | El agente trabaja con todos tus proyectos — el catálogo completo. |
| Un proyecto | Una landing dedicada: el agente solo habla de ese único proyecto y se centra en él desde el primer mensaje. Ideal para un widget web o una línea de WhatsApp de un proyecto concreto. |
| Varios proyectos | Una landing de promoción: el agente se limita exactamente a esos proyectos — útil para promocionar juntas las fases de una misma promoción. |
Elegir un solo proyecto ofrece al lead la experiencia enfocada de un asistente de ventas de un único proyecto — nunca menciona tus otras promociones.
Si tu workspace no tiene proyectos, el selector de Project scope aparece desactivado con una breve indicación. Crea primero un proyecto y vuelve después para acotar el agente.
Colaboración con agencias
Cuando el tipo de agente es Off-plan — Multiple projects y la colaboración con agencias está activada para tu workspace, tienes disponible el interruptor Agency collaboration en los ajustes del agente. Al activarlo, el agente pregunta al inicio de cada conversación si está hablando con un comprador final o con una agencia inmobiliaria. Los compradores siguen la conversación de obra nueva habitual, sin cambios. A las agencias que quieren revender tus proyectos se las reconoce y se las invita a identificarse y dejar sus datos —y pueden ver el proyecto (fotos y material de venta) igual que un comprador— para que tu equipo pueda hacer seguimiento.
El interruptor está desactivado por defecto. Actívalo si trabajas con agencias externas o brókers que puedan contactar a través de tus canales para solicitar colaboración.
Si no ves este interruptor, la colaboración con agencias aún no está activada para tu workspace; contacta con soporte para habilitarla.
Opciones de configuración
Nivel de seguridad
El nivel de seguridad controla cuán cauto es tu agente al responder:
| Nivel | Descripción | Ideal para |
|---|---|---|
| Low | Respuestas más creativas y menos restrictivas | Conversaciones informales |
| Medium | Enfoque equilibrado (recomendado) | La mayoría de los casos |
| High | Respuestas conservadoras, centradas en hechos | Sectores sensibles |
Empieza con Medium y ajusta según el feedback de los clientes y la calidad de las conversaciones.
Turnos de conversación
Define el número máximo de intercambios antes de que el agente sugiera traspasar la conversación a un humano:
- Mínimo: 3 turnos
- Recomendado: 10-15 turnos
- Máximo: 50 turnos
Esto evita que las conversaciones se alarguen indefinidamente y asegura que las consultas complejas reciban atención humana.
Idioma de respuesta
Configura en qué idiomas puede responder tu agente:
- English (por defecto)
- Spanish
- Arabic
El agente puede detectar el idioma del cliente y responder en consecuencia si tienes varios idiomas activados.
Conexión con la base de conocimiento
Vincula tu agente a datasets concretos de tu base de conocimiento:
- Haz clic en Select Datasets
- Elige qué colecciones de documentos debe usar el agente
- Haz clic en Save
El agente solo consultará documentos de los datasets seleccionados al responder preguntas.
Ajustes avanzados
Workflow backend
PropPilot usa un sistema de workflow para procesar mensajes. Los usuarios avanzados pueden configurar:
| Ajuste | Descripción |
|---|---|
| Workflow URL | Endpoint personalizado para procesar mensajes |
| Timeout | Tiempo máximo de espera de respuesta (por defecto: 30s) |
La mayoría de los usuarios deberían dejar estos valores por defecto. Modifícalos solo si tienes una configuración personalizada de n8n o automatización.
Rate limiting
Cada agente trae rate limiting integrado para evitar abusos:
- Por defecto: 10 peticiones por segundo por tenant
- Evita un uso excesivo de la API
- Protege frente a ataques de spam
Probar tu agente
Antes de pasar a producción, prueba tu agente:
- Habilítalo en un canal de pruebas
- Envía mensajes de distintos tipos
- Verifica las respuestas en cuanto a precisión y tono
- Confirma que la información de la base de conocimiento es correcta
- Prueba casos límite y preguntas inusuales
Escenarios de prueba
Prueba estos escenarios:
- ✅ Consulta básica sobre una propiedad
- ✅ Preguntas sobre precios
- ✅ Solicitud de agendar una cita
- ✅ Pregunta fuera de tema (debería redirigir con elegancia)
- ✅ Múltiples preguntas en un solo mensaje
- ✅ Mensajes en distintos idiomas
Guardar cambios
Tras realizar cambios en la configuración:
- Revisa todos los ajustes
- Haz clic en Save Changes
- Espera el toast de confirmación
Los cambios se aplican de inmediato a las nuevas conversaciones. Las conversaciones en curso pueden necesitar reiniciarse para reflejar las novedades.
Buenas prácticas
Recomendado
- ✅ Mantén los documentos de la base de conocimiento al día
- ✅ Empieza con nivel de seguridad medio
- ✅ Define límites razonables de turnos de conversación
- ✅ Prueba a fondo antes de activar
- ✅ Monitoriza las conversaciones con regularidad
Evita
- ❌ Bajar demasiado el nivel de seguridad sin probar
- ❌ Conectar agentes a datasets irrelevantes
- ❌ Activar sin pruebas
- ❌ Ignorar los logs de conversación
¿Qué sigue?
Define cómo habla tu agente con los clientes — su personalidad, identidad y reglas: