¿Instalar drupal/ai ya me da acceso a un modelo de IA?

No. drupal/ai instala la capa de abstracción (AI Core) y submódulos opcionales, pero necesitas instalar por separado un módulo de proveedor (OpenAI, Anthropic, Ollama) y configurar su API key para que el sistema pueda generar respuestas.

¿Qué versión de Drupal necesito para instalar el módulo AI?

Drupal 10.5 o superior, o Drupal 11.2 o superior. También necesitas el módulo Key habilitado, ya que AI Core depende de él para el manejo seguro de credenciales.

¿Cuál es el único submódulo obligatorio de Drupal AI?

AI Core (machine name ai ). El resto de submódulos —API Explorer, CKEditor, Automators, Chatbot, Assistant API, Observability, Search— son opcionales y se habilitan según el caso de uso.

¿Puedo usar un modelo local en lugar de OpenAI o Anthropic?

Sí, mediante el módulo drupal/ai_provider_ollama , que conecta Drupal con modelos ejecutados en tu propia infraestructura sin depender de un servicio externo.

¿Cómo pruebo que la instalación funciona sin escribir código?

Habilitando AI API Explorer, que expone un formulario en la interfaz de administración de Drupal para enviar un prompt de prueba a cualquier proveedor configurado y ver la respuesta directamente.

Cómo instalar Drupal AI: guía completa paso a paso

Instalar el módulo AI en Drupal implica mucho más que ejecutar un único comando de Composer. El proyecto drupal/ai es, en realidad, un ecosistema de submódulos independientes —trece en su versión 1.4.5— que conviene comprender antes de decidir cuáles habilitar. En esta guía recorreremos todo el proceso, desde la creación de un sitio Drupal nuevo hasta obtener la primera respuesta de un modelo de lenguaje, resolviendo las dudas más comunes que suelen surgir durante la primera instalación.

El error más común no es de instalación, es de expectativa: instalar drupal/ai habilita la capa de abstracción, no un proveedor de IA. Sin un módulo de proveedor —OpenAI, Anthropic, Ollama— y sin una API key configurada, el sistema no tiene con quién hablar.

Instalar drupal/ai no es lo mismo que tener IA funcionando en tu sitio: es el paso cero, no el último.

Requisitos para instalar el módulo AI en Drupal

Antes de empezar, confirma que tu entorno cumple con lo que drupal/ai exige realmente: Drupal 10.5+ o 11.2+, PHP 8.3, Composer y el módulo Key (obligatorio, gestiona el almacenamiento seguro de las API keys de cada proveedor). Para levantar el entorno local usaremos DDEV como entorno de desarrollo y Drush como interfaz de línea de comandos de Drupal.

Drupal 10.5+ o 11.2+
PHP 8.3
Composer
DDEV
Drush

Crear el proyecto Drupal y configurar DDEV

El primer paso es levantar un proyecto Drupal nuevo con la distribución recomendada, y configurar DDEV mediante flags en lugar del asistente interactivo, lo que hace el proceso reproducible en CI o en la máquina de otro desarrollador del equipo:

composer create-project drupal/recommended-project ai-chatbot
cd ai-chatbot

ddev config \
  --project-name=ai-chatbot \
  --project-type=drupal11 \
  --docroot=web \
  --php-version=8.3

ddev start

Instalar Drupal con Drush

Con el contenedor de DDEV activo, se instala Drush como dependencia del proyecto y se ejecuta la instalación de Drupal sin pasar por el asistente web:

ddev composer require drush/drush

ddev drush site:install \
  --account-name=admin \
  --account-pass=admin \
  --account-mail=admin@example.com \
  --site-name="AI Chatbot Install"

Instalar el proyecto drupal/ai con Composer

Con el sitio base funcionando, el siguiente comando trae el proyecto completo drupal/ai y sus dependencias:

ddev composer require drupal/ai

Terminal ejecutando ddev composer require drupal/ai para instalar el módulo AI para Drupal y sus dependencias

Entre esas dependencias llega el módulo Key —un proyecto contrib independiente, no parte del núcleo de Drupal— si el sitio todavía no lo tenía instalado. Conviene tenerlo claro porque aparece mezclado en el listado que imprime Composer y es fácil asumir después que viene con Drupal core: en realidad es el módulo del que depende drupal/ai para el almacenamiento seguro de las API keys de cada proveedor, y va a aparecer habilitado junto a AI Core en /admin/modules.

Detalle del log de Composer mostrando la instalación de drupal/key junto con drupal/ai

Este comando no habilita ningún módulo automáticamente: solo descarga el código. La activación de submódulos específicos se hace después, desde /admin/modules o vía Drush, y es aquí donde la mayoría de guías se detienen sin explicar qué se acaba de instalar realmente.

Qué módulos instala Drupal AI y cuáles habilitar

El proyecto drupal/ai no es un único módulo: es un paquete de submódulos que aparecen agrupados bajo la categoría "AI" en /admin/modules. AI Core (machine name ai) es el único obligatorio —provee la capa de abstracción y no hace nada visible por sí solo—; el resto se habilita según el caso de uso:

Lista de submódulos de Drupal AI en la página Extender (/admin/modules) filtrada por 'AI'

Submódulo	Descripción	Cuándo habilitarlo
AI Core	Capa de abstracción del ecosistema AI; conecta con cualquier proveedor configurado.	Siempre — es la dependencia base de todo lo demás.
AI API Explorer	Herramienta de desarrollo para probar prompts y configuraciones directamente desde la interfaz de Drupal.	Solo en entornos de desarrollo; no dejar habilitado en producción.
AI CKEditor	Añade un plugin a CKEditor 5 para que los editores de contenido invoquen IA generativa desde el propio editor de texto.	Sitios editoriales donde redactores necesitan asistencia de escritura.
AI Automators	Rellena campos automáticamente a partir de contexto, vía cron, batch o acciones del editor.	Automatización de contenido — por ejemplo, generar un resumen o etiquetas al guardar un nodo.
AI Assistant API	Base desacoplada para construir asistentes que cualquier frontend puede consumir.	Cuando se necesita un asistente propio más allá de la interfaz de chat de referencia.
AI Chatbot	Implementación de referencia de un chatbot, construida sobre AI Assistant API.	Chatbots — es el punto de partida más rápido para tener uno funcionando.
AI Observability	Registra las solicitudes de IA en el logger de Drupal y en OpenTelemetry.	Producción — indispensable para auditar costo, latencia y errores de cada llamada a un modelo.
AI Search	Implementación de Search API sobre una base de datos vectorial, para búsqueda semántica.	Casos avanzados de búsqueda; sigue marcado como experimental.

El único paso obligatorio en esta etapa es habilitar AI Core:

ddev drush en ai -y

Terminal mostrando ddev drush en ai -y con los módulos ai y key instalados exitosamente

Vale la pena mencionar que la lista de submódulos de drupal/ai cambia entre versiones: en releases recientes, AI Logging, AI Content Suggestions, AI Translate, AI Validations y AI ECA integration ya aparecen marcados como obsoletos o en proceso de mudarse a proyectos contrib independientes. Antes de habilitar cualquiera de estos cinco, revisa el estado actual en /admin/modules — el panel de Drupal marca explícitamente cuáles están deprecados.

Configurar la API key

El módulo Key ya llegó instalado como dependencia de drupal/ai (ver sección anterior), así que la clave se puede crear desde ahora, incluso antes de instalar un proveedor específico. Se hace en /admin/config/system/keys — nunca pegar la API key directamente en un campo de configuración de texto plano.

Página /admin/config/system/keys del módulo Key en Drupal, vacía y con el botón Add Key

Formulario Add key del módulo Key en Drupal con los campos Key name, Key type y Key provider

Instalar un proveedor de IA: OpenAI, Anthropic u Ollama

AI Core no incluye ningún proveedor: cada uno es un proyecto Composer separado que se instala y configura de forma independiente.

Página AI Providers en /admin/config/ai/providers mostrando el mensaje 'No AI provider is configured'

El listado completo de proveedores se puede encontrar en la matriz oficial de proveedores y operaciones soportadas, generada automáticamente a partir del código fuente, pero los tres más usados son:

OpenAI — ddev composer require drupal/ai_provider_openai
Anthropic — ddev composer require drupal/ai_provider_anthropic
Ollama — ddev composer require drupal/ai_provider_ollama, para modelos ejecutados en infraestructura propia sin depender de un servicio externo

No es necesario instalar los tres: basta con el módulo del proveedor que realmente vayas a usar, y cada uno requiere AI Core como dependencia. Nada impide instalar varios en paralelo si quieres comparar resultados entre proveedores o alternar según el caso de uso — aunque decidir qué proveedor gobierna qué caso de uso, y bajo qué permisos, ya es terreno de la gobernanza de IA en CMS, no de esta guía de instalación. Al trabajar con DDEV, es recomendable ejecutar estos comandos con el mismo prefijo ddev composer require usado para instalar drupal/ai, para que la instalación quede dentro del contenedor y no en el entorno local.

OpenAI, Anthropic y Ollama son los proveedores más usados, pero no son los únicos: el ecosistema de drupal/ai soporta decenas de proveedores adicionales —Google Vertex, Gemini, Azure, LiteLLM, entre otros—, cada uno con su propio módulo Composer y su propio nivel de soporte para operaciones como chat, embeddings o generación de imágenes.

Elegir proveedor no es una decisión trivial de configuración: define si tus datos salen a un servicio externo o se quedan en tu propia infraestructura.

Con la clave ya creada y el proveedor instalado, el último paso es asignarle esa clave en su configuración específica, dentro de /admin/config/ai/providers — accesible desde el menú Configuration > AI del panel de administración:

Menú de administración de Drupal con Configuration > AI expandido, mostrando Overview, AI Infrastructure, Tools & Automation y Safety & Compliance

Página /admin/config/ai de Drupal mostrando AI Platform Providers, Default Models for AI Operations y AI API Explorer

Dentro de AI Platform Providers, cada proveedor instalado tiene su propia página de configuración — para OpenAI, por ejemplo, /admin/config/ai/providers/openai — donde se selecciona desde un menú desplegable la clave creada en /admin/config/system/keys (el primer paso de esta guía, en "Configurar la API key"):

Página Setup OpenAI Authentication en /admin/config/ai/providers/openai con el menú desplegable para seleccionar la clave API creada

Probar la instalación con AI API Explorer

AI API Explorer no tiene el mismo nivel de importancia que AI Core: es una herramienta opcional para desarrollo, no un requisito del sistema, y no debería quedar activa en producción. Se habilita aparte:

ddev drush en ai_api_explorer -y

Terminal mostrando ddev drush en ai_api_explorer -y instalado exitosamente

Una vez habilitado, la ruta real es /admin/config/ai/explorers: un listado de "exploradores", uno por cada tipo de operación soportada — Chat Generation, Embeddings Generation, Moderation, Speech-To-Text Generation, Text-To-Image Generation, Text-To-Speech Generation y Tools Explorer, entre otros que pueden aparecer según los proveedores que ya tengas configurados.

Página /admin/config/ai/explorers de Drupal con el listado de exploradores: Chat, Embeddings, Moderation, Speech-To-Text, Text-To-Image, Text-To-Speech y Tools

Para una primera prueba, entra al explorador de Chat Generation (/admin/config/ai/explorers/chat_generator):

Formulario Chat Generation Explorer en Drupal con los campos Role, Message, proveedor y modelo

Los campos mínimos para una prueba básica son:

Role: escribe user — es el rol estándar para un mensaje que simula lo que escribiría una persona.
Message: escribe cualquier prompt corto — funciona en cualquier idioma, por ejemplo "Present yourself in one phrase" o "Preséntate en una frase".
En el panel derecho, confirma que el proveedor (OpenAI, Anthropic u Ollama) sea el que configuraste con tu API key, y elige un Model del desplegable — la lista de modelos disponibles depende del proveedor seleccionado.

El resto de campos (System Prompt, File, Streamed, Max Tokens, Reasoning Effort, Advanced) se pueden dejar con su valor por defecto para esta primera prueba. Al final del formulario, presiona el botón Ask The AI:

Botón Ask The AI del formulario Chat Generation Explorer en Drupal

La respuesta del modelo reemplaza el texto "Response will appear here" en el panel central, junto con el rol de quien responde (assistant) y, en varios exploradores, dos secciones plegables adicionales — Code Example y Raw Code Example — con el código PHP equivalente a la llamada, listo para reutilizar en un módulo custom:

Respuesta del modelo en el Chat Generation Explorer de Drupal, con las secciones Code Example y Raw Code Example

Ver una respuesta aquí confirma que la conexión funciona de punta a punta. Si el módulo AI Observability también está habilitado, esa misma llamada queda registrada en el log de Drupal para revisión posterior.

Problemas frecuentes al instalar Drupal AI

La mayoría de los bloqueos en este proceso no vienen del código de drupal/ai, sino de pasos que se dan por sentados:

"El módulo AI Core no aparece en /admin/modules": casi siempre significa que composer require drupal/ai se ejecutó fuera del contenedor de DDEV (sin el prefijo ddev), o que falta ejecutar ddev composer install después de clonar un proyecto existente.
"Instalé drupal/ai pero no tengo IA funcionando": es el error de expectativa mencionado al inicio — falta instalar y configurar un módulo de proveedor con su API key.
Error de dependencia con el módulo Key: si se instaló manualmente un submódulo antes que AI Core, Composer puede fallar por orden de dependencias; instalar siempre drupal/ai primero y habilitar submódulos después.
Respuestas lentas o con timeout en AI API Explorer: revisar primero el proveedor elegido (Ollama local depende de los recursos de la máquina, no del código de Drupal) antes de asumir un bug del módulo.

Preguntas frecuentes

¿Instalar drupal/ai ya me da acceso a un modelo de IA?: No. drupal/ai instala la capa de abstracción (AI Core) y submódulos opcionales, pero necesitas instalar por separado un módulo de proveedor (OpenAI, Anthropic, Ollama) y configurar su API key para que el sistema pueda generar respuestas.
¿Qué versión de Drupal necesito para instalar el módulo AI?: Drupal 10.5 o superior, o Drupal 11.2 o superior. También necesitas el módulo Key habilitado, ya que AI Core depende de él para el manejo seguro de credenciales.
¿Cuál es el único submódulo obligatorio de Drupal AI?: AI Core (machine name ai). El resto de submódulos —API Explorer, CKEditor, Automators, Chatbot, Assistant API, Observability, Search— son opcionales y se habilitan según el caso de uso.
¿Puedo usar un modelo local en lugar de OpenAI o Anthropic?: Sí, mediante el módulo drupal/ai_provider_ollama, que conecta Drupal con modelos ejecutados en tu propia infraestructura sin depender de un servicio externo.
¿Cómo pruebo que la instalación funciona sin escribir código?: Habilitando AI API Explorer, que expone un formulario en la interfaz de administración de Drupal para enviar un prompt de prueba a cualquier proveedor configurado y ver la respuesta directamente.

¿Necesitas ayuda instalando o gobernando Drupal AI en un proyecto enterprise? Conversemos →

Publicado por Seed EM · Julio 2026.