# local_ai_manager - Multi-tenant AI backend This plugin provides a fully functional AI backend. It can be used as alternative choice for the AI subsystem which is being shipped with Moodle 4.5. The AI manager provides the key feature of being a _**multi-tenant**_ AI backend which is the main reason you should be using this plugin for providing AI functionality in your moodle instance instead of the moodle core AI subsystem. CARE: Currently, plugins requiring the moodle AI subsystem are not compatible with the AI manager and vice versa. ## Features Key features are: - Multi-tenancy - Two subplugin types - *AI tool* (Namespace prefix `aitool`): A subplugin of this type basically connects an external AI tool like ChatGPT, Google Gemini, Dall-E, Ollama etc. to the moodle instance. - *AI purpose* (Namespace prefix `aipurpose`): This subplugin defines a purpose which is being used. For each purpose which is being used by frontend plugins you can define a different AI tool to be used, and you can even differentiate for different roles. - Customizability due to the provisioning of hooks that can be used to customize the handling of the tenants in your moodle instance - API functions both on PHP and JS side for connecting frontend plugins like: - Chatbot (https://github.com/mebis-lp/moodle-block_ai_chat) - AI text question type (https://github.com/marcusgreen/moodle-qtype_aitext) - Tiny AI tools (https://github.com/mebis-lp/moodle-tiny_ai) - AI control center (https://github.com/mebis-lp/moodle-block_ai_control) - ... probably more to come - Enabling/disabling of users of a tenant - Limiting requests per time for each role - Control if users with a certain role can access certain purposes - Detailed possibilities to monitor user usage - Possibility for teachers to see the prompts of students (can be customized/disabled by capabilities) - Frontend components that can be implemented in all frontend plugins: - Information about data being sent to external AI systems - Current usage/limits - Warning regarding how to deal with results of generative AI Currently supported AI tools: - OpenAI ChatGPT (also via Azure) - OpenAI TTS (also via Azure) - OpenAI Dall-E (also via Azure) - Google Gemini - Google Synthesize (text to speech) - Google Imagen 3 (via Vertex AI) - Ollama - Telli (Service for German schools) Currently available AI purposes: - Chat - Feedback - Image generation - Image to text - Single prompt - Translate - Text to speech # Tenants and accessing tenant config pages Once installed, the local_ai_manager plugin will register a navigation node in the primary navigation. If you do not want this, you can disable the navigation node by an admin setting of the local_ai_manager plugin. By clicking on the navigation node you will be redirected to the main configuration page of your tenant. For accessing the tenant config pages, you will need to have either the capability `local/ai_manager:manage` on the tenant context (system context by default, but can be customized by a hook) or `local/ai_manager:managetenents` on the system context. The selected tenant is being determined by the current user's configured tenant user field (which is an admin setting, currently you currently can select between `institution` (default) and `department`). If the field is empty for your user, this means that the "default tenant" is being used. If you want to make configurations for a different tenant than the one which is being automatically determined by the user field, you can just use the deeplink https://your_moodle_site.com/local/ai_manager/tenant_config.php?tenant=YOUR_TENANT_IDENTIFIER. Of course, you will need sufficient capabilities for being able to use that. ## Requirements As this plugin makes heavy usage of the hooks and dependency injection, you need at least Moodle 4.4 for running this plugin. ## Installing via uploaded ZIP file ## 1. Log in to your Moodle site as an admin and go to _Site administration > Plugins > Install plugins_. 2. Upload the ZIP file with the plugin code. You should only be prompted to add extra details if your plugin type is not automatically detected. 3. Check the plugin validation report and finish the installation. ## Installing manually ## The plugin can be also installed by putting the contents of this directory to {your/moodle/dirroot}/local/ai_manager Afterwards, log in to your Moodle site as an admin and go to _Site administration > Notifications_ to complete the installation. Alternatively, you can run $ php admin/cli/upgrade.php to complete the installation from the command line. ## License ## 2024, ISB Bayern Lead developer: Philipp Memmel This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see .