AI Chatlog

Overview

AI Chatlog records the conversations your site's AI assistants and agents have with users, and presents them as browsable, threaded transcripts in the Drupal admin UI. It is built for sites using the AI module ecosystem.

The module keeps conversations in its own storage and starts recording as soon as it is enabled. No logging or observability module has to be set up first.

Features

• Conversation list - paginated overview of all AI conversations with user, assistant, opening message, message count, timestamps and token usage. Built with Views, so it can be customised.
• Filtering and sorting - filter by user, assistant and date range; sort by most columns.
• Full transcripts - click any conversation to see the complete exchange history with per-exchange metadata (model, provider, tokens, timestamp).
• Agent tool calls - tool-call retries are folded into the user turn they belong to, with each call's arguments and result. Conversations that ended without a text answer are flagged as unresolved.
• Render modes - view messages as raw text, Markdown or safe HTML. Markdown needs league/commonmark ^2.0.
• Privacy controls - choose whether to store message input and output, and what happens to a user's conversations when their account is deleted.
• Retention management - configurable automatic cleanup via cron (default: 90 days). Delete a single conversation or all of them.
• Error alerts - the optional AI Chatlog Alerts submodule detects tool-call failures and unresolved conversations, logs them, and can email a list of recipients.
• Optional cost figures - shown on the transcript page when the ai_insights_cost submodule of AI Insights is enabled.
• Service API - other modules can inject the ai_chatlog.query service to access conversation data programmatically.
• Drush commands - rebuild or reconcile conversation summaries.

How it works

AI Chatlog subscribes to the AI module's response events and writes one record per exchange, holding the full input and output. A summary row per conversation is derived from those records and drives the list page. A streamed response is stored as a single record.

Recording never breaks a chat response: failures are caught and written to the ai_chatlog log channel.

Supported assistant types

• AI Assistant API assistants (ai_assistant_api)
• AI Agents (ai_agents)

Requirements

• Drupal 10.3 or later, 11 or 12
• AI

Privacy

The module stores whatever users typed and whatever the model replied, so treat it as personal data. Anyone with View AI conversations can read every user's conversations, not only their own.

Updating from a development snapshot

Sites that ran 1.0.x-dev before 1.0.0-beta1 must update to 1.0.0-beta1 first. See UPDATES.md in the module for details.