The IBM Watson Connector Suite is a collection of connectors that brings the IBM Watson cognitive services to the Mendix platform. For the latest documentation, please refer to our Mendix Docs.
-
Deploy an example application using the Mendix's IBM Watson Connector Suite by clicking on the following button (or follow this documentation).
-
When possible, IBM Watson services should be automatically configured. To check the service, please refer to the documentation here.
With this project and you will be ready to go using the Mendix Modeler to deploy locally or in the Mendix free tier (because this is an example app plus the connectors that point to several IBM Watson services).
- Mendix user account (sign up here)
- IBM Cloud account (sign up here)
- Mendix Modeler (only Windows-compatible) (download here)
These are the Watson APIs that have a connector implemented:
- Assistant (formerly Conversation) – Create Session
- Assistant (formerly Conversation) – Send Message
- Language Translation – Translate
- Language Translation – Get Identifiable Languages
- Language Translation – Get Models
- Text to Speech – Synthesize
- Speech to Text – Recognize Audio
- Tone Analyzer – Analyze Tone
- Visual Recognition – Classify Image
- Visual Recognition – Create Classifier
- Visual Recognition – Detect Faces
The project includes two modules that represent the list of available connectors and examples. Both modules are structured following the same categories used by IBM in its portfolio:
To be able to use the Watson Connector Suite in your project, you have to export the WatsonServices module and import it into the project where you want to use it:
Once you have imported the module into your project, you will have at your disposal the collection of new IBM Watson connectors to use in any microflow:
In your IBM Cloud console, every instance of a Watson service will have a section called "Service credentials", which will provide you the data in a format like this:
{
"credentials": {
"apikey": "<YOUR_API_KEY>",
"url": "<SERVICE_URL_PROVIDED_BY_IBM_CLOUD>"
}
}
Please follow the instructions in the example app to provide the service with the necessary credentials.
The Watson Connectors Suite will install the following dependencies in your project's userlib folder:
- java-sdk-x.y.z-jar-with-dependencies.jar
Note: Please be aware if you upgrade The Watson Connector Suite in your project, you will have to remove manually the old version of these dependencies.
- The ChatWidget doesn't show the username properly when the example app is deployed in a sandbox.
- Not all Watson services are available in all regions. The the Service availability document contains a comprehensive list of services and the regions where they are available.
This was built with the following:
- Mendix Modeler 7.15.1
- Eclipse IDE Neon
We use SemVer for versioning. For the versions available, see the tags on this repository.
This project is licensed under the Apache License v2 (for details, see the LICENSE file).