Skip to main content

Using the AI Assistant

FairTest includes an AI-powered chat assistant that can help you query your testing data and take actions using natural language.

Accessing the AI Assistant​

Click Chat in the main navigation to open the AI assistant.

What You Can Ask​

The assistant can search and analyse your organisation's data. Some example questions:

  • "How many tests did we run last month?"
  • "Show me all positive results this year"
  • "Which location has the highest positive rate?"
  • "List employees who haven't been tested in 6 months"
  • "What's our compliance rate for Q1?"
  • "Show me all selections from last week"
  • "Who are the managers in our team?"

Actions​

The AI assistant can perform actions on your behalf, not just answer questions. Some example requests:

  • "Run a 10% selection for the Melbourne warehouse"
  • "Log a negative urine test for Jane Doe"
  • "Add a new employee called Sam Wilson at Head Office"
  • "Move Sarah Connor to the Brisbane location"

The assistant will always confirm actions before executing them, so you can review what will happen before it proceeds.

What the Assistant Can Access​

The AI assistant has access to:

  • Test records — search by employee, location, result, status, date range
  • Test statistics — aggregate counts, positive rates, filtering by location
  • Employee data — search by name, location, department, job class, employment type
  • Selection events — search by status, date, selected employees
  • Setup entities — list your locations, departments, job classifications, pay types, test types
  • Team members — view team by role

Data Access Levels​

Your organisation can control what data the AI assistant can access. This is configured in Settings > AI Assistant:

LevelWhat the AI Can See
Full accessAll testing data including employee names and details
AnonymisedTest data with employee names and personal details redacted
Statistics onlyAggregate statistics only — no individual test records

AI Provider​

By default, FairTest uses its own managed AI service. Your organisation can optionally connect a custom AI provider in Settings > AI Assistant:

  • Anthropic (Claude)
  • OpenAI (GPT)
  • Azure OpenAI
  • Google (Gemini)

The current provider is shown at the bottom of the chat input.

Conversations​

  • Each conversation is saved automatically and can be resumed later
  • Conversations are titled automatically based on your first message
  • You can start a new conversation or delete old ones
  • Conversations are private to your user account and organisation

Tips​

  • Be specific with dates and filters for more accurate results
  • The assistant works best with clear, direct questions
  • You can ask follow-up questions — the assistant remembers the conversation context
  • Use it for quick data lookups instead of building a full report

Related Articles: