fix: Support Azure OpenAI

[fipro78]

• Add configuration of OpenAI API version
• Add configuration of supportsDeveloperMessage
• If OpenAI API version is configured, use AzureOpenAI

Fixes #14711

What it does

It fixes #14711 and adds support for accessing an OpenAI model deployed on Azure.
To make this work, the AzureOpenAI class needs to be used, as described in the openai-node docs.

To build up the request with AzureOpenAI you need to pass a apiVersion. This PR therefore adds the option to configure the apiVersion in the settings. If no apiVersion is configured, the default OpenAI object is used for initialization.

I also noticed that it can happen, that the OpenAI model version deployed on Azure might not yet support the developer role. Therefore I also added the option to configure whether the developer role is supported or not, which defaults to true.

How to test

The reviewer would need to have an OpenAI model available in Azure and then configure a custom openai model like this:

{
  "ai-features.AiEnable.enableAI": true,
  "ai-features.openAiCustom.customOpenAiModels": [
    {
      "model": "gpt4o",
      "url": "<AZURE_OPENAI_API_BASE_URL>",
      "id": "azure-deployment",
      "apiKey": "<AZURE_OPENAI_API_KEY>",
      "apiVersion": "<AZURE_OPENAI_API_VERSION>",
      "supportsDeveloperMessage": false
    }
  ],
  "ai-features.agentSettings": {
    "Universal": {
      "languageModelRequirements": [
        {
          "purpose": "chat",
          "identifier": "azure-deployment"
        }
      ]
    },
    "Orchestrator": {
      "languageModelRequirements": [
        {
          "purpose": "agent-selection",
          "identifier": "azure-deployment"
        }
      ]
    }
  }
}

Of course a non Azure model deployment should still work as before.

Follow-ups

Breaking changes

• This PR introduces breaking changes and requires careful review. If yes, the breaking changes section in the changelog has been updated.

Attribution

Review checklist

• As an author, I have thoroughly tested my changes and carefully followed the review guidelines

Reminder for reviewers

• As a reviewer, I agree to behave in accordance with the review guidelines

[planger]

Thank you very much @fipro78!

Code looks good to me and existing behavior still seems to work fine. I can't test with Azure though, as I don't have an account at hand at the moment.

Can you please also add a short hint on how to configure/use this to the README.md of this package (like you did in the description of this PR)?

[fipro78]

@planger
Thanks for the review. I updated the readme.

[JonasHelming]

@planger I guess we can merge this then?

[sdirix]

Code looks good to me! I don't have an Azure key, so I did not test the new functionality however I did verify that the regular Open AI models continue working.