Zum Inhalt springen
ENKonsole
DEVELOPERS / DEVELOPERS
Markdown ansehenMarkdown herunterladen
In ChatGPT öffnenIn Claude öffnen

Seite nicht erreichbar? Kopiere das Markdown und füge es im Chat ein.

Fehler, Konflikte und Wiederholungen

Fehler beheben, ohne Zugriff auszuweiten oder Schreibaktionen zu duplizieren.

Fachlich geprüft · 2026-09-26 / Ridian

Situation Lösungsweg
Ungültige Eingabe oder unbekannte Zeitzone Anfrage korrigieren; fehlende Absicht beim Nutzer klären
Abgelaufene/widerrufene Autorisierung Refresh oder Neuverbinden; Zugriff nicht ausweiten
Ausgeschlossener Kalender oder unzulässige Aktion Ablauf ändern oder passende ausdrückliche Freigabe erhalten
Parallele Änderung / ETag-Konflikt Aktuellen Termin lesen, vergleichen und entscheiden
Anbieterdrosselung oder vorübergehender Fehler Mit Abstand wiederholen; vorhandene Wiederholhinweise beachten
Timeout nach möglichem Schreiben Ergebnis als unklar behandeln; prüfen oder mit gleichem Aktionsschlüssel wiederholen

MCP-Werkzeugfehler kommen als Werkzeugergebnis mit isError: true zurück, nicht als HTTP-Fehler; nur eine fehlende oder abgelaufene Anmeldung antwortet mit HTTP 401. Jeder Fehler nennt die Ursachenklasse (etwa widerrufener Anbieterzugriff, fehlende Freigabe für diesen Bereich oder ungültige Eingabe) und einen nächsten Schritt. Muss der Nutzer in Ridian handeln, enthält der Text einen direkten Link auf die passende Seite, etwa Verbindungen oder KI & Assistenten. Ein Schreibfehler sagt nur dann „Nothing was changed“, wenn er vor dem Schreiben auftrat; sonst verlangt er, vor einer Wiederholung den aktuellen Stand zu prüfen.

Erfolgreiche Ergebnisse können einen kurzen Hinweis ergänzen, wenn Konten ausgeschlossen wurden, etwa weil eine Anbieterfreigabe abgelaufen ist oder ein Bereich nicht freigeschaltet wurde. Die strukturierte Ausgabe bleibt unverändert; der Hinweis ist ein zusätzlicher Textblock.

Eine Anlagenwiederholung ist dieselbe beabsichtigte Aktion. Behalte ursprüngliche requestId und Nutzlast. Ein neuer Schlüssel beschreibt eine neue Anlage und kann ein Duplikat erzeugen. Geänderte Eingaben mit altem Schlüssel können als Konflikt abgelehnt werden. Versprich keine Exactly-once-Semantik über den dokumentierten Anbieterpfad hinaus.

Änderungen und Löschungen haben anbieterspezifische Parallelitätsgrenzen. CalDAV nutzt starke ETags und bedingte Anfragen, um andere Bearbeitungen nicht still zu überschreiben. Ein bereits gelöschtes Objekt kann als nicht mehr vorhanden gemeldet werden, statt als neu ausgeführte Löschung.

Unvollständige Verfügbarkeit ist keine freie Zeit

Abschnitt betitelt „Unvollständige Verfügbarkeit ist keine freie Zeit“

Kann ein angeforderter Kalender nicht geprüft werden, darf der Client nicht behaupten, dass alle Kalender frei seien. Leeres Anbieterergebnis, Rechteverweigerung und fehlgeschlagener Abruf bedeuten Unterschiedliches.

Erfasse vorhandene Request-ID, Aktion, Anbieter, Zeitpunkt und bereinigten Fehler. Protokolliere keine Tokens, App-Passwörter, vollständigen Anbieterantworten oder Terminbeschreibungen. Die REST-Schnittstelle bietet noch nicht den vollständigen geplanten Partnervertrag für Fehler und Limits; behandle die tatsächliche Antwort statt eines zukünftigen Schemas.

RIDIAN

Frag die Docs

Enter zum Senden · ⇧ Enter für neue Zeile

Keine Passwörter oder Kalenderinhalte. KI-Antworten mit Quellen abgleichen. KI & Datenschutz