Guía de configuración de ajustes de IntelliWP, configuración de RAG + Ajuste fino del agente de inteligencia artificial de WordPress
IntelliWP representa una evolución significativa en la integración de inteligencia artificial dentro del ecosistema de WordPress. Su página de configuración de ajustes constituye el centro de control desde donde los desarrolladores pueden implementar un sofisticado agente de inteligencia artificial de WordPress que va más allá de los chatbots tradicionales.
La característica distintiva que posiciona a IntelliWP por encima de otros plugins radica en su arquitectura dual de RAG + Ajuste fino. Esta flexibilidad permite a los usuarios elegir la metodología más adecuada según sus necesidades específicas, algo que ningún otro plugin de WordPress ofrece con esta sofisticación técnica.
Configuración de la API de OpenAI, la base de la conectividad
La gestión de claves API en IntelliWP implementa un sistema de prioridad inteligente que prioriza la seguridad sobre la conveniencia. El sistema busca la clave API en orden jerárquico: primero en variables de entorno del servidor, luego en wp-config.php y finalmente en la base de datos como último recurso.
Cuando la clave se carga desde fuentes externas, el campo aparece deshabilitado con el mensaje «Este campo es de solo lectura porque la clave API se carga desde una fuente externa», confirmando que el sistema opera en modo seguro. En este caso, se muestra una vista previa de la clave para verificación sin exponer credenciales completas.
Para la configuración manual, el campo permite la entrada directa de la clave API con el marcador de posición «Ingresa tu clave API de OpenAI». El sistema valida automáticamente la conectividad con OpenAI y muestra el estado de la conexión.
La prominente advertencia de términos de servicio no es meramente informativa: recuerda que aunque IntelliWP es GPL, el uso de la API de OpenAI está sujeto a términos específicos de OpenAI, estableciendo responsabilidades claras con respecto al procesamiento de contenido.
Selección del modo de operación, Ajuste fino vs RAG
Esta es quizás la decisión más crítica en toda la configuración. IntelliWP ofrece dos metodologías completamente diferentes para crear tu inteligente agente de inteligencia artificial de WordPress, cada una con ventajas específicas según el caso de uso.
El Ajuste fino (Modo clásico) crea un modelo específicamente entrenado con tu contenido. La descripción técnica explica: «Crea un modelo específicamente entrenado con tu contenido. Requiere reentrenamiento cuando el contenido cambia.» Este método es ideal para sitios con contenido relativamente estático donde la precisión y la consistencia son prioridades.
RAG (Generación Aumentada por Recuperación) utiliza búsqueda vectorial para recuperar contenido relevante para cada consulta. La descripción indica: «Utiliza búsqueda vectorial para recuperar contenido relevante para cada consulta. Se actualiza automáticamente cuando cambia el contenido.» Cuando seleccionas esta opción, aparece dinámicamente un enlace «Configurar más», que lleva a configuraciones específicas del agente RAG de WordPress.
La elección entre estos métodos determina completamente el comportamiento posterior del sistema, incluidos los costos operativos, la velocidad de respuesta y la flexibilidad para actualizaciones de contenido.
Gestión de fuentes de contenido
IntelliWP proporciona un control detallado sobre qué contenido se incluye en el entrenamiento o indexación del agente inteligente de WordPress.
La opción «Incluir publicaciones y páginas en el entrenamiento» viene activada por defecto y extrae contenido de todas las publicaciones y páginas publicadas en el sitio. Esta es la fuente de conocimiento principal para la mayoría de implementaciones.
«Incluir archivos de la biblioteca multimedia» permite extraer texto de archivos en la biblioteca multimedia. Esta función viene desactivada por defecto con la advertencia «Esto puede aumentar significativamente el tiempo de entrenamiento», reflejando el impacto en el rendimiento y los costos.
La función «Usar IA para generar conjuntos de datos de entrenamiento mejorados» utiliza la API de OpenAI para generar pares de preguntas y respuestas de alta calidad. La descripción técnica especifica: «Utiliza la API de OpenAI para generar pares de preguntas y respuestas de alta calidad» con la advertencia explícita «Esta opción consume tokens adicionales de la API y puede aumentar los costos».
Selección y configuración del modelo base
El menú desplegable de selección de modelo organiza las opciones en dos categorías claramente diferenciadas. Los «Modelos base» incluyen modelos oficiales como GPT-3.5 Turbo, GPT-4 y GPT-4 Turbo, que siempre están disponibles cuando la clave API es válida.
Los «Modelos Ajustados» muestran modelos previamente entrenados por el usuario. Si no existen modelos personalizados, se muestra «No hay modelos ajustados disponibles», indicando que al menos un ciclo de entrenamiento debe completarse antes de tener opciones adicionales.
La selección del modelo base determina las capacidades fundamentales del agente, incluida la comprensión contextual, la calidad de respuesta y los costos operativos.
Configuración avanzada y control de costos
IntelliWP muestra una transparencia excepcional en el manejo de costos a través de información detallada sobre precios. Los costos aproximados se presentan claramente: «Entrenamiento: $0.008 por 1K tokens» y «Uso de modelo ajustado: $0.012 por 1K tokens (entrada), $0.016 por 1K tokens (salida)».
El enlace directo a la página de precios oficial de OpenAI permite verificar la información actualizada, reconociendo que los precios pueden variar.
El campo «Límite de contenido para mejora de IA» controla el número máximo de elementos de contenido procesados con la API de OpenAI. El valor predeterminado de 100 representa un equilibrio entre la calidad del conjunto de datos y los costos razonables. La descripción explica: «Número máximo de elementos de contenido que se procesarán con la API de OpenAI. Un número mayor mejora la calidad del conjunto de datos pero aumenta el costo».
Protección contra límites de velocidad
El sistema de protección contra el uso excesivo incluye la casilla «Proteger contra el uso excesivo de la API» que evita llamadas no controladas a la API. Esta función es esencial para evitar costos inesperados por un uso masivo accidental.
El campo «Solicitudes por minuto» permite configurar el número máximo de solicitudes a la API por minuto, con un valor predeterminado de 50 y una recomendación de 20 para un uso conservador. Este control es particularmente importante en sitios con alto tráfico donde múltiples usuarios podrían interactuar simultáneamente con el agente.
Control de acceso externo y seguridad
La configuración de dominios permitidos incluye cinco campos específicos para URLs autorizadas. Solo los dominios listados aquí pueden acceder a la API de chat desde aplicaciones JavaScript externas, estableciendo un perímetro de seguridad claro.
La nota de seguridad explica que «Solo los dominios listados aquí podrán acceder a la API de chat desde aplicaciones JavaScript externas», enfatizando la importancia de configurar correctamente estos campos antes de implementar integraciones externas.
La casilla «Habilitar encabezados CORS para respuestas de API» permite solicitudes entre dominios autorizados. Esta configuración es obligatoria para aplicaciones JavaScript externas y debe activarse junto con la lista de dominios permitidos.
Integración de fragmento de JavaScript
IntelliWP facilita la implementación externa a través de un fragmento de JavaScript preconfigurado. El campo de texto grande contiene código listo para copiar y pegar en sitios externos, con la instrucción «Copia este código y pégalo en el HTML de tu sitio externo».
La funcionalidad «Integración fácil» incluye opciones para personalizar temas y configuraciones responsivas, junto con un botón «Copiar fragmento de JavaScript» que facilita la implementación sin errores de transcripción.
Avisos de seguridad y validación final
Los avisos de seguridad finales establecen tres requisitos críticos para el correcto funcionamiento: los fragmentos solo funcionan en dominios de la lista permitida, es necesario agregar dominios a la lista permitida y los encabezados CORS deben estar habilitados si se utiliza el fragmento de JavaScript.
El cuarto punto recomienda probar la integración en el dominio de destino antes de considerar completa la implementación.
Características distintivas de IntelliWP
La arquitectura dual permite alternar entre el agente de inteligencia artificial de WordPress con ajuste fino y el agente RAG de WordPress desde la misma interfaz a través de botones de radio en la sección de Modo de operación. Una vez seleccionado RAG, aparece dinámicamente el enlace «Configurar más» para acceder a configuraciones específicas.
El sistema de gestión de claves API implementa una búsqueda jerárquica: variables de entorno, wp-config.php y base de datos como último recurso. Cuando se detecta una configuración externa, el campo aparece deshabilitado mostrando «Este campo es de solo lectura porque la clave API se carga desde una fuente externa».
La transparencia de costos incluye información detallada: «Entrenamiento: $0.008 por 1K tokens» y «Uso de modelo ajustado: $0.012 por 1K tokens (entrada), $0.016 por 1K tokens (salida)» con enlace directo a la página de precios oficial de OpenAI.
La página de Configuración de IntelliWP concentra todas las decisiones estratégicas que determinan el comportamiento, rendimiento y costos del sistema de IA. Dominar estas configuraciones proporciona un control completo sobre la implementación, permitiendo la optimización del equilibrio entre funcionalidad, rendimiento y costos según los requisitos específicos del proyecto.