> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getnexor.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Configuración del agente
Esta página es la referencia para configurar un agente: los ajustes que controlan quién es, cómo habla, qué canales usa, qué datos recopila y cómo trabaja hacia tu objetivo. Llegas a ella desde la pantalla de configuración del agente, donde cada sección de abajo aparece como su propio bloque. Define primero el **Objetivo** y luego adapta el prompt, el pipeline, las variables y las fuentes de conocimiento a ese resultado.
## Objetivo
El ajuste **Objetivo** define el resultado que el agente persigue en cada conversación. No es solo una etiqueta: cambia las herramientas integradas, las etapas sugeridas, la métrica principal y las secciones de configuración que aparecen.
El selector ofrece estos objetivos:
| Objetivo | `goal_type` | Cuándo usarlo | Configuración relacionada |
| ------------------------- | --------------------- | -------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| Agendar una reunión | `appointment` | Califica, consulta disponibilidad y reserva una reunión. | Muestra **Reunión** y habilita las herramientas de calendario. |
| Enviar link de pago | `payment_link` | Lleva la conversación hasta el cobro y comparte un link de pago. | Define en las reglas cuándo ofrecerlo y qué herramienta o integración entrega el link. |
| Calificación de leads | `qualification` | Recopila datos y decide si un lead cumple los criterios. | Define variables requeridas y reglas de transición del pipeline. |
| Dar información | `information` | Responde preguntas sobre productos, servicios o procesos. | Prioriza una base de conocimiento completa y actualizada. |
| Atención al cliente | `support` | Resuelve incidencias y escala los casos que requieren intervención humana. | Configura límites, escalación y fuentes de conocimiento. |
| Recolección de documentos | `document_collection` | Solicita y verifica los documentos requeridos para completar un trámite. | Muestra **Documentos**, donde se define cada documento necesario. |
| Generar cotización | `quote` | Arma y envía una cotización desde el catálogo asignado. | Muestra **Cotización**, donde eliges el catálogo de productos o servicios. |
| Personalizado | `custom` | Persigue un resultado que no encaja en los presets, como cobranza, reactivación, post-venta o encuestas. | Agrega un objetivo escrito por ti de hasta 600 caracteres. No habilita agendamiento. |
### Objetivo personalizado
Al seleccionar **Personalizado**, aparece el campo **¿Qué debe lograr este agente?**. Describe el resultado observable, no una secuencia de instrucciones. Por ejemplo: `Recuperar la cuota atrasada con una fecha concreta de pago acordada, sin dañar la relación con el cliente.`
Ese texto se guarda como `config.goal_statement` y se incorpora al comportamiento del agente con prioridad sobre el lenguaje genérico de los presets. Las reglas de negocio siguen definiendo el contexto, los límites y la forma de actuar.
Un agente `custom` no recibe las herramientas integradas de calendario. Si el resultado termina en una reunión agendada, usa `appointment` y expresa los criterios previos en las reglas y el pipeline.
Al cambiar el objetivo, Nexor reconcilia el target del goal en el pipeline y muestra las secciones de configuración correspondientes. Revisa las etapas, las variables requeridas y las herramientas antes de procesar más leads.
## Tu agente
La sección **Tu agente** define la identidad de tu agente: el nombre que usa, a quién representa y cómo suena. Estos ajustes determinan el tono del agente y cómo se presenta ante cada lead.
| Campo | Qué define |
| ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Nombre | El nombre visible del agente, usado cuando se presenta (p. ej. `Jarvis`). |
| Rol / Cargo | El cargo del agente (p. ej. `Asesor de ventas`). |
| Empresa | El negocio que representa el agente (p. ej. `Stark Industries`). |
| Idioma | El idioma que habla el agente, incluyendo la variante regional (p. ej. `Español (Chile)`). |
| Zona horaria | La zona horaria del agente (p. ej. `America/Santiago (UTC-3/-4)`), usada para agendar reuniones y respetar los horarios de contacto. |
| Voz | La voz usada en canales de voz y llamadas. Puedes filtrar las voces disponibles para el idioma, escucharlas y, si está habilitado para tu cuenta, clonar una voz. |
Define el Nombre, el Rol y la Empresa para que coincidan con cómo quieres que los leads perciban tu negocio. El agente usa los tres cuando se presenta al inicio de una conversación.
## Reglas de negocio
La sección **Reglas de negocio** es el prompt de tu agente: describe cómo opera tu negocio y qué debe hacer el agente en cada escenario. Aquí le enseñas a recopilar la información relevante, manejar objeciones, reconocer que el objetivo se logró y decidir cuándo derivar a una persona.
El prompt se divide en 7 secciones entre las que cambias desde un menú desplegable. Edita una a la vez:
| Sección | Qué cubre |
| ------------------------- | ----------------------------------------------------------------------------------- |
| Contexto del negocio | Qué hace tu negocio, a quién atiende y qué resultado debe conseguir el agente |
| Límites del agente | Lo que el agente nunca debe hacer ni decir |
| Manejo de objeciones | Cómo responder a objeciones y dudas comunes |
| Escalación | Cuándo y cómo derivar a una persona |
| Conversaciones de ejemplo | Diálogos de muestra que modelan el tono y el flujo correctos |
| Reglas adicionales | Cualquier instrucción extra que no encaje en las otras secciones |
| Reglas de descarte | Condiciones para dejar de perseguir un lead o cerrar el caso sin lograr el objetivo |
Cada sección tiene su propio propósito y estilo de redacción. Para una guía detallada y ejemplos sobre cómo completar cada una, consulta la [guía de buenas prácticas de prompts](/docs/es/guides/agents/prompt-best-practices).
**Presupuesto de tokens.** Un contador muestra cuánto de tu presupuesto de prompt (alrededor de 3.000 tokens) has usado entre las 7 secciones combinadas. Si lo superas, ajusta tu redacción en lugar de eliminar secciones completas.
**Historial.** Cada cambio guardado queda versionado. Abre **Historial** para revisar versiones anteriores y revertir a cualquiera de ellas.
**Entrena tu agente.** Después de editar tus reglas, haz clic en **Entrena tu agente** para aplicar los cambios. El agente usa el prompt actualizado solo después de que termina el entrenamiento.
No intentes completar cada sección a la perfección en el primer intento. Empieza con **Contexto del negocio**, entrena y prueba en el playground, y luego refina las demás secciones según cómo responda realmente el agente.
## Canales
La sección **Canales** define cómo tu agente alcanza y responde a los leads. Cada canal muestra un estado de conexión de **Activo** o **Conectar**. Desde **Administrar** también puedes ajustar instrucciones y estilo por canal; los canales compatibles permiten elegir el modelo y WhatsApp/email administran sus plantillas desde aquí.
El menú desplegable **Canal de primer contacto** define qué canal usa tu agente para el primer mensaje saliente (por ejemplo, WhatsApp).
| Canal | Notas |
| --------- | --------------------------------------------------------------------------------------------------------------------- |
| WhatsApp | Envía y recibe mensajes desde tu número conectado. Consulta [Conectar WhatsApp](/docs/es/guides/connecting-whatsapp). |
| Instagram | Una cuenta por agente. Conecta a través de Meta. |
| Email | Responde desde tu dirección de remitente (por ejemplo, `sales@starkindustries.com`). |
| Teléfono | Un número de teléfono usado para voz. |
| SMS | Un número usado para mensajes de texto. |
| Web Chat | Un widget entrante incrustado en tu sitio web; no aparece como canal de primer contacto. |
Configura el **Canal de primer contacto** con el canal en el que tus leads tengan más probabilidades de responder. WhatsApp es la opción más común.
## Horarios de contacto
Define las ventanas en las que tu agente puede iniciar o reactivar contacto saliente. Las respuestas entrantes se atienden aunque estén fuera de esas ventanas.
En **Fuera de estos horarios**, **Bloquear llamadas** evita llamadas pero permite recontactar por WhatsApp, email o SMS. **Bloquear todos los canales** pospone todo recontacto saliente hasta la siguiente ventana.
Elige qué días puede contactar el agente y luego define el rango horario para esos días.
| Campo | Descripción |
| -------------- | ---------------------------------------------------------------------------------------------------------- |
| Días | Cuándo puede iniciar contacto el agente: **Lun-Vie**, **Lun-Sáb**, **Todos los días** o **Personalizado**. |
| Hora de inicio | Lo más temprano que el agente contactará (p. ej. 8:00 AM). |
| Hora de fin | Lo más tarde que el agente contactará (p. ej. 7:30 PM). |
Puedes agregar varios rangos horarios dentro de un día, por ejemplo para pausar durante un descanso al mediodía.
Con **Personalizado** puedes definir rangos distintos por día. Todos los horarios se interpretan en la zona horaria configurada para el agente.
## Intentos de reactivación
La sección **Intentos de reactivación** controla con qué insistencia tu agente da seguimiento a un lead que deja de responder, hasta lograr el resultado del goal o agotar los intentos.
| Ajuste | Ejemplo | Significado |
| ---------------- | ------- | ----------------------------------------------------------------------------------------------- |
| Intentos totales | 5 | Cantidad máxima de veces que el agente vuelve a contactar a un lead antes de darse por vencido. |
| Primera espera | 3h | Horas a esperar después de que el lead se queda en silencio antes del primer recontacto. |
| Entre intentos | 24h | Horas mínimas entre cada recontacto posterior. |
Con los valores anteriores, el agente vuelve a contactar al lead hasta 5 veces. El primer seguimiento sale 3 horas después de que el lead deja de responder, y cada intento posterior se espacia al menos 24 horas. Si el lead sigue sin responder tras los 5 intentos, queda marcado como **Perdido**.
En **Avanzado** puedes activar reglas solo para etapas intermedias elegibles, escribir instrucciones de IA por etapa y sobrescribir la primera espera, el intervalo y el máximo de intentos. Las etapas iniciales, terminales, pausadas o que ya representan el objetivo no se ofrecen para reactivación.
## Variables
La sección **Variables** define los campos que tu agente recopila de cada lead durante la conversación. Mientras el agente habla, extrae estos valores de lo que dice el lead y los almacena en el registro del lead.
Cada variable tiene estas propiedades:
| Propiedad | Descripción |
| ------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| **Nombre** | Lo que estás capturando, por ejemplo "Principal punto de dolor". |
| **Tipo** | `Texto`, `Número`, `Fecha`, `Selección` o `Sí/No`. Las variables `Selección` incluyen una lista cerrada de opciones. |
| **Requerida** | Si el agente debe capturar el valor. Las variables opcionales se completan solo cuando el lead las proporciona. |
| **Instrucciones de extracción** | Señales y formatos que ayudan a la IA a reconocer el valor correctamente. |
| **Prellenar desde metadata** | Mapea una clave de metadata entrante. Si llega, Nexor completa el valor y la IA no vuelve a preguntarlo. |
A continuación, variables comunes usadas para calificar a un lead:
| Variable | Tipo |
| ----------------------------- | --------- |
| Principal punto de dolor | Texto |
| Número de usuarios | Número |
| Tipo de propiedad | Texto |
| Próximo contacto comprometido | Fecha |
| Zona de trabajo | Texto |
| Nivel de interés | Selección |
| Objeciones planteadas | Texto |
| Plataforma actual | Texto |
| Región | Texto |
| Tiempo en el rubro | Texto |
Las variables impulsan la calificación y las transiciones del pipeline: una etapa puede requerir que ciertas variables estén completas antes de que un lead avance, para que el agente sepa qué le falta preguntar.
Usa **+ Agregar** para crear tus propias variables. Marca una variable como requerida cuando una etapa posterior dependa de ella, y usa `Número` para valores que quieras filtrar u ordenar más adelante.
## Pipeline
El pipeline define las etapas por las que pasa cada lead, desde el primer contacto hasta un resultado cerrado. A medida que tu agente habla con un lead, lo mueve entre etapas según las instrucciones de transición que definas.
### Etapas iniciales según el goal
Todos los pipelines comienzan con etapas del sistema para **Nuevo**, **Contactado** y **En conversación**. El resultado ganador cambia con el goal:
| Goal | Etapa que representa el objetivo |
| --------------------- | --------------------------------------------------------------------- |
| `appointment` | Reunión agendada |
| `payment_link` | Link de pago enviado |
| `qualification` | Calificado; exige las variables requeridas |
| `information` | Información entregada |
| `support` | Resuelto |
| `document_collection` | Documentos aprobados, después de una etapa pausada de revisión humana |
| `quote` | Cotización enviada |
| `custom` | Objetivo logrado |
También puedes agregar **etapas personalizadas** para que coincidan con tu proceso de ventas, como una etapa "Tomó demo" para leads que pasaron por una demo del producto.
### Etapas terminales
Las etapas terminales marcan el final del pipeline:
| Etapa | Tipo | Significado |
| ------- | ----------------- | -------------------------------------------------------- |
| Ganado | Resultado exitoso | Objetivo logrado; su etiqueta concreta depende del goal. |
| Perdido | Perdido | El lead declinó o dejó de responder. |
### Configurar una etapa
Cada etapa tiene sus propios ajustes. Selecciona una etapa para editar lo siguiente:
El nombre de la etapa que se muestra en las vistas del agente y del pipeline.
Un color usado para identificar la etapa de un vistazo.
Una breve explicación de lo que representa la etapa.
Define si la etapa es normal, se activa por primer contacto o primera respuesta, funciona como compuerta de calificación o representa una reunión agendada. Las etapas terminales se clasifican como ganadas, perdidas o pausadas.
Reglas en lenguaje natural que describen cuándo un lead debe pasar a esta etapa. Referencia las variables recopiladas con `@`, por ejemplo `@budget` o `@company_size`.
Opcionalmente mueve a un lead más adelante cuando se queda en silencio. Define un tiempo de espera en horas y luego elige la etapa a la que pasa el lead una vez que transcurre ese tiempo.
Una barrera estricta que impide que un lead entre a la etapa hasta que las variables requeridas estén completas. Úsala para asegurarte de que se capture información clave antes de que un lead avance.
Usa las instrucciones de transición y las variables requeridas en conjunto: las instrucciones le indican al agente cuándo avanzar a un lead, mientras que las variables requeridas garantizan que los datos detrás de esa decisión estén completos.
## Cotización
Esta sección solo aparece cuando el objetivo es **Generar cotización** (`quote`).
Selecciona el catálogo desde el que el agente buscará productos o servicios y construirá la cotización. El contenido del catálogo se administra en la página global **Catálogos**; esta sección solo lo asigna al agente. Antes de activar, prueba que los ítems tengan nombres, precios y atributos suficientes para distinguirlos.
## Documentos
Esta sección solo aparece cuando el objetivo es **Recolección de documentos** (`document_collection`).
Agrega un requisito por documento. Cada uno define un nombre, una clave única en `snake_case`, una descripción para el equipo, instrucciones para que la IA lo solicite, si es obligatorio y los formatos aceptados. Puedes aceptar cualquier archivo o restringirlo a JPEG, PNG, PDF, HEIC, WebP, DOC y DOCX.
Cuando llegan todos los documentos obligatorios, el lead pasa a **Documentos recopilados** y el agente se pausa para revisión humana. La aprobación humana completa el objetivo en **Documentos aprobados**.
## Agendamiento de reuniones
Esta sección solo aparece cuando el objetivo es **Agendar una reunión** (`appointment`).
La sección **Reunión** controla cómo el agente agenda reuniones una vez que un lead está calificado, cómo se ve el evento del calendario y quién asiste.
### Detalles del evento
Define el título y la duración del evento que el agente crea cuando agenda una reunión.
| Campo | Descripción |
| ----------------- | -------------------------------------------------------------------------------------------------- |
| Título del evento | El nombre del evento del calendario, p. ej. `Meet Stark Industries`. Admite variables (ver abajo). |
| Duración | Duración de la reunión en minutos, p. ej. `30`. |
Puedes usar estas variables en el título del evento:
| Variable | Se resuelve a |
| ----------------- | ---------------------------------------- |
| `{{leadName}}` | El nombre del lead |
| `{{hostName}}` | El miembro del equipo asignado |
| `{{clientName}}` | El nombre de tu empresa |
| `{{meetingType}}` | El tipo de reunión que se está agendando |
### Reglas de agendamiento
**Permitir sobrecupo** permite que varias reuniones caigan en el mismo horario. Déjalo desactivado para limitar cada horario a una sola reserva.
### Asignación de miembros del equipo
Elige cómo el agente selecciona quién hospeda cada reunión.
* **Criterios de selección** — una regla de texto libre para la asignación rotativa (round-robin). Describe cómo deben distribuirse las reuniones, por ejemplo: distribuir las reuniones de forma equitativa entre el equipo, asignar a quien tenga menos en ese momento, o respetar siempre la disponibilidad de cada miembro.
* **Miembros del equipo** — la lista de personas que asisten a las reuniones, cada una con su propia disponibilidad. El agente solo asigna horarios que caen dentro de la disponibilidad de un miembro.
* **Usa tu propia herramienta de asignación** — omite la lógica integrada y deja que una herramienta externa decida quién queda asignado.
### Invitar siempre
Agrega personas que deban ser invitadas a cada reunión, sin importar quién quede asignado como anfitrión. Útil para gerentes o tomadores de notas que se suman a cada llamada.
### Email de confirmación
Activa el **email de confirmación de reserva** para enviar automáticamente al lead una confirmación después de que se agenda una reunión.
## Recordatorios y alertas
Configura los mensajes que tu agente envía alrededor de cada reunión y las acciones automáticas que toma cuando ocurren eventos de reunión.
### Recordatorios
Los recordatorios son mensajes programados que se envían antes o después de una reunión. Agrega tantos como necesites, cada uno con su propio tiempo, canal y plantilla.
| Campo | Descripción |
| --------- | ------------------------------------------------------------------------------------------------------------------ |
| Tiempo | Cuándo se envía el recordatorio respecto a la reunión, por ejemplo `5 min antes`, `1 hora antes` o `de inmediato`. |
| Canal | Cómo se entrega el recordatorio: WhatsApp o llamada de voz. |
| Plantilla | La plantilla de mensaje aprobada a usar, por ejemplo `utility_recordatorio_reunion_v1`. |
Agrega varios recordatorios para construir una secuencia, como uno una hora antes y otro cinco minutos antes de la reunión.
### Alertas y seguimientos automáticos
Las alertas y los seguimientos se activan por eventos de reunión. Habilita cada uno de forma independiente.
| Evento | Acción |
| ----------------------------------- | -------------------------------------------------------------------- |
| Nueva reunión | Notifica al anfitrión que se agendó una reunión. |
| Cancelación (aviso al anfitrión) | Notifica al anfitrión por email cuando se cancela una reunión. |
| No asistencia | Reactiva automáticamente a los leads que no asistieron a su reunión. |
| Cancelación (reactivación del lead) | Reactiva automáticamente a los leads que cancelaron su reunión. |
Los recordatorios usan plantillas de mensaje aprobadas. Asegúrate de que la plantilla que selecciones esté aprobada en el canal antes de depender de ella.
## Base de conocimiento
La base de conocimiento es todo aquello en lo que tu agente puede apoyarse para responder preguntas durante una conversación. Conecta las fuentes que describen tu negocio, productos y políticas para que el agente responda con información precisa y actualizada.
| Fuente | Qué es |
| ---------- | ----------------------------------------------------------------------------------------------------------------- |
| Archivos | Documentos que subes (PDFs, planillas y otros archivos) para que el agente los consulte. |
| Sitios web | Páginas de un sitio web. Usa una sola página o rastrea todas las páginas de un sitio, como `starkindustries.com`. |
| Catálogos | Catálogos estructurados de productos o propiedades de los que el agente puede extraer listados y detalles. |
Usa **Administrar** para agregar, editar o eliminar fuentes en cada categoría.
El agente solo usa las fuentes que habilites. Cualquier cosa que dejes deshabilitada se ignora, incluso si sigue listada aquí.
Para los pasos de configuración y las buenas prácticas, consulta la [guía de la base de conocimiento](/docs/es/guides/agents/knowledge-base).
## Avanzado del agente
El bloque **Avanzado** dentro de la configuración de un agente controla capacidades que pertenecen solo a ese agente. Es distinto del hub global **Avanzado** de la barra lateral, donde se administran Webhooks, Background Jobs, Pre-procesadores y funciones de código. Consulta la [guía del hub Avanzado](/docs/es/guides/advanced/overview) para esas automatizaciones globales.
### Consolidar reportes bajo
Usa **Consolidar reportes bajo** para agrupar los números de este agente con otros agentes en el dashboard. Elige un grupo (el agente maestro), y las métricas de este agente se reportan junto con el resto de ese grupo en lugar de por separado.
Agrupa varios agentes bajo un agente maestro cuando quieras una única vista combinada, por ejemplo una cifra por equipo o por región en lugar de por agente individual.
### Herramientas MCP
Las herramientas MCP son funciones HTTP que la IA puede invocar durante una conversación, por ejemplo para consultar un CRM, comprobar inventario, calcular un precio o tomar una acción mientras habla con un lead. Puedes asignarlas desde el catálogo global o crear una herramienta exclusiva para el agente.
Los agentes nuevos reciben un conjunto de herramientas según el goal. Todos incluyen funciones esenciales para guardar variables, actualizar metadata y mover el lead por el pipeline. `appointment` agrega consulta de disponibilidad, reserva, cancelación, reagendamiento e invitados; `document_collection` agrega solicitud y confirmación de documentos; y los goals que usan catálogos pueden buscar y leer productos o servicios. Las herramientas personalizadas se suman a ese conjunto.
| Ajuste | Qué hace |
| ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Hooks previos al agente | Herramientas que se ejecutan en el momento en que un lead entra al agente, antes de que se envíe cualquier mensaje. Úsalas para preparar o enriquecer la conversación de antemano. |
| Restricción de herramientas por etapa | Limita una herramienta a etapas específicas. Selecciona las etapas donde se permite la herramienta; sin ninguna etapa seleccionada, la herramienta está disponible en todas las etapas. |
| Acciones por etapa | Ejecuta una herramienta automáticamente cuando un lead entra a una etapa, sin depender de que el agente decida llamarla durante la conversación. |
Un hook previo y una restricción por etapa son mutuamente excluyentes: el hook corre antes de que exista una etapa conversacional que pueda aplicar el gate. Las acciones por etapa también son automáticas y deben recibir de antemano cualquier argumento que normalmente redactaría el agente.