# トラブルシューティング

> エージェントが見当違いのことをした、実行が終わらない、何も起きない。よくある症状と、それぞれを実際に解決する方法。

よく起きる順に症状をまとめています。コネクター固有の問題は[専用のページ](/ja/docs/connect/troubleshooting/)にあります。

## エージェントが見当違いのことをした

何かを変える前に、まず[実行](/ja/docs/work/runs/)の中身を読みましょう。ツール呼び出しを見ればどこでずれたのかがわかり、直し方もそこから見えてきます。

| 実行に見られること | 原因 | 対処 |
| --- | --- | --- |
| ツールを一つも呼ばず、一般的な知識だけで答えた | 何かを調べるべきだとわかっていない | [システムプロンプト](/ja/docs/build/system-prompt/)にそう書く。コネクターが紐付けられているか確認する |
| 正しいツールを間違った引数で呼んだ | コンテキストが足りない | その事実をプロンプトか[メモリ](/ja/docs/capabilities/memory/)に入れる |
| 収束せずに同じことを繰り返した | タスクの指定があいまい、またはタスクの長さに対して[推論レベル](/ja/docs/build/models/#推論レベル)が低すぎる | タスクを絞る。推論レベルを上げる |
| 答えは正しいが、そのままでは使えない | 「完了」の基準が示されていない | 欲しい成果物の形をプロンプトに書く |
| 当たり前のことを聞いてきた | その事実が、エージェントから見える場所のどこにもない | プロンプト、メモリ、または[プロジェクト](/ja/docs/capabilities/projects/)に入れる |

一文の軌道修正で毎回実行を立て直せるなら、その一文はプロンプトに書いておくべきです。[テストと改善](/ja/docs/build/iterating/)を参照してください。

## 実行が終わらない

**一時停止して、あなたを待っています**。[質問](/ja/docs/work/questions/)、[承認](/ja/docs/work/approvals/)、[スキルのリクエスト](/ja/docs/capabilities/skills/#エージェントがスキルを求めるとき)があると、実行はそこで無期限に止まります。会話の一番下までスクロールしてください。応答を求める表示がそこにあります。

**ステップ数の上限に達しました**。長いタスクは、最終的な答えが出ないまま終わります。続けるよう頼むか、タスクを分割してください。

**失敗しました**。エラーは会話の中に表示されています。モデルのエラーは、たいていモデルプロバイダーが呼び出しを拒否したことを意味します。[BYOK](/ja/docs/account/bring-your-own-key/) を使っている場合は、キーとそのクレジット残高を確認してください。原因を解消したら、[アクティビティ](/ja/docs/work/activity/#失敗した実行を再試行する)ボードか、会話の上部にある**再試行**ボタンから再実行できます。

**アプリを閉じました**。それで何かが止まることはありません。実行は endue のサーバー上で最後まで進み、戻ってきたときにはスレッドに結果が届いています。

## メッセージを送っても何も起きない

- **すでに実行が進んでいます**。実行中に送ったメッセージは、新しいターンを始めるのではなく、進行中の実行を[軌道修正](/ja/docs/work/steering/)します。
- **利用枠を使い切っています**。その週の利用枠を使い切ると、実行は受け付けられなくなります。[プランと使用量](/ja/docs/account/plans-and-usage/)を参照してください。
- **ログアウトされています**。一定時間操作がないと、セッションは終了します。もう一度ログインすれば、会話は中断したところから続けられます。

## エージェントが以前できたことをできなくなった

| 症状 | 確認すること |
| --- | --- |
| コネクターのツールが消えた | 接続の再認証が必要か、紐付けが解除されています。[接続のトラブルシューティング](/ja/docs/connect/troubleshooting/)を参照してください |
| 物事を覚えなくなった | メモリの[ツールグループ](/ja/docs/capabilities/built-in-tools/)がオフになっている可能性があります |
| アウトプットを保存しなくなった | アウトプットのツールグループがオフになっている可能性があります |
| 以前のバージョンのように振る舞う | プロンプトの[リビジョン](/ja/docs/build/system-prompt/#リビジョンとロールバック)が復元された可能性があります |

変更が反映されるのは、次の実行からです。今加えた変更をエージェントが無視しているように見えるなら、おそらく実行の途中です。

## ルーティンが動かない

- **失敗が続いたため、一時停止されています**。endue は、失敗し続けるルーティンを延々と再試行するのではなく、一時停止してあなたに知らせます。
- **実行されたものの、操作を拒否しました**。誰も見ていない実行では、送信も削除もできません。[ルーティン](/ja/docs/automate/routines/#承認する人は誰もいない)を参照してください。
- **実行されたことに気づいていません**。[アクティビティ](/ja/docs/work/activity/)ボードを確認してください。結果はたいてい[アウトプット](/ja/docs/capabilities/outputs/)として届いています。

<Aside type="tip" title="新しい会話で再現してみる">
  長いスレッドには、設定とは関係なく答えを変えてしまう履歴が積み重なっています。原因を特定しにくい問題なら、エージェントが壊れていると結論づける前に、新しい会話で同じ依頼をしてみてください。
</Aside>

## 困ったときは

- **ドキュメントを検索**：どのページからでも <kbd>Ctrl</kbd>/<kbd>⌘</kbd> + <kbd>K</kbd> を押します。
- **メールで問い合わせる**：[support@endue.ai](mailto:support@endue.ai) まで。何を依頼したか、エージェントが何をしたか、どのツール呼び出しでおかしくなったかを書き添えてください。たいていはそれだけで、何度もやり取りせずに回答できます。

## 関連項目

<CardGrid>
  <LinkCard
    title="接続のトラブルシューティング"
    href="/ja/docs/connect/troubleshooting/"
    description="期限切れのトークン、取り消されたアクセス権、間違ったアカウント。"
  />
  <LinkCard
    title="テストと改善"
    href="/ja/docs/build/iterating/"
    description="繰り返し起きる問題を、より良いエージェントづくりに生かす。"
  />
  <LinkCard
    title="実行"
    href="/ja/docs/work/runs/"
    description="実行の読み方と、実行が止まるあらゆる理由。"
  />
</CardGrid>