Skip to content

Configuration

After enabling the module, follow these steps to configure AI Context.

Step 1: Create agents

Go to /admin/config/ai/agents to add one or more AI agents. Agents are the consumers of context items -- each agent can have its own context configuration.

Step 2: Create context items

Go to /admin/ai/context/items to create context items. Each item contains information that agents can use when helping with tasks on your site. Content is written in markdown using the MDXEditor.

Step 3: Configure agent context

Go to /admin/ai/context/settings/agents to configure which context items each agent can access. For each agent you can set:

  • Scope subscriptions -- which scope values the agent should prioritize
  • Always include -- context items that are always provided to the agent
  • Never include -- context items explicitly excluded from the agent
  • Assigned items -- specific items manually assigned to the agent

See Agent configuration for full details.

Admin pages reference

Context management

Page Path
Overview /admin/ai/context/overview
Context items /admin/ai/context/items
Add context item /admin/ai/context/items/add
Usage /admin/ai/context/usage

Settings

Page Path
Settings (redirects to General) /admin/ai/context/settings
General settings /admin/ai/context/settings/general
Context item type settings /admin/ai/context/settings/items
Scope settings /admin/ai/context/settings/scope
Agent settings /admin/ai/context/settings/agents
Agent context edit /admin/ai/context/settings/agents/{agent_id}/edit
Usage settings /admin/ai/context/settings/usage
Clear usage records /admin/ai/context/settings/usage/clear

Entity routes

Page Path
View context item /admin/ai/context/items/{id}
Edit context item /admin/ai/context/items/{id}/edit
Delete context item /admin/ai/context/items/{id}/delete
Duplicate context item /admin/ai/context/items/{id}/duplicate
Revision history /admin/ai/context/items/{id}/revisions
View revision /admin/ai/context/items/{id}/revisions/{rev}/view
Revert revision /admin/ai/context/items/{id}/revisions/{rev}/revert
Delete revision /admin/ai/context/items/{id}/revisions/{rev}/delete
Usage record detail /admin/ai/context/usage/{usage_id}

Permissions

The module provides granular permissions at /admin/people/permissions/module/ai_context:

  • Administer AI Context -- manage settings and agent configurations
  • View AI Context Items -- view the context items listing
  • View any unpublished AI Context Item -- view unpublished items
  • Create AI Context Item -- create new context items
  • Edit own / Edit any AI Context Item -- edit context items
  • Delete own / Delete any AI Context Item -- delete context items
  • View / Revert / Delete all AI Context Item revisions -- revision management
  • Schedule publishing of AI Context Items -- use Scheduler features
  • View scheduled AI Context Item -- see scheduled items
  • View AI Context Usage -- access the usage tracking page