Collaboration (Beta), 2025.13
FirstSpirit Collaboration: Konfiguration von KI-Agenten
Um den FirstSpirit-AI-Agenten oder benutzerdefinierte KI-Agenten konfigurieren und nutzen zu können, müssen Sie Kunde der FirstSpirit AI Suite sein.
Der FirstSpirit-AI-Agent ist bereits für Sie angelegt, und Sie können ihn direkt verwenden. Um andere benutzerdefinierte KI-Agenten in FirstSpirit Collaboration nutzen zu können, müssen diese entsprechend in der Prompt-Konfiguration im ContentCreator oder im ServerManager angelegt werden.
Anlegen eines KI-Agenten für FirstSpirit Collaboration
Das Anlegen neuer Agenten ist ausschließlich Projektadministratoren vorbehalten. Um einen KI-Agenten in der ContentCreator Prompt-Konfiguration zu erstellen:
- Öffnen Sie die ContentCreator Prompt-Konfiguration.
- Legen Sie eine neue Operation an.
- Geben Sie im Feld Name einen Namen für den Agenten ein.
Der Operationsname kann aus Buchstaben, Zahlen und den folgenden Sonderzeichen bestehen: "-", "_", ".", "#", ")", "(". Leerzeichen sind nicht erlaubt.
Um Operationen eindeutig als Collaboration-Agent zu kennzeichnen, können Sie optional dem Namen den Präfix "Collaboration:" voranstellen. Zwischen dem Präfix und dem Agenten-Namen ist ein Leerzeichen notwendig. Im ContentCreator wird dem Benutzer weiterhin nur der eigentliche Name angezeigt.
Agenten werden vom Benutzer in Collaboration mit "@< NAME >" angesprochen.
Um Operationen eindeutig als Collaboration-Agent zu kennzeichnen, können Sie optional dem Namen den Präfix "Collaboration:" voranstellen. Zwischen dem Präfix und dem Agenten-Namen ist ein Leerzeichen notwendig. Im ContentCreator wird dem Benutzer weiterhin nur der eigentliche Name angezeigt.
Agenten werden vom Benutzer in Collaboration mit "@< NAME >" angesprochen.
- Aktivieren Sie die Sichtbarkeit der Operation für Collaboration.
- Geben Sie im Feld Prompt Ihren Prompt ein.
Optional: Verwenden Sie Platzhalter im Prompt um Kontext für den Agenten bereitzustellen. - Optional: Erlauben Sie dem Agenten Zugriff auf Funktionen.
Funktionen erweitern die Fähigkeiten von KI-Agenten und ermöglichen ihnen, auf ihre Umgebung einzuwirken. Funktionen können etwa für Agenten Informationen bereitstellen, oder bilden Aktionen ab, die von einem Agenten ausgeführt werden können.
Bereitstellung von Kontext
Um dem Agenten Kontext bereitzustellen, können Sie die folgenden Platzhalter im Agent-Prompt verwenden. Durch die Verwendung dieser Platzhalter erhält der Agent alle relevanten Informationen, um präzise und kontextbezogene Antworten zu liefern:
- $AI.COMMENTS.THREAD$: Enthält die Historie des aktuellen Kommentar-Threads. Der Agent kann diese Informationen nutzen, um den Verlauf der Diskussion innerhalb dieses Threads zu berücksichtigen und darauf Bezug zu nehmen.
- $AI.CONTENT.EDITOR$: Enthält die aktuellen Formulardaten für die Eingabekomponente auf die sich der aktuelle Kommentar bezieht. Diese Daten spiegeln den aktuellen Bearbeitungsstand wider und ermöglichen dem Agenten, präzise Vorschläge oder Anpassungen zu liefern.
- $AI.CONTENT.PAGE$: Enthält die Formulardaten für die gesamte Seite. Der Agent kann so den Kontext der gesamten Seite verstehen, nicht nur einzelner Inhalte im Editor.
- $AI.USER.REQUEST$: Enthält die aktuelle Chatnachricht des Benutzers an den Agenten. Dies ist die direkte Anfrage oder Frage, auf die der Agent reagieren soll.
- $FS.PROJECT.ID$: Enthält die eindeutige ID des FirstSpirit-Projekts.
- $FS.PROJECT.NAME$: Enthält den Namen des FirstSpirit-Projekts.
Wenn nur die Chatnachricht als Prompt verwendet werden soll, genügt es, in der Prompt-Konfiguration ausschließlich den Platzhalter $AI.USER.REQUEST$ zu verwenden.
Die Platzhalter werden in der Konfiguration des FirstSpirit-AI-Agenten verwendet. Der Prompt des FirstSpirit-AI-Agenten ist für Projektadministratoren einsehbar. Sie können den Prompt einsehen und sich bei der Verwendung der Platzhalter daran orientieren.