Azure AI API provider

New feature
in Moodle 4.5!

Moodle LMS's integration with Azure AI provides access to AI Actions such as generate text, generate an image or summarise course content.

More information about Azure AI can be found at https://learn.microsoft.com/en-us/azure/ai-services/openai

Requirements

An active Azure account. If you don't have one, you can create it through the Azure portal.

Ensure you have an active subscription to access Azure AI services. Obtain the API key and endpoint from the Azure Portal to authenticate your requests (This is found under the "Keys and Endpoint" section of your resource.)

Configuring Azure AI API provider

1. Go to Site administration -> General -> AI -> AI providers
2. Enable the "Azure AI API Provider" by clicking on the “Enabled” toggle.
3. Click on the "Azure AI API Provider" settings link.
4. In the “Settings” area proceed to configure the following:
   • Azure AI API key: You can find the key in your Azure AI account.
   • Azure AI API endpoint:  Enter the endpoint URL for your Azure AI API, in the following format: https://YOUR_RESOURCE_NAME.openai.azure.com.
   • Set site-wide rate limit:  An optional feature to limit the number of requests that the Azure AI API Provider can receive across the entire site every hour.
   • Maximum number of site-wide requests can be configured after enable “Set site-wide rate limit”.
   • Set user rate limit: An optional feature to limit the number of AI requests each user can make to this provider each hour.
   • Maximum number of requests per user can be configured after enabling “Set user rate limit”
5. In the “Actions” area you can control which available Actions are enabled and configure further Action settings.

Configuring Azure AI API Provider Actions

Azure AI Actions

The following Action settings are available for the Azure AI API Provider.

Generate text: You can configure the following settings:

• Deployment ID:  The unique identifier assigned to a specific model deployment, which you can find in the "Deployments" section of your Azure OpenAI resource in the Azure Portal.
• API version: The API specific version of the API you're interacting with, you can find the latest available version under the "API Management" section of your Azure OpenAI resource.
• System instruction: There are default system instructions in place to help direct the expected response format from the AI, but these can be customised to suit your specific needs. These are used to ensure a smooth user experience where only the requested text generation is returned, with no salutations, repetition of the request etc. It is therefore recommended these are not modified unless you are confident the change is absolutely necessary.

Summarise text: The required configuration is the same as for the Generate text Action.

Generate image: You can configure the following settings:

• Deployment ID: The unique identifier assigned to the specific DALL-E model deployment, which you can find in the "Deployments" section of your Azure OpenAI resource in the Azure Portal, allowing you to generate images via API requests.
• API version. The API specific version of the API you're interacting with, you can find the latest available version under the "API Management" section of your Azure OpenAI resource.

With all of the above enabled and configured, the Azure AI API Provider can be used for all of the AI Placements available in your Moodle LMS instance; Course Assistance and HTML Text Editor Placements. Don't forget to also enable and configure AI Placements settings.

Azure AI Provider - Generate text

Azure AI Provider - Generate image