Handbuch

Areki

Areki ist die KI-Infrastruktur der AREVA AG für die Automatisierung von Revisions- und Mandats-Workflows. Dieses Handbuch beschreibt die einzelnen Komponenten und wie sie im Arbeitsalltag eingesetzt werden.

Areki

Komponenten-Übersicht

Zugänge

DienstAdresseBeschreibung
Login auth.areki.li Authentik SSO — alle Services werden über Single Sign-On angemeldet
LibreChat librechat.areki.li KI-Chat-Interface
Auditron dms.areki.li Dokumentenmanagement & Suche
Nextcloud nextcloud.areki.li Dateiverwaltung & Mandatsordner
Scheduler scheduler.areki.li Automatisierung der Verarbeitungsprozesse

Komponente

LibreChat — KI-Chat & Agenten

Erreichbar unter librechat.areki.li

Was ist LibreChat?

  • Open-Source KI-Chat-Interface, ähnlich wie ChatGPT
  • Verbindet sich mit verschiedenen KI-Modellen
  • Unterstützt Agenten mit Tools (MCP), Dateisuche und Code-Ausführung

Verfügbare Modelle

Alle Modelle laufen über die Mistral API (EU, DSGVO-konform, Training deaktiviert).

ModellKennungBeschreibung
Mistral Large mistral-large-latest Haupt-Modell, 675B Parameter, EU-gehostet (Paris)
Mistral Small mistral-small-latest Schnelleres Modell für einfache Aufgaben, 6B aktive Parameter

Grundlegende Bedienung

  • Neuer Chat: Oben links „New Chat“
  • Modell wählen: Dropdown oben im Chat
  • Dateien hochladen: Büroklammer-Icon im Chat-Eingabefeld
  • Websuche: Integriert via SearXNG (kann in Agenten aktiviert werden)

Agenten — Was ist das?

  • Ein Agent ist ein vorkonfigurierter KI-Assistent mit spezifischen Fähigkeiten
  • Hat eigene Anweisungen (System-Prompt), Modell-Auswahl und Tools
  • Kann auf Nextcloud-Dateien zugreifen, in Auditron suchen und Dokumente verarbeiten

Quelle: librechat.ai/docs/features/agents

Einen Agenten verwenden

  • Im Chat-Dropdown „Agents“ wählen
  • Existierenden Agenten aus der Liste wählen
  • Oder im Chat mit @ erwähnen

Eigenen Agenten erstellen

  1. „Agents“ im Endpoint-Menü wählen
  2. Side Panel öffnen (Icon oben rechts)
  3. „New Agent“ klicken
  4. Name und Beschreibung eingeben
  5. Anweisungen schreiben (System-Prompt — hier steuert man das Verhalten)
  6. Modell wählen (z. B. Mistral Large)
  7. Capabilities aktivieren:
    • File Context: Dateien im Chat als Kontext nutzen
    • File Search: In hochgeladenen Dokumenten suchen
    • Code Interpreter: Python-Code ausführen (Berechnungen, Charts)
    • Web Search: Internet-Suche via SearXNG
    • Artifacts: Strukturierte Ausgaben (Code, Dokumente)
  8. Tools hinzufügen (MCP):
    • Auditron DMS: Dokumente suchen und abrufen
    • Nextcloud: Dateien lesen, verschieben, erstellen
    • Docktor: PDFs/Word/Excel in Text umwandeln
  9. Speichern

Quelle: librechat.ai/docs/features/agents

MCP Tools — Verbindung zu Areki-Services

  • MCP = Model Context Protocol (offener Standard)
  • Erlaubt Agenten, direkt auf Auditron, Nextcloud etc. zuzugreifen
  • Konfiguration in librechat.yaml (wird vom Admin gemacht)

Aktuell verfügbare MCP-Server:

  • Auditron DMS (dms.areki.li) — Dokumentensuche
  • Nextcloud MCP — Dateiverwaltung
  • Docktor MCP — Dokumenten-Konvertierung

Quellen: librechat.ai/docs/features/agents (Abschnitt MCP), librechat.ai/docs/configuration/tools

Tipps

  • Klare, spezifische Anweisungen im System-Prompt geben
  • Für wiederkehrende Aufgaben: eigenen Agenten erstellen
  • Dateien zuerst im Chat hochladen, dann Fragen dazu stellen
  • Bei langen Dokumenten: File Search aktivieren statt Copy-Paste

Komponente

Auditron — Dokumentenmanagement & Suche

Erreichbar unter dms.areki.li

Was ist Auditron?

  • Internes Dokumentenmanagementsystem (DMS) von Areki
  • Eigenentwicklung (Python/FastAPI, SQLite mit Volltextsuche FTS5)
  • Indexiert automatisch alle Dokumente aus den Nextcloud-Mandatsordnern
  • Erreichbar über dms.areki.li oder als MCP-Tool in LibreChat

Dokumentensuche

  • Suchfeld oben: Suchbegriff eingeben (Dateiname, Inhalt, Kontonummer, Betrag)
  • Volltextsuche: durchsucht den extrahierten Text aller indexierten Dokumente
  • Ergebnisse zeigen: Dateiname, Mandatsordner, Relevanz-Score, Text-Vorschau
  • Unterstützte Formate: PDF, Word (.docx), Excel (.xlsx), Bilder (via OCR)

Über einen Umschalter im Suchfeld lässt sich der Suchmodus einstellen:

ModusVerhalten
Exakt Sucht nach dem genauen Wortlaut / der genauen Phrase — präzise, aber streng (keine Treffer bei abweichender Schreibweise oder Wortform)
Fuzzy Unscharfe Volltextsuche mit FTS5-Ranking — findet auch bei Tippfehlern, Wortformen oder abweichender Schreibweise, sortiert nach Relevanz

Dokumenten-Ansicht

  • Klick auf ein Suchergebnis → Dokument-Detailansicht
  • Zeigt: vollständiger extrahierter Text, Metadaten, Dateipfad in Nextcloud
  • Link zurück zum Original in Nextcloud

Indexierung

  • Automatische Indexierung: Der Scheduler triggert periodisch die Synchronisation
  • Neue Dokumente in Nextcloud werden automatisch erkannt und indexiert
  • Textextraktion: pdfplumber (PDFs), python-docx (Word), openpyxl (Excel), pytesseract (Bilder/Scans)
  • Der Index wird in einer lokalen SQLite-Datenbank gespeichert

Suche über LibreChat

  • In LibreChat einen Agenten mit dem Auditron MCP-Tool verwenden
„Suche alle Dokumente zum Konto 18020“ → Agent durchsucht Auditron
„Finde die Rechnung von AREVA vom März 2025“ → Volltextsuche

Geplante Features

  • RelationMap: Visuelle Darstellung von Dokumenten-Beziehungen (Qdrant + Three.js)
  • Kontoblatt-Integration: Aufklappbare Kontoblätter mit direkter Belegsuche

Komponente

Nextcloud — Dateiverwaltung

Erreichbar unter nextcloud.areki.li

Was ist Nextcloud?

  • Self-hosted Cloud-Speicher (wie Google Drive / Dropbox)
  • Alle Mandatsdokumente werden hier zentral gespeichert
  • Zugänglich via Browser, Desktop-App oder WebDAV

Ordnerstruktur

Es gibt drei Hauptbereiche (Groupfolders):

Groupfolder „Mandate“

Enthält einen Ordner pro Mandat, z. B.:

Fondation_Carraresi/
Herbstblume/
My_Way_Foundation/
...

Jeder Mandatsordner hat die folgenden Revisionskontenplan-Unterordner:

  • AABSCHLUSS
  • CGUTHABEN BEI BANKEN, POSTCHECKGUTHABEN UND KASSENBESTAND
  • DWERTPAPIERE
  • EFORDERUNGEN
  • FVORRÄTE
  • GRECHNUNGSABGRENZUNGEN
  • HFINANZANLAGEN
  • KSACHANLAGEN
  • LIMMATERIELLE ANLAGEWERTE
  • MVERBINDLICHKEITEN
  • OSTEUERN
  • OOMWST
  • PRECHNUNGSABGRENZUNGSPOSTEN
  • RRÜCKSTELLUNGEN
  • TEIGENKAPITAL
  • UNKLARNicht zuordenbare Belege

Groupfolder „Einlesen“

Hier werden neue Dokumente zum Verarbeiten abgelegt.

  • PDFs/Belege hier ablegen → werden automatisch verarbeitet
  • Output-Ordner enthält die generierten Excel-Dateien

Groupfolder „Knowledge“

Allgemeine, nicht mandatsspezifische Wissensbasis.

  • Enthält Vorlagen, Richtlinien und Musterdokumente sowie allgemeines Fachwissen
  • Ist nicht einem einzelnen Mandat zugeordnet, sondern gilt mandatsübergreifend
  • Wird von Agenten in LibreChat als allgemeiner Kontext genutzt (z. B. via File Search oder Nextcloud-MCP), unabhängig vom jeweils bearbeiteten Mandat

Dokumente hochladen

  • Drag & Drop: Dateien direkt in den Browser ziehen (in den richtigen Ordner)
  • Upload-Button: „+“ oben links → „Datei hochladen“
  • Desktop-App: Nextcloud Desktop Client synchronisiert automatisch

Wo lege ich was ab?

WasWohin
Neue Belege zum automatischen Sortieren Groupfolder Einlesen (werden von sortiere-mandat verarbeitet)
Bereits zugeordnete Belege (manuell), z. B.
  • Bankauszug UBS
  • Kaufvertrag Aktie
  • Rechnung Revisionsstelle
Direkt in den passenden Unterordner im Mandatsordner
  • Mandat/C – GUTHABEN BEI BANKEN/
  • Mandat/D – WERTPAPIERE/
  • Mandat/A – ABSCHLUSS/
Kontoblätter / Saldobilanzen Groupfolder Einlesen (werden von einlese-mandat verarbeitet)
Vorlagen, Richtlinien, mandatsübergreifendes Fachwissen Groupfolder Knowledge (dient LibreChat-Agenten als allgemeine Wissensbasis)

Automatische Verarbeitung

  • einlese-mandat: Liest Kontoblätter/Saldobilanzen ein → erzeugt Excel
  • sortiere-mandat: Sortiert Belege aus „Einlesen“ in die richtigen Mandatsordner
    • Liest Dateiname und PDF-Inhalt (erste 800 Zeichen)
    • Klassifiziert via Mistral AI in den passenden Ordner
    • Benennt Dateien automatisch um (Audit-Kürzel)
  • Scheduler: Orchestriert die automatischen Prozesse (scheduler.areki.li)

Komponente

Scheduler — Automatisierung

Erreichbar unter scheduler.areki.li

Was macht der Scheduler?

  • Weboberfläche zur Steuerung der automatischen Prozesse
  • Startet einlese-mandat, sortiere-mandat und die Auditron-Indexierung
  • Zeigt Status und Logs der letzten Durchläufe

Verfügbare Aktionen

  • Mandatsordner auswählen
  • „Einlesen starten“: Verarbeitet neue Dateien im Einlesen-Ordner
  • „Sortieren starten“: Sortiert unsortierte Belege
  • „Index aktualisieren“: Triggert Auditron-Neuindexierung
  • Auto-Modus (geplant): Führt alles automatisch in Sequenz aus