Setup

1. Log in as admin
2. Go to Site admin -> General -> AI -> AI providers
3. Click 'Create a new provider instance'
4. Choose 'OpenAI API provider' and fill out all other required values (reach out if you need credentials)
5. Ensure 'Explain text' action is enabled on the provider
6. Ensure your new AI provider is enabled too
7. Go to Site admin -> General -> AI -> AI placements
8. Enable 'Course assistance placement'
9. Create a course
10. Add a 'Page' resource and add anything you like as the content.
11. View the page and click 'Explain' from the AI features actions.
12. Ensure it generates a response (we will need this for the next part).

Test

1. Go to Site admin -> Reports -> AI reports -> AI usage
2. CONFIRM you see the 'Explain text' entry in the report table
3. CONFIRM you see numeric values in the 'Prompt tokens' and 'Completion tokens' columns
4. Click the 'Filters' button
5. Set 'Prompt tokens' to 'Greater than' and enter 0
6. Set 'Completion tokens' to 'Greater than' and enter 0
7. CONFIRM you see the same record displayed for your 'Explain text' action

Code verified against automated checks.

Checked MDL-85106 using repository: https://github.com/davewoloszyn/moodle.git

• main (0 errors / 0 warnings) [branch: MDL-85106-main | CI Job]

_{More information about this report}

Built on: Fri Apr 4 04:36:21 UTC 2025

Launching automatic jobs for branch MDL-85106-main

• https://ci.moodle.org/view/Testing/job/DEV.02%20-%20Developer-requested%20PHPUnit/18927/ PHPUnit (sqlsrv)
• https://ci.moodle.org/view/Testing/job/DEV.01%20-%20Developer-requested%20Behat/64780/ Behat (NonJS - boost and classic)
• https://ci.moodle.org/view/Testing/job/DEV.01%20-%20Developer-requested%20Behat/64781/ Behat (Firefox - boost)
• https://ci.moodle.org/view/Testing/job/DEV.01%20-%20Developer-requested%20Behat/64782/ Behat (Firefox - classic)
• https://ci.moodle.org/view/Testing/job/DEV.01%20-%20Developer-requested%20Behat/64783/ App tests (stable app version)

Built on: Fri Apr 4 12:25:15 UTC 2025