ALBERT | AI Agents berechtigen

Hinweis: Diese Dokumentation bezieht sich auf die aktuellste Version des Plugins ALBERT | AI Agents. Aktualisieren Sie das hier beschriebene Plugin, um die Dokumentation verwenden zu können.

Diese Dokumentation zeigt, wie Sie das Plugin berechtigen, damit Benutzer KI-Tools und KI-Agenten in agorum core pro verwenden können.

Berechtigungen vergeben

Die Berechtigungen vergeben Sie über folgende ACLs und Benutzergruppen:

ACL	Benutzergruppe	Beschreibung
ACL_agorum.ai.agents_chat_debug	GRP_agorum.ai.agents_chat_debug	Berechtigt Benutzer, zusätzlich die Debug-Funktionalität im KI-Chat über die Schaltfläche zu nutzen.
ACL_agorum.ai.agents_tools_setup	GRP_agorum.ai.agents_tools_setup	Berechtigt Benutzer, die Einstellungen zum KI-Chat zu öffnen (unter > Administration > Konfiguration > KI-Tools).
ACL_agorum.ai.agents_details_chat	GRP_agorum.ai.agents_details_chat	Steuert die Anzeige des zusätzlichen Reiters ALBERT \| AI im Detailfenster
ACL_agorum.ai.agents.library.basic	GRP_agorum.ai.agents.library.basic_ai_tools	Berechtigt Benutzer zur Verwendung der mitgelieferten Basis-KI-Tools.
ACL_agorum.ai.agents.library.basic.setupKnowledge		Berechtigt Benutzer, die Einstellungen zum KI-Chat zu öffnen (unter > Administration > Konfiguration > KI-Wissen).
ACL_agorum.ai.agents.library.basic.database		Berechtigt Benutzer zur Verwendung der mitgelieferten Basis-KI-Wissens.

So finden Sie die Gruppen:

Öffnen Sie links in der Seitenleiste Administration und dann Gruppen.
Öffnen Sie den folgenden Pfad, um die Benutzergruppen für die KI-Agenten und KI-Tools zu finden:
```
agorum.ai.agents
```
Öffenen Sie den folgenden Pfad, um die Benutzergruppen für die Basistools zu finden:
```
agorum.ai.agents.library.basic
```
Fügen Sie in die entsprechende Benutzergruppe Ihre Benutzergruppen oder Benutzer ein.

So finden Sie die ACLs:

Öffnen Sie links in der Seitenleiste Administration und dann ACLs/Rechte.
Öffnen Sie den folgenden Pfad für die ACLs für die KI-Agenten und KI-Tools:
```
agorum.ai.agents
```
Öffnen Sie den folgenden Pfad für die ACLs für die Basistools und das Basiswissen:
```
agorum.ai.agents.library.basic
```

Zusammenspiel mit Benutzergruppen in KI-Voreinstellungen

Neben den oben genannten ACLs und Benutzergruppen gibt es eine weitere Ebene der Zugriffsverwaltung: die Benutzergruppe, die direkt in jeder KI-Voreinstellung (Preset), jedem KI-Tool, jedem Handler und jedem Agenten konfiguriert werden kann.

Wie funktioniert das Zusammenspiel?

Die Berechtigungen wirken auf zwei Ebenen:

Ebene	Steuerung über	Wirkung
Grundzugriff auf KI-Funktionen	ACLs und Benutzergruppen (diese Dokumentation)	Steuert, ob ein Benutzer überhaupt den KI-Chat, die Debug-Funktion, die Einstellungen oder die Basistools verwenden darf.
Zugriff auf einzelne Konfigurationen	Benutzergruppe in der jeweiligen KI-Voreinstellung / dem KI-Tool	Steuert, welche konkreten Voreinstellungen und Tools ein Benutzer sehen und verwenden kann.

Beide Ebenen müssen erfüllt sein, damit ein Benutzer eine bestimmte KI-Funktion nutzen kann. Ein Benutzer benötigt also sowohl den Grundzugriff als auch die Berechtigung für die jeweilige Konfiguration.

Automatisch erstellte Projektgruppen

Beim Erstellen von KI-Voreinstellungen oder KI-Tools über die Einstellungsoberfläche werden automatisch Benutzergruppen pro Projekt und Typ angelegt. Diese folgen dem Namensschema:

GRP_<Projektname>_ai_<Typ>s

Beispiele:

GRP_agorum.doc.test_ai_presets – für KI-Voreinstellungen des Projekts agorum.doc.test
GRP_agorum.doc.test_ai_tools – für KI-Tools des Projekts agorum.doc.test
GRP_agorum.doc.test_ai_handlers – für Handler des Projekts agorum.doc.test

Diese Gruppen werden als Standard-Benutzergruppe beim Erstellen neuer Konfigurationen vorgeschlagen. Sie können in der jeweiligen Konfiguration jederzeit durch eine andere Benutzergruppe ersetzt werden.