Settings 

Provider configuration 

Providers, models and configurations are database-backed and managed in the LLM backend module — not via TypoScript. nr-llm does not read plugin.tx_nrllm TypoScript settings; any such constants/setup have no effect (this is true for both classic TypoScript templates and site sets).

To make the generic chat() / complete() entry points work without pinning a provider per call, set up a default configuration:

1. Open the LLM backend module.
2. Create a Provider (e.g. OpenAI) and store its API key as an nr-vault identifier — see API key protection.
3. Create a Model for that provider.
4. Create a Configuration bundling the model, then mark it active and default.

The Setup Wizard in the module walks through these steps.

Without an active default configuration, generic calls throw "No provider specified and no default provider configured".

Background worker 

A queued run reads its provider key in a process without a logged-in backend user (ADR-234). The setting is in the extension configuration of nr_llm, section worker.

Filling empty fields on save 

An installation can have empty fields written by AI after a save (ADR-237). The settings are in the extension configuration of nr_llm, section fieldFill. Nothing happens until fieldFill.fields is set.

When an editor changes and saves a record with such a field empty, a background run is queued and the save ends. A save that changes nothing queues nothing. A worker has to run (Background tasks from the command line and the scheduler). It writes the text as the user who saved, and only while the field is still empty. A failed run writes nothing, and Agent Runs shows what became of each answer.

Nothing is queued for a field the save itself emptied, for a page with hardly any text, for _cli_ or an import, for a copy or a translation made by TYPO3, or for a user who may not use the default configuration. The record's text is sent to the provider of the default configuration.

Vision editor actions 

The editor actions Set alternative text and Update file metadata send the image of the file to the model (ADR-235). The settings are in the extension configuration of nr_llm, section vision.

The action is not offered when the default configuration's model declares capabilities without vision. A model with an empty capability field passes. A configuration that selects its model by criteria has to require vision in its criteria. The prompt asks for the language of the backend user.

Environment variables 

# TYPO3 encryption key (used for API key encryption)
TYPO3_CONF_VARS__SYS__encryptionKey=your-key

Security 

// Strip markup and control characters from free-text input before it is
// sent to a provider. (GeneralUtility::removeXSS() was removed from the
// TYPO3 core and must not be used.)
$sanitizedInput = trim(strip_tags($userInput));

$response = $adapter->chatCompletion([
    ['role' => 'user', 'content' => $sanitizedInput],
]);

$response = $adapter->chatCompletion([
    ['role' => 'user', 'content' => $prompt],
]);

$safeOutput = htmlspecialchars(
    $response->content, ENT_QUOTES, 'UTF-8'
);

Logging 

use Psr\Log\LogLevel;
use TYPO3\CMS\Core\Log\Writer\FileWriter;

$GLOBALS['TYPO3_CONF_VARS']['LOG']
    ['Netresearch']['NrLlm'] = [
    'writerConfiguration' => [
        LogLevel::DEBUG => [
            FileWriter::class => [
                'logFileInfix' => 'nr_llm',
            ],
        ],
    ],
];

Log files: var/log/typo3_nr_llm_*.log

Caching 

The extension uses TYPO3's caching framework with cache identifier nrllm_responses.

No cache backend is specified — TYPO3 automatically uses the instance's default cache backend. If your instance has Redis, Valkey, or Memcached configured, nr-llm uses it transparently with zero configuration.

• Cache identifier: nrllm_responses
• Cache group: nrllm
• Default TTL: 3600 seconds (1 hour)
• Embeddings TTL: 86400 seconds (24 hours)

To override the backend for this cache specifically:

use TYPO3\CMS\Core\Cache\Backend\RedisBackend;

$GLOBALS['TYPO3_CONF_VARS']['SYS']['caching']
    ['cacheConfigurations']['nrllm_responses']
    ['backend'] = RedisBackend::class;

Clear cache:

vendor/bin/typo3 cache:flush --group=nrllm