Integración con Wagtail
Un asistente de IA que responde preguntas en tu sitio Wagtail
Descripción general
El paquete de Wagtail pone un asistente de IA en tu sitio. Un botón de chat aparece en la esquina de cada página, los visitantes preguntan con sus propias palabras, y la respuesta sale de tu propio contenido: tu sitio web, tus documentos subidos y tus artículos de ayuda.
Aviso sobre la IA: Las respuestas en tu sitio web las genera una IA. A veces pueden ser inexactas o incompletas. Compruébalas antes de fiarte de ellas, sobre todo en decisiones importantes.
Cómo funciona
El paquete añade un middleware que pone un script pequeño justo antes de la etiqueta de cierre body de cada página. Ese script espera a que la página termine de cargar y luego trae el widget de chat desde Asyntai, así tu sitio se dibuja primero y la velocidad de la página no cambia. Tu servidor nunca habla con Asyntai; solo lo hace el navegador del visitante.
No cambias nada en tus plantillas. El middleware deja en paz la administración de Wagtail, y deja en paz todo lo que no sea una página HTML.
Requisitos
- Una cuenta de Asyntai. El plan gratuito basta para empezar.
- Un sitio Wagtail, versión 5.2 o posterior, con Django 4.2 o posterior y Python 3.9 o posterior.
- Acceso al código de ese sitio, porque instalas un paquete de Python.
Instalación
Sigue estos pasos para añadir Asyntai a tu sitio Wagtail:
Instala el paquete
Instálalo desde el Python Package Index, en el mismo entorno que tu sitio:
pip install wagtail-ai-chatbot
Añádelo a tus ajustes
Añade la aplicación y el módulo de ajustes de Wagtail a INSTALLED_APPS, y el middleware al principio de MIDDLEWARE:
INSTALLED_APPS = ["wagtail_asyntai", "wagtail.contrib.settings", ...]
MIDDLEWARE = ["wagtail_asyntai.middleware.AsyntaiWidgetMiddleware", ...]
Ejecuta la migración
Esto crea la tabla que guarda tus ajustes:
python manage.py migrate wagtail_asyntai
Pegue el ID de su widget
En la administración de Wagtail, abre Settings y luego Asyntai chat assistant. Pega tu ID de widget y elige Save. Encuentras el ID en tu panel de Asyntai en Setup & Integration. Puedes pegar el fragmento entero; el paquete solo se queda con el ID.
Consejo: Añade tus documentos, tus preguntas y respuestas y tus instrucciones en el panel de Asyntai antes de publicar, para que el asistente responda bien desde el primer visitante.
Ajustes
- ID del widget: el chat está activo mientras este campo tenga un ID válido, y apagado cuando está vacío.
- Mostrar el chat solo a visitantes sin sesión: los usuarios que han iniciado sesión nunca ven el chat. Útil cuando el asistente está para responder a gente que aún no se ha registrado.
- Dirección del script del widget: deja este valor como está, salvo que el soporte de Asyntai te pida cambiarlo.
Los ajustes son por sitio, así que un proyecto que sirve varios sitios desde una sola instalación de Wagtail puede dar a cada sitio su propio asistente.
Ajustes en tu archivo de ajustes
Un proyecto que guarda su configuración en variables de entorno puede saltarse la administración y poner los valores en el código. Si están los dos, gana la administración.
ASYNTAI_WIDGET_ID = "asyntai_ab12cd34"
Hay tres valores más opcionales: ASYNTAI_SHOW_TO_ANONYMOUS_ONLY, ASYNTAI_SCRIPT_URL y ASYNTAI_SKIP_PREFIXES. El último nombra las rutas que el widget nunca toca, y lo necesitas cuando tu administración no está en /admin/.
Colocar el widget a mano
Si prefieres elegir tú el sitio, deja fuera el middleware y pon la etiqueta en tu plantilla base. La etiqueta y el middleware nunca actúan a la vez, así que puedes quedarte con los dos.
{% load asyntai %} ... {% asyntai_widget %}
Qué puede hacer el asistente
- Responder al momento a las preguntas de los visitantes, 24/7, en cada página
- Responder en más de 80 idiomas, detectados automáticamente a partir de la pregunta
- Seguir abierto mientras el visitante pasa de una página a otra
- Usar sus propios documentos, preguntas frecuentes e instrucciones para dar respuestas precisas
Privacidad
El paquete publica exactamente dos valores en la página: el ID del widget y la dirección del script. Nada sobre tus páginas ni sobre tus usuarios se envía a Asyntai. Solo el navegador del visitante habla con Asyntai, y solo cuando el visitante abre el chat.
Planes y precios
La integración con Wagtail está disponible en todos los planes de Asyntai, incluido el gratuito. Cada plan incluye un número mensual de mensajes compartido entre todos tus canales e integraciones. Ver precios.
Desinstalación
Vacía el campo del ID del widget para apagar el chat. Para quitar el paquete, saca el middleware y la aplicación de tus ajustes y desinstálalo con pip.
Código fuente
El paquete es libre y de código abierto, con licencia MIT. Puedes leer cada línea en GitHub.
¿Necesita ayuda?
Si tiene alguna pregunta o encuentras problemas, contáctanos en [email protected].