Extension Integration

​

Purpose

​

Request lifecycle

1. Your extension builds the prompt and context.
2. Your service calls AiServiceInterface.
3. T3AF resolves the requested provider or the default provider.
4. The matching adapter performs the completion, stream, or embedding request.
5. Request metadata is logged for usage, analytics, and troubleshooting.

​

Dependency injection

use NITSAN\NsT3AF\Api\AiServiceInterface;

final class MyAiService
{
    public function __construct(
        private readonly AiServiceInterface $aiService,
    ) {}
}

​

Minimal working example

use NITSAN\NsT3AF\Api\AiOptions;
use NITSAN\NsT3AF\Api\AiServiceInterface;

final class SeoDescriptionGenerator
{
    public function __construct(
        private readonly AiServiceInterface $aiService,
    ) {}

    public function generate(string $prompt, int $pageUid): string
    {
        $response = $this->aiService->complete(
            $prompt,
            new AiOptions(
                extensionKey: 'my_extension',
                featureKey: 'seo.meta_description',
                featureLabel: 'SEO meta description',
                requestSource: 'backend_module',
                contentEntityType: 'pages',
                contentEntityUid: $pageUid,
            ),
        );

        return $response->content;
    }
}

​

What to put in AiOptions

​

Best practices

• Use AiServiceInterface as the only runtime AI integration surface.
• Keep featureKey stable so analytics history remains meaningful.
• Treat AI output as untrusted content before rendering or saving it.
• Do not log API keys, provider secrets, or sensitive prompt payloads.
• Handle provider failures and empty responses in your feature code.
• For CLI or Scheduler usage, configure an absolute TYPO3 site base URL when required by your environment.

​

Troubleshooting

• Confirm a provider is connected in T3AF > AI Providers.
• Confirm your feature-level provider override, if used, points to an enabled provider.

• Confirm extensionKey and featureKey are set in AiOptions.
• Check AI Usage & Logs.

​

Related documentation

• Feature Provider Overrides
• Custom AI Providers
• AI Providers
• AI Usage & Logs