Fehler, Konflikte und Wiederholungen
Fehler beheben, ohne Zugriff auszuweiten oder Schreibaktionen zu duplizieren.
Fachlich geprüft · 2026-09-26 / Ridian
Vor einer Wiederholung einordnen
Abschnitt betitelt „Vor einer Wiederholung einordnen“| 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 |
Nächste Schritte in MCP-Ergebnissen
Abschnitt betitelt „Nächste Schritte in MCP-Ergebnissen“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.
Aktionsidentität erhalten
Abschnitt betitelt „Aktionsidentität erhalten“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.
Ohne Inhaltskopien diagnostizieren
Abschnitt betitelt „Ohne Inhaltskopien diagnostizieren“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.