AI Interpolator
Un módulo framework que permite la población automática de campos de entidad utilizando procesamiento basado en IA desde campos de texto de origen.
ai_interpolator
Overview
AI Interpolator proporciona un potente framework basado en plugins para poblar automáticamente campos de entidades Drupal utilizando servicios de IA. El módulo funciona leyendo contenido de un campo de origen (típicamente un campo de texto) y usando IA para generar valores apropiados para campos de destino de varios tipos.
El módulo en sí no incluye ningún proveedor de IA - sirve como un framework que otros módulos pueden extender con implementaciones específicas de IA (como OpenAI, Claude, etc.). Esta arquitectura permite a los constructores de sitios elegir su servicio de IA preferido mientras mantienen interfaces de configuración de campos consistentes.
Las características arquitectónicas clave incluyen:
- Reglas de campo basadas en plugins: Sistema extensible para definir cómo diferentes tipos de campos deben ser poblados usando IA
- Múltiples métodos de procesamiento: Soporte para procesamiento síncrono directo, procesamiento por lotes con JavaScript, o procesamiento asíncrono basado en cola vía cron
- Sistema de eventos: Eventos completos para interceptar y modificar el comportamiento de interpolación en varias etapas
- Soporte de Token: Modo avanzado usando tokens de Drupal para generación dinámica de prompts
- Seguimiento de estado: Campo de estado automático para rastrear el progreso de interpolación (pendiente, procesando, fallido, finalizado)
Features
- Arquitectura basada en plugins para definir reglas de campos IA para diferentes tipos de campos (texto, taxonomía, booleano, numérico, referencia de entidad, imagen, enlace, opciones, etc.)
- Tres modos de procesamiento: Directo (síncrono), Lote (basado en JavaScript), y Cola/Cron (procesamiento asíncrono en segundo plano)
- Seguimiento automático de campo de estado para entidades con interpolación habilitada (pendiente, procesando, fallido, finalizado)
- Modo Base: Usa el contenido de un campo de origen con prompts personalizables usando marcadores de posición estilo Twig
- Modo Token Avanzado: Integración con el módulo Token de Drupal para generación dinámica de prompts basada en datos de entidad
- Orden de procesamiento de campos basado en peso para manejar dependencias entre campos interpolados
- Opción de modo de edición para re-interpolar campos cuando el contenido de origen cambia
- 20 clases base preconstruidas para reglas de tipos de campos comunes incluyendo SimpleTextChat, ComplexTextChat, Taxonomy, Boolean, Numeric, Options, Lists, Link, EntityReference, TextToImage, ImageToImage, y más
- Arquitectura orientada a eventos con 5 eventos para personalizar configuración, procesamiento de campos, visibilidad de reglas, cambios de valores e información detallada
- Servicios auxiliares para operaciones comunes: análisis de JSON, parámetros LLM, manejo de archivos, preprocesamiento de estilos de imagen, unión de texto
- Implementación de plugin de ejemplo incluida para crear reglas personalizadas sin IA
Use Cases
Etiquetado automático de taxonomía
Configure un campo de referencia de términos de taxonomía para que se pueble automáticamente basándose en el contenido del cuerpo del artículo. La IA analiza el texto y selecciona o crea etiquetas apropiadas del vocabulario configurado. Soporta auto-creación de nuevos términos cuando está habilitado, manipulación de texto (minúsculas, mayúsculas, primera letra mayúscula), y coincidencia de etiquetas similares para evitar duplicados.
Resumen de contenido
Configure un campo de texto de resumen que genere automáticamente un resumen ejecutivo de un campo de cuerpo extenso. Use la clase base SimpleTextChat con un prompt como 'Resume el siguiente contenido en 2-3 oraciones: {{ context }}'. El resumen se genera cuando se guarda el contenido.
Análisis de sentimiento
Añada un campo de lista con opciones de sentimiento (positivo, negativo, neutral) y configure AI Interpolator con la clase base Options para analizar y categorizar automáticamente el sentimiento del contenido basándose en el texto del cuerpo.
Imágenes destacadas generadas por IA
Use la clase base TextToImage (requiere submódulo de generación de imágenes con IA) para generar automáticamente imágenes destacadas basadas en títulos o descripciones de artículos. La IA crea imágenes que coinciden con el tema del contenido.
Campos meta SEO automatizados
Configure campos de cadena para títulos y descripciones meta que se generen automáticamente desde el contenido principal. Use prompts que instruyan a la IA a crear texto optimizado para SEO dentro de límites de caracteres.
Población de referencias de entidad
Cree y enlace automáticamente entidades relacionadas basándose en el contenido de origen. La clase base EntityReference puede analizar contenido y generar entidades hijas con múltiples campos poblados por IA.
Clasificación de campos booleanos
Añada campos booleanos que clasifiquen automáticamente el contenido basándose en análisis de IA. Por ejemplo, banderas de 'Contiene datos personales' o 'Es sensible al tiempo' que la IA determina del análisis del contenido.
Puntuación numérica
Use la clase base Numeric para que la IA asigne puntuaciones o calificaciones numéricas al contenido. Respeta los ajustes de mínimo/máximo del campo y valida la salida numérica.
Extracción de enlaces
Extraiga y almacene automáticamente URLs mencionadas en el contenido usando la clase base Link. La IA identifica enlaces y su contexto para poblar campos de enlace con URI y título.
Procesamiento masivo asíncrono
Use el modo de procesamiento Cola/Cron para importar grandes cantidades de contenido donde el tiempo de procesamiento de IA causaría tiempos de espera agotados. El contenido se guarda inmediatamente con estado 'pendiente', y los campos de IA se pueblan en segundo plano vía cron.
Tips
- Siempre instale al menos un submódulo proveedor de IA - el módulo base AI Interpolator proporciona el framework pero ninguna funcionalidad de IA real
- Use el modo de procesamiento Cola/Cron para sitios de producción con APIs de IA lentas para evitar tiempos de espera HTTP agotados durante la edición de contenido
- Establezca pesos apropiados cuando múltiples campos dependen de los valores interpolados de otros - pesos menores se procesan primero
- Habilite 'Editar cuando cambie' con cuidado ya que re-procesará campos en cada guardado cuando el campo de origen cambie
- Use Modo Token Avanzado cuando necesite incluir datos de entidades referenciadas o relaciones de entidades complejas en los prompts
- El campo de estado (ai_interpolator_status) se añade automáticamente a los bundles de entidades cuando cualquier campo tiene interpolación habilitada - úselo para filtrar o mostrar el estado de procesamiento
- Pruebe los prompts exhaustivamente con contenido representativo antes de habilitar en producción - las respuestas de IA pueden variar significativamente según la redacción del prompt
- Considere crear reglas personalizadas sin IA para transformaciones simples (como el ejemplo StripTags) para evitar llamadas innecesarias a la API
- Use el método parseJson() del servicio GeneralHelper al crear reglas que esperan respuestas JSON de la IA
- Suscríbase al evento ai_interpolator.change_value para post-procesar respuestas de IA antes del almacenamiento, como validación o formateo adicional
Technical Details
Admin Pages 1
/admin/structure/types/manage/{bundle}/fields/{field_config}
AI Interpolator añade ajustes a los formularios de configuración de campos cuando existen reglas aplicables para el tipo de campo. Los ajustes aparecen como una casilla 'Habilitar AI Interpolator' que revela opciones de configuración adicionales cuando se marca.
Hooks 2
hook_ai_interpolator_field_rule_alter
Altera las definiciones de plugins de reglas de campo descubiertas
hook_ai_interpolator_process_alter
Altera las definiciones de plugins de reglas de proceso descubiertas