Getting started using the OpenAI AI Integration (GPT/ChatGPT) in TLex, tlTerm, tlCorpus, tlDatabase
Following is a brief how-to on getting started using the new OpenAI AI integration in TLex, tlTerm, tlCorpus, tlDatabase.
See the User Guide for more details.
Note this functionality applies to versions 15 or higher.
Step 1: Obtain OpenAI API Key
You will firstly need a "secret API key" from OpenAI, which is a special code linked to your OpenAI account that you keep secret, that authenticates you to the OpenAI service - you plug this 'API key' into your TLex (or tlTerm etc.) settings, and it then uses the key to communicate with the OpenAI service.
- Go to https://platform.openai.com/
- Log in (if you don't have an account, you will need to create one) - if you are already using ChatGPT online, this is the same account
- Click on the your profile icon (typically near top right)
- Select 'View API keys' from the dropdown
- Create a secret key. Copy this to the clipboard - NB you will only be able to see it once (you can't later re-retrieve keys, though you may delete them)
Step 2: Enter OpenAI key in Settings (of TLex, tlTerm, tlCorpus, tlDatabase)
- Open TLex (or tlTerm, tlCorpus, tlDatabase etc.)
- Select the 'Tools/Options' menu command (or if using Mac, this will be under the Application menu, "Preferences")
- Select the 'User Preferences' tab
- Scroll to the OpenAI settings, and double-click on the "APIkey" setting
- Paste your secret key here
Please note you will need to repeat this for each application you use. Also note this is only stored in your local user settings, not inside any project files or database, so would also need to be repeated on other computers.
Note also that this is a third-party service, and (other than through e.g. customizing prompts or fine-tuning) we have no control over this service, and are not affiliated with OpenAI.
You can now start using the integrated AI functionality.
These are mainly available from all over the application, e.g. via right-click in Entry List, right-click in Tree View, from inside the integrated Word/Excel popup window, from the Multi-Document Smart-Search (e.g. if searching loaded TMX, XLIFF files etc.).
Just look for the menu commands labelled 'AI'
In tlCorpus, you can right-click on words anywhere in the search results to also access AI prompts.
Custom User Prompts
You can configure your own prompts, also via the above-described Settings/Preferences dialog - these will also appear on the AI menus.
See User Guide for more details
XML prompts and entry auto-creation
If entry auto-creation setting is enabled, then if the AI returns entry data in structured XML (it can be prompted to do so), TLex (or tlDatabase, tlTerm etc.) can auto-create entries. See the included samples and custom user prompts for more guidance.
You will notice all the AI menu commands have both a normal plain text return option, and a separate one labelled 'XML' - the plain ones are more 'human-friendly' but the XML ones are 'computer-friendly' and thus allow the applications like TLex, tlTerm, tlDatabase to do interesting and cool things like entry auto creation with the responses from the OpenAI service.
Also see the User Guide for more details.
Batch Mode and Automation
Commands like entry creation can be configured to run in batch/automation mode to e.g. create many entries at once - again, see the OpenAI settings in the application as well as the User Guide for more details.
You can also watch a video presentation of this here » that was presented live at 20th CODH seminar in Japan, 2023
The User Guide is accessible from the Help menu in the applications.
Sample Generative-AI Dictionary
You can browse the Sample generative-AI humor dictionary here » created by GPT/ChatGPT.