Configure A Lucidworks AI Gateway IntegrationLucidworks AI
Before you can use Lucidworks AI with Lucidworks Platform, you must configure the Lucidworks AI Gateway to provide a secure, authenticated integration between self-hosted Fusion and your hosted models. This configuration is done through a secret properties file that you can find in the Lucidworks Platform UI.
This feature is only available in Fusion 5.9.5 and later versions of Fusion 5.9. |
Integrations are created for you by the Lucidworks team. But as a workspace owner, you can configure those integrations with Lucidworks AI Gateway. Each account can have its own set of credentials and associated scopes, which define the operations it can perform. If configuration properties are not provided at the account level, default settings are used instead.
To configure the Lucidworks AI Gateway, navigate to the megamenu and click Models.
-
On the Integrations tab, click your integration. If you don’t see your integration, contact your Lucidworks representative.
-
Download or copy the YAML code and paste it into a file called
account.yaml
.The file for a single integration should look similar to this one:
lwai-gateway: lwai: credentials: | fusion.lwai.default.baseUrl: https://APPLICATION_ID.applications.lucidworks.com fusion.lwai.default.authEndpoint: https://identity.lucidworks.com/oauth2/XXXXXXXXXX/v1/token fusion.lwai.account[0].name: ACCOUNT_NAME fusion.lwai.account[0].scopes: machinelearning.predict,machinelearning.model fusion.lwai.account[0].clientId: ***** fusion.lwai.account[0].clientSecret: *****
For a configuration with multiple integrations, it should look like this:
lwai-gateway: lwai: credentials: | fusion.lwai.default.authEndpoint: https://identity.lucidworks.com/oauth2/XXXXXXXXXX/v1/token fusion.lwai.account[0].baseUrl: https://APPLICATION_ID.applications.lucidworks.com fusion.lwai.account[0].name: ACCOUNT_NAME fusion.lwai.account[0].scopes: machinelearning.predict,machinelearning.model fusion.lwai.account[0].clientId: ***** fusion.lwai.account[0].clientSecret: ***** fusion.lwai.account[1].baseUrl: https://APPLICATION_ID2.applications.lucidworks.com fusion.lwai.account[1].name: ACCOUNT_NAME fusion.lwai.account[1].scopes: machinelearning.predict,machinelearning.model fusion.lwai.account[1].clientId: ***** fusion.lwai.account[1].clientSecret: *****
Non-admin users must have the following permissions to use Lucidworks AI integrations: PUT,POST,GET:/LWAI-ACCOUNT-NAME/**
whereLWAI-ACCOUNT-NAME
must match the value offusion.lwai.account[n].name
in the integration YAML. -
Apply the file to your Fusion configuration file. For example:
helm upgrade KUBERNETES_NAMESPACE lucidworks/fusion -f FUSION_VALUES.yaml
You can confirm that the integration is working by configuring Neural Hybrid Search. |