Exceptions und Fehlerbehandlung
Alle Exceptions, die das SDK wirft, befinden sich im Namespace Revolution\Copilot\Exceptions. Sie treten auf zwei Arten auf: Einige werden im Session-Ergebnis gehalten und beim Aufruf von throw() geworfen, andere werden sofort geworfen, zum Beispiel bei RPC-Aufrufen.
Session-Fehler und Timeouts
Bei sendAndWait() und Copilot::run() wird ein Session-Fehler oder Timeout nicht sofort geworfen. Stattdessen wird die Exception im zurückgegebenen SessionEvent gehalten. Wie bei Http und Process in Laravel wirft der Aufruf von throw() die gehaltene Exception. Liegt kein Fehler vor, macht throw() nichts, sodass Sie weitere Methoden verketten können.
Um den Erfolg zu prüfen, ohne eine Exception zu werfen, verwenden Sie failed() und successful(). Details finden Sie unter SessionEvent.
SessionTimeoutException
Wird gehalten, wenn das Warten auf session.idle (Abschluss der Antwort) das Zeitlimit überschreitet. Legen Sie das Zeitlimit mit dem Argument timeout von sendAndWait() fest. Wenn Sie es weglassen, wird der Konfigurationswert copilot.timeout verwendet (standardmäßig 60 Sekunden).
SessionErrorException
Wird gehalten, wenn die Session über ein SESSION_ERROR-Event einen Fehler zurückgibt. Die Nachricht enthält den von der Runtime zurückgegebenen Fehler.
JsonRpcException
Wird sofort geworfen, wenn die CLI für einen RPC-Aufruf einen JSON-RPC-Fehler zurückgibt. Den JSON-RPC-Fehlercode lesen Sie aus der Eigenschaft code, die an den Fehler angehängten Daten aus der Eigenschaft data.
SessionFsSqliteTransactionFailure
Verwenden Sie diese Exception, wenn Sie einen SessionFs-SQLite-Provider implementieren. Sie fangen sie nicht ab, sondern werfen sie aus transaction() des Providers, um der Runtime mitzuteilen, wie der Fehler klassifiziert werden soll. Die Klassifizierung legen Sie mit errorClass fest:
Fatal (Standard): ein nicht behebbarer Fehler
BusyOrLocked: nur verwenden, wenn SQLite vor dem Commit BUSY/LOCKED zurückgegeben hat und die Transaktion zurückgerollt wurde
PostCommitAmbiguous: das Ergebnis nach dem Commit lässt sich nicht bestimmen
Jede andere Exception, die aus transaction() geworfen wird, wird als fatal gemeldet.
StrayRequestException
Wird vom Test-Fake geworfen, wenn Sie einen Request senden, für den kein passender Fake registriert ist. Tritt sie unerwartet auf, haben Sie vergessen, einen Fake für diesen Request zu registrieren. Wie Sie Fakes verwenden, erfahren Sie unter Tests.Zuletzt geändert am 15. November 2026