1. Nutzung der Übersetzungsfunktion im TYPO3

Voraussetzung der Übersetzungsfunktion ist die Nutzung der Mehrsprachigkeit im TYPO3, also destination.language. Solltet Ihr diese nicht gebucht haben (weil Ihr bisher keine Fremdsprachen nutzt oder bspw. mit Drittanbietern (GTranslate, Conword,...) arbeitet, steht Euch diese Funktion nicht zur Verfügung. Kommt hier bei Bedarf auf Euren zuständige:n Ansprechpartner:in zu.

Welche Vorteile hat die Nutzung?

1. Das Übersetzen mit KI soll den aufwändigen, manuellen Übersetzungsprozess jeder Bühne und jedes Moduls erleichtern und spart damit sehr viel Zeit
   
2. Dennoch kann jede Übersetzung nach Bedarf von Euch nachgearbeitet und angepasst werden
   
3. Wir übernehmen 1:1 die Logik der bekannten Übersetzungsfunktion: Das bedeutet, Ihr habt die bekannten Freiheiten bei der Anpassung der URL-Pfade und die hreflang-Auszeichnungen werden ebenfalls wie bekannt übernommen.
   

Die Abrechnung der Übersetzungsanfragen im TYPO3 erfolgt über oi.Calls. Diese findet Ihr hier bei uns im Shop, sofern Ihr noch keine Lizenz oder Prepaid-Abrechnung gebucht habt: Hier geht es zum Shop. 100 oi.Calls pro Monat sind im Zuge einer vorhandenen destination.one Lizenz immer frei. 

1.1 Wo lege ich mein Modell für die Übersetzungen an?

Im ersten Step könnt Ihr ein Modell in der oi.platform anlegen. Im TYPO3 greift Ihr dann auf dieses Modell zurück. Solltet Ihr keine individuellen Prompts für die Übersetzung hinterlegen wollen, geht direkt weiter zu Schritt 1.2.

Die Anleitung für die Einrichtung eines Modells in der oi.platform findest Du hier.

Folgendes wird über das TYPO3 bereits als Prompt generiert und muss daher von Euch nicht im Prompt des Modells mit auftauchen.

Übersetze das JSON in die Sprache [en-GB]
-> Hier wird automatisiert die gewählte Sprache im TYPO3 übernommen. Ihr könnt also ein Modell für alle Sprachen nutzen oder je Sprache ein eigenes Modell anlegen. Das obliegt Euch.
Es ist außerdem sinnvoll, wenn Ihr keine technischen Infos im Prompt übergebt. Dieser sollte rein inhaltlicher Natur sein.

Beachte dabei folgende Vorgaben:

- Sprachstil: Verwende das Sprachniveau A1 (Anfänger).

-> Kann im TYPO3 im Drop-Down beeinflusst werden. Hier könnt Ihr im Prompt auch etwas anderes mitgeben, müsst Ihr aber nicht. 

- Ansprache: Formuliere konsequent in der Du-Form

-> Kann im TYPO3 im Drop-Down beeinflusst werden. Hier könnt Ihr im Prompt auch etwas anderes mitgeben, müsst Ihr aber nicht. 

- Tonalität: Achte darauf, dass die Tonalität objektiv ist.

-> Kann im TYPO3 im Drop-Down beeinflusst werden. Hier könnt Ihr im Prompt auch etwas anderes mitgeben, müsst Ihr aber nicht. 

-> Sofern Ihr im Prompt eine Info dazu mitgebt, wählt in der späteren Vorlage im Dropdown das leere Auswahlfeld aus.

- Formatierung

  - Antworte ausschließlich mit einem gültigen JSON-Objekt im gleichen Strukturformat wie die Eingabe.

  - Übersetze nur die Werte, behalte alle Schlüssel unverändert.

  - Verwende keine Markdown-Formatierung, keine zusätzlichen Erklärungen oder Kommentare.

1.2 Vorlagen für Übersetzungen im TYPO3 erstellen

Auf der rechten Seite über "+Neue Vorlage erstellen" könnt Ihr Vorlagen erstellen, auf die im Übersetzungsprozess zurückgegriffen werden soll. 

Die Vorlagen können nur von dem "one.intelligence Admin-User" erstellt und bearbeitet werden. Vgl. Einrichtung der one.intelligence Funktionen im TYPO3.

- Name der Vorlage

Wenn Euer gewünschtes Modell nicht in der Liste erscheint, kann es über den roten Button "Aktualisieren" helfen, einmal den Cache zu leeren.

Wenn Ihr Euch für ein passendes Modell entschieden habt (dies können eigens von Euch generierte Modelle, aber auch alle Open Source Large Language Modelle sein), müsst Ihr dies einfach nur einmal durch Anklicken auswählen.

Wichtig ist, dass das Modell übersetzen kann. Das Modell "one.intelligence" bspw. hat keine Übersetzungsfunktion.

Über den kleinen grauen Pfeil unter der Modellauswahl habt Ihr die Möglichkeit, ein Feld auszuklappen. Hier könnt Ihr den hinterlegten Prompt aus der oi.platform einsehen:

Weiter könnt Ihr Sprachstil (Sprachniveau), Ansprache und Tonalität der Vorlage einstellen.

2. Übersetzungen einzelner Seiten anstoßen

Um eine Seite mit KI zu übersetzen, ist es nicht notwendig, dass diese schon über die "Standard-Übersetzungsfunktion" vom TYPO3 angelegt wurde. Ihr könnt mit der Funktion bestehende Seiten überarbeiten oder Seiten ganz neu übersetzen.

Sucht Euch also eine beliebige Seite zum Übersetzen aus und klickt den grünen one.intelligence Button.

1. Schritt 1: Auswahl der Sprache
   Hier wählt Ihr nun die Sprache aus, in die übersetzt werden soll. Es stehen Euch nur die Sprachen zur Auswahl, die für Euer Projekt gebucht wurden. Ihr könnt hier eine Sprache oder direkt mehrere Sprachen auswählen. 
   

Wenn Ihr je ein spezielles Modell pro Sprache in der oi.platform gebaut habt, ist es sinnvoll, die Sprachen einzeln zu übersetzen, da in dieser Operation jeweils nur eine Vorlage gewählt werden kann. Das funktioniert dann mit mehreren Sprachen besser, wenn Ihr hier auf ein LLM zurück greift. 

1. Schritt 2: Auswahl der Inhaltselemente
   Hier wählt Ihr nun die Inhaltselemente aus, die übersetzt werden sollen. Da wir im Produkt mit dem freien Übersetzungsmodus arbeiten, müssen die Sprachseiten nicht 1:1 die Inhalte und Bühnen beinhalten, die die deutsche Basisseite beinhaltet. Hier werden Euch alle äußeren Inhaltselemente aufgelistet, die jeweils aktiviert oder deaktiviert werden können.
   
   
   
   Konkret bedeutet das, wenn Ihr bspw. eine erste Bühne habt, die aus einer einspaltigen Bühne, einem Text-Medien-Element und einem Button besteht, könnt Ihr nicht den Button oder das Text-Medien-Element einzeln übersetzen, sondern nur die gesamte Bühne inkl. aller innenliegenden Elemente.
   
   
2. Schritt 3: Übersetzungskonfiguration auswählen
   Nachdem Ihr alle zu übersetzenden Elemente ausgewählt habt, könnt Ihr nun die konkrete Übersetzungskonfiguration festlegen. Dazu wählt Ihr eine der zuvor angelegten Vorlagen aus:
   
   
   
   
   
   
   Auf Basis der Vorlage werden dann die Einstellungen für Sprachstil (Sprachniveau), Ansprache und Tonalität übernommen. Hier habt Ihr aber die Möglichkeit, für eine einzelne Operation, diese Konfiguration zu überschreiben und für diese einmalige Übersetzung eine andere Einstellung für Sprachstil (Sprachniveau), Ansprache und Tonalität auszuwählen.
   
   
   
3. Schritt 4: Bestätigung der Übersetzungs-Operation
   Im letzten Schritt werdet Ihr noch einmal aufgefordert, aktiv die Übersetzung anzustoßen. Hier findet Ihr eine Zusammenfassung der gewählten Aktionen im Überblick
   - Seitenanzahl
   - Sprachen
   - Anzahl der Inhaltselemente
   - Zeichenanzahl
   - Anzahl der oi.Calls
   
   

Wie werden die zu verbrauchenden oi.Calls berechnet?

Eine Anfrage = 1.000 Zeichen

1.000 Zeichen = 1 oi.Call

1. Schritt 5: Nach der Bestätigung der Übersetzung
   Sobald der Auftrag abgeschickt wurde, findet Ihr einen Status oben auf der soeben übersetzten Seite:
   
   Solange der Status "Warten" ist, könnt Ihr diesen noch abbrechen. Dann werden keine oi.Calls abgerechnet. 
   
   Für das Durchführen der Übersetzungen wird von uns ein sog. "Scheduler-Task" in Eurem Projekt angelegt. Dieser kann jede Stunde oder auch einmal in der Nach laufen. Diese Zeit können wir beliebig einstellen. Zwischenzeitlich werden alle Übersetzungsaufträge "gesammelt" und warten auf das Durchlaufen des Scheduler-Tasks.
   
   Beispiel: 
   Der Scheduler-Task wurde mit einem Zeitintervall zu jeder vollen Stunde eingetragen und es ist 11:10 Uhr. Ihr übersetzt zwischen 11:10 Uhr und 11:45 Uhr einige Seiten. Wann tauchen die Übersetzungen nun auf?
   -> Sobald der Scheduler-Task um 12:00 Uhr, also zur nächsten vollen Stunde, durchgelaufen ist.
   
   
2. Schritt 6: Einsehen des aktuellen Übersetzungsstandes
   Möchtet Ihr den Status Eurer Übersetzungen einsehen, gelangt Ihr dort wie folgt hin:
   -> one.intelligence -> Bulk-Übersetzungen -> "Übersetzung starten" (keine Sorge, hier wird direkt noch keine Übersetzung gestartet)
   Dort seht Ihr in der Tabelle dann den jewieligen Stand:
   
   
   Die genaue Bedeutung der Status findet Ihr unter Punkt 4. dieser Anleitung "Status der Übersetzungen".

3. Bulk-Übersetzungen

4. Status der Übersetzungen