Installation

Use this guide to install or reinstall T3AC Premium (EXT:ns_t3ac) with the required AI Foundation setup. T3AC depends on AI Foundation (EXT:ns_t3af) for AI providers, models, prompts, shared services, and request handling.

Important

If you are upgrading from an older T3AC installation, remove the existing extension first and complete the license activation flow again. This helps TYPO3 load the latest package and required dependencies correctly.

Step 1 — Remove the Existing Extension

If you are upgrading, uninstall EXT:ns_t3ac from your TYPO3 installation before installing the latest version.

This step is required because older extension files or cached registrations may conflict with the new AI Foundation-based setup.

Step 2 — Update the License Manager

Install the latest version of EXT:ns_license before continuing.

The License Manager controls access to T3Planet Premium packages. Older versions may not download the latest extension package or dependency information correctly.

Step 3 — Re-Activate the License

Non-Composer Installation

Use this workflow when your project installs T3Planet extensions from the TYPO3 backend:

1. Open Admin Tools → License Manager.

2. Remove the currently activated license key.

3. Save the changes.

4. Enter the license key again.

5. Activate the license.

6. Confirm that the latest T3AC package is downloaded.

7. Confirm that AI Foundation (EXT:ns_t3af) is installed automatically or available after activation.

Composer Installation

Use this workflow when your TYPO3 project is managed with Composer:

1. Remove the old T3AC package from the project if it is already installed.

2. Check the T3Planet Composer repository configuration.

3. Update the only parameter so the project can download T3AC, T3CS, and AI Foundation:

   "only": [
     "nitsan/ns-t3ac",
     "nitsan/ns-t3cs",
     "nitsan/ns-t3af"
   ]
   

4. Install the latest T3AC package.

5. Run Composer update for the affected packages.

6. Verify that nitsan/ns-t3af is installed as a dependency.

Full license activation details: https://docs.t3planet.de/en/latest/License/LicenseActivation/Index.html

Step 4 — Install AI Foundation

AI Foundation (EXT:ns_t3af) is required before T3AC can be used. It provides the shared AI provider configuration, models, API access, logs, and service layer used by T3AC.

Composer installations should install AI Foundation automatically when the repository configuration is correct. Non-Composer users should verify that AI Foundation is installed after license activation.

Premium Version

For license activation and access to premium features, see: https://docs.t3planet.de/en/latest/License/Index.html

T3AC setup and AI Foundation

Before you use T3AC, install AI Foundation (EXT:ns_t3af). It is the parent extension and provides shared AI models, provider configuration, authentication, and core AI services for T3AC.

These extensions do not change how your website looks on the frontend. They work in the backend and support T3AC technically.

Please keep both extensions enabled.

T3AC

T3AC provides a central backend module where you can:

• Manage data sources such as sitemaps, PDFs, TYPO3 pages, web pages, and Q&A records.

• Run a training pipeline that keeps chatbot answers in sync with your project content.

• Configure and monitor the AI chatbot.

• View usage analytics for chatbot activity.

AI Foundation (ns_t3af)

AI Foundation is the shared AI infrastructure for T3Planet AI Universe extensions. Complete the parent setup first, then return to T3AC installation.

Helpful AI Foundation references:

• AI Foundation Installation

• AI Foundation Configuration

• AI Providers

Step 5 — Run Database Analyzer

After installing or updating the extension, apply all pending database changes:

1. Open Admin Tools.

2. Go to Maintenance.

3. Open Analyze Database Structure.

4. Apply all pending database schema updates.

Run this before using T3AC modules in the TYPO3 backend.

Step 6 — Configure the AI Provider

After installation:

1. Open AI Foundation in the TYPO3 backend.

2. Configure your preferred AI provider.

3. Save the provider and model configuration.

4. Verify the AI connection with a test request.

T3AC will not function correctly until AI Foundation has a working AI provider configuration.

Step 7 — Verify the Installation

Before handing the system to editors, verify that:

• EXT:ns_t3ac is installed and active.

• EXT:ns_t3af is installed and active.

• The T3AC license is active.

• Database Analyzer changes are applied.

• The AI provider is configured in AI Foundation.

• TYPO3 caches are cleared.

• T3AC backend modules load without errors.