Manual de Instalación & Uso

Xabia Agent Core

1. Estructura del menú en WordPress

Tras activar Xabia Agent Core, en el escritorio aparece el menú Xabia Agent con icono de “superhero”.

Entrada del menú Qué muestra
Xabia Agent Pantalla principal: listado de agentes, escaparate de addons, y bloque global Conexión a la IA (licencia + modo Cloud / infra propia).
Addons Listado tipo tarjetas: addons conocidos por el Core, estado (activo / instalado / disponible) y enlaces a Plugins o información.
Cartera / Wallet Saldo de tokens, consumo a 30 días, packs de recarga y renovación cuando aplica.

Opciones según lo que tenga instalado su sitio

  • Si tiene Xabia Central activo, puede ver Federación (Xabia Central) como submenú para enlazar varios sitios o nodos cuando use esa función.
  • Si tiene el addon Federación Nexus, puede aparecer Federación o Federación Nexus (consulte el manual de ese addon si lo usa).

Para cambiar casi todos los ajustes hace falta estar entrado como administrador de WordPress (o con un perfil equivalente que permita gestionar plugins y opciones del sitio).


2. Pantalla principal: listado de agentes

Cuando abre Xabia Agent sin estar editando un agente concreto, verá:

2.1 Título y acciones

  • Nuevo agente: crea una ficha nueva y abre el editor. Al guardar por primera vez, el sistema le asigna un identificador estable (derivado del nombre); ese código es el que pegará más adelante en la página web con el shortcode (ver más abajo).

2.2 Tarjetas de agentes existentes

Cada tarjeta muestra:

  • Nombre con el que verá el agente en el panel.
  • ID: un código como ID: mi-asistente que debe coincidir con lo que pone en el shortcode: .
  • Editar: abre toda la configuración del agente.
  • Borrar: elimina el agente y toda la memoria de conocimiento que hubiera generado para él (lo aprendido al sincronizar y entrenar). No se puede deshacer con un solo clic.

Si borra un agente: pierde su configuración, los mapeos de datos y la “memoria” asociada. Si subió un archivo CSV para ese agente, el archivo puede seguir en el servidor; si ya no lo necesita, puede borrarlo desde Medios o por FTP según su caso.

2.3 Bloque «Addons disponibles»

Tarjetas con los complementos (addons) que Xabia conoce: nombre, breve descripción y enlace para instalar o gestionar. Activar o desactivar un plugin sigue haciéndose en Plugins de WordPress, como con cualquier otro plugin.

Importante: un addon puede estar instalado pero inactivo, o activo pero requerir otra configuración (licencia addon, tablas, etc.).


3. Conexión a la IA (tarjeta global)

Aquí decide cómo su web se conecta a la inteligencia artificial y al servicio xabia.ai cuando use el modo recomendado.

Use el botón Guardar configuración de esta misma página (no confundir con Guardar agente dentro de un agente).

3.1 Modo de conexión

Tiene dos opciones:

Opción Nombre en pantalla Qué implica para usted
Cloud de Xabia Xabia Cloud (recomendado) Su sitio usa una licencia Xabia y el saldo de tokens de su cuenta. Las conversaciones pasan por la infraestructura de Xabia; no necesita pegar aquí ni en cada agente sus claves de OpenAI o Google: con licencia y saldo suficiente, ya está cubierto. En el agente puede que no vea el selector entre OpenAI y Google; el sistema fija por detrás lo adecuado para Cloud.
Cuenta propia Infraestructura propia Las facturas van directamente contra su cuenta de OpenAI o Google Cloud (Vertex). Suele aparecer la sección de Claves API y Google Cloud para configurar rutas de credenciales. La licencia Xabia puede seguir siendo necesaria para otras funciones según su plan; pero el modelo de gasto aquí es el suyo directamente con proveedores externos.

Tras cambiar de modo, revise cada agente: en Cloud no debe preocuparse por el “motor”; en infraestructura propia debe comprobar en cada uno qué proveedor usa y si las rutas/claves están bien.

3.2 Licencia y saldo

Bloque informativo (tokens y caducidad)

  • Tokens restantes: lo que figura después de que el sistema compruebe su licencia. Si lleva tiempo sin sincronizar, puede aparecer una raya hasta que pulse Actualizar saldo.
  • Caducidad: fecha hasta la que su licencia está activa según lo que recibe el sistema.
  • Comprobado: cuándo se hizo la última verificación contra el servicio central.

El botón Actualizar saldo vuelve a preguntar a Xabia y refresca estos datos. Si aún no ha guardado una licencia, le avisará antes.

Sin licencia válida o sin saldo, el chat puede no responder o mostrar un mensaje sobre saldo insuficiente o licencia según configuración del servicio.

Campo «Licencia Xabia de este sitio»

  • Es un campo tipo contraseña; puede usar el ícono de ojo para ver solo lo que está escribiendo ahora.
  • Si ya tiene una licencia guardada y deja este campo vacío al guardar, no borra la antigua. Para quitar definitivamente la licencia use la casilla Eliminar licencia guardada (véase más abajo).
  • Solo pegue aquí cuando quiera cambiar la licencia por una nueva cadena que le hayan enviado.

Licencia guardada: en pantalla solo verá asteriscos y quizá los últimos caracteres (por seguridad).

Aviso amarillo: si el sistema detecta que lo guardado parece un ID de panel (por ejemplo empieza por lic_…) y no la cadena larga de activación que suele empezar por xabia_, le avisará: el servicio probablemente no la aceptará. Lo habitual es eliminar la licencia guardada, guardar, y volver a pegar la clave completa del correo o de su compra.

Botón «Ver licencia guardada en WordPress»

Muestra lo que realmente está guardado en su WordPress (sin espacios raros ni cortes). Solo lo deben usar administradores de confianza: quien vea la licencia podría usarla en otro sitio si la copiara.

Cómo se protege la conexión

Cuando la licencia es correcta, el plugin la usa para identificar de forma segura su sitio ante xabia.ai al enviar las peticiones. No hace falta que entienda el detalle técnico: si cambia de licencia, la nueva empieza a aplicarse al guardar. Si por error pega los asteriscos de la pantalla en lugar de la clave real, el sistema intenta no sustituir la buena licencia guardada.

Casilla «Eliminar licencia guardada de este sitio»

  • Al marcarla y pulsar Guardar configuración, se borra la licencia de este sitio.
  • Efecto: el chat dejará de usar el servicio Xabia asociado a esa clave hasta que pegue otra licencia válida.
  • No borra por sí sola sus claves OpenAI o Google de la sección avanzada; solo la licencia Xabia.

3.3 Claves API y Google Cloud (cuenta propia)

Solo aparece si eligió Infraestructura propia. La sección viene plegada en desplegable para no abrumar: ábrala cuando vaya a configurar credenciales.

OpenAI — clave (global aquí)

  • Es la clave secreta de su cuenta OpenAI.
  • Sirve cuando el agente está configurado para usar OpenAI y cuando no lleva una clave distinta sólo para él.
  • Trátela como una contraseña de banca: si alguien la copia, puede generar cargos en su nombre. Cambiela desde el panel OpenAI si cree que ha filtrado.

Google Cloud (Vertex AI) — ruta al archivo JSON de la cuenta de servicio

  • Debe ser la ruta completa en el servidor al archivo JSON que le da Google para la cuenta de servicio con permisos de Vertex/Gemini.
  • Si en un agente concreto no rellena nada, se usará esta ruta global.

Errores frecuentes: ruta mal escrita, el servidor no puede leer el archivo, la cuenta no tiene permisos de Vertex, o el proyecto/región no coinciden con lo que usa en Google.

Google Cloud — clave de Maps

  • Para mapas en el chat o piezas visuales que integren Google Maps, si su proyecto lo usa.

Federación Nexus — «Activar solo modo Puente»

Solo verá esto si tiene instalado el addon Federación Nexus.

Importante: si está en Xabia Cloud, marcar o desmarcar esta casilla en esta pantalla puede no guardarse como espera; el valor real sigue el que ya tenía el sitio. Para cambiar el modo Puente con seguridad, use Infraestructura propia o la pantalla que indique el manual de Nexus.

Qué es el modo Puente (en pocas palabras): su WordPress actúa como servidor de datos para otros sitios de la federación. No es el modo normal para un hotel o tienda que solo quiere un chat en la página. Si lo activa por error en un sitio público, es posible que el shortcode habitual del chat no se muestre como antes; consulte con quien le haya pedido la federación.

Consejo: si no sabe para qué es la federación, no marque solo modo Puente.


4. Editor de un agente: vista general

Al pulsar Editar o Nuevo agente, el formulario usa pestañas. Las predeterminadas del Core son:

  1. General — datos básicos, motor de IA solo si usa infraestructura propia, fuentes (CSV/SQL…) y cómo etiquetar columnas para el bot.
  2. Personalidad — colores, lectura por voz, cuánto contexto usar, límites de respuesta y el “guión” general del asistente.
  3. Registro de conversaciones — historial reciente guardado si lo tiene habilitado.

Los addons pueden añadir pestañas extra dentro del mismo agente (por ejemplo Avirato).

Pulse Guardar agente al final para aplicar cambios; hasta entonces solo hay borradores en pantalla.


5. Pestaña «General»

5.1 Nombre del agente

  • Nombre visible en el panel para usted y su equipo.
  • Si crea el agente hoy por primera vez, el identificador del shortcode se genera a partir del nombre. Si solo cambia el nombre de un agente antiguo, el identificador del shortcode suele mantenerse (no cambia la URL pegada antigua).

5.2 Shortcode

Tras guardar un agente existente se muestra:


Al pegarlo en una página de WordPress publica el chat de ese agente. Algunos complementos admiten opciones extra en el mismo shortcode (idioma, modo tótem, nombre visible del avatar, etc.): revíselas en el manual de cada addon que use.

5.3 Bloque Xabia Cloud (cuando el UI está en modo Cloud)

Mensaje informativo: el agente usa el servicio de Xabia; la licencia y el saldo los gestiona en la pantalla principal del plugin, no aquí dentro del agente.

En esta vista no verá opciones duplicadas de motor o de Google Cloud: el sistema usa lo que ya tiene guardado para ese agente y lo coherente con Xabia Cloud.

5.4 Motor de inteligencia (solo aparece en infraestructura propia)

Motor de Inteligencia:

Opción Qué significa en la práctica
OpenAI Usa los servicios de OpenAI para el chat y, si corresponde, para generar la “memoria” vectorial del conocimiento
Google Cloud (Vertex) Usa Gemini/Vertex según su configuración; necesita la ruta al JSON correcta en servidor

Archivo JSON de Google por agente (opcional): si está vacío, se usa la ruta global de ajustes generales.

Clave OpenAI solo para este agente (opcional):

  • Si rellena y guarda, este agente usa esa clave y no la global.
  • Si deja vacío al editar y el agente ya tenía clave, suele conservarse la anterior.
  • Según su modo global y licencia, si no hay clave local donde haga falta, el sistema puede derivar por el proxy Xabia; depende del caso.

Consejo práctico: si un agente usa su cuenta OpenAI directa y otro no, pueden aparecer cargos separados por proveedor — anote cuál usa cuál si lo administra más de uno.


6. Fuente de información (de dónde aprende el asistente)

Aquí decide qué datos debe “leer” el sistema antes de crear la memoria que usa el chat (preguntas frecuentes, catálogo, contenidos estructurados, etc.). Es aparte del contexto automático que algunos addons añaden en cada mensaje (por ejemplo disponibilidad de reservas).

El plugin le recordará en pantalla que los addons activos pueden aportar información adicional sin pasar solo por aquí; lo que elija en esta lista es la base de conocimiento que usted controla con CSV, SQL o conectores.

6.1 Archivos CSV

  • Útiles para catálogos en tabla: productos, puntos de interés, listados exportados desde Excel como CSV.
  • Subir CSV guarda el archivo en el sitio y lo enlaza a este agente.
  • Eliminar CSV quita el archivo enlazado y la referencia.
  • Explorar / escanear CSV detecta columnas y prepara el mapeo (qué significa cada columna para el bot).
  • Por lo general distingue si las columnas van separadas por coma o por punto y coma.

Recuerde: hasta que pulse Sincronizar datos —y, si usa búsqueda por similitud semántica, Entrenar— el asistente puede no “ver” bien esas filas en las respuestas.

6.2 Base de datos de WordPress (SQL local)

Una consulta sobre la base de datos del propio WordPress. Use el comodín {prefix} cuando la plantilla lo indique: el sistema lo sustituye por el prefijo real de sus tablas (suele ser wp_ u otro que haya configurado su alojamiento).

Consejo: las consultas muy amplias pueden ralentizar el sitio o sacar datos de más. Pruebe primero en copia de seguridad/desarrollo o con límites razonables.

6.3 Base de datos externa (SQL remota)

Rellene Host, Nombre de la base, Usuario, Contraseña y la consulta cuando el catálogo viva fuera de WordPress.

Seguridad: las credenciales quedan guardadas con el agente; lo ideal es que el servidor remoto solo acepte conexiones desde la IP de su web.

6.4 Conectores de addons

Solo está disponible con un addon compatible instalado y activo. Si aparece como no disponible, instale primero ese plugin desde Plugins.

Tras seleccionarlo, use Conectar y Mapear para revisar las columnas que expone antes de usarlas.

6.5 Varios orígenes a la vez (“multi‑fuente”)

Puede combinar hasta dos fuentes (por ejemplo SQL remoto + CSV).

  • Cada parte lleva sus propios datos y su propio mapeo de columnas.
  • En remotos suele poder ayudar un prefijo automático con el mismo criterio que {prefix}.

Consejo: más fuentes ofrecen flexibilidad, pero también más sitios donde equivocarse; revise cada bloque con tranquilidad.


7. Herramientas dentro de la pestaña Datos

7.1 Probar la consulta SQL (una fila)

Hace una lectura de prueba (solo la primera fila) de su consulta para mostrarle qué columnas detecta y ayudarle en el mapeo. Evite usarlo en picos de visitas en sitios en producción sin control: es una herramienta de comprobación.

7.2 Asistente de contenidos WordPress (“Consola de curación”)

Un asistente paso a paso que:

  1. Lista los tipos de contenido públicos (páginas, entradas, tipos personalizados).
  2. Sugiere qué campos son interesantes para el bot (título, texto, metadatos donde existan, taxonomías…).
  3. Puede transferir una consulta SQL y un mapeo razonable al formulario del agente.

Qué es “Ente”: marque el campo que identifica de forma única cada elemento (útil en experiencias con QR o cuando el visitante “elige” una ficha concreta).

También tiene un atajo para añadir metadatos de un tipo de contenido sin pasar por todo el asistente.

7.3 Mapeo de columnas (atributos repetibles)

Por cada fila elija:

  • Columna o campo del CSV/SQL.
  • Etiqueta amigable (“Precio”, “Teléfono de reservas”…).
  • Rol visual en el chat cuando corresponda mostrar tarjeta enriquecida: título, texto, fecha, imagen, teléfono, web, email, mapa, etc.
  • IDENTIDAD (ENTE) si ese campo distingue registros únicos en su proyecto.

Algunas columnas típicas del núcleo de WordPress muestran un icono de “cerebro” para destacar que son buenos candidatos como texto principal del conocimiento — no es obligatorio tocarlo si no lo necesita.


8. Modo «tótem» (pantallas públicas tipo kiosko)

Algunas instalaciones permiten un modo pensado para tablet o pantalla en recepción:

  • Activado o no según el proyecto.
  • Minutos de inactividad: tras ese tiempo sin usar el chat puede volver al inicio o avisar según el diseño de su web.

Si usa el shortcode puede forzar minutos con el parámetro totem; consulte la guía rápida que le haya dado su proveedor si no ve casillas en el panel (a veces viene de un addon o del propio tema).

Resumen: modo tótem = experiencia de “quiosco”; no tiene que usarlo si solo quiere chat clásico en la web.


9. Barra lateral (solo agente ya guardado, no «new»)

9.1 Memoria del agente (cifras de la barra lateral)

  • Registros sincronizados: líneas incorporadas tras la última Sincronizar datos.
  • Listos para búsqueda inteligente: cuántos trozos ya llevan preparada la parte “semántica” si usa esa función.
  • Tokens hoy: cuántos ha gastado ese agente hoy comparado con su tope diario (véase más abajo en Personalidad).

9.2 Botón «1. Sincronizar datos»

Vuelve a leer su CSV/SQL/multi‑fuente o conector según lo que configuró en General. Hágalo después de cambiar archivos fuente o la consulta.

9.3 Botón «2. Entrenar» (cuando aplique vectorización)

Prepara los fragmentos de texto para la búsqueda por similitud. Si algo falla (permiso de Google, falta de saldo Cloud, etc.) el sistema mostrará un mensaje claro para corregirlo.

9.4 «Borrar memoria vectorial»

Limpia la memoria matemática asociada a este agente (no borra necesariamente el CSV en disco). Úselo cuando quiera empezar de cero después de mover muchos datos.

9.5 Zona de pruebas («Playground»)

Un chat de laboratorio igual que usará el visitante pero sin publicar página todavía. Ideal para tunear antes de abrir al público.


10. Pestaña «Personalidad»

Aquí da “cara y voz” al asistente. Algunos addons pueden añadir más opciones al final de esta pantalla.

10.1 Nombre del asistente (avatar)

El nombre corto que verá el visitante junto a cada mensaje (por defecto “Xabia”). En el shortcode suele poder personalizarlo también si su versión lo permite.

10.2 Colores y tipografía

  • Color identidad: botones y detalles destacados del chat.
  • Color de fondo del chat.
  • Tamaño del texto en píxeles (elija lo que se lea bien en móvil y ordenador).

10.3 Voz (lector del navegador)

El visitante puede usar leer en voz alta si su navegador lo permite.

  • Tipo de voz (por defecto / más femenina / más masculina): es una sugerencia al sistema; el resultado depende del dispositivo.
  • Velocidad: de lenta a rápida dentro del rango permitido.
  • Filtros para que suene natural: puede quitar negritas asteriscos, marcas técnicas tipo [ACCIÓN:…] o emojis, y añadir textos concretos que no quiera que se lean (por ejemplo enlaces larguísimos).

10.4 Índice de confianza del contexto

Valor entre 0 y 1 (en pantalla suele sugerirse algo cercano a 0,20).

En lenguaje claro: cuánto debe “encajar” el material de su web con la pregunta para que el modelo lo use. Si sube mucho este valor, el asistente será más exigente: puede volverse cortante o genérico porque descarta trozos que no le parecen una coincidencia suficiente. Si baja el valor, aceptará más contexto relacionado; a veces aparece algo más de ruido si los datos no están bien ordenados.

Consejo: ajuste despacio y pruebe en el Playground antes de abrir al público.

10.5 Cuánto puede alargarse cada respuesta

Controla el tamaño máximo de texto que puede generar cada respuesta (el sistema tiene un rango razonable guardado).

Si aumenta este límite: las respuestas pueden ser más largas y detalladas, pero también gastan más tokens y pueden tardar algo más. Si reduce el límite: ahorra y es más directo, pero quizá no desarrolle tanto el tema.

10.6 Tope diario de consumo por agente

Número máximo de tokens que este agente puede usar en un día (el contador se cierra según el día “técnico” del servicio, habitualmente en horario universal).

Si se supera, el chat puede entrar en modo mantenimiento para ese agente aunque la cartera general tenga saldo: es un fusible útil frente a picos o abusos accidentales.

10.7 Cuántos trozos de conocimiento enviar en cada pregunta (“contexto”)

Número de fragmentos de su conocimiento base que se pueden mezclar con la pregunta en cada turno (suele estar en un rango amplio; si lo deja vacío, el sistema usará un valor por defecto).

  • Más trozos: contextualmente más rico, pero más gasto y a veces más “disperso” si no acierta el contenido.
  • Menos trozos: más económico y directo, pero el asistente puede dejar fuera datos que estaban en otros fragmentos menos priorizados.

10.8 Búsqueda inteligente (“vectorial”) y sensibilidad

  • Activar búsqueda vectorial: conviene solo si ya ha hecho Entrenar y ve en la barra lateral que hay memoria lista. Si no hay nada entrenado, el texto de ayuda le avisará.
  • Umbral de similitud (0–1): qué tan parecido debe ser un trozo a la pregunta para contar. Valores muy altos pueden hacer que “no encuentre nada” sobre temas relacionados pero no idénticos.

10.9 Saludo inicial

Texto HTML sencillo que ve el visitante al abrir el chat. WordPress aplicará sus reglas de seguridad habituales sobre etiquetas permitidas.

10.10 Instrucciones generales (personalidad y reglas)

Aquí escribe quién es el asistente, tono (formal, cercano, breve), límites (“no opina de política”, “no invente precios sin consultar datos”, etc.).

Consejo práctico: no hace falta listar todos los sinónimos de su sector; con buenos datos y una memoria bien sincronizada las respuestas son más naturales. Use este cuadro para el comportamiento estable del negocio.


11. Pestaña «Registro de conversaciones»

Aquí aparece, cuando está activado, el historial reciente: fecha, mensaje del visitante y respuesta del asistente.

Privacidad (RGPD): compruebe con su responsable jurídico si puede guardar conversaciones que incluyan datos personales y si debe informarlo en política de privacidad / cookies como corresponda en su país.


12. Precios orientativos (tienda oficial y página pública)

Los importes de esta tabla pueden variar. El valor que vale es siempre el que ve al pagar en el momento de la compra en la tienda o enlace oficial. Como referencia de consulta habitual: xabia.ai/precio.

Concepto Precio indicativo (consulte la web al comprar) Para qué sirve en pocas palabras
Licencia Core (primer año) 199 € incluye habitualmente bolsa inicial de texto del orden de unos 500.000 tokens Activa la plataforma en su web
Renovación Core Entorno de 69 € / año (suele venir bolsa nueva promocional) Extiende el contrato año a año
Pack Starter 29 € (~medio millón tokens, conversaciones orientativas) Para sitios de bajo tráfico o prueba
Pack Business 79 € (~órdenes de dos millones de tokens) Uso medio de chat todos los días
Pack Enterprise 249 € (bolsa orientativa del orden de diez millones de tokens) Uso muy intenso
Addon Xabia–Avirato 49 € / año Conectar disponibilidad con el motor Avirato
Addon Xabia–Woo 49 € / año Catálogo y WooCommerce en contexto del chat
Addon Xabia–MEC 49 € / año Eventos con Modern Events Calendar
Smart QR / tótems Según página o campaña Experiencias en punto físico; ver precios
Red federada (Central) Proyectos corporativos o municipios: presupuesto a medida con ventas Xabia Varios nodos enlazados; requiere plan comercial especial

Las recargas típicas se hacen en Xabia Agent → Cartera / Wallet.

Los addons añaden funciones, pero las conversaciones habituales con IA siguen usando tokens salvo donde un addon aclare lo contrario en su propio manual (respuestas “ligeras” sin modelo).


13. Cartera / Wallet

Menú: Xabia Agent → Cartera / Wallet.

13.1 Qué muestra esta pantalla

  • Saldo actual de tokens asociados a esta instalación cuando el servicio lo confirme.
  • Un identificador de cliente o licencia que verá también en algunos enlaces de pago. No es necesariamente el mismo texto que la cadena secreta xabia_… que pega en Conexión a la IA. Si necesita estar seguro, use «Ver licencia guardada» en la pantalla principal.
  • Histograma de consumo de las últimas semanas para hacerse una idea visual del ritmo de gasto.
  • Renovar año aparece habitualmente cuando se acerca la fecha de caducidad (ventana habitual de orden de treinta días).

13.2 Cómo recargar tokens

  1. Compruebe que en Conexión a la IA tiene la licencia larga correcta (la que fue el correo o la clave activable, normalmente formato xabia_…).
  2. Entre en Cartera / Wallet como administrador.
  3. Pulse Recargar en el pack que se ajuste a su público (Starter, Business o Enterprise — véase tabla arriba).
  4. Complete el pago en la pasarela que se abre. El sistema ya envía detrás los datos necesarios para asociar la compra a este sitio; suele hacer falta esperar unos minutos y después pulsar Actualizar saldo en la pantalla principal hasta que coincida.

Comprado desde otro ordenador: no suele haber problema mientras sea la misma combinación dominio + licencia que espera la tienda para su sitio.

Multisite o una copia de prueba (staging): fíjese bien en desde qué dirección URL tiene instalado Xabia: la compra puede quedar vinculada a esa máquina concreta.

13.3 Renovar solo la licencia (importe habitual entorno 69 €/año)

El botón de renovación debe continuar la misma licencia, no crear otra nueva. Si la fecha sigue vieja después de esperar un rato y de Actualizar saldo, abra incidente de soporte con el comprobante de pago.

13.4 Aviso de saldo bajo

Si el saldo baja de orden de las decenas de miles de tokens, puede ver un mensaje destacado recordándole revisar Wallet antes de que el público encuentre cortes por falta de créditos.


14. Pantalla Addons

Una cuadrícula cómoda para descubrir complementos (como Avirato, Woo, etc.) con enlaces rápidos hacia Plugins o textos de ayuda.

El instalador ZIP y el contrato siguen llegando por el canal comercial o el correo habitual de Xabia.


15. Orden práctico para no perderse

  1. Modalidad Cloud vs infra propia, licencia y saldo (pantalla principal).
  2. Crear agente — nombre identificativo y cópielo en el shortcode donde quiera chat.
  3. Elegir fuente de datos — mapear con calma; pruebas en staging si existe.
  4. Sincronizar datos → mirar estadísticas lateral → si usa búsqueda inteligente, Entrenar hasta que los contadores pinten coherentes.
  5. Afinar Personalidad → probar Playground → publicar página con shortcode → vigilar gasto en Wallet.

16. Problemas frecuentes (qué revisar antes de escribir a soporte)

Situación Primer chequeo rápido
El chat menciona falta licencia o saldo Cartera más Actualizar saldo; compruebe no haber pegado sólo puntos tipo contraseña falsa donde iba una clave real
Pagué pero el saldo no sube Espere algunos minutos; Actualizar saldo; confirme que compró desde el sitio esperado mismo dominio
Google Cloud dice error al entrenar Ruta JSON, permisos y región coherentes su panel Google
Con Cloud siguen errores extraños entre modelos A veces toca soporte porque el lado central puede estar corrigiendo un modelo puntual para su zona
“No encuentra” lo que cargó en CSV ¿Ejecutó Sincronizar tras subir el archivo? ¿Pulsó Entrenar si usa búsqueda inteligente? Baje un poco los controles de confianza del contexto y de similitud: demasiado altos hacen que el asistente “no vea” textos relacionados pero no idénticos
Mezcla confusa con multi‑fuente Revise el segundo bloque de mapeo con el mismo cuidado que el primero

17. Preguntas frecuentes

¿Cuántos agentes puedo crear con una licencia?

En el uso típico retail, uno o varios agentes en el mismo dominio están incluidos sin coste extra por agente. Confirme siempre los límites exactos en su correo de bienvenida, en la página de precios oficial o con su comercial si el proyecto es grande.

¿Qué es exactamente un “token”?

Es la unidad con la que se mide cuánto trabajo de lenguaje ocupa una conversación (texto que entra más texto que sale cuando se usa el modelo). El entrenamiento de la memoria inteligente también consume tokens. Cuando la respuesta viene de una plantilla fija (sin modelo), muchas veces no gasta ninguno.

¿Tengo que pegar mi clave de OpenAI si uso Xabia Cloud?

Por lo general no. Con Cloud y licencia con saldo el tráfico habitual va por Xabia. La clave OpenAI entra en juego sobre todo en Infraestructura propia.

¿Por qué “no recuerda” mis tablas o PDF si los tengo en el servidor?

Debe incorporar ese conocimiento con Sincronizar (y Entrenar si activó búsqueda por similitudes). Los addons que aportan datos en vivo (reservas, etc.) son un canal aparte que no sustituye ese paso si usted quiere que el asistente cite su documentación.

¿Puedo usar copia de pruebas (staging) con la misma licencia que producción?

Depende de condiciones contractuales: dos direcciones públicas distintas a veces cuentan como dos instalaciones. Pregunte antes de mover tráfico real.

¿Si elimino la licencia se borran mis agentes?

No desaparecen de la lista ni su configuración borrada automáticamente, pero el chat dejará de funcionar bien en Cloud hasta que pegue otra licencia válida.

¿Hay saldo en la cartera pero el visitante ve “modo mantenimiento”?

Mire en Personalidad el tope diario de tokens por agente. La barra lateral Tokens hoy muestra si ya alcanzó ese techo para el día técnico en curso; al día siguiente ese contador vuelve a cero para el agente, aunque su cartera global siga teniendo saldo disponible para otros agentes u otros días.

Xabia AI — La web viva

Sabiduría natural con inteligencia artificial

Xabia AI está especialmente indicada para empresas y asociaciones del sector del turismo, instituciones, empresas y tiendas online que quieran incrementar su conversión.

Xabia AI está desarrollada por Digixop.

Xabia AI · Garaizar, 2 · 48004 Bilbao (SPAIN)

help@xabia.ai