FirstSpirit AI: Prompt-Konfiguration

Sie können Prompts für den Content Assistant, Analyze Assistant und Image Assistant gesammelt im FirstSpirit AI Configuration-Service und der FirstSpirit AI Configuration ProjectApp verwalten.

Die FirstSpiritAI Configuration ProjectApp wird bei Verwendung des FirstSpirit AI Configuration-Services automatisch für alle Projekte auf einem Server hinzugefügt.

Als Server-Admin können Sie Folgendes im FirstSpirit AI Configuration-Service konfigurieren:

• Plugins: Das Plugin definiert die Verbindung zwischen der FirstSpirit AI API und dem gewählten KI-Modell.
• System-Prompts: Diese Prompts werden bei der Ausführung jeder Operation verwendet. Sie werden benötigt, um die korrekte Interpretation und Ausführung von Operationen zu gewährleisten. System-Prompts können nur von System-Admins editiert werden.
• Globale Prompts: Globale Prompts stehen in allen Projekten eines Servers zur Verfügung. Sie können globale Prompts nur als Server-Admin auf Server-Ebene bearbeiten.
• Geteilte Prompts: Ähnlich den globalen Prompts stehen geteilte Prompts in allen Projekten eines Servers zur Verfügung. Geteilte Prompts können von Server- oder Projekt-Admins auf Server- oder Projekt-Ebene verwaltet werden.

Als Projekt-Admin können Sie Folgendes in der FirstSpirit AI Configuration ProjectApp konfigurieren:

• Projekt-Prompts: Diese Prompts stehen nur in individuellen Projekten zur Verfügung
• Geteilte Prompts

Globale, geteilte, und Projekt-Prompts bestehen aus folgenden Teilen die Sie konfigurieren können:

• Operationen: Eine Operation ist eine Aufgabenstellung die in einem der Assistenten oder in einem benutzerdefinierten Skript ausgeführt wird.
• Optionen: Sie können eine Option mit einer oder mehreren Operationen verknüpfen. Mit Optionen können Sie die Aufgabenstellung um vordefinierte Werte ergänzen.
• Tags: Verwenden Sie Tags, um Vorgänge und Optionen einem oder mehreren Assistenten oder benutzerdefinierten Skripten zuzuweisen. Sie können Tags auf allen Ebenen anpassen, um die Sichtbarkeit von Vorgängen und Optionen für Benutzer zu verwalten.

FirstSpirit AI Configuration

Konfigurieren Sie Prompts im FirstSpirit AI Configuration-Service:

• Navigieren Sie zur Modul-Liste.
  ServerManager > Server > Eigenschaften > Module
• Aktivieren Sie Dienste anzeigen und geben Sie "AI" in der Suchleiste ein.
  → Der FirstSpirit AI Configuration-Service wird in der Ergebnisliste angezeigt.
  
• Wählen Sie den Service aus und und klicken Sie auf Konfigurieren.
  → Ein neues Fenster wird geöffnet.
  

System-Prompts

System-Prompts ermöglichen die korrekte Verarbeitung von Eingabekomponenten und gewährleisten die reibungslose Generierung von Ausgabetext für jede Operation.

System-Prompts können von unterschiedlichem Typ sein, welcher in der Spalte Typ angezeigt wird:

• Standardwert: Crownpeak bietet Standardwerte für die System-Prompts sowohl für den Content Assistant als auch für den Analyze Assistant an. Standardwerte können nicht gelöscht werden.
• Geändert: Diese System-Prompts sind Standardwerte für System-Prompts die vom Server-Admin geändert wurden.
• Benutzerdefiniert: Benutzerdefinierte System-Prompts wurden von einem Server-Admin hinzugefügt und definiert.

Standardwerte für System-Prompts für den Content Assistant und den Analyze Assistant sind bereits vorkonfiguriert und voll funktionsfähig. Sie werden von Crownpeak auf dem neuesten Stand gehalten. Wir empfehlen, sie unverändert zu verwenden.

Bearbeiten eines Standardwertes eines System-Prompts

• Im Tab System Prompts, wählen Sie einen Prompt vom Typ Standardwert aus.
• Klicken Sie auf Bearbeiten.
  → Ein neues Fenster wird geöffnet in dem Sie den gewählten Prompt bearbeiten können.
  
• Klicken Sie auf OK um die Änderungen zu speichern.
  → Der Prompt ist als Geändert in der Typ-Spalte gekennzeichnet.

Wiederherstellen eines Standardwerts eines System-Prompts

• Wählen Sie im Tab System Prompts den geänderten Prompt aus, den Sie auf den Standardwert zurücksetzen möchten.
• Klicken Sie auf Bearbeiten.
  → Ein neues Fenster wird geöffnet.
• Klicken Sie auf Standard wiederherstellen.
  
• Klicken Sie auf OK, um Ihre Änderungen zu speichern.
  → Der wiederhergestellte System-Prompt wird in der Typ-Spalte wieder als Standardwert markiert.

Hinzufügen eines benutzerdefinierten System-Prompts

Sie können einen aufgabenspezifischen System-Prompt hinzufügen, um diesen bei Verwendung der FirstSpirit AI API in einem benutzerdefinierten Skript oder einer Modulaktion zu verwenden.

• Navigieren Sie zum Tab System Prompts in FirstSpirit AI Configuration.
• Klicken Sie auf Hinzufügen.
  → Ein neues Fenster wird geöffnet.
• Geben Sie im Feld Name einen beschreibenden Namen für Ihren benutzerdefinierten System-Prompt ein, z.B. "MyCustomAssistant: System".
  In Ihrem benutzerdefinierten Skript können Sie den in diesem Feld definierten Namen verwenden, um auf Ihren benutzerdefinierten System-Prompt zuzugreifen.
• Geben Sie im Feld Prompt einen Prompt ein.
• Klicken Sie auf OK, um Ihre Änderungen zu speichern.
  → Ihr neu erstellter System-Prompt erscheint in der Liste und ist in der Spalte Typ als Benutzerdefiniert markiert.

Globale Prompts

Sie können globale Prompts im Content Assistant, Analyze Assistant, Image Assistant oder einem benutzerdefinierten Skript verwenden. Globale Prompts sind in allen Projekten eines Servers verfügbar. Globale Operationen und Optionen können nur auf Server-Level von einem Server-Admin hinzugefügt, editiert oder gelöscht werden.

Globale Operationen und Optionen können die folgenden Quellen haben, die in der Spalte Quelle entweder im Tab Operationen oder Optionen angezeigt werden:

• Voreinstellung: Diese Einträge befinden sich im Originalzustand, wie sie von Crownpeak bereitgestellt wurden. Voreingestellte globale Prompts können nicht gelöscht werden.
• Voreinstellung (Geändert): Diese Einträge wurden von Crownpeak bereitgestellt, aber von einem Server-Admin bearbeitet.
• Global: Diese Einträge wurden von einem Server-Admin erstellt.

Hinzufügen einer Operation

• Klicken Sie im Tab Operationen auf Hinzufügen.
  → Ein neues Fenster wird geöffnet in dem Sie die neue Operation definieren können.
  

Sie können die ID verwenden, um diese bestimmte Operation in Ihrem benutzerdefinierten Skript oder Ihrer Modulaktion zu referenzieren.

• Geben Sie im Feld Name einen Namen für die Operation ein. Dieser Name wird dem Benutzer im ContentCreator angezeigt.
• (De-)Aktivieren Sie Tags für jeden Assistenten oder jedes benutzerdefinierte Skript oder Modulaktionen, in denen ein Benutzer diesen Vorgang verwenden können soll.
• Optional: Erstellen Sie einen neuen benutzerdefinierten Tag in der Eingabezeile Tags.
  → Die Operation wird direkt dem neu erstellten Tag zugewiesen.
• Geben Sie im Feld Prompt Ihren Prompt ein.

Weitere Informationen zur Prompt-Erstellung, finden Sie im Starterpaket und in den Prompting-Hinweisen.

• Optional: Aktivieren Sie die Checkbox Diese Operation benötigt Eingabetext um ausgeführt zu werden, wenn Ihr Prompt Eingabetext verwendet.
• Optional: Fügen Sie Ihrem Prompt eine oder mehrere Optionen durch Ankreuzen der entsprechenden Kästchen im Tab Optionen hinzu.
• Optional: Testen Sie Ihren Prompt.
• Optional: Verwenden Sie die Nach oben verschieben- und Nach unten verschieben-Schaltflächen oder Drag&Drop, um Operationen zu verschieben. Dadurch bestimmen Sie die Reihenfolge in der der Endbenutzer die Operationen im ContentCreator sieht.
• Klicken Sie auf OK, um Ihre Änderungen zu speichern.
  → Ihr Prompt erscheint in der Liste und ist in der Spalte Quelle als Global markiert ist.

Testen eines Prompts

• Wählen Sie einen Prompt aus und klicken Sie auf Bearbeiten.
  → Ein neues Fenster öffnet sich.
• Klicken Sie auf Test.
  → Ein neues Fenster wird geöffnet.
  
• Wählen Sie ein Test-Plugin, um Ihren Prompt in einer spezifischen Umgebung zu testen, z.B. ContentAssistantPromptConfigurationTestPlugin, um Ihre Eingabeaufforderung für die Verwendung im Content Assistant zu testen.
  → Der Text im Feld Beispieltext ändert sich je nach dem gewählten Test-Plugin.
• Optional: Bearbeiten Sie den Text im Feld Beispieltext..
• Klicken Sie auf Prompt testen.
  → Basierend auf Ihrem Prompt und dem bereitgestellten Beispieltext wird der generierte Text im Feld API-Antwort gestreamt.
• Optional: Bearbeiten Sie Ihren Prompt im Feld Prompt, wenn die API-Antwort unzufriedenstellend war, und testen Sie ihn erneut.
• Klicken Sie auf Prompt speichern.

Hinzufügen einer Option

• Im Tab Optionen klicken Sie auf Hinzufügen.
  → Ein neues Fenster wird geöffnet.
  

Sie können die ID verwenden, um diese bestimme Option in Ihrem benutzerdefinierten Skript oder Ihrer Modulaktion zu referenzieren.

• Im Feld Name geben Sie einen Namen für die Option ein.
• Klicken Sie im Tab Prompts auf Hinzufügen, um einen Optionswert hinzuzufügen.
  → Ein neues Fenster wird geöffnet.
  
• Geben Sie im Feld Name den Namen des Optionswertes ein.
  → Der Benutzer kann den Wert unter diesem Namen im Dropdown der Option im Content Creator auswählen.

Sie können die ID verwenden, um diesen bestimmten Optionswert in Ihrem benutzerdefinierten Skript oder Ihrer Modulaktion zu referenzieren.

• Im Prompt-Feld geben Sie einenwertbezogenen Prompt ein.
• Klicken Sie auf OK, um Ihre Änderungen zu speichern.
• Erstellen Sie so viele Werte wie nötig für die Option.
• Optional: Verwenden Sie die Schaltflächen Nach oben verschieben und Nach unten verschieben oder Drag&Drop, um Optionswerte zu verschieben. Dies stellt die Reihenfolge dar, die der Endbenutzer im ContentCreator sieht.
• Wählen Sie im Operations-Tab eine oder mehrere Checkboxen aus.
  → Die Option ist mit den ausgewählten Operationen verbunden.
• Klicken Sie auf OK, um Ihre Änderungen zu speichern.

Duplizieren einer Operation oder Option

• Wählen Sie im Tab Operationen oder Optionen eine Eintragung aus und klicken Sie auf Duplizieren.
  → Der Eintrag wird kopiert und auf Ihrer aktuellen Ebene gespeichert.
• Optional: Wenn die duplizierte Operation mit Optionen kombiniert ist:
  Wählen Sie im Pop-Up Duplizieren, wenn die mit der Operation verbundenen Optionen ebenfalls dupliziert werden sollen. Wählen Sie Referenzieren, wenn die bereits vorhandenen Optionen mit der duplizierten Operation verknüpft werden sollen.
• Optional: Passen Sie den Prompt oder andere Einstellungen der duplizierten Operation oder Option an.

Hinzufügen eines Tags

Erstellen Sie einen benutzerdefinierten Tag, um Operationen benutzerdefinierten Skripten oder Modulaktionen zuzuweisen.

• Klicken Sie im Tab Tags auf Hinzufügen.
  → Ein neues Fenster wird geöffnet.
  
• Geben Sie im Feld Tag einen Namen ein, z. B. MyCustomAssistant.
• Wählen Sie im Tab Operationen die Operationen für Ihren benutzerdefinierten Tag aus.
• Klicken Sie auf OK, um Ihre Änderungen zu speichern.
  → Ihr benutzerdefinierter Tag erscheint in der Liste und ist nicht als Standard gekennzeichnet.

Zuweisen eines Tags zu mehreren Operationen

• Im Tab Tags wählen Sie einen bestehenden Tag aus.
• Klicken Sie auf Bearbeiten.
  → Ein neues Fenster wird geöffnet.
• (De-)Aktivieren Sie Operationen für den Tag.
• Klicken Sie auf OK, um Ihre Änderungen zu speichern.

Geteilte Prompts

Geteilte Prompts sind in allen Projekten auf einem bestimmten Server verfügbar. Im Gegensatz zu globalen Prompts können Sie geteilte Prompts auch in der Konfiguration einzelner Projekte bearbeiten.

Während globale Operationen und Optionen auch im Tab Geteilte Prompts sichtbar sind, können Sie die Prompts selbst nur im Tab Globale Prompts ändern. Sie können auch Tags für globale Prompts im Tab Geteilte Prompts anpassen.

Das Verwalten von geteilten Operationen, Optionen und Tags ist identisch zu globalen Prompts:

• Hinzufügen einer Operation
• Testen eines Prompts
• Hinzufügen einer Option
• Duplizieren einer Operation oder Option
• Zuordnen eines Tags zu mehreren Operationen
• Hinzufügen eines Tags

Jede Operation, Option oder Tag, den Sie im Tab Geteilte Prompts hinzufügen, wird in der Spalte Quelle als Geteilt markiert.

FirstSpirit AI Configuration ProjectApp

Konfigurieren Sie Prompts in der FirstSpirit AI Configuration ProjectApp:

• Öffnen Sie die Projektkomponenten des Projekts.
  ServerManager > Projekt > Eigenschaften > [Projektauswahl] > Projekt-Komponenten
• Wählen Sie die FirstSpirit AI Configuration ProjectApp aus.
• Klicken Sie auf Konfigurieren.
  → Ein neues Fenster wird geöffnet.
  

Projekt-Prompts sind spezifisch für einzelne Projekte und können nur in der FirstSpirit AI Configuration ProjectApp hinzugefügt, bearbeitet oder gelöscht werden.

Das Verwalten von Projektoperationen, -optionen und Tags ist identisch zu globalen Prompts:

• Hinzufügen einer Operation
• Testen eines Prompts
• Hinzufügen einer Option
• Duplizieren einer Operation oder Option
• Zuweisen eines Tags zu mehreren Operationen
• Hinzufügen eines Tags

Jede Operation, Option oder Tag, die Sie im Konfigurationsfenster hinzufügen, wird in der Spalte Quelle als Projekt gekennzeichnet.

Geteilte Prompts

Zusätzlich zur Verwaltung von Projekt-Prompts können Sie als Projekt-Admin auch geteilte Prompts auf Projektebene konfigurieren.

• Im Konfigurationsfenster klicken Sie auf Geteilte Prompts bearbeiten.
  → Ein neues Geteilte Prompts-Fenster wird geöffnet.
  
• Fügen Sie einen geteilten Prompt hinzu, entfernen, bearbeiten oder duplizieren Sie ihn.
• Klicken Sie auf OK, um Ihre Änderungen zu speichern.
  → Ihre Änderungen werden serverweit angewendet.