Überblick

Der JURA KI Assistent kann externe KI-Sprachmodelle verschiedener Anbieter nutzen. Dafür muss der JURA KI Assistent eine Verbindung zum jeweils ausgewählten KI-Anbieter herstellen können.

Wenn API-Key und KI-Sprachmodell korrekt eingerichtet sind, eine Anfrage aber trotzdem nicht gesendet oder verarbeitet werden kann, können Netzwerk-, Sicherheits- oder Anbieterbedingungen die Ursache sein.

Die nachfolgenden Hinweise helfen dabei, typische Verbindungsursachen einzugrenzen.

 

Hintergrund

Bei einer Anfrage an ein externes KI-Sprachmodell wird die Anfrage über eine verschlüsselte Internetverbindung an den jeweiligen KI-Anbieter gesendet.

In Kanzlei- und Unternehmensumgebungen können Firewalls, Proxyserver, Webfilter, Endpoint-Security-Lösungen oder HTTPS-/SSL-Inspection diese Verbindung beeinflussen oder blockieren.

Auch Störungen, Wartungsarbeiten oder Einschränkungen beim jeweiligen KI-Anbieter können dazu führen, dass eine Anfrage zeitweise nicht erfolgreich verarbeitet wird.

 

Internetverbindung prüfen

Für Anfragen an externe KI-Sprachmodelle benötigt der JURA KI Assistent eine funktionierende Internetverbindung.

Bitte prüfen Sie insbesondere:

• Ist das Gerät bzw. der Terminalserver mit dem Internet verbunden?
• Können externe HTTPS-Webseiten im Browser geöffnet werden?
• Tritt das Problem nur in einem bestimmten Netzwerk auf?
• Tritt das Problem nur bei einzelnen Benutzern oder an einzelnen Arbeitsplätzen auf?
• Ist eine VPN-Verbindung aktiv, die den Zugriff einschränken kann?

 

Firewall, Proxy und Webfilter

In vielen Kanzlei- und Unternehmensumgebungen werden ausgehende Verbindungen durch Firewall, Proxy oder Webfilter gesteuert.

Bitte lassen Sie durch die Kunden-IT oder den zuständigen Systemadministrator prüfen, ob ausgehende HTTPS-Verbindungen zum jeweiligen KI-Anbieter erlaubt sind.

Besonders relevant sind:

• Firewall-Regeln für ausgehende HTTPS-Verbindungen
• Proxy-Einstellungen auf Client, Terminalserver oder Netzwerkebene
• Webfilter-Regeln für API-Domains der KI-Anbieter
• blockierte Kategorien oder Sicherheitsbewertungen im Webfilter
• unterschiedliche Regeln für Benutzergruppen oder Netzwerkprofile

Wenn der JURA KI Assistent auf einem Terminalserver eingesetzt wird, müssen die Regeln direkt für den Terminalserver bzw. die jeweilige Benutzersitzung greifen.

 

HTTPS-/SSL-Inspection

HTTPS-/SSL-Inspection kann verschlüsselte Verbindungen aufbrechen, prüfen und erneut herstellen. Einige KI-Anbieter oder API-Verbindungen können dadurch gestört werden.

Bitte prüfen Sie, ob HTTPS-/SSL-Inspection für Verbindungen zu KI-Anbietern aktiv ist.

Typische Hinweise auf Probleme mit HTTPS-/SSL-Inspection sind:

• Zertifikatsfehler
• Verbindungsabbrüche trotz gültigem API-Key
• Fehler nur im Kanzlei- oder Unternehmensnetzwerk
• erfolgreiche Nutzung außerhalb des geschützten Netzwerks
• unterschiedliche Ergebnisse je nach Arbeitsplatz, Benutzer oder Netzwerkprofil

Falls HTTPS-/SSL-Inspection eingesetzt wird, sollten für die API-Dienste der verwendeten KI-Anbieter geeignete Ausnahmen geprüft werden.

 

Sicherheitssoftware auf Client oder Terminalserver

Endpoint-Security-Lösungen, Antivirenprogramme oder Anwendungssteuerungen können ausgehende Verbindungen oder lokale Prozesse blockieren.

Bitte prüfen Sie insbesondere:

• Werden Prozesse des JURA KI Assistenten blockiert?
• Werden ausgehende Verbindungen des JURA KI Assistenten blockiert?
• Gibt es Einträge in den Protokollen der Sicherheitssoftware?
• Werden temporäre Prozesse oder Sandbox-Prozesse blockiert?
• Greifen Regeln je nach Benutzer, Terminalserver-Sitzung oder Netzwerkprofil unterschiedlich?

Weitere Hinweise finden Sie im Beitrag:

Welche Firewall- und Antivirus-Ausnahmen benötigt der JURA KI Assistent?
https://ki-wiki.dictanet.com/faq/welche-firewall-und-antivirus-ausnahmen-benoetigt-der-jura-ki-assistent

 

Anbieter-Domains und API-Dienste

Je nach ausgewähltem KI-Sprachmodell muss der jeweilige API-Dienst des Anbieters erreichbar sein.

Beispiele:

• OpenAI bei Nutzung eines OpenAI-Modells
• Anthropic bei Nutzung eines Claude-Modells
• Google bei Nutzung eines Gemini-Modells
• Mistral bei Nutzung eines Mistral-Modells
• Perplexity bei Nutzung eines Perplexity-Modells

Wenn nur ein bestimmter Anbieter betroffen ist, spricht dies eher für eine anbieterbezogene Einschränkung, eine blockierte Anbieter-Domain, eine Anbieterstörung oder eine modellbezogene Berechtigung.

Wenn mehrere Anbieter betroffen sind, sollte zuerst die allgemeine Netzwerk-, Proxy- oder Sicherheitskonfiguration geprüft werden.

 

Anbieterstatus und Nutzungseinschränkungen

Auch wenn die lokale Einrichtung korrekt ist, kann eine Anfrage fehlschlagen, wenn der jeweilige KI-Anbieter aktuell Einschränkungen hat.

Mögliche Ursachen sind:

• temporäre Anbieterstörung
• Wartungsarbeiten
• Überlastung
• Rate-Limits
• Kontingent- oder Nutzungslimits
• Abrechnungs- oder Guthabenprobleme
• eingeschränkter Zugriff auf ein bestimmtes Modell

Weitere Hinweise zu API-Fehlern, Rate-Limits und Kontingenten finden Sie im Beitrag:

Was sind API-Fehler und was kann ich selbst tun?
https://ki-wiki.dictanet.com/faq/was-sind-api-fehler-und-was-kann-ich-selbst-tun

 

Typische Hinweise auf Verbindungsprobleme

Typische Hinweise auf Verbindungsprobleme zum KI-Anbieter sind:

• Die Anfrage wird nicht gesendet.
• Die Anfrage bricht nach kurzer Zeit ab.
• Die Antwort des KI-Sprachmodells wird nicht geladen.
• Es erscheint eine Netzwerk-, Verbindungs- oder Timeout-Meldung.
• Es erscheint die Meldung „API Fehler“ (ohne Anbieternamen) mit dem Hinweistext „Ein unbekannter Fehler ist aufgetreten“.
• Der Fehler tritt nur im Kanzlei- oder Unternehmensnetzwerk auf.
• Der Fehler tritt nur bei einem bestimmten KI-Anbieter auf.
• Der Fehler tritt auf dem Terminalserver auf, aber nicht auf einem lokalen Einzelplatz.
• Der Fehler tritt nur bei bestimmten Benutzern oder Benutzergruppen auf.

Diese Hinweise müssen nicht ausschließlich durch die Netzwerkumgebung verursacht werden. Sie sind aber ein sinnvoller Ansatzpunkt für die technische Prüfung.

 

Zusammenfassung - Prüfpunkte für die Kunden-IT

Bitte lassen Sie durch Ihre IT oder den zuständigen Systemadministrator insbesondere prüfen:

• Sind ausgehende HTTPS-Verbindungen vom betreffenden Gerät bzw. Terminalserver erlaubt?
• Ist ein Proxyserver im Einsatz und korrekt konfiguriert?
• Werden API-Domains des ausgewählten KI-Anbieters durch Firewall oder Webfilter blockiert?
• Ist HTTPS-/SSL-Inspection aktiv?
• Gibt es blockierte Verbindungen in Firewall-, Proxy- oder Webfilter-Protokollen?
• Blockiert Endpoint-Security Prozesse oder Verbindungen des JURA KI Assistenten?
• Greifen unterschiedliche Regeln für einzelne Benutzer, Gruppen, Geräte oder Netzwerkprofile?
• Funktioniert die Verbindung außerhalb des Kanzlei- oder Unternehmensnetzwerks?
• Ist der jeweilige KI-Anbieter aktuell erreichbar?
• Sind beim Anbieter Kontingent, Abrechnung und Modellzugriff aktiv?

 

Weiterführende Beiträge und Anleitungen

Zusätzlich hilfreich sind folgende FAQ-Beiträge:

Welche Firewall- und Antivirus-Ausnahmen benötigt der JURA KI Assistent?
https://ki-wiki.dictanet.com/faq/welche-firewall-und-antivirus-ausnahmen-benoetigt-der-jura-ki-assistent

Warum wird mein API-Key als ungültig oder nicht nutzbar erkannt?
https://ki-wiki.dictanet.com/faq/warum-wird-mein-api-key-als-ungueltig-oder-nicht-nutzbar-erkannt

Was sind API-Fehler und was kann ich selbst tun?
https://ki-wiki.dictanet.com/faq/was-sind-api-fehler-und-was-kann-ich-selbst-tun

Benötige ich ein Abonnement wie ChatGPT Plus, Claude Pro oder Google AI Pro?
https://ki-wiki.dictanet.com/faq/benoetige-ich-ein-abonnement-wie-chatgpt-plus-claude-pro-oder-google-ai-pro

Ausführliche Schritt-für-Schritt-Anleitungen finden Sie hier:

Konfiguration von Firewalls für den JURA KI Assistenten
https://ki-lab.dictanet.com/downloads/JURA_KI-Whitelist-Anleitung.pdf

Konfiguration von SOPHOS Firewalls für den JURA KI Assistenten
https://ki-lab.dictanet.com/downloads/JURA_KI-Whitelist-Anleitung_SOPHOS.pdf

 

Falls das Problem weiterhin besteht

Besteht das Problem weiterhin, wenden Sie sich bitte an unseren Support unter: jura-ki@jurasoft.de

Teilen Sie uns möglichst die nachfolgenden Informationen mit und übersenden Sie die Log-Dateien des JURA KI Assistenten. Dadurch können wir den Fehler genauer eingrenzen und gezielte Lösungsansätze unterbreiten.

Bitte teilen Sie uns mit:

• Welches KI-Sprachmodell bzw. welcher KI-Anbieter wurde ausgewählt?
• Tritt das Problem bei allen KI-Anbietern oder nur bei einem bestimmten Anbieter auf?
• Tritt das Problem bei allen Benutzern oder nur bei einzelnen Benutzern auf?
• Wird Windows, Windows Terminalserver oder macOS eingesetzt?
• Ist ein Proxy, Webfilter, eine Firewall oder HTTPS-/SSL-Inspection im Einsatz?
• Wird eine Fehlermeldung angezeigt? Falls ja, senden Sie bitte einen Screenshot mit.
• Tritt der Fehler nur im Kanzlei- bzw. Unternehmensnetzwerk auf oder auch außerhalb dieses Netzwerks?
• Wurde der API-Key im JURA KI Assistenten gespeichert und erfolgreich geprüft?

Bitte fügen Sie Ihrer E-Mail außerdem die Log-Dateien bei.

 

Log-Dateien unter Windows

Unter Windows befinden sich die Log-Dateien im folgenden Verzeichnis:
C:\ProgramData\JuraSoft\Jura-KI\logs

1. Kopieren Sie den Pfad C:\ProgramData\JuraSoft\Jura-KI in die Adresszeile des Datei-Explorers und drücken Sie die Eingabetaste. Der Ordner „ProgramData“ ist standardmäßig ausgeblendet, über die Adresszeile gelangen Sie trotzdem dorthin.
2. Klicken Sie mit der rechten Maustaste auf den Ordner logs.
3. Wählen Sie (je nach Windows-Version) Senden an → ZIP-komprimierter Ordner oder Komprimieren in ZIP-Datei.
4. Fügen Sie die erstellte ZIP-Datei Ihrer E-Mail bei.

 

Log-Dateien unter macOS

Unter macOS befinden sich die Log-Dateien im Benutzerordner unter:
~/Library/Application Support/JuraSoft/Jura-KI/logs

1. Öffnen Sie den Finder und wählen Sie in der Menüleiste Gehe zu → Gehe zum Ordner … (Tastenkombination Umschalt + Befehl + G).
2. Geben Sie ~/Library/Application Support/JuraSoft/Jura-KI ein und drücken Sie die Eingabetaste. Das Zeichen ~ steht für Ihren Benutzerordner; der ausgeblendete Ordner „Library“ wird so direkt geöffnet.
3. Klicken Sie mit der rechten Maustaste (oder bei gedrückter Ctrl-Taste) auf den Ordner logs und wählen Sie „logs“ komprimieren.
4. Fügen Sie die erstellte ZIP-Datei Ihrer E-Mail bei.