Durchsuchbare Dokumentation aufrufen | Zurück zur Dokumentationsübersicht

Navigation: Dokumentationen agorum core > agorum core Module und Plugins > NORA | 360° > NORA l 360° AI


NORA l 360° AI einrichten

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 die Einrichtung des Plugins NORA | 360° AI in agorum core pro. Ziel der Einrichtung ist es, dass sowohl das mitgelieferte Chat-Preset NORA | 360° als auch eigene KI-Voreinstellungen die NORA l 360° KI-Tools verwenden können.

Überblick über die Einrichtungsschritte

Die Einrichtung besteht aus folgenden Schritten:

  1. Überprüfen Sie, dass die Voraussetzungen erfüllt sind und installieren Sie ggf. die aktuellen Versionen der Plugins ALBERT | AI Suite und NORA | 360° (agorum.smartorga) in agorum core pro.
  2. Installieren Sie das Plugin NORA | 360° AI (agorum.smartorga.ai) in agorum core pro.
  3. Konfigurieren Sie das Basis-Preset  agorum_smartorga_ai_nora_base für die Verwendung eines Sprachmodells, siehe Basis-Preset umkonfigurieren.
  4. Nehmen Sie die Benutzer, die die KI-Tools verwenden sollen, in die entsprechenden Benutzergruppen auf, siehe NORA l 360° AI berechtigen.
  5. Überprüfen Sie die Chat-KI-Voreinstellung, siehe Chat-KI-Voreinstellung NORA | 360° prüfen und aktivieren.
  6. Testen Sie die Verwendung im Chat, siehe Erste Tests im Chat.
  7. Optional: Schalten Sie die KI-gestützte Vorlagenauswahl frei, siehe KI-gestützte Vorlagenauswahl freischalten, und hinterlegen Sie Beschreibungen für die KI in den Vorlagen.
  8. Optional: Verwenden Sie die NORA l 360° KI-Tools in eigenen KI-Voreinstellungen, siehe NORA-Tools in eigenen KI-Voreinstellungen verwenden.

 

Verweis: Für weiterführende Informationen zum allgemeinen Einrichten von KI-Voreinstellungen siehe KI-Voreinstellungen einrichten.

Basis-Preset umkonfigurieren

Die mitgelieferte Basis-KI-Voreinstellung agorum_smartorga_ai_nora_base wird als Referenz-KI-Voreinstellung eingesetzt, damit die Modell- und Provider-Einstellungen für NORA | 360° zentral an einer Stelle gepflegt werden können (siehe KI-Voreinstellungen einrichten, Abschnitt Aufeinander aufbauende KI-Voreinstellungen). Die mitgelieferte Chat-KI-Voreinstellung NORA | 360° baut auf dieser Basis-KI-Voreinstellung auf.

Wichtig: Damit die KI-Voreinstellungen nach der Installation funktionieren, muss die Referenz der Basis-KI-Voreinstellung auf eine bei Ihnen bereits eingerichtete Modellkonfiguration angepasst werden. Andernfalls funktionieren die NORA-Tools bzw. die Chat-KI-Voreinstellung NORA | 360° nicht.

Voraussetzung: Sie haben in ALBERT | AI mindestens eine aktivierte KI-Voreinstellung eingerichtet, die auf ein reales KI-Modell (z. B. bei OpenAI, Azure OpenAI, Anthropic, Gemini oder ein lokal betriebenes Modell) verweist. Nur aktivierte KI-Voreinstellungen können als Referenz gewählt werden. Es wird empfohlen, hierfür ein leistungsstarkes Modell zu wählen, weil die NORA-Tools regelmäßig Werkzeug-Aufrufe (Tool-Calls) durchführen.

Gehen Sie wie folgt vor:

  1. Öffnen Sie ☰ > Administration > Konfiguration > KI-Voreinstellungen.
  2. Wählen Sie in der Auswahlliste den Eintrag agorum_smartorga_ai_nora_base aus und klicken Sie auf Bearbeiten.

    Ergebnis: Das Fenster KI-Voreinstellung einrichten öffnet sich. Die Checkbox Diese Voreinstellung referenziert auf eine andere Voreinstellung ist aktiv.
  3. Ändern Sie im Auswahlfeld Referenz auf eine Voreinstellung die Referenz auf die von Ihnen eingerichtete Modellkonfiguration (z. B. eine KI-Voreinstellung mit einem OpenAI- oder Anthropic-Modell). Nur aktivierte KI-Voreinstellungen werden hier zur Auswahl angeboten.
  4. Optional: Fügen Sie im Bereich Fallback-Referenzen weitere Modellkonfigurationen hinzu, die verwendet werden sollen, wenn die Hauptreferenz nicht verfügbar ist.
  5. Klicken Sie Speichern.

    Ergebnis: Die Basis-KI-Voreinstellung verwendet ab sofort das von Ihnen ausgewählte KI-Modell und damit auch die Chat-KI-Voreinstellung NORA | 360°.

Chat-KI-Voreinstellung NORA | 360° prüfen und aktivieren

Die mitgelieferte Chat-KI-Voreinstellung NORA | 360° (technischer Name: agorum_smartorga_ai_nora) ist bereits so vorkonfiguriert, dass sie:

Sie können diese KI-Voreinstellung direkt verwenden oder sie als Vorlage für eigene KI-Voreinstellungen duplizieren. Kontrollieren Sie einmalig nach der Installation, dass die KI-Voreinstellung aktiv ist und in ALBERTs Chat genutzt werden kann:

  1. Öffnen Sie ☰ > Administration > Konfiguration > KI-Voreinstellungen.
  2. Wählen Sie in der Auswahlliste NORA | 360° aus und klicken Sie auf Bearbeiten.
  3. Prüfen Sie, dass die Optionen Diese Voreinstellung ist aktiv und kann genutzt werden und Diese Voreinstellung kann in ALBERTs Chat genutzt werden aktiviert sind.
  4. Klicken Sie Speichern.

Erste Tests im Chat

Nach der Einrichtung können Sie die NORA-Tools direkt im Chat testen:

  1. Öffnen Sie ALBERTs Chat.
  2. Wählen Sie in der Modellauswahl die KI-Voreinstellung NORA | 360° aus.

    Ergebnis: Sie sehen die Willkommensnachricht mit Beispiel-Prompts (u. a. Kunden suchen, Vorgang anlegen, Aufgabe anlegen).
  3. Verwenden Sie einen der angebotenen Beispiel-Prompts oder testen Sie einen weiteren Prompt, z. B.:
     
    Suche mir alle offenen Aufgaben.

KI-gestützte Vorlagenauswahl freischalten

NORA | 360° AI bringt eine KI-gestützte Vorlagenauswahl mit: Klickt eine Benutzerin bzw. ein Benutzer auf einer NORA | 360° Karte auf Vorlagen, bewertet ALBERT | AI die dort anlegbaren Vorlagen und stellt die passendsten voran. Vorgeschlagen werden ausschließlich Vorlagen, die an dieser Stelle tatsächlich angelegt werden dürfen; die vollständige Liste bleibt jederzeit über den Untermenüpunkt Andere Vorlagen erreichbar.

Wichtig: Die KI-gestützte Vorlagenauswahl ist nach der Installation zunächst deaktiviert. Erst nach den beiden folgenden Schritten wird sie für die berechtigten Benutzer aktiv. Benutzer außerhalb der Gruppe GRP_agorum.smartorga.ai_template_suggest sehen den Vorlagen-Button unverändert wie bisher.

Gehen Sie zur Freischaltung wie folgt vor:

Schritt 1: Modell im Basis-Preset pflegen

  1. Öffnen Sie ☰ > Administration > Konfiguration > KI-Voreinstellungen.
  2. Wählen Sie in der Auswahlliste den Eintrag agorum_smartorga_ai_template_suggest_base aus und klicken Sie auf Bearbeiten.
  3. Ändern Sie im Auswahlfeld Referenz auf eine Voreinstellung die Referenz auf die von Ihnen eingerichtete Modellkonfiguration (z. B. eine KI-Voreinstellung mit einem OpenAI- oder Anthropic-Modell). Nur aktivierte KI-Voreinstellungen werden hier zur Auswahl angeboten.
  4. Klicken Sie Speichern.

Schritt 2: Benutzer berechtigen

  1. Öffnen Sie links in der Seitenleiste Administration und dann Gruppen.
  2. Öffnen Sie den Pfad
    agorum.smartorga.ai
  3. Fügen Sie der Gruppe GRP_agorum.smartorga.ai_template_suggest die Benutzer oder Gruppen hinzu, die die KI-gestützte Vorlagenauswahl nutzen dürfen.

    Ergebnis: Für die Mitglieder dieser Gruppe stellt die KI beim Klick auf Vorlagen nun passende Vorlagen voran.

Hinweis: Die berechtigten Benutzer benötigen zusätzlich die üblichen Berechtigungen für die NORA-Tools (Gruppe GRP_agorum.smartorga.ai_ai_tools).

NORA-Tools in eigenen KI-Voreinstellungen verwenden

Zusätzlich zur mitgelieferten Chat-KI-Voreinstellung NORA | 360° können Sie die NORA-Tools auch in eigenen KI-Voreinstellungen einsetzen. Damit lassen sich fachspezifische KI-Voreinstellungen bauen, die neben den NORA-Fähigkeiten weitere Kontexte, Handler oder Tools kombinieren.

Variante 1: Die komplette Toolgruppe verwenden

Der einfachste Weg ist, die ausgelieferte Toolgruppe All NORA | 360° Tools als Ganzes einzubinden:

  1. Öffnen Sie ☰ > Administration > Konfiguration > KI-Voreinstellungen.
  2. Legen Sie eine neue Voreinstellung an oder wählen Sie die zu erweiternde Voreinstellung aus und klicken Sie Bearbeiten.
  3. Scrollen Sie zum Bereich Tools und klicken Sie auf Tool hinzufügen.
  4. Wählen Sie in der Auswahlliste den Eintrag All NORA | 360° Tools aus.
  5. Klicken Sie Speichern.

    Ergebnis: Die KI-Voreinstellung verwendet ab sofort alle NORA-Tools und die Basis-Tools der ALBERT | AI Agents-Bibliothek, die in der Toolgruppe enthalten sind.

Variante 2: Einzelne Tools verwenden

Wenn Sie nur einen Ausschnitt der NORA-Fähigkeiten benötigen (z. B. nur die Suche in NORA-Objekten), können Sie stattdessen einzelne Tools auswählen:

  1. Klicken Sie im Bereich Tools auf Tool hinzufügen.
  2. Suchen Sie in der Auswahlliste (oder über die Lupe) nach dem gewünschten KI-Tool, z. B. NORA - Search objects oder NORA - Get metadata.
  3. Wiederholen Sie den Vorgang für alle gewünschten Tools.
  4. Klicken Sie Speichern.

Hinweis: Sie können die NORA-Tools mit anderen Tools und Handlern kombinieren. Beachten Sie dabei, dass die NORA-Tools zur Laufzeit automatisch das Wissen agorum-smartorga/nora-tools laden – das entsprechende Wissens-Tool (agorum_ai_agents_library_basic_knowledge) muss daher entweder direkt oder über die Toolgruppe All NORA | 360° Tools ebenfalls verfügbar sein.

Tipp: Zusatzangaben im Feld Kontext Ihrer eigenen KI-Voreinstellung werden automatisch mit dem Kontext der referenzierten Basis-KI-Voreinstellung zusammengeführt. Details zur Verkettung von Kontexten siehe KI-Voreinstellungen einrichten.