AI Assistant UI

AI Assistant UI provides two common AI interfaces for your site:

• Chatbot — a chat widget with streaming replies and session history.
• AI search answers — an AI-generated answer to the visitor's search, as a block or as a Views area.

Both are powered by the AI module's AI Assistant API, which brings agentic tools such as RAG. The front end is built from Drupal-native Single Directory Components.

Features

• Answers stream in as the model writes them, or arrive complete when streaming is off.
• Conversation history is kept per visitor session and can be restored after a page reload.
• Suggested first questions, introduction text, disclaimer and configurable labels.
• Optional terms of service screen that visitors accept before chatting and can revoke later.
• Search answers follow the view's exposed filters, facets and Views AJAX.
• Optional link preview cards and per-session caching for search answers.
• Rate limiting on the chat and link preview endpoints.
• Themeable: copy a component into your theme with one Drush command.

Requirements

• Drupal 10.4 or later, 11 or 12.
• The AI module with its AI Assistant API submodule, a configured AI Assistant and an LLM provider.
• Optional: league/commonmark, to render Markdown in answers as HTML.

Installation

composer require 'drupal/ai_assistant_ui:^1.0@beta'
drush en ai_assistant_ui

Post-Installation

1. Add the Markdown parser (recommended): composer require league/commonmark
2. Configure an AI Assistant at Administration → AI → Assistants.
3. Place a block at Structure → Block layout: search for AI Assistant Chatbot or AI Assistant Search Results, then configure it. For a search view, add the AI Assistant answer area to the view's header instead.
4. Theming: copy the template and component into your theme for easy customisation.

   drush aut-scaffold chatbot
   drush aut-scaffold search-results

Similar projects

The chatbot is functionally similar to the DeepChat block provided by the ai_chatbot module of the AI module, but its front end is 100% Drupal-native, which gives a more flexible and familiar theming workflow. The search answers are similar to the AI Search Block module; the main difference is that ai_search_block does not use an AI Assistant and has its own RAG implementation.

Supporting this Module

Developed and maintained by LOOM —
https://loom.de