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¶
| Komponente | Beschreibung |
|---|---|
| GGU-CONNECT-CLI | Muss installiert und konfiguriert sein (Datenbankverbindung) |
| API-Schluessel | Anthropic API Key (fuer Claude) oder OpenAI API Key (fuer GPT-4o) |
| GGU-CONNECT-Datenbank | Access (.mdb), PostgreSQL oder MSSQL |
| Internetverbindung | Erforderlich fuer die Kommunikation mit dem KI-Dienst |
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:
| XML-Element | Attribute | Beschreibung |
|---|---|---|
anthropic-config |
api-key, model, max-tokens, language |
Anthropic/Claude-Konfiguration |
llm-config |
llm-provider, openai-api-key, large-language-model |
LLM-Anbieter-Auswahl |
mcp-server |
name, base-url, type, auth-header |
Zusaetzliche Wissensquellen |
ggu-app-configs |
connect-cli-path |
Pfad zur GGU-CONNECT-CLI |
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¶
| Variable | Beschreibung | Beispiel |
|---|---|---|
ANTHROPIC_API_KEY |
API-Schluessel fuer Claude | sk-ant-... |
OPENAI_API_KEY |
API-Schluessel fuer GPT-4o | sk-... |
LLM_PROVIDER |
KI-Anbieter | anthropic oder openai |
GGU_DATABASE |
Datenbank-Verbindung | access:C:\\Daten\\Projekt.mdb |
GGU_DB_PROFILE |
Datenbankprofil-Name | mein-profil |
GGU_CONNECT_CLI_PATH |
Pfad zur CLI | C:\\Programme\\GGU\\CLI.exe |
GGU_LANGUAGE |
Sprache | de oder en |
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¶
| Befehl | Funktion |
|---|---|
/help |
Zeigt verfuegbare Befehle und Beispiele |
/tools |
Listet alle verfuegbaren GGU-CONNECT-Werkzeuge auf |
/new |
Startet eine neue Konversation (loescht den bisherigen Verlauf) |
/clear |
Leert den Bildschirm |
/exit |
Beendet Connie |
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:
| Format | Beschreibung | Beispiel-Anweisung |
|---|---|---|
| SEP3 / Geodin | Standard-Austauschformat (.mdb) | "Importiere die SEP3-Datei aus C:\Daten\bohrungen.mdb" |
| CSV | Koordinaten und Kurzzeilen | "Importiere die Koordinaten aus C:\Daten\coords.csv" |
| BoreholeML | XML-Bohrdatenformat | "Lade die BoreholeML-Datei C:\Daten\bml.xml" |
Daten exportieren¶
| Format | Beschreibung | Beispiel-Anweisung |
|---|---|---|
| CSV / Excel | Tabellarische Ausgabe | "Exportiere alle Bohrungen als CSV" |
| SEP3 | SEP3-konforme Datenbank | "Erstelle einen SEP3-Export fuer Projekt 1" |
| GGU-Formate | STRATIG, BORELOG etc. | "Oeffne Bohrung B-04 in GGU-STRATIG" |
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:
| Thema | Beispiel-Frage |
|---|---|
| Bodenklassifikation | "Was bedeutet die Kurzbezeichnung fS,ms nach DIN 18196?" |
| DIN-Normen | "Erklaere mir die Bodengruppen nach DIN EN ISO 14688" |
| SEP3-Format | "Welche Pflichtfelder hat eine SEP3-Schichtbeschreibung?" |
| GGU-Produkte | "Welches GGU-Programm brauche ich fuer Setzungsberechnungen?" |
KI-Anbieter¶
Connie unterstuetzt zwei KI-Anbieter:
| Anbieter | Modell | Staerken |
|---|---|---|
| Anthropic (Standard) | Claude Sonnet | Praezise Antworten, starke Werkzeug-Integration |
| OpenAI | GPT-4o | Alternative bei bestehenden OpenAI-Vertraegen |
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:
- Ist der Schluessel in der Appsettings.xml, config.json oder als Umgebungsvariable hinterlegt?
- Beginnt der Schluessel mit
sk-ant-(Anthropic) odersk-(OpenAI)? - Ist der Schluessel noch gueltig? (Pruefen Sie im Anbieter-Dashboard)
"GGU-CONNECT-CLI nicht gefunden"¶
Connie benoetigt die CLI im Hintergrund. Loesungen:
- Setzen Sie den Pfad explizit in der Konfiguration (
gguConnectCliPath) - Stellen Sie sicher, dass
GGU.Apps.ConnectCLI.exeinstalliert ist - Pruefen Sie, ob die CLI einzeln funktioniert:
GGU.Apps.ConnectCLI.exe --help
"Datenbank nicht erreichbar"¶
- Pruefen Sie den Datenbankpfad in der Konfiguration
- Bei Access: Existiert die .mdb-Datei am angegebenen Pfad?
- Bei PostgreSQL/MSSQL: Ist der Datenbankserver erreichbar?
- Testen Sie die Verbindung ueber die CLI:
GGU.Apps.ConnectCLI.exe db test
"Netzwerkfehler / Timeout"¶
Connie benoetigt eine Internetverbindung fuer die KI-Kommunikation:
- Pruefen Sie Ihre Internetverbindung
- Ist ein Proxy konfiguriert? Setzen Sie ggf.
HTTPS_PROXY - 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.