AI tools
AI tools help staff generate course content, questions and lesson materials using a configured AI provider.
Entitlement note
AI tools must be enabled for your tenant by the platform operator. If you do not see the AI menu items, contact your operator. See Entitlements and feature flags.
Screens
| Screen | Route | Who | Description |
|---|---|---|---|
| Prompt templates | /admin/ai-prompts | Admin, Moderator | Create and manage reusable prompt templates |
| AI usage | /admin/ai-usage | Admin | View token usage and request history per user |
| AI settings | /admin/ai-settings | Admin | Configure the active provider and model |
| Generate question | /question/ai-generate | Admin, Moderator, Teacher | Generate assessment questions using AI |
Supported providers
Configured via environment variables by the platform operator:
| Provider | Variables |
|---|---|
| OpenAI | AI_OPENAI_KEY, AI_OPENAI_MODEL |
| Azure OpenAI | AI_AZURE_KEY, AI_AZURE_ENDPOINT, AI_AZURE_DEPLOYMENT |
| Google Gemini | AI_GEMINI_KEY, AI_GEMINI_MODEL |
| Ollama (self-hosted) | AI_OLLAMA_BASE_URL, AI_OLLAMA_MODEL |
| HuggingFace | AI_HF_TOKEN, AI_HF_MODEL, AI_HF_BASE_URL |
The active provider is set with AI_ACTIVE_PROVIDER.
Prompt templates
Prompt templates are reusable instructions that pre-fill the AI generation form. Create them under AI tools → Prompt templates to standardise how staff generate content.
- Go to AI tools → Prompt templates and select New template.
- Enter a Name and the Prompt text.
- Select Save. The template is available to all staff in the generation form.
Generate a question with AI
- Go to Questions → Generate with AI (or open a course and select AI generate).
- Select a prompt template or enter a custom prompt.
- Select Generate. Review the output and edit as needed.
- Select Save to add the question to the course.
View AI usage
Go to AI tools → Usage to see token consumption and request counts by user and date range. Use this to monitor costs and identify heavy users.