Generation task

A GenerationTask represents one AI-generation request. Tasks are stored in the database table tx_ai3_domain_model_generation_task and managed through the Extbase GenerationTaskRepository.

Task lifecycle

Every task moves through a set of states defined by \Wegewerk\Ai3Core\Enums\Status:

Value	Meaning
`Pending`	Task created, waiting to be processed.
`Processing`	Reserved for future use (processing flag).
`Done`	AI generation completed; `result` is populated.
`Failed`	Generation failed; `error_message` is populated.
`Canceled`	Task was canceled before processing.

Field reference

status

Type: string (enum)
Default: Pending

Current lifecycle state. One of Pending, Processing, Done, Failed, Canceled.

prompt

Type: string
Default: (empty)

The text prompt sent to the AI endpoint.

image

Type: string
Default: (empty)

Optional path to an image passed to the capability endpoint.

capability

Type: string
Default: (empty)

Key of the registered capability (e.g. my_ext_summary). See Capability API.

record_table

Type: string
Default: (empty)

Name of the TYPO3 database table that owns the record being processed (e.g. tt_content).

record_field

Type: string
Default: (empty)

Name of the field within record_table that will receive the generated text.

record_uid

Type: int

UID of the owning record.

generate_language

Type: string
Default: (empty)

ISO language code passed to the capability endpoint.

result

Type: string
Default: (empty)

The text returned by the capability endpoint after a successful generation.

result_meta

Type: string
Default: (empty)

Optional JSON metadata returned alongside the result.

error_message

Type: string
Default: (empty)

Human-readable error description when status is Failed.

reviewed

Type: bool
Default: false

Set to true by an editor after reviewing the generated result.

generated_timestamp

Type: int (Unix timestamp)
Default: 0

Unix timestamp set when generation completes successfully.

GenerationTaskService

\Wegewerk\Ai3Core\Service\GenerationTaskService is the primary API for working with the task queue. Inject it via constructor:

Adding a generation task

use Wegewerk\Ai3Core\Domain\Model\Dto\AddGenerationTask;
use Wegewerk\Ai3Core\Service\GenerationTaskService;

$dto = new AddGenerationTask(
    status: 'Pending',
    prompt: 'Write a short product description.',
    image: '',
    capability: 'my_ext_summary',
    record_table: 'tt_content',
    record_field: 'bodytext',
    record_uid: 42,
    generateLanguage: 'en',
    parameters: '',
    result: '',
    result_meta: '',
    error_message: '',
);

$task = $this->generationTaskService->addTask($dto);

Useful query methods:

Method	Description
`getTask(int $uid)`	Latest task for `record_uid`.
`isTaskRunning(int $uid)`	`true` if status is Pending or Processing.
`hasGenerationDone(int $uid)`	`true` if the latest task is Done.
`getLatestResult(int $uid)`	Result string of the most recent Done task.
`isReviewed(int $uid)`	`true` if the latest task has been reviewed.
`setReviewed(GenerationTask $task)`	Marks the task as reviewed and persists.