Skip to main content
Initial module enablement, custom agent configuration, and document indexation must be performed by an Administrator.

Quick Start

The AI tools provided within Cleverschool are designed to demonstrate and deliver practical artificial intelligence capabilities directly to school staff without the complexities of personal account creation, subscription management, or school firewall restrictions. Follow these steps to get started with AI Tools:
1

Enable the AI Tools module

Navigate to Administration > Modules and locate the AI Tools module. Toggle the module to Enabled.
2

Open AI Tools

From the main navigation sidebar, select AI Tools (or navigate to /ai/index).
3

Accept the AI Terms of Use

Upon first opening the module, you will be directed to the AI Terms of Use (/ai/terms). Review the acceptable use guidelines—confirming that you will not enter pupil-identifiable information (PII) and acknowledging that you remain the human in the loop—and click Agree.
4

Explore the AI Image Studio

Select Image Generator from the AI Tools portal to create your first educational illustration, poster, or worksheet graphic.

Further Setup (Administrator Guide)

Creating custom Support Agents, managing document vector stores, and auditing school-wide token usage is managed by an Administrator.

1. Creating Custom Policy Support Agents

School administrators can configure dedicated AI assistants tailored to specific school operational domains (such as HR & Staff Absence Assistant, Curriculum Guidelines Bot, or Governors Handbook Assistant):
  1. On the AI Tools dashboard, click the Manage button in the header (or navigate to /ai/admin).
  2. Click New Agent to open the agent configuration modal:
    • Name: Descriptive title displayed on staff dashboard cards (e.g. Staff Policy Assistant).
    • Description: Brief summary explaining the agent’s scope to staff.
    • Instructions: Custom system instructions directing how the agent should behave (e.g. “Answer staff queries clearly and professionally using only uploaded policy documents. Always cite the document name.”).
    • Disclaimer: Reassurance text reminding staff to verify advice against primary source documents.
  3. Click Save to create the agent and provision its underlying vector store.

2. Attaching School Policy Documents (RAG)

To ground your agent in accurate school policies:
  1. In the AI Administration table, locate the agent and click Documents in the row menu (or navigate to /ai/admin/chat/{agent}).
  2. Browse available documents from your school’s Documents module or filter by document type.
  3. Select the relevant policies (e.g. Staff Code of Conduct, Attendance Policy, Leave of Absence Policy) and click Store.
  4. The system automatically extracts text, chunks content, and indexes semantic embeddings into the agent’s vector store for instant retrieval during staff chats.

3. Multi-Academy Trust (MAT) Synchronisation

If your school belongs to a Multi-Academy Trust:
  • Central trust administrators can author standardised support agents and vector stores at the central tenant level.
  • Click Sync on central agents to propagate them across all academies in the trust automatically.

Staff User Guide

Once the module is active and terms are acknowledged, staff can access tools directly from the portal:
  • Generating Images: Select Image Generator, pick an aspect ratio (Landscape, Square, or Portrait), type a descriptive prompt, and click Generate.
  • Editing Existing Images: Upload a photo or graphic, describe the desired changes (such as modifying backgrounds or adding elements), and synthesize updated versions.
  • Querying Support Agents: Click on any configured Support Agent card, type a policy question, and receive verified answers with clickable document citations.
  • Monitoring Usage: Click AI Activity in the top navigation bar to inspect your personal prompt and completion token statistics.

Next Steps & Guides

Tutorials & Practical Guides

Step-by-step guides for generating classroom media, uploading policy documents, and chatting with support agents.

Operational Workflows

Explore end-to-end lifecycles, prompt engineering tips, and token usage governance.