NORA l 360° AI berechtigen

Hinweis: Diese Dokumentation bezieht sich auf die aktuellste Version des Plugins NORA l 360° AI. Aktualisieren Sie das hier beschriebene Plugin, um die Dokumentation verwenden zu können.

Diese Dokumentation beschreibt das Berechtigungskonzept für NORA | 360° AI. Das Plugin verwendet die bestehenden Berechtigungssysteme von ALBERT | AI und NORA | 360° und legt automatisch erstellte Benutzergruppen an.

Übersicht

Damit ein Benutzer die NORA-Tools produktiv verwenden kann, müssen Berechtigungen auf drei Ebenen gegeben sein:

Ebene	Beschreibung
KI-Voreinstellung	Steuert, welche Benutzer die ausgelieferten NORA-KI-Voreinstellungen in der Modellauswahl im KI-Chat sehen und verwenden dürfen. Die KI-Voreinstellungen sind der NORA-Gruppe `GRP_agorum.smartorga.ai_ai_presets` zugewiesen.
KI-Tools	Steuert, welche Benutzer die einzelnen NORA-Tools und die Toolgruppe All NORA \| 360° Tools aufrufen dürfen. Die Tools sind der NORA-Gruppe `GRP_agorum.smartorga.ai_ai_tools` zugewiesen.
NORA \| 360° Objekte	Steuert, mit welchen Objekten der Benutzer tatsächlich arbeiten darf. Hierfür gelten die normalen Berechtigungen von NORA \| 360° und agorum core (NORA-Typberechtigungen und klassische Objekt-ACLs).

Automatisch angelegte Benutzergruppen

Beim Installieren des Plugins werden automatisch folgende Benutzergruppen erstellt:

Gruppe	Zweck	Wer sollte Mitglied sein?
`GRP_agorum.smartorga.ai_ai_presets`	Berechtigt die Verwendung der ausgelieferten KI-Voreinstellungen (NORA \| 360° und agorum_smartorga_ai_nora_base).	Alle Benutzer, die im Chat mit dem Preset NORA \| 360° arbeiten sollen.
`GRP_agorum.smartorga.ai_ai_tools`	Berechtigt die Verwendung der NORA-Tools und der Toolgruppe All NORA \| 360° Tools. Wird auch benötigt, wenn eigene Presets die NORA-Tools einbinden.	Alle Benutzer, die die NORA-Tools direkt (über eigene KI-Voreinstellungen) oder indirekt (über die Chat-KI-Voreinstellung NORA \| 360°) verwenden sollen.
`GRP_agorum.smartorga.ai_template_suggest`	Schaltet die KI-gestützte Vorlagenauswahl auf den NORA \| 360° Karten frei (Button Vorlagen). Nur für Mitglieder dieser Gruppe bewertet die KI die anlegbaren Vorlagen und stellt die passendsten voran.	Alle Benutzer, für die die KI-gestützte Vorlagenauswahl aktiv sein soll. Benutzer außerhalb dieser Gruppe sehen den Vorlagen-Button unverändert wie bisher.

Hinweis: Damit ein Benutzer produktiv im Chat mit NORA | 360° arbeiten kann, muss er in beiden Gruppen enthalten sein: einmal für die KI-Voreinstellung selbst und einmal für die darin verwendete Toolgruppe.

Berechtigungen vergeben

Die Berechtigungen vergeben Sie über folgende Benutzergruppen:

So finden Sie die Benutzergruppen:

Öffnen Sie links in der Seitenleiste Administration und dann Gruppen.
Öffnen Sie den Pfad:
```
agorum.smartorga.ai
```
Fügen Sie den beiden Benutzergruppen GRP_agorum.smartorga.ai_ai_presets und GRP_agorum.smartorga.ai_ai_tools die Mitglieder (Benutzer) hinzu, die die KI-Tools für die Arbeit mit NORA | 360° Objekten verwenden sollen.

Wechselwirkung mit NORA | 360° Berechtigungen

Zusätzlich zu den Berechtigungen für Presets und Tools gelten die regulären Berechtigungen von NORA | 360°. Damit die KI-Tools erfolgreich Objekte anlegen, aktualisieren oder suchen können, benötigt der Benutzer:

Die passenden NORA-Typberechtigungen (_create, _view, _search) für die betroffenen Objekttypen. Diese werden pro Objekttyp über automatisch angelegte Gruppen der Form GRP_acso2_<identifier>_create, GRP_acso2_<identifier>_view und GRP_acso2_<identifier>_search gesteuert.
Die klassischen agorum core Objekt-ACLs auf den konkreten Objekten, mit denen gearbeitet wird (Lese- und Schreibzugriff).

Ohne diese NORA-Berechtigungen weiß die KI zwar, wie sie die Tools aufrufen würde, die Tools erhalten aber vom NORA-System einen Fehler zurück.