GGU-CONNECT - ggu-assistant.exe

Connie – Der KI-Assistent fuer GGU-CONNECT

Uebersicht

Connie (ggu-assistant.exe) ist ein KI-gestützter Assistent fuer Geotechniker, der natuerlichsprachliche Interaktion mit GGU-CONNECT-Datenbanken ermoeglicht. Anstatt manuell durch Menues zu navigieren, koennen Sie Connie in normaler Sprache bitten, Daten zu suchen, zu importieren, zu exportieren oder zu validieren.

Connie kombiniert:

• Kuenstliche Intelligenz (Claude von Anthropic oder GPT-4o von OpenAI) fuer das Sprachverstaendnis

• Geotechnisches Fachwissen zu DIN-Normen, SEP3-Format und Bodenklassifikation

• Direkten Datenbankzugriff ueber die GGU-CONNECT-CLI im Hintergrund

Voraussetzungen

Installation und Start

Installation

Connie wird als einzelne ausfuehrbare Datei (ggu-assistant.exe) ausgeliefert. Eine separate Installation ist nicht erforderlich — kopieren Sie die Datei in ein beliebiges Verzeichnis.

Programmstart

Starten Sie Connie per Doppelklick oder ueber die Kommandozeile:

ggu-assistant.exe

Nach dem Start erscheint das Connie-Logo und die Eingabeaufforderung:

   ____                  _
  / ___|___  _ __  _ __ (_) ___
 | |   / _ \| '_ \| '_ \| |/ _ \
 | |__| (_) | | | | | | | |  __/
  \____\___/|_| |_|_| |_|_|\___|

  GGU-CONNECT KI-Assistent v0.1.0

Sie:

Konfiguration

Connie liest Einstellungen aus mehreren Quellen. Die Reihenfolge der Prioritaet (hoechste zuerst):

Option 1: GGU-CONNECT-Appsettings.xml (empfohlen)

Wenn Sie GGU-CONNECT bereits nutzen, werden die Einstellungen automatisch aus der gemeinsamen Konfigurationsdatei gelesen:

%APPDATA%\GGU-Software\GGU-CONNECT\GGU-CONNECT-Appsettings.xml

Folgende Einstellungen werden daraus uebernommen:

Option 2: config.json

Legen Sie eine Datei config.json im selben Verzeichnis wie ggu-assistant.exe an:

{
  "apiKey": "sk-ant-...",
  "llmProvider": "anthropic",
  "model": "claude-sonnet-4-20250514",
  "maxTokens": 4096,
  "language": "de",
  "database": "access:C:\\Pfad\\Zur\\Datenbank.mdb",
  "gguConnectCliPath": "C:\\Programme\\GGU\\GGU.Apps.ConnectCLI.exe"
}

Option 3: Umgebungsvariablen

Hinweis: Wenn Sie GGU-CONNECT bereits installiert haben, ist Option 1 (Appsettings.xml) der einfachste Weg — Connie uebernimmt die Konfiguration automatisch.

Bedienung

Chat-Eingabe

Schreiben Sie Ihre Frage oder Anweisung einfach in natuerlicher Sprache nach dem Sie:-Prompt. Connie versteht Deutsch und Englisch.

Befehle

Beispiel-Konversation

Sie: Zeige mir alle Projekte in meiner Datenbank

Connie: Ich suche nach allen Projekten in Ihrer Datenbank...
        [Werkzeug: search_projects]

        In Ihrer Datenbank befinden sich 3 Projekte:

        | Nr. | Projektname              | Bohrungen |
        |-----|--------------------------|-----------|
        | 1   | Bauvorhaben Musterstadt  | 12        |
        | 2   | Erkundung Gewerbegebiet  | 8         |
        | 3   | Altlast Industriepark    | 24        |

        Moechten Sie Details zu einem bestimmten Projekt sehen?

Sie: Zeige mir die Bohrungen von Projekt 1

Connie: Ich lade die Bohrungsdaten fuer "Bauvorhaben Musterstadt"...
        ...

Funktionen

Daten durchsuchen

Connie kann Ihre GGU-CONNECT-Datenbank nach Projekten, Bohrungen, Schichten, Proben und Grundwasserdaten durchsuchen.

Beispiele:

• "Zeige mir alle Projekte"

• "Suche die Bohrung B-04 im Projekt Musterstadt"

• "Welche Bohrungen haben Grundwasserstände?"

• "Liste alle Schichten der Bohrung KB-1 auf"

Daten importieren

Connie kann verschiedene Datenformate in Ihre Datenbank importieren:

Daten exportieren

Daten validieren

Connie kann Ihre Daten auf SEP3-Konformitaet pruefen und Qualitaetsprobleme identifizieren:

• "Validiere das Projekt auf SEP3-Konformitaet"

• "Pruefe die Datenqualitaet aller Bohrungen"

• "Gibt es Fehler in den Schichtbeschreibungen?"

Fachliche Beratung

Connie verfuegt ueber geotechnisches Fachwissen und kann bei fachlichen Fragen helfen:

KI-Anbieter

Connie unterstuetzt zwei KI-Anbieter:

Der Anbieter wird in der Konfiguration festgelegt (llmProvider). Beide Anbieter liefern vergleichbare Ergebnisse bei der Arbeit mit GGU-CONNECT-Daten.

Fehlerbehebung

"API Key nicht konfiguriert"

Connie benoetigt einen gueltigen API-Schluessel. Pruefen Sie:

1. Ist der Schluessel in der Appsettings.xml, config.json oder als Umgebungsvariable hinterlegt?

2. Beginnt der Schluessel mit sk-ant- (Anthropic) oder sk- (OpenAI)?

3. Ist der Schluessel noch gueltig? (Pruefen Sie im Anbieter-Dashboard)

"GGU-CONNECT-CLI nicht gefunden"

Connie benoetigt die CLI im Hintergrund. Loesungen:

1. Setzen Sie den Pfad explizit in der Konfiguration (gguConnectCliPath)

2. Stellen Sie sicher, dass GGU.Apps.ConnectCLI.exe installiert ist

3. Pruefen Sie, ob die CLI einzeln funktioniert: GGU.Apps.ConnectCLI.exe --help

"Datenbank nicht erreichbar"

1. Pruefen Sie den Datenbankpfad in der Konfiguration

2. Bei Access: Existiert die .mdb-Datei am angegebenen Pfad?

3. Bei PostgreSQL/MSSQL: Ist der Datenbankserver erreichbar?

4. Testen Sie die Verbindung ueber die CLI: GGU.Apps.ConnectCLI.exe db test

"Netzwerkfehler / Timeout"

Connie benoetigt eine Internetverbindung fuer die KI-Kommunikation:

1. Pruefen Sie Ihre Internetverbindung

2. Ist ein Proxy konfiguriert? Setzen Sie ggf. HTTPS_PROXY

3. Wird die Verbindung durch eine Firewall blockiert? Port 443 (HTTPS) muss offen sein

Konversation zuruecksetzen

Wenn Connie unerwartete Antworten gibt, starten Sie eine neue Konversation:

/new

Dies loescht den bisherigen Verlauf und beginnt von vorne.