Skip to main content
This page is only for upgrading from an old version (before v14) to version 14. For a new installation, use Installation.

​
Overview

Since version 14, AI Search works together with AI Foundation (ns_t3af). AI Foundation now holds the connection to your AI service (API keys, models and prompts). AI Search still does the search, the training and the statistics. Do the steps below in the given order. Skipping a step can cause missing settings or errors.

​
Before Updating

  • Test the upgrade on a copy of your website (staging) first.
  • Check that your server meets the requirements: TYPO3 v12, v13 or v14 and PHP 8.2 – 8.5 (see TYPO3 v12, v13 and v14).
  • Have the API keys of your AI service ready. You will enter them again in AI Foundation.

​
Migration Steps

​
Backup Project

  1. Make a full backup of your website files and database.
  2. Write down your AI API keys.
With a backup of the trained data you don’t need to train your content again. Ask your developer to back up the tables listed under “For developers” below.

​
Upgrade

  1. Install or update AI Foundation (ns_t3af).
  2. In AI Foundation, add your AI provider and API key (see AI Providers).
  3. Test the provider connection.
  4. Install or update AI Search.
  5. Go to Admin Tools → Maintenance (on TYPO3 v14: System → Maintenance) and run Analyze Database Structure. Apply all changes.
  6. Go to Admin Tools → Upgrade → Upgrade Wizard (on TYPO3 v14: System → Upgrade) and run all wizards for AI Search and AI Chatbot/Search.
  7. Clear all caches.
  8. Check the settings that moved out of the site configuration. 1. Go to AI Universe → AI Chatbot/Search → Search.
  9. Your old values are already filled in. Check them.
  10. Click Save Configuration. Only then are they saved.
  11. Sync your data sources again if needed, and run the training.
  12. Search for something on your website and check the answer.
On TYPO3 13.4 and v14 this list includes EXT:ns_t3as: Migrate T3AS Search plugin to content type. It converts your existing AI Search plugins to the new content element type.
See Upgrading? Where your old settings moved

​
After the update, check

  • The Dashboard shows the right AI provider and model.
  • One data source can be synced, and training runs without errors.
  • Search for something on your website and check the answer.
  • The Scheduler task for training still runs.
  • AI Logs show no errors (see AI Usage & Logs).

​
Common Migration Issues

  • AI Foundation is not installed – AI Search needs it. Install AI Foundation.
  • AI provider not connected – add a provider in AI Foundation, set it as default, save and test the connection.
  • Answers are empty or weak – check the prompts, data sources and the Training Center.
  • Training does not run – check that the Scheduler task exists and that your server runs the Scheduler.
Back up the database tables of the extension before you reinstall. They hold the trained data.
  • Back up all tables that start with tx_nst3cs_ and tx_nst3as_.
  • After the reinstall, open the Database Analyzer (Admin Tools → Maintenance → Analyze Database Structure) and apply the changes. It adds an index that keeps the search fast.