Fehlerbehebung

Diese Seite behandelt die häufigsten Probleme, auf die Nutzende von Claira stoßen, und wie sie sich lösen lassen. Ist Ihr Problem hier nicht aufgeführt oder helfen diese Schritte nicht, wenden Sie sich mit einer Beschreibung des Problems und allen sichtbaren Fehlercodes an den Support.

Der Claira-Bereich ist leer oder lädt nicht

Warum das passiert: Der Claira-Bereich muss Teil Ihres Arbeitsbereichslayouts in Nuix Discover sein, und Claira muss für Ihren Fall und Ihre Benutzergruppe aktiviert sein.

So beheben Sie das Problem:

1. Prüfen Sie, ob Ihr Arbeitsbereichslayout den Claira-Bereich enthält. Sehen Sie ihn nicht, bitten Sie Ihre Fall-Administration, Claira einem Arbeitsbereichslayout hinzuzufügen.
2. Vergewissern Sie sich, dass Claira für Ihren Fall aktiviert wurde. Die Aktivierung erfolgt auf Fallebene — ist der Fall nicht aktiviert, lädt der Bereich keine Inhalte.
3. Prüfen Sie, ob Ihre Benutzergruppe Zugriff auf Claira hat. Ihre Administration legt fest, welche Gruppen den Claira-Bereich sehen können.
4. Laden Sie die Seite neu. Gelegentlich behebt ein Neuladen Ladeprobleme.

Ein Medien-Scan (Bild / Audio / Video) bleibt hängen oder liefert kein Ergebnis

Warum das passiert: In den Modi Bild, Audio oder Video lädt Claira zunächst die Quelldatei aus Nuix Discover herunter und sendet diese Datei dann zur Analyse. Der Text-Modus kann noch funktionieren, wenn dieser Downloadschritt langsam oder blockiert ist oder einen allgemeinen Content-Type zurückgibt. Die je Modus zulässigen Dateiformate finden Sie unter Medien-Scans.

So beheben Sie das Problem:

1. Prüfen Sie zwei Netzwerkschritte in den Entwicklerwerkzeugen Ihres Browsers. Die Downloadanfrage an Nuix sollte abgeschlossen sein (HTTP 200), bevor die Orchestrator-Anfrage .../api/v1/orchestrate/chat/completions läuft. Bleibt der Download pending, liegt es an Nuix, am Netzwerk oder an der Dateigröße — noch nicht am KI-Schritt.
2. Warten Sie bei großen Dateien. Sehr große Downloads können mehrere Minuten dauern; Claira wartet nach Ablauf einer Zeitgrenze nicht weiter und zeigt einen klaren Download-Fehler.
3. 403/404 beim Download: Wenden Sie sich an Ihre Nuix-Administration wegen Dokumentzugriff, gebrandeter Schwärzungen, Größenbeschränkungen für Downloads und der Anforderungen an das UIX-Sitzungs-Token (Downloads müssen das UIX-Sitzungs-Token verwenden, nicht ein persönliches API-Token).

Die Scan-Schaltfläche ist ausgegraut

Warum das passiert: Claira verlangt sowohl einen gespeicherten Prompt als auch ein verbundenes Feld, bevor ein Scan möglich ist. Fehlt eines davon, bleibt die Scan-Schaltfläche deaktiviert, um unvollständige Scans zu verhindern.

So beheben Sie das Problem:

1. Wechseln Sie in den Bereich Prompt und stellen Sie sicher, dass ein Prompt geschrieben und gespeichert ist.
2. Wechseln Sie in den Bereich Einstellungen und bestätigen Sie, dass ein Feld in Nuix Discover verbunden ist.
3. Ist beides vorhanden und die Schaltfläche dennoch ausgegraut, prüfen Sie, ob im Document Viewer ein Dokument geladen ist (bei Einzel-Scans) oder ob Sie in der Dokumentliste Dokumente ausgewählt haben (bei Massen-Scans).

Ergebnisse wirken falsch oder uneinheitlich

Warum das passiert: In den meisten Fällen weisen uneinheitliche Ergebnisse auf einen Prompt hin, der präziser sein könnte. Die KI folgt Anweisungen wörtlich, und kleine Mehrdeutigkeiten in Ihrem Prompt können zu schwankenden Ausgaben über verschiedene Dokumente hinweg führen.

So beheben Sie das Problem:

1. Verfeinern Sie Ihren Prompt. Sagen Sie ausdrücklicher, was Sie möchten. Definieren Sie Schlüsselbegriffe, legen Sie das exakte Ausgabeformat fest und listen Sie die zulässigen Antwortwerte auf. Ausführliche Hinweise finden Sie im Prompting-Überblick.
2. Testen Sie an bekannten Dokumenten. Führen Sie Ihren Prompt an Dokumenten aus, deren richtige Antwort Sie bereits kennen. So erkennen Sie, ob das Problem beim Prompt oder beim Dokument liegt.
3. Scan-Einstellungen vergleichen und erneut ausführen. Schwanken Ergebnisse, führen Sie denselben Prompt an Referenzdokumenten erneut aus und vergleichen Sie die Ausgaben vor und nach jeder Änderung.
4. Prüfen Sie, ob das Dokument extrahierten Text hat. Hat das Quelldokument keinen Text, unleserlichen Text oder sehr wenig Text, stellen Sie das Dropdown Scannen als auf Bild, Audio oder Video um, passend zur Quelldatei des Dokuments.

Der Massen-Scan wurde gestoppt oder ist fehlgeschlagen

Warum das passiert: Massen-Scans können aus verschiedenen Gründen stoppen, etwa durch Unterbrechungen im Browser, aufgebrauchte Token oder Fehler während der Verarbeitung.

So beheben Sie das Problem:

1. Prüfen Sie, ob das Browserfenster geschlossen wurde. Massen-Scans setzen voraus, dass das Browserfenster geöffnet bleibt. Wurde es geschlossen oder der Tab auf eine andere Seite geführt, ist die Aufgabe gestoppt.
2. Prüfen Sie Ihr Token-Guthaben. Sind Ihnen mitten in der Aufgabe die Token ausgegangen, stoppt der Scan. Ihr Guthaben sehen Sie im Einblendfenster Nutzung oder im Bestätigungsbereich des Massen-Scans.
3. Achten Sie auf Fehlercodes. Sind einzelne Dokumente fehlgeschlagen, zeigt Claira für jedes einen Fehlercode. Schritte zur Behebung finden Sie auf der Seite Fehlercodes.
4. Setzen Sie fort, wenn möglich. Ein Scan, der vor dem Abschluss gestoppt wurde, zeigt im Verlauf der Massen-Scan-Aufgaben eine bernsteinfarbene Kennzeichnung Unvollständig; öffnen Sie die Aufgabe, um zu sehen, wie viele Dokumente noch zu scannen sind, und klicken Sie dann auf Aufgabe fortsetzen, um sie abzuschließen (bereits gescannte Dokumente werden nicht erneut gescannt und nicht erneut abgerechnet). Möchten Sie den Lauf nicht abschließen, gibt Aufgabe abbrechen die reservierten Token frei. Siehe Wenn ein Scan vorzeitig endet.

Felder lassen sich nicht verbinden

Warum das passiert: Feldverbindungen setzen voraus, dass das Feld in Nuix Discover vorhanden und aus der Claira-Integration erreichbar ist.

So beheben Sie das Problem:

1. Prüfen Sie, ob das Feld in Nuix Discover vorhanden ist. Öffnen Sie Ihren Fall in Nuix Discover und bestätigen Sie, dass das gewünschte Feld vorhanden ist und den richtigen Typ hat.
2. Prüfen Sie die zusammengesetzte Feld-ID. Claira identifiziert Felder über eine zusammengesetzte ID. Wurde die ID manuell eingegeben, prüfen Sie sie auf Tippfehler.
3. Bestätigen Sie, dass Claira für Ihren Fall aktiviert ist. Wurde Claira nicht von einer Administration aktiviert, stehen Feldverbindungen nicht zur Verfügung.
4. Prüfen Sie die Berechtigungen. Ihr Konto braucht Schreibzugriff auf das Zielfeld. Bitten Sie Ihre Fall-Administration, Ihre Berechtigungen zu prüfen.

Weiterhin nicht gelöst?

Wenn keiner der obigen Schritte Ihr Problem löst:

1. Notieren Sie die genaue Fehlermeldung oder das genaue Verhalten, das Sie beobachten.
2. Halten Sie Zeitpunkt, Fallnamen und — sofern zutreffend — die IDs der betroffenen Dokumente fest.
3. Sehen Sie auf der Seite Fehlercodes nach Hinweisen zum jeweiligen Fehlercode.
4. Schreiben Sie uns mit diesen Angaben an support@claira.to.

---

Brauchen Sie Hilfe? Schreiben Sie uns an support@claira.to.