The following instructions outline the necessary steps to set up Preemptive AI for Domino. Once completed, you will be able to use the demo email template to send AI requests to OpenAI's GPT 4.1 mini, a top-tier model known for its excellent balance between cost and performance.


The document assumes that you have basic Domino administration skills and are familiar with signing templates and creating databases. 


Use the link Preemptive sent you to download the latest version of Preemptive AI.


The provided software operates on a subscription model. Upon initial installation, it offers full functionality for 14 days, after which you must obtain either a trial license extension or a permanent license from Preemptive.


In the zip file, you will find four templates, (where x.x.x is the version number):

  • AI-Requests-x.x.x.ntf
  • AI-Proxy145-x.x.x.ntf (this is for Domino 14.5 and higher)
  • AI-Proxy-x.x.x.ntf (this is for Domino 12 and 14)
  • Mail-Demo-x.x.x.ntf. 


Unzip the files into a location accessible by the Domino Administrator client.


Using an ID that has "unrestricted methods and operations rights" in the security settings of the Domino server, sign the templates.


Create the AI-Proxy Database

  • Create a new AI Proxy Database on the Domino Server using the AI-Proxy.ntf template. Use the AI-Proxy145-x.x.x.ntf if you have a Domino 14.5 server; otherwise, use AI-Proxy-x.x.x.ntf. We recommend creating this database in a new folder named AI, located at the root of the Domino Data directory.

    When you create the database the product's license agreement will appear. Please review the agreement, and if you agree to the terms and conditions, kindly tick the box and close the form. If you do not wish to proceed, please close the form and remove the software. If the database is currently open, please close it.

  • Secure the ACL for this database so only Administrators and LocalDomainServers have ‘Manager’ access, and the assigned role [Admin]. Default access should be ‘Reader. Assign the Role of [Admin] to users that have administration rights to the database. 


Create the AI-Requests database

  • Create a new AI Requests Database on the same Domino Server using the AI-Requests.ntf template. We recommend creating it in the same directory as the AI Proxy database above. If the database is currently open, please close it.

  • Adjust the ACL of this database to be:
    -Default- Editor Create documents
    LocalDomainServers, User type: Server Group, Access: Manager, Role [ReadEverything] [Admin]
    LocalDomainAdmins, Usertype: Person Group, Access: Manager, Role [ReadEverything], [Admin]
    Make sure the Domino server hosting the database has Manager rights and the Roles, [ReadEverything], [Admin]


Note: The database also has a role called [ReadEverything]. Entities assigned with the role can see all requests within the database; otherwise, the documents should be protected by a readers field. Assign the role [Admin] to uses that can change the configuration of the database.


Configure the AI-Proxy database

  • Once the AI-Proxy. On the outline on the left-hand side of the navigator, click the settings button (if the settings button is missing, it means you have not been assigned the [Admin] role in the ACL), enter the details for the AI-Requests database you created above, and click on the Check Connection button to confirm the settings

  • If you possess a license key, enter it in the License Key field; otherwise, please leave it blank and make use of the trial period. Click Check License. Here is an example:

  • Save and close the Technical Settings document

  • By default, all instructions are configured to use the "Default" service, which utilizes OpenAI's GPT-4.1 mini service. Using OpenAI requires an access key. You can follow these instructions to obtain one.

  • Open the Default AI Service, enter the API Key, and save and close the document.


Configure the AI-Requests database

You now need to configure the AI-Requests database to connect to its corresponding AI-Proxy database

  • Open the AI-Requests database and select Settings (if the settings button is missing, it means you have not been assigned the [Admin] role in the ACL). 
  • Enter the AI Proxy database details. Check the settings and Save and Close the document.


Adjusting the Demo Mail template to work in your environment.

The demonstration mail template needs the location and name of your AI-Requests database.

  • Open the Mail-Demo.ntf with the Domino Designer.

  • In the navigator on the left-hand side, select Code, Script Libraries, and open the Preemptive-AI script library

  • Go to the (Declarations) section and adjust the values for AIRequestServer and AIRequestDB to match your environment.

  • Save the changes


Finally, replace the design of a test/demo mail database with the Mail-Demo-x.x.x.ntf (Preemptive AI Mail Demo). That database will now have Preemptive AI capabilities.


Recommended reading