# Fehler von Agenten beheben | Benutzerhandbuch | Shotomatic

> Fehlercodes und Stoppgründe, die ein KI-Agent von Shotomatic bekommen kann, was sie bedeuten und was du tun kannst.

- Typ: Öffentliche Webseite
- Kanonische Seite: [https://www.shotomatic.com/de/guide/ai-agents/errors](https://www.shotomatic.com/de/guide/ai-agents/errors)
- Markdown-Seite: [https://www.shotomatic.com/de/guide/ai-agents/errors.md](https://www.shotomatic.com/de/guide/ai-agents/errors.md)

Benutzerhandbuch durchsuchen

Auf dieser Seite

1.  [Fehlercodes](#fehlercodes)
2.  [Warum eine Aufnahme pausiert](#warum-eine-aufnahme-pausiert)
3.  [Warum eine Aufnahme endete](#warum-eine-aufnahme-endete)

Kann ein Werkzeug von Shotomatic eine Anfrage nicht ausführen, gibt es einen Fehler mit `code`, einer Meldung, der Angabe, ob ein neuer Versuch helfen kann, und oft einem Schritt für dich zurück. Ein guter Agent gibt diesen Schritt an dich weiter. Diese Seite listet alle Codes, damit du weißt, was zu tun ist, wenn ein Agent einen meldet.

## Fehlercodes

Code

Bedeutung

Was du tun kannst

`approval_required`

Der Agent ist noch nicht zugelassen. Bis dahin kann er nur den Status lesen.

Öffne Shotomatic und wähle auf der Zulassungskarte **Erlauben**.

`permission_required`

macOS hat **Bildschirmaufnahme** oder, für Tastendrücke, **Bedienungshilfen** nicht erlaubt.

Schalte Shotomatic unter **Systemeinstellungen > Datenschutz & Sicherheit** ein und öffne es neu. Siehe [macOS-Berechtigungen](https://www.shotomatic.com/de/guide/get-started/macos-permissions).

`license_limit`

Eine Grenze der kostenlosen Version ist erreicht, etwa Screenshots pro Tag oder URLs pro Stapel.

Wähle einen kleineren Job, warte bis morgen oder sieh dir die [Preise](https://www.shotomatic.com/de/pricing) an. Bereits gespeicherte Screenshots bleiben erhalten.

`pro_feature`

Die Anfrage nutzt eine Funktion, die Pro braucht, für den Agenten genau wie für dich.

Bitte um den Job ohne diese Funktion oder steige auf Pro um.

`busy`

Eine andere Aufnahme läuft, oder Shotomatic fragt dich bereits etwas.

Lass den anderen Job enden oder stoppe ihn, beantworte die offene Karte und frag dann erneut.

`source_unavailable`

Das Fenster oder der Bildschirm ist weg oder lässt sich nicht aufnehmen.

Öffne das Fenster erneut oder bitte den Agenten, eine andere Quelle zu wählen.

`not_found`

Die ID der Session, des Dokuments, des Ablaufs oder des Jobs gibt es nicht mehr.

Bitte den Agenten, die Elemente erneut aufzulisten.

`revision_conflict`

Das Dokument hat sich geändert, nachdem der Agent es gelesen hat, meist weil du es bearbeitet hast.

Der Agent sollte das Dokument neu lesen und seine Änderung erneut anwenden.

`browser_not_installed`

Website Capture braucht den Browser von Shotomatic, der noch nicht installiert ist.

Öffne in Shotomatic die Seite Website Capture und installiere den Browser.

`invalid_request`

Der Agent hat einen Wert geschickt, mit dem Shotomatic nichts anfangen kann.

Meist korrigiert der Agent das selbst. Wiederholt es sich, formuliere die Anfrage anders.

`confirmation_declined`

Du hast auf einer Bestätigungskarte **Abbrechen** gewählt.

Nichts. Es wurde nichts gelöscht oder geplant.

`confirmation_timeout`

Niemand hat eine Bestätigungskarte innerhalb einer Minute beantwortet.

Frag erneut, wenn du am Computer bist.

`unavailable`

Das Hauptfenster von Shotomatic ist nicht offen, oder die App konnte den Job nicht starten.

Öffne Shotomatic, lass das Hauptfenster offen und frag erneut.

`failed`

Etwas anderes ist schiefgegangen.

Lies die Meldung, versuch es erneut und [wende dich an den Support](mailto:support@shotomatic.com), wenn es sich wiederholt.

## Warum eine Aufnahme pausiert

Eine Auto Capture, die ein Agent gestartet hat, pausiert, statt Tasten an der falschen Stelle zu drücken:

-   **Ein anderes Fenster liegt vorn.** Shotomatic drückt nie eine Taste, solange das aufgenommene Fenster nicht vorn liegt. Hol es zurück und sag dem Agenten, dass er fortsetzen soll. Lass den Computer während der Aufnahme in Ruhe.
-   **Der Bildschirm ist gesperrt.** Entsperre ihn und sag dem Agenten, dass er fortsetzen soll.

## Warum eine Aufnahme endete

Wenn ein Job endet, bekommt der Agent einen Grund. Diese sind normal:

-   **Der Inhalt ändert sich nicht mehr.** Mit Tastendruck stoppt Shotomatic, sobald sich die Seite nicht mehr ändert, etwa am Ende eines Buchs.
-   **Stoppbedingung erreicht.** Die gewünschte Anzahl an Screenshots, die Dauer oder die Endzeit wurde erreicht.
-   **Von dir oder vom Agenten gestoppt.** Du hast **Aufnahme beenden** gewählt, oder der Agent hat den Job gestoppt. Bereits aufgenommene Screenshots bleiben erhalten.

Diese brauchen deine Aufmerksamkeit:

-   **Grenze der kostenlosen Version erreicht.** Die Grenze der kostenlosen Version hat die Aufnahme beendet. Die bis dahin gespeicherten Screenshots liegen im Aufnahmeverlauf. Eine Action Capture endet in der kostenlosen Version nach 5 Schritten.
-   **Fenster geschlossen.** Das aufgenommene Fenster wurde während der Aufnahme geschlossen.
-   **Fenster blieb nicht vorn.** Shotomatic konnte das Fenster nicht nach vorn bringen. Lass es sichtbar, benutze den Computer nicht und bitte den Agenten, neu zu starten.
-   **Session anderswo beendet.** Die Aufnahme-Session wurde in Shotomatic geschlossen, während die Aufnahme lief.

Kommst du nicht weiter? Sieh unter [Fehlerbehebung](https://www.shotomatic.com/de/guide/troubleshooting/common-issues#ein-ki-agent-kann-sich-nicht-verbinden-oder-shotomatic-nicht-nutzen) oder in der [Fehlerliste für Clients](https://www.shotomatic.com/de/guide/ai-agents/other-agents#fehlerbehebung) nach.

## Auf dieser Seite

1.  [Fehlercodes](#fehlercodes)
2.  [Warum eine Aufnahme pausiert](#warum-eine-aufnahme-pausiert)
3.  [Warum eine Aufnahme endete](#warum-eine-aufnahme-endete)

## Über diese Fassung

Diese Markdown-Seite wird aus der öffentlich erreichbaren, serverseitig gerenderten Shotomatic-Seite erzeugt. Interaktive Bedienelemente und die Seitennavigation sind nicht enthalten. Verwende zum Zitieren oder Teilen die kanonische Seite.
