Drup-AID Academy

Drup-AID Platform Developer Course

Learn to build AI agents on Drup-AID at the code level. Sixteen short, narrated chapters take you from a fresh Drupal 11 dev environment all the way to a custom, secured, deployed minion — every step built on Drup-AID itself. Written for Drupal developers; if you can read PHP, you can follow along.

16 chapters · ~48 minutes · code-level · free & open source

Course content

  1. 1. Dev environment & tooling Stand up a Drupal 11 dev environment with DDEV, Docker, Composer and Drush.
  2. 2. PHP & Git for Drupal The PHP (OOP, namespaces, attributes) and the Git workflow Drupal expects.
  3. 3. Entities, fields & the module skeleton Content vs configuration entities, fields, and the anatomy of a module.
  4. 4. Services, DI, plugins & hooks The service container, dependency injection, plugins, and keeping hooks thin.
  5. 5. Routing, render, config & caching Routes, controllers, render arrays, configuration management and cache tags.
  6. 6. The ai module: providers, chat & secrets How the ai module talks to LLM providers, runs chat, and stores keys safely.
  7. 7. ai_agents: config-entity agents & the explorer Agents as configuration, the run lifecycle, and tracing them in the explorer.
  8. 8. Scaffold a Drup-AID module Generate a working module skeleton from the template pack.
  9. 9. Build a custom executable tool (#[FunctionCall]) Write a real agent tool with the FunctionCall attribute, from signature to execute().
  10. 10. Custom data & building a minion Custom-table data and assembling your first sub-agent (minion).
  11. 11. Wire it in: core services, security & cockpit Hook the minion into core services, secure it, and surface it in the cockpit.
  12. 12. Multi-agent orchestration & MCP Master-and-minion delegation, and consuming or exposing MCP servers.
  13. 13. Local LLM reliability & autonomous loops Make local models reliable and build done-gated autonomous loops.
  14. 14. Quality, security & debugging PHPCS/PHPStan quality gates, security hardening, and debugging agents.
  15. 15. Recipes, deployment & upstream standards Package with recipes, deploy, and meet upstream contribution standards.
  16. 16. Capstone: build a minion end-to-end Build, secure, test and deploy a complete minion + tool, start to finish.

Chapter 1 — Dev environment & tooling

Stand up a Drupal 11 dev environment with DDEV, Docker, Composer and Drush.

Chapter 2 — PHP & Git for Drupal

The PHP (OOP, namespaces, attributes) and the Git workflow Drupal expects.

Chapter 3 — Entities, fields & the module skeleton

Content vs configuration entities, fields, and the anatomy of a module.

Chapter 4 — Services, DI, plugins & hooks

The service container, dependency injection, plugins, and keeping hooks thin.

Chapter 5 — Routing, render, config & caching

Routes, controllers, render arrays, configuration management and cache tags.

Chapter 6 — The ai module: providers, chat & secrets

How the ai module talks to LLM providers, runs chat, and stores keys safely.

Chapter 7 — ai_agents: config-entity agents & the explorer

Agents as configuration, the run lifecycle, and tracing them in the explorer.

Chapter 8 — Scaffold a Drup-AID module

Generate a working module skeleton from the template pack.

Chapter 9 — Build a custom executable tool (#[FunctionCall])

Write a real agent tool with the FunctionCall attribute, from signature to execute().

Chapter 10 — Custom data & building a minion

Custom-table data and assembling your first sub-agent (minion).

Chapter 11 — Wire it in: core services, security & cockpit

Hook the minion into core services, secure it, and surface it in the cockpit.

Chapter 12 — Multi-agent orchestration & MCP

Master-and-minion delegation, and consuming or exposing MCP servers.

Chapter 13 — Local LLM reliability & autonomous loops

Make local models reliable and build done-gated autonomous loops.

Chapter 14 — Quality, security & debugging

PHPCS/PHPStan quality gates, security hardening, and debugging agents.

Chapter 15 — Recipes, deployment & upstream standards

Package with recipes, deploy, and meet upstream contribution standards.

Chapter 16 — Capstone: build a minion end-to-end

Build, secure, test and deploy a complete minion + tool, start to finish.