On this page
AIエージェントの実行を監視する
AIエージェントがチケットに対してトリガーされるたびに、LiveAgentはその全ライフサイクルを追跡する**実行記録(run record)**を作成します。この記事では、実行記録の確認場所、各実行ステータスの意味、および考えられる失敗理由の解釈方法について説明します。
実行記録を確認するには、Reports > AI Agent Runs(レポート > AIエージェント実行)に移動します。このセクションは、アカウントでAIエージェント機能が有効になっている場合に利用可能で、AIエージェントを管理する権限が必要です。
実行記録に表示される内容
各実行記録には以下が表示されます:
- 実行されたAIエージェント
- 処理されたチケット
- 開始時刻と処理時間
- 実行されたツール呼び出しの回数
- 現在のステータス、および該当する場合は失敗理由
実行ステータス
| ステータス | 意味 |
|---|---|
| Running(実行中) | 実行が作成され、AIプロバイダーに送信されました。フローまたはモデルが実行中で、ツール呼び出しを行っている場合があります。 |
| Completed(完了) | 実行が処理を完了しました — AIがツール呼び出しを行い、チケットに対して最終的なアクションに到達しました。 |
| Failed(失敗) | 実行が完了しませんでした。実行記録を開いて失敗理由を確認してください(下記参照)。 |
スロットリング(Throttling): AIプロバイダーが一時的にレート制限(rate-limited)を受けている場合、LiveAgentは自動的に実行を一時停止し、プロバイダーのスロットル期間が終了した時点で再開します — お客様側での対応は不要です。一時停止された実行が開始から60分以内に再開できない場合、タイムアウトとなります。
セーフティネット・タイムアウト: Running(実行中)の状態が10分以上続いても完了しない実行は、自動的に終了されます。すでに少なくとも1回のツール呼び出しを行っていた場合はCompleted(完了)としてマークされ、1回も行っていなかった場合はFailed(失敗)としてExecution timed out(実行がタイムアウトしました)の理由でマークされます。
考えられる失敗理由
実行が失敗すると、その記録には以下のいずれかの理由が表示されます:
| 理由 | 意味 | 対処方法 |
|---|---|---|
| Execution timed out(実行がタイムアウトしました) | 実行が時間内に完了せず、時間枠が経過するまでツール呼び出しが行われませんでした — 10分以上実行中の状態が続いたか、スロットリングされた実行が開始から60分以内に再開できなかったかのいずれかです。 | フローまたはモデルの設定と、プロバイダーの可用性を確認してください。スロットリングが頻繁に発生する場合は、同時にAIエージェントをトリガーするルールの数を減らしてください。次に一致するルールトリガーが発生すると、自動的に新しい実行が作成されます。 |
| AI provider error(AIプロバイダーエラー) | 処理中にAIモデルが予期しないエラーを返しました。 | プロバイダーまたはフローの設定を確認してください。エラーが断続的なものであれば、次のルールトリガーで自動的に新しい実行が作成されます。 |
| Tool execution failed(ツール実行に失敗しました) | AIがツール呼び出しを要求しましたが、そのアクションを完了できませんでした(例:もう存在しないエージェントにチケットを割り当てようとした場合)。 | フローまたはエージェントのロジックを確認し、参照されているエージェント、部門、タグがLiveAgentに引き続き存在するか確認してください。 |
| Tenant rate limit exceeded(テナントのレート制限を超過しました) | アカウント全体のAIレート制限に達しました。 | 同時にAIエージェントをトリガーするルールの数を減らすか、負荷を分散させてください。制限は時間の経過とともに自動的にリセットされます。 |
| Monthly AI budget exhausted(月間AI予算が使い切られました) | この実行に選択された予算が、実行完了前に月間ツール呼び出し上限に達しました。 | 予算の月間上限を増やすか、チケットあたりのツール呼び出しをより少なくするようフローを簡素化してください。詳細はAI Budgets & Credits(AI予算とクレジット)を参照してください。各予算の使用状況は、毎月月初にリセットされます。 |
| Credit pool exhausted(クレジットプールが使い切られました) | アカウントのAIクレジット残高がすべて使用されました。 | クレジットの仕組みとアカウントに含まれる無料クレジットについては、AI Budgets & Credits(AI予算とクレジット)を参照してください。 |
| Ticket was deleted(チケットが削除されました) | AIが処理中に、チケットがLiveAgentから削除されました。 | 対応は不要です。これは処理中にチケットが削除された場合の想定される動作です。 |