This project is not covered by Drupal’s security advisory policy.
AI Agent Modes puts a simple Mode dropdown in front of your AI assistant, so you can tell it what kind of job you want done before you start typing.
Pick "Page Builder Only" and the assistant builds pages. Pick "Content Types & Fields" and it works on your content structure. Leave it on "All" and it decides for itself, exactly as it does today.
Why it helps
An AI assistant that can do everything has to consider everything. The more jobs it knows about, the more it has to read before it answers, and the more likely it is to wander off or invent something that does not fit your site.
Choosing a mode narrows the job. The assistant is pointed at the handful of skills that matter for that task, so it stays on topic and gives steadier results. Nothing is taken away: the assistant keeps all of its abilities and is simply steered towards the right ones.
What you get
- A Mode dropdown next to the chat box, listing the modes your site offers.
- Your choice sticks for the rest of the conversation, so you set it once and keep working.
- Modes you can create, name and edit yourself, and share between sites as configuration.
- A settings screen to choose where the dropdown sits: at the top of the panel, above the message box, under the message box, or tucked into the toolbar.
Tips and things to know
Note: The selector only appears when there is more on offer than the free-form default. Create at least one mode, or make sure the parent assistant has live sub-agents, otherwise the dropdown stays hidden.
Note: A mode choice is remembered in Drupal's private temporary store rather than saved as a permanent setting. Each person chooses independently, and the choice is not carried over forever.
Tip: A mode never takes tools away from the assistant. It only adds a steering instruction, so the assistant keeps its full capability and is simply nudged towards the right skills.
Where it appears
- Drupal Canvas AI: the dropdown appears in the Canvas AI panel while you build pages.
- AI Assistant chatbot: the dropdown is added to the assistant chat.
- Anywhere else: place the "AI Agent Mode selector" block next to any AI chat on your site.
Managing modes
Site administrators manage everything at Configuration > AI > AI Agent Modes. The Modes tab lists each mode, which assistant it belongs to, the skills it covers, and whether it is switched on. The Settings tab controls where the dropdown appears. A dedicated "administer ai agent modes" permission keeps this in the hands of the people who should have it.
Getting started
- Install the module. It needs only the AI and AI Agents modules.
- Go to Configuration > AI > AI Agent Modes to review the modes your site has.
- Open your AI assistant and pick a mode from the dropdown before you type.
If your site uses Drupal Canvas, a starter set of modes for page, section, component and pattern work is added for you when the matching Canvas agents are present. Otherwise you start with the free-form default and add your own modes.
Documentation
The full documentation covers choosing a mode while you work, managing modes and where the dropdown can sit, developing against the configuration entity, and the behaviors that look like faults and are not.
Who maintains this
AI Agent Modes is built and maintained by Vardot.
Supporting organizations:
Initial building, ongoing maintenance and development
Project information
- Project categories: Artificial Intelligence (AI)
- Ecosystem: AI (Artificial Intelligence)
6 sites report using this module- Created by rajab natshah on , updated
This project is not covered by the security advisory policy.
Use at your own risk! It may have publicly disclosed vulnerabilities.
Releases
1.0.0-alpha2
released 27 July 2026
Works with Drupal: ^11
Install:
Development version: 1.0.x-dev updated 27 Jul 2026 at 20:30 UTC
