ユーザーガイドを開く

エージェントのエラーと対処法

AIエージェントがShotomaticから受け取るエラーコードと停止理由、それぞれの意味とユーザーにできることをまとめました。

更新日 2026年11月16日

Markdownを表示
このページの内容

Shotomaticのツールがエージェントの依頼を実行できないときは、code、メッセージ、再試行で解決するかどうか、多くの場合はユーザーにしてほしいことを含むエラーを返します。よくできたエージェントは、そのしてほしいことをユーザーに伝えます。エージェントがエラーコードを報告したときに何をすればよいか分かるよう、すべてのコードをまとめました。

エラーコード

コード意味できること
approval_requiredまだ許可していないエージェントです。許可するまでは状態しか読めません。Shotomaticを開き、許可カードで許可を選びます。
permission_requiredmacOSで画面収録、またはキー入力に必要なアクセシビリティが許可されていません。システム設定 > プライバシーとセキュリティでShotomaticをオンにして、開き直します。macOSの権限をご覧ください。
license_limit1日のスクリーンショット数やバッチあたりのURL数など、無料プランの上限に達しました。作業を小さくする、明日にする、または料金を確認します。保存済みのスクリーンショットは残ります。
pro_featureユーザーにProが必要な機能は、エージェントにもProが必要です。その機能を使わない依頼にするか、アップグレードします。
busy別の撮影が実行中か、Shotomaticがすでに何かを確認しています。別の作業が終わるか止めるまで待ち、開いているカードに答えてから、もう一度依頼します。
source_unavailableウインドウや画面がなくなったか、撮影できません。ウインドウを開き直すか、別の対象を選ぶようエージェントに伝えます。
not_foundセッション、ドキュメント、ワークフロー、ジョブのIDがもう存在しません。項目の一覧を取り直すようエージェントに伝えます。
revision_conflictエージェントが読み込んだ後にドキュメントが変わりました。多くはユーザーが編集した場合です。エージェントがドキュメントを読み直し、変更をやり直す必要があります。
browser_not_installedWebサイトキャプチャに必要なShotomaticのブラウザがまだインストールされていません。ShotomaticでWebサイトキャプチャのページを開き、ブラウザをインストールします。
invalid_requestエージェントが、Shotomaticで使えない値を送りました。多くはエージェントが自分で直します。繰り返す場合は、依頼の言い方を変えてみます。
confirmation_declined確認カードでキャンセルを選びました。何もする必要はありません。削除もスケジュール設定も行われていません。
confirmation_timeout1分以内に確認カードへの返事がありませんでした。パソコンの前にいるときに、もう一度依頼します。
unavailableShotomaticのメインウインドウが開いていないか、アプリがジョブを開始できませんでした。Shotomaticを開いてメインウインドウを表示したまま、もう一度依頼します。
failedそのほかの問題が起きました。メッセージを確認して再試行します。繰り返す場合はサポートに連絡してください。

撮影が一時停止した理由

エージェントが始めた自動キャプチャは、間違った場所でキーを押す代わりに一時停止します。

  • 別のウインドウが前面にある: Shotomaticは、撮影中のウインドウが前面にないときはキーを押しません。ウインドウを前面に戻し、再開するようエージェントに伝えます。撮影中はパソコンに触れないでください。
  • 画面がロックされた: ロックを解除し、再開するようエージェントに伝えます。

撮影が終了した理由

ジョブが終わると、エージェントは理由を受け取ります。次の理由は正常な終了です。

  • 内容が変わらなくなった: キーを押す撮影は、本の最後のようにページが変わらなくなると止まります。
  • 停止条件に達した: 指定した枚数、時間、終了時刻に達しました。
  • ユーザーまたはエージェントが止めた: ユーザーがキャプチャを終了を選んだか、エージェントがジョブを止めました。撮影済みのスクリーンショットは残ります。

次の理由は確認が必要です。

  • 無料の上限に達した: 無料プランの上限で撮影が終わりました。それまでに保存したスクリーンショットはキャプチャ履歴にあります。操作キャプチャは、無料プランでは5手順で終わります。
  • ウインドウが閉じられた: 撮影中に対象のウインドウが閉じられました。
  • ウインドウを前面に保てなかった: Shotomaticがウインドウを前面に出せませんでした。ウインドウが見える状態にし、パソコンを使わずに、もう一度始めるようエージェントに伝えます。
  • 別の場所でセッションが終了した: 撮影中に、Shotomatic側でキャプチャセッションが閉じられました。

それでも解決しない場合は、トラブルシューティングやクライアントのトラブルシューティング一覧をご覧ください。

エージェントのエラーと対処法 | ユーザーガイド | Shotomatic