Klassifikationsspezifische AI-Textgenerierung

Seit Version 5.6 besteht die Möglichkeit, taxonomie- bzw. kategoriespezifische Prompts für die KI-gestützte Textgenerierung zu definieren, wofür sich auch Attributprofile verwenden lassen. Dieses Kapitel erklärt an einem Beispiel, wie die KI-gestützte Textgenerierung für eine Kategorie der Primärtaxonomie und den Texttyp „PLAIN“ definiert wird. Zudem wird ein Attributprofil erstellt und als Basis für die Textgenerierung festgelegt, wobei dies optional ist.

Note
  • Die klassifikationsspezifische AI-Textgenerierung muss über die Property general.openaitext.classification.dependent aktiviert werden. Dazu wird die Property auf “true“ gesetzt.
  • Die Schritte bzgl. des Attributprofils sind optional. Falls kein Attributprofil für die Textgenerierung definiert wurde, wird eine Standardattributauswahl verwendet. Diese setzt sich zusammen aus den Attributen, welche über die Property attribute.identifier.textgen definiert wurden, sowie aus den Kategorieattributen der Kategorie des jeweiligen Produkts.
  • In diesem Beispiel werden die Kategorieeigschaften als lokalisierte Zeichenketten angelegt, so dass sich für die einzelnen Sprachen getrennte AIHub-Workflows konfigurieren lassen. Alternativ besteht auch die Möglichkeit, die Kategorieeigschaften als nicht lokalisierte Zeichenketten anzulegen. Dann kann ein einzelner AIHub-Workflow für alle Sprachen verwendet werden. Die Unterscheidung der Sprachen erfolgt innerhalb des AIHub-Workflows (prompt_<language>, z. B. prompt_en, prompt_fr etc.).
INFO
Die klassifikationsspezfische Generierung von Werten funktioniert auch für die Aktion “AI-Attributwertgenerierung“.

Kategorieeigenschaft für Texttypverknüpfung

In diesem Schritt wird die Kategorieeigenschaft definiert, über die der Texttyp an die Klassifikation geknüpft wird. In diesem Beispiel ist das Texttyp „Plain“, welcher an die Primärtaxonomie geknüpft wird. Später wird diese Kategorieeigenschaft verwendet, um den entsprechenden AIHub-Workflow in einer bestimmten Kategorie als Basis für die AI-Textgenerierung festzulegen.

Kategorieeigenschaft anlegen

In diesem Schritt wird die Kategorieeigenschaft angelegt:

  1. Das iPIM-CC-Modul aufrufen.
  2. In den Reiter „Konfiguration“ der Attributkonfiguration gehen.
  1. Auf den ERSTELLEN-Button klicken. Pfeil nach rechts Ein neuer Attributdatensatz mit leeren Eingabefeldern wird erzeugt. Lediglich im Feld „ID“ befindet sich ein Platzhalter.
  1. Den Identifier für die Kategorieeigenschaft in das „Attribut-ID“-Feld eingeben. Der erforderliche Identifier setzt sich zusammen aus einem Präfix und dem Indentifier des gewünschten Texttyps. Diese sind durch einen Unterstrich getrennt. In diesem Beispiel sind das „OPENAI_CONFIG“* und „PLAIN“. 
  2. Den Attributtyp „Zeichenkette, lokalisiert“ aus dem „Attributtyp“-Menü auswählen.
  3. Den Attributbereich „Kategorieeigenschaft“ aus dem „Bereich“-Menü  auswählen.
  4. Die Option „Optional“ aus dem „Pflichtfeld“-Menü  auswählen. Pfeil nach rechtsNachdem alle Pflichtfelder gefüllt wurden, wird der SPEICHERN-Button eingeblendet.
  5. Auf den SPEICHERN-Button klicken, um das Attribut bzw. die Kategorieeigenschaft zu speichern. Pfeil nach rechts Es wird eine Erfolgsmeldung eingeblendet. Das Attribut ist nun erstellt.
Note
*Das Präfix lässt sich über die Property general.openaitext.classification.prefix definieren. In diesem Beispiel wäre der Wert für die Property „OPENAI_CONFIG“.

Kategorieeigenschaft mit Klassifikation verknüpfen

In diesem Schritt wird die Kategorieeigenschaft an die Primärtaxonomie geknüpft:

  1. Den Reiter „Kategorien“ aktivieren.
  1. Auf den HINZUFÜGEN-Button klicken, um das entsprechende Dialogfenster aufzurufen.
  1. Über das „Versionen“-Menü die Primärtaxonomie auswählen.
  2. Einen Haken bei der Primärtaxonomie  setzen.
  3. Auf den SPEICHERN-Button klicken, um die Auswahl der Klassifikation abzuschließen.
    Das Dialogfenster schließt sich und es wird eine Erfolgsmeldung eingeblendet. Die Kategorieeigenschaft ist nun an die Primärtaxonomie geknüpft.

Kategorieeigenschaft für Attributprofilverknüpfung (optional)

In diesem Schritt wird eine weitere Kategorieeigenschaft definiert, über die ebenfalls ein Texttyp an eine Klassifikation geknüpft wird. In diesem Beispiel ist das Texttyp „PLAIN“, welcher an die Primärtaxonomie geknüpft wird. Später wird diese Kategorieeigenschaft verwendet, um ein Attributprofil festzulegen, welches in der jeweiligen Kategorie der Primärtaxonomie als Basis für die AI-Textgenerierung verwendet wird.

Kategorieeigenschaft anlegen

In diesem Schritt wird die Kategorieeigenschaft angelegt.

  1. Zurück in den Reiter „Konfiguration“ der Attributkonfiguration gehen.
  1. Auf den ERSTELLEN-Button klicken.Pfeil nach rechtsEs wird ein neuer Attributdatensatz mit leeren Eingabefeldern erzeugt. Lediglich im „ID“-Feld befindet sich ein Platzhalter.
  1. Den Identifier für die Kategorieeigenschaft in das „Attribut-ID“-Feld eingeben. Der erforderliche Identifier setzt sich zusammen aus einem Präfix und dem Indentifier des gewünschten Texttyps. Diese sind durch einen Unterstrich getrennt. In diesem Beispiel sind das „AI_TEXT_GEN_PROFILE“* und „PLAIN“. 
  2. Den Attributtyp „Zeichenkette, lokalisiert“ aus dem „Attributtyp“-Menü auswählen.
  3. Den Attributbereich „Kategorieeigenschaft“ aus dem „Bereich“-Menü  auswählen.
  4. Die Option „Optional“ aus dem „Pflichtfeld“-Menü  auswählen. Pfeil nach rechtsNachdem alle erforderlichen Eingaben vorgenommen wurden, wird der SPEICHERN-Button eingeblendet.
  5. Auf den SPEICHERN-Button klicken, um das Attribut bzw. die Kategorieeigenschaft zu speichern. Pfeil nach rechts Es wird eine Erfolgsmeldung eingeblendet. Das Attribut ist nun erstellt.
Note
*Das Präfix lässt sich über die Property general.openaitext.classification.profile definieren. In diesem Beispiel wäre der Wert für die Property „AI_TEXT_GEN_PROFILE“.

Kategorieeigenschaft mit Klassifikation verknüpfen

In diesem Schritt wird die Kategorieeigenschaft an die Primärtaxonomie geknüpft:

  1. Den Reiter „Kategorien“ aktivieren.
  1. Auf den HINZUFÜGEN-Button klicken, um das entsprechende Dialogfenster aufzurufen.
  1. Über das „Versionen“-Menü die Primärtaxonomie auswählen.
  2. Einen Haken bei der Primärtaxonomie  setzen.
  3. Auf den SPEICHERN-Button klicken, um die Auswahl der Klassifikation abzuschließen.
    Das Dialogfenster schließt sich und es wird eine Erfolgsmeldung eingeblendet. Die Kategorieeigenschaft ist nun an die Primärtaxonomie geknüpft.

Texttyp aktivieren

In diesem Schritt wird der Texttyp für die AI-Textgenerierung aktiviert. In diesem Beispiel ist das der Texttyp „PLAIN“. Um den Texttyp zu aktivieren, muss die Typeigenschaft AiGeneratedText (REST-API: KI-Generierter Text) auf „JA“ gesetzt werden:

  1. Den Abschnitt „Typen“ des Bereichs „Systemsetup“ von iPIM CC aufrufen.
  1. Aus dem „Typ auswählen“-Menü die Option „TEXT_TYPE“ auswählen.Pfeil nach rechtsDie bestehenden Texttypen werden in der Tabelle angegezeigt.
  1. Den Texttyp „PLAIN“ aus der Tabelle heraussuchen. Optional: Einen Suchbegriff in das Suchfeld eingeben, um die Auswahl der Texttypen anhand eines Suchbegriffs zu filtern.
  2. Auf den Attribute-Button klicken, um das Dialogfenster zum Auswählen von Typeigenschaften aufzurufen.
  1. Die Typeigenschaft AiGeneratedText (REST-API: KI-Generierter Text) aus der Liste heraussuchen. Gegebenenfalls einen Suchbegriff in das Suchfeld eingeben, um die Auswahl der Typeigenschaften anhand eines Suchbegriffs zu filtern.
  2. Die Typeigenschaft von der linken Spalte in die rechte Spalte übertragen, um die Typeigenschaft auszuwählen. Dazu auf die Typeigenschaft klicken.
  3. Auf den ÜBERNEHMEN-Button klicken, um die Auswahl der Typeigenschaft abzuschließen.
    Das Dialogfenster schließt sich und die Typeigenschaft wird in der Tabelle eingeblendet.
  1. In der Tabellenzeile des Texttyps „PLAIN“ in die Zelle der Spalte der Typeigenschaft doppelklicken.
  2. Die Option JA aus dem Menü auswählen.
  3. Die Tabellenzelle verlassen.
  4. Auf den ÜBERNEHMEN-Button klicken, um die Konfiguration der Typeigenschaft abzuschließen.
    Es wird eine Erfolgsmeldung eingeblendet. Der Texttyp ist nun für die KI-gestützte Textgenerierung aktiviert.

Attributprofil anlegen (optional)

In diesem Schritt wird das Attributprofil angelegt, dessen Attribute für die KI-gestützte Textgenerierung herangezogen wird. In diesem Beispiel wird eine Auswahl von Kategorieattributen zusammengestellt. Diese gehören zur Kategorie „Küchengeräte“ der Primärtaxonomie.

  1. In den Abschnitt „Profile“ des Bereichs „Attribute“ von iPIM CC gehen.
  1. Auf den ERSTELLEN-Button klicken, um das Dialogfenster zum Erstellen von Attributprofilen aufzurufen.
  1. Den Identifier für das Attributprofil in das „Identifier“-Feld eingeben.
  2. Den „Benutzer“-Radiobutton aktivieren.
  3. Den entsprechenden Benutzer* aus dem Menü auswählen.
  4. Auf die Schaltfläche Pfeil nach rechts klicken, um zum nächsten Slider zu gelangen.
  1. Den „Kategorieattribute“-Radiobutton aktivieren.
  2. Auf die Schaltfläche Pfeil nach rechts klicken, um zum nächsten Slider zu gelangen.
  1. Aus dem „Versionen“-Menü die Primärtaxonomie auswählen. Pfeil nach rechtsDie Verzeichnisstruktur der Primärtaxonomie wird unterhalb des Menüs eingeblendet.
  2. Die Kategorie aus dem Kategorienverzeichnis heraussuchen. Optional: Einen Suchbegriff in das Suchfeld eingeben, um die Auswahl der Kategorien anhand eines Suchbegriffs zu filtern.
  3. Auf die Kategorie klicken, um diese auszuwählen.
  4. Auf die SchaltflächePfeil nach rechts klicken, um zum nächsten Slider zu gelangen.
  1. Die gewünschten Attribute aus der Liste der verfügbaren Attribute heraussuchen. Optional: Einen Suchbegriff in das Suchfeld eingeben, um die Auswahl der Attribute anhand eines Suchbegriffs zu filtern.
  2. Das erste Attribut von der linken Spalte in die rechte Spalte  übertragen, um dieses auszuwählen. Dazu auf das Attribut klicken.
  3. Den Rest der gewünschten Attribute in rechte Spalte übertragen. 
  4. Auf den ÜBERNEHMEN-Button klicken, um die Erstellung des Attributprofils abzuschließen.
    Das Dialogfenster schließt sich und es erscheint eine Erfolgsmeldung. Das Attributprofil ist nun erstellt.
Note
*Der hier ausgewählte Benutzer muss der Property general.openaitext.profile.userid als Wert zugewiesen werden.

Kategorieeigenschaften konfigurieren

In diesem Beispiel wird für die Kategorie „Küchengeräte“ der Primärtaxonomie der entsprechende AIHub-Workflow für die Textgenerierung  festgelegt. Dazu wird dieser der zuvor erstellen Kategorieeigenschaft „OPENAI_CONFIG_PLAIN“ zugewiesen. Zudem wird das zuvor erstellte Attributprofil der Kategorie als Grundlage für die Textgenerierung zugewiesen, wobei dieser Schritt optional ist*:

  1. Das iPIM Portal aufrufen.
  2. Die „Taxonomien“-App öffnen.
  1. Über das oberste Menü in der Karte „Taxonomiesuche“ die Primärtaxonomie auswählen.Pfeil nach rechtsDas Kategorienverzeichnis der Primärtaxonomie wird im unteren Bereich der Karte eingeblendet.
  2. Die Kategorie aus dem Kategorienverzeichnis auswählen. Optional: Einen Suchbegriff in das Suchfeld eingeben, um die Auswahl der Kategorien anhand eines Suchbegriffs zu filtern.
  3. Auf die Kategorie klicken, um diese auszuwählen.
  4. Den Reiter „Taxonomie-Eigenschaften“ auswählen.
  5. Auf den EIGENSCHAFTEN HINZUFÜGEN-Button  klicken, um das Dialogfenster zum Auswählen von Kategorieeigenschaften auszurufen.
  1. Die Kategorieeigenschaften „OPENAI_CONFIG_PLAIN“ und „AI_TEXT_GEN_PROFILE_PLAIN“ aus der Liste heraussuchen. Optional: Einen Suchbegriff in das Suchfeld eingeben, um die Auswahl der Kategorieeigenschaften anhand eines Suchbegriffs zu filtern.
  2. Die beiden Kategorieeigenschaften von der linken Spalte in die rechte Spalte übertragen, um diese auszuwählen. Dazu jeweils auf die Kategorieeigenschaften klicken.
  3. Auf den ÜBERNEHMEN-Button klicken, um das Auswählen der Kategorieeigenschaften abzuschließen.
    Das Dialogfenster schließt sich und die Kategorieeigenschaften werden in der Tabelle angezeigt.
  1. In der Tabellenzeile der Kategorieeigenschaft „OPENAI_CONFIG_PLAIN“ in die Zelle der Spalte „Wert“ doppelklicken.
  2. Den Identifier des AIHub-Workflows eingeben. In diesem Beispiel ist das „create_product_description“.
  3. In der Tabellenzeile der Kategorieeigenschaft „AI_TEXT_GEN_PROFILE_PLAIN“ in die Zelle der Spalte „Wert“ doppelklicken.
  4. Den Identifier des zuvor angelegten Attributprofils eingeben (ai-att-profile).
  5. Auf den SPEICHERN-Button klicken, um die vorgenommenen Einstellungen zu speichern.
    Es erscheint eine Erfolgsmeldung. Die Kategorieeigenschaften sind nun konfiguriert.
Note
*Falls kein Attributprofil für die Textgenerierung festgelegt wird, wird eine Standardauswahl herangezogen. Diese umfasst die Attribute, welche über die Property attribute.identifier.textgen definiert wurden, sowie die Kategorieattribute der jeweiligen Produkte.