Guía

Cómo funciona Neolo Chat, paso a paso

1. Conceptos clave

Agente

Un asistente de chat con su propia base de conocimiento, instrucciones, modelo, aspecto y límites. Cada cuenta puede tener varios agentes, según el plan.

Fuente de datos

De dónde aprende el agente: una URL, todo un dominio, un sitemap.xml o un texto pegado.

Fragmento (chunk)

Un trozo de texto de unos 1.800 caracteres en el que se divide el contenido para poder buscarlo con precisión.

Embedding

Una representación numérica del significado de un texto. Dos textos con significado parecido tienen embeddings cercanos, aunque no compartan palabras.

Búsqueda semántica (RAG)

Buscar en la base de conocimiento los fragmentos más cercanos en significado a la pregunta, y dárselos al modelo como contexto antes de que responda.

Instrucciones (prompt de sistema)

El texto que define cómo debe comportarse el agente: tono, alcance, qué hacer y qué no hacer.

Widget

El chat que ve el visitante en tu web: una burbuja flotante que abre un panel, o un iframe incrustado.

Visitante y conversación

Cada navegador recibe un código anónimo y tiene una conversación por agente, que se conserva si vuelve a la web.

2. Paso a paso: de cero a un agente funcionando

Todo se hace desde el panel en neolochat.com/dashboard. Lleva unos 10 minutos y no requiere programar.

1. Crea tu cuenta. Escribe tu email y abre el enlace que te enviamos (enlace mágico). No hay contraseñas. La cuenta gratuita incluye 1 agente y 50 mensajes al mes, sin tarjeta de crédito.
2. Crea un agente. Pulsa Nuevo agente y ponle nombre. Cada agente tiene las pestañas General, Model, Instructions, Data sources, Playground, Guardrails, Embed, Chat log y Analytics.
3. Entrénalo con tu sitio (pestaña Data sources). Elige una o varias fuentes:
   • URL: lee una sola página.
   • Rastreo de dominio: parte de una URL y sigue los enlaces internos del mismo dominio, hasta 40 páginas.
   • Sitemap: lee las URL de tu sitemap.xml, hasta 150 páginas.
   • Texto: pegas tú mismo la información (precios, políticas, preguntas frecuentes).
   Cada fuente pasa por los estados processing → indexed (o failed, con el motivo del error).
4. Escribe las instrucciones (pestaña Instructions). Define el tono, qué temas puede responder, qué enlaces debe usar, en qué idioma responder y cuándo derivar a una persona. Es la parte que más cambia la calidad de las respuestas.
5. Elige el modelo (pestaña Model). Corre sobre modelos de OpenAI. No necesitas cuenta ni clave propia: se usa la infraestructura de Neolo.
6. Personaliza el aspecto (pestaña General): color (selector o código HEX), tipografía, tamaño de letra, foto del agente, icono de la burbuja, mensaje de bienvenida, texto del campo de mensaje y pie de página. Hay vista previa en vivo.
   • Traducción automática: si el navegador del visitante está en otro idioma, el mensaje de bienvenida, el campo de mensaje y el pie se traducen solos.
   • Pedir el email: opcional, con tres modos: desactivado, opcional (el visitante puede omitirlo) u obligatorio antes de chatear. El email queda guardado en la conversación.
7. Pruébalo (pestaña Playground). Chatea con el agente usando sus instrucciones, modelo y conocimiento reales. Estas pruebas no se mezclan con las conversaciones de visitantes.
8. Configura los límites (pestaña Guardrails):
   • Máximo de mensajes por visitante en un período (por defecto 20 mensajes cada 60 segundos) y el texto que ve al superarlo.
   • Presupuesto mensual y diario en dólares: al alcanzarlo, el agente deja de responder.
   • Países bloqueados: a esos visitantes no se les muestra el widget.
   • Dominios permitidos: solo tus sitios podrán cargar el chat.
9. Publícalo (pestaña Embed). Copia esta línea y pégala antes de la etiqueta </body> de tu web:

   <script src="https://www.neolochat.com/widget.js"
           data-agent-id="TU-ID-DE-AGENTE" defer></script>

   Si prefieres un chat incrustado en la página en lugar de una burbuja flotante, usa el iframe:

   <iframe src="https://www.neolochat.com/iframe/TU-ID-DE-AGENTE"
           width="100%" style="height:100%;min-height:500px"
           frameborder="0"></iframe>

10. Revisa y mejora. En Chat log lees las conversaciones (con país y email si lo pediste) y puedes exportarlas a CSV. En Analytics ves visitas, conversaciones, mensajes, usuarios activos y votos positivos y negativos. Si tu web cambia, pulsa Reentrenar agente en Data sources.

3. Qué ocurre cuando un visitante escribe un mensaje

Desde que el visitante pulsa enviar hasta que ve la respuesta, el sistema hace esto:

1. El widget envía el mensaje al servidor de Neolo Chat junto con el código anónimo del visitante.
2. Comprueba el origen: si el agente tiene dominios permitidos, la petición debe venir de uno de ellos. Si el país del visitante está bloqueado, se rechaza.
3. Aplica el límite por visitante. Si lo superó, responde con el texto de límite configurado, sin llamar al modelo.
4. Comprueba presupuesto y cuota: el presupuesto diario y mensual del agente y los mensajes del mes del plan. Si se agotaron, responde que el asistente no está disponible por ahora.
5. Recupera la conversación del visitante (o la crea) y toma los últimos 10 mensajes como memoria de la charla.
6. Convierte la pregunta en un embedding y la compara con los de todos los fragmentos del agente.
7. Selecciona los 5 fragmentos más parecidos por similitud coseno. Además añade siempre el fragmento de enlaces de navegación del sitio, para que el agente conozca las URL reales.
8. Arma la petición al modelo: instrucciones + fragmentos recuperados como contexto + historial reciente + pregunta.
9. El modelo redacta la respuesta y el servidor la guarda junto con los tokens usados y el costo.
10. El widget muestra la respuesta, con enlaces clicables y botones 👍/👎 para que el visitante valore.

Si el contexto no contiene la respuesta, el comportamiento depende de tus instrucciones: puede decir que no está seguro, ofrecer contacto humano o responder con conocimiento general.

4. Cómo se entrena el agente, en detalle

1. Descarga: el servidor obtiene el contenido de cada fuente. Bloquea direcciones internas o privadas por seguridad.
2. Extracción de texto: se quita el código y la navegación, y queda el texto legible de cada página con su título.
3. División en fragmentos: el texto se parte en trozos de unos 1.800 caracteres con 200 de solape, para no cortar ideas por la mitad.
4. Embeddings: cada fragmento se convierte en un vector numérico con un modelo de embeddings de OpenAI.
5. Almacenamiento: fragmento y vector se guardan en la base de datos asociados al agente. Al reentrenar, se reemplazan los de esa fuente.
6. Enlaces de navegación: al rastrear un dominio se guarda también la lista de enlaces del sitio como un fragmento especial.

5. Límites y reglas

6. Privacidad y aislamiento

• El widget se dibuja dentro de un Shadow DOM: sus estilos no afectan a tu web ni los de tu web al chat.
• No usa cookies de terceros. El código anónimo del visitante se guarda en el almacenamiento local de tu propio dominio.
• Las claves de API de la plataforma nunca llegan al navegador del visitante.
• El email del visitante solo se guarda si activas esa opción y él lo escribe.

7. Preguntas frecuentes

¿De dónde saca el agente las respuestas?

De los fragmentos de tu contenido que más se parecen a la pregunta, más las instrucciones que escribiste. Si no está en tu contenido, depende de tus instrucciones.

¿Hay que reentrenar cada vez que cambia mi web?

Sí, pulsando Reentrenar agente. Mientras tanto, el agente sigue respondiendo con lo anterior.

¿Los visitantes necesitan registrarse?

No. Se identifican con un código anónimo y, si tú lo activas, pueden dejar su email.

¿Responde en el idioma del visitante?

Sí, si tus instrucciones lo indican. Además, el mensaje de bienvenida y el pie se traducen según el idioma de su navegador.

¿Puedo ver qué preguntan los visitantes?

Sí. El Chat log muestra cada conversación y se puede exportar a CSV.

8. Datos clave en formato de lista

• Producto: Neolo Chat, de Neolo (neolo.com). Sitio: neolochat.com.
• Qué es: widget de chat con IA entrenado con el contenido del propio sitio del cliente.
• Técnica: recuperación aumentada por búsqueda (RAG) con embeddings y similitud coseno.
• Fuentes de entrenamiento: URL, rastreo de dominio, sitemap.xml, texto.
• Instalación: una línea <script> antes de </body>, o un <iframe>.
• Cuenta: acceso con enlace mágico por email, sin contraseña.
• Control: instrucciones, límite por visitante, presupuesto diario y mensual, bloqueo por país, dominios permitidos.
• Seguimiento: Chat log, exportación CSV, Analytics, opción de pedir el email del visitante.
• Idiomas del panel: español e inglés. El agente puede responder en cualquier idioma.