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

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

- 種類: 公開Webページ
- 正規ページ: [https://www.shotomatic.com/ja/guide/ai-agents/errors](https://www.shotomatic.com/ja/guide/ai-agents/errors)
- Markdownページ: [https://www.shotomatic.com/ja/guide/ai-agents/errors.md](https://www.shotomatic.com/ja/guide/ai-agents/errors.md)

ユーザーガイドを開く

このページの内容

1.  [エラーコード](#エラーコード)
2.  [撮影が一時停止した理由](#撮影が一時停止した理由)
3.  [撮影が終了した理由](#撮影が終了した理由)

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

## エラーコード

コード

意味

できること

`approval_required`

まだ許可していないエージェントです。許可するまでは状態しか読めません。

Shotomaticを開き、許可カードで**許可**を選びます。

`permission_required`

macOSで**画面収録**、またはキー入力に必要な**アクセシビリティ**が許可されていません。

**システム設定 > プライバシーとセキュリティ**でShotomaticをオンにして、開き直します。[macOSの権限](https://www.shotomatic.com/ja/guide/get-started/macos-permissions)をご覧ください。

`license_limit`

1日のスクリーンショット数やバッチあたりのURL数など、無料プランの上限に達しました。

作業を小さくする、明日にする、または[料金](https://www.shotomatic.com/ja/pricing)を確認します。保存済みのスクリーンショットは残ります。

`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`

そのほかの問題が起きました。

メッセージを確認して再試行します。繰り返す場合は[サポートに連絡](mailto:support@shotomatic.com)してください。

## 撮影が一時停止した理由

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

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

## 撮影が終了した理由

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

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

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

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

それでも解決しない場合は、[トラブルシューティング](https://www.shotomatic.com/ja/guide/troubleshooting/common-issues#ai%E3%82%A8%E3%83%BC%E3%82%B8%E3%82%A7%E3%83%B3%E3%83%88%E3%81%8C%E6%8E%A5%E7%B6%9A%E3%81%A7%E3%81%8D%E3%81%AA%E3%81%84%E3%81%BE%E3%81%9F%E3%81%AFshotomatic%E3%82%92%E4%BD%BF%E3%81%88%E3%81%AA%E3%81%84)や[クライアントのトラブルシューティング一覧](https://www.shotomatic.com/ja/guide/ai-agents/other-agents#%E3%83%88%E3%83%A9%E3%83%96%E3%83%AB%E3%82%B7%E3%83%A5%E3%83%BC%E3%83%86%E3%82%A3%E3%83%B3%E3%82%B0)をご覧ください。

## このページの内容

1.  [エラーコード](#エラーコード)
2.  [撮影が一時停止した理由](#撮影が一時停止した理由)
3.  [撮影が終了した理由](#撮影が終了した理由)

## この版について

このMarkdownページは、サーバーでレンダリングされたShotomaticの公開ページから生成されています。操作部品とサイトナビゲーションは含まれません。引用や共有には正規ページを使用してください。
