エージェントのエラーと対処法
AIエージェントがShotomaticから受け取るエラーコードと停止理由、それぞれの意味とユーザーにできることをまとめました。
更新日 2026年11月16日
このページの内容
Shotomaticのツールがエージェントの依頼を実行できないときは、code、メッセージ、再試行で解決するかどうか、多くの場合はユーザーにしてほしいことを含むエラーを返します。よくできたエージェントは、そのしてほしいことをユーザーに伝えます。エージェントがエラーコードを報告したときに何をすればよいか分かるよう、すべてのコードをまとめました。
エラーコード
| コード | 意味 | できること |
|---|---|---|
approval_required | まだ許可していないエージェントです。許可するまでは状態しか読めません。 | Shotomaticを開き、許可カードで許可を選びます。 |
permission_required | macOSで画面収録、またはキー入力に必要なアクセシビリティが許可されていません。 | システム設定 > プライバシーとセキュリティでShotomaticをオンにして、開き直します。macOSの権限をご覧ください。 |
license_limit | 1日のスクリーンショット数やバッチあたりのURL数など、無料プランの上限に達しました。 | 作業を小さくする、明日にする、または料金を確認します。保存済みのスクリーンショットは残ります。 |
pro_feature | ユーザーにProが必要な機能は、エージェントにもProが必要です。 | その機能を使わない依頼にするか、アップグレードします。 |
busy | 別の撮影が実行中か、Shotomaticがすでに何かを確認しています。 | 別の作業が終わるか止めるまで待ち、開いているカードに答えてから、もう一度依頼します。 |
source_unavailable | ウインドウや画面がなくなったか、撮影できません。 | ウインドウを開き直すか、別の対象を選ぶようエージェントに伝えます。 |
not_found | セッション、ドキュメント、ワークフロー、ジョブのIDがもう存在しません。 | 項目の一覧を取り直すようエージェントに伝えます。 |
revision_conflict | エージェントが読み込んだ後にドキュメントが変わりました。多くはユーザーが編集した場合です。 | エージェントがドキュメントを読み直し、変更をやり直す必要があります。 |
browser_not_installed | Webサイトキャプチャに必要なShotomaticのブラウザがまだインストールされていません。 | ShotomaticでWebサイトキャプチャのページを開き、ブラウザをインストールします。 |
invalid_request | エージェントが、Shotomaticで使えない値を送りました。 | 多くはエージェントが自分で直します。繰り返す場合は、依頼の言い方を変えてみます。 |
confirmation_declined | 確認カードでキャンセルを選びました。 | 何もする必要はありません。削除もスケジュール設定も行われていません。 |
confirmation_timeout | 1分以内に確認カードへの返事がありませんでした。 | パソコンの前にいるときに、もう一度依頼します。 |
unavailable | Shotomaticのメインウインドウが開いていないか、アプリがジョブを開始できませんでした。 | Shotomaticを開いてメインウインドウを表示したまま、もう一度依頼します。 |
failed | そのほかの問題が起きました。 | メッセージを確認して再試行します。繰り返す場合はサポートに連絡してください。 |
撮影が一時停止した理由
エージェントが始めた自動キャプチャは、間違った場所でキーを押す代わりに一時停止します。
- 別のウインドウが前面にある: Shotomaticは、撮影中のウインドウが前面にないときはキーを押しません。ウインドウを前面に戻し、再開するようエージェントに伝えます。撮影中はパソコンに触れないでください。
- 画面がロックされた: ロックを解除し、再開するようエージェントに伝えます。
撮影が終了した理由
ジョブが終わると、エージェントは理由を受け取ります。次の理由は正常な終了です。
- 内容が変わらなくなった: キーを押す撮影は、本の最後のようにページが変わらなくなると止まります。
- 停止条件に達した: 指定した枚数、時間、終了時刻に達しました。
- ユーザーまたはエージェントが止めた: ユーザーがキャプチャを終了を選んだか、エージェントがジョブを止めました。撮影済みのスクリーンショットは残ります。
次の理由は確認が必要です。
- 無料の上限に達した: 無料プランの上限で撮影が終わりました。それまでに保存したスクリーンショットはキャプチャ履歴にあります。操作キャプチャは、無料プランでは5手順で終わります。
- ウインドウが閉じられた: 撮影中に対象のウインドウが閉じられました。
- ウインドウを前面に保てなかった: Shotomaticがウインドウを前面に出せませんでした。ウインドウが見える状態にし、パソコンを使わずに、もう一度始めるようエージェントに伝えます。
- 別の場所でセッションが終了した: 撮影中に、Shotomatic側でキャプチャセッションが閉じられました。
それでも解決しない場合は、トラブルシューティングやクライアントのトラブルシューティング一覧をご覧ください。