AI エージェントの実行履歴
AI エージェントが AI エージェントノードまたは API から実行されるたびに、MonoChat はその実行を記録します。使用したハーネスとモデル、与えられた指示、行ったすべてのモデル呼び出しとツール呼び出し、予算の使用量、そして終了の状況が記録されます。
実行履歴は 設定 › オートメーション › AI エージェントの実行履歴 にあります。このメニュー項目は、オートメーション内の AI エージェント実行の閲覧権限を持つユーザーに表示されます。
実行の一覧
| 列 | 表示内容 |
|---|---|
| AI ハーネス | エージェントを実行したハーネス。カーソルを重ねるとハーネスの種類が表示されます。 |
| ステータス | 待機中、実行中、完了、失敗、予算超過、タイムアウト、キャンセル済みのいずれか。失敗した実行にカーソルを重ねるとエラーが表示されます。 |
| モデル呼び出し | 使用したモデル呼び出し数 / 予算の最大モデル呼び出し数。 |
| ツール呼び出し | 使用したツール呼び出し数 / 予算の最大ツール呼び出し数。 |
| トークン | 合計トークン数。カーソルを重ねると、入力トークンと出力トークンが表示されます。プロバイダーが報告している場合は、キャッシュの読み取りと書き込みも表示されます。 |
| 所要時間 | 実行にかかった時間。 |
| 作成日時 | 実行が開始された日時。 |
各行には 3 つのボタンがあります。
- IDをコピー: 実行 ID をコピーします。たとえば
aiAgentRuns.showで検索したり、サポートに送ったりするときに使います。 - チャット: その実行が作業した会話を開きます。会話に属する実行にのみ表示されます。
- 表示: 実行の詳細を開きます。
フィルターを使うと、AIハーネス、ステータス、作成日時（期間）で一覧を絞り込めます。一覧は自動では更新されません。新しい実行やステータスの変更を読み込むには、ヘッダーの更新ボタンを使ってください。
実行の詳細
表示をクリックすると、AI エージェントの実行ドロワーが開きます。
サマリー
| 行 | 表示内容 |
|---|---|
| ID | 実行 ID（コピーボタン付き）。 |
| AI ハーネス | ハーネスの名前と種類。 |
| ステータス | 実行がどのように終了したか、またはまだ待機中か実行中か。 |
| エラー | 完了しなかった実行のエラーメッセージ。 |
| メインモデル、フォールバックモデル（ソフトリミット後）、高速モデル（軽量なバックグラウンドタスク用） | AI モデルを使用するハーネスで、ノードに設定された AI モデル。 |
| モデル（ハーネスで許可されたモデルのいずれか） | ホステッドハーネスの場合のモデル。 |
| 作成日時、開始日時、終了日時 | 実行がキューに入った日時、開始した日時、終了した日時。 |
| 所要時間 | 使用した時間 / 最大実行時間（秒）。 |
| モデル呼び出し | 使用した呼び出し数 / 最大数。ソフトリミットが設定されている場合はその値も表示されます。 |
| ツール呼び出し | 使用した呼び出し数 / 最大数。 |
| トークン | 入力トークンと出力トークン（およびキャッシュトークン）、合計 / 最大合計トークン数。 |
ステップ
ステップには、エージェントが行ったことが順番に表示され、右側には実行開始からの経過時間が表示されます。
| ステップ | 表示内容 |
|---|---|
| モデル呼び出し n | モデル、入力トークンと出力トークン、そしてモデルが要求したツール（要求されたツール: …）または最終回答。 |
| ツール呼び出し | ツールの名前と所要時間。 |
| フォールバックモデルに切り替えました | 実行がソフトリミットに達し、フォールバックモデルで続行したことを示します。 |
| 中間メッセージ | エージェントが作業中に書いたメッセージ。お客様に送信されたもの、またはウィスパーとして追加されたもの。 |
| 再試行 | 失敗して再試行されたモデル呼び出しと、そのエラー。 |
ハーネスがステップを報告しない場合、ドロワーには「この実行にはステップが記録されていません。」と表示されます。
手順、入力、結果、JSONデータ
- 手順: エージェントが受け取ったノードの手順。
- 入力: タグがすでに入力された状態のタスク。
- 結果: エージェントの最終回答。
- JSONデータ: 実行記録の全体。コピーボタンを使って、開発者や MonoChat サポートと共有できます。
エージェントのデバッグ
| 状況 | 確認すること |
|---|---|
| 予算超過でモデル呼び出しが最大に達している | ステップを確認してください。エージェントが収束せずにツールを呼び出し続けている場合は、手順とツールの説明をより具体的にします。タスクが本当により多くのステップを必要とする場合は、最大モデル呼び出し数を引き上げてください。 |
| 予算超過でトークンが最大に達している | 長い会話履歴や大きなツールの結果がトークン予算を使い切っています。メッセージ履歴の上限を下げるか、ツールが返すデータを減らすか、最大合計トークン数を引き上げてください。 |
| 予算超過でツール呼び出しが最大に達している | エージェントが許可された数を超えるツールを要求しました。最大ツール呼び出し数を引き上げるか、どのツールをどのような場合に使うかを手順で伝えてください。 |
| タイムアウト | ステップでツール呼び出しの所要時間を確認してください。API や MCP サーバーの応答が遅いと、**最大実行時間（秒）**を使い切ってしまいます。 |
| 失敗で「An AI scope or MCP tool was not found in this workspace.」と表示される | ノードのスコープまたは MCP ツールが削除されました。ノードのツール設定を更新してください。 |
| 失敗で「Choose one of the AI harness's allowed models.」と表示される | ノードのモデルが、ホステッドハーネスの許可されるモデルから削除されました。 |
| 失敗で「This harness is not available on this server.」と表示される | このハーネスには MonoChat のエージェントランナーが必要ですが、利用できません。別のハーネスを選択してください。 |
| お客様に回答が届かなかった | 実行が完了していること、ノードで回答を送信がオンになっていること、結果が空でないことを確認してください。 |
| 意図しない「考え中」のメッセージがお客様に表示された | 中間メッセージをお客様に転送をオフにしてください。メッセージはチーム向けのウィスパーとして残ります。 |
ヒント
予算を変更する前に、同じノードの実行をいくつか比較してください。ステップを見れば、エージェントに必要なのは余裕なのか、より良い手順なのかがわかります。