- TRACE
- LATENCY
- ERROR
- HUMAN
すぐに答え
エージェントのツール呼び出しをどうデバッグすればいいですか?
エージェントがMetorialを使用して詳細な実行トレースを取得し、ツール呼び出しの失敗や停止箇所をピンポイントで特定します。各ステップの入出力内容を明確に把握できます。
デバッグ結果の分類
データの分類項目
AIがトレース情報を特定のカテゴリに自動で分類します。
TRACE
ロジックの欠落を特定
AIがトレースログを取得し、エージェントの推論が意図した経路から外れた箇所を特定します。
LATENCY
遅延の原因を特定
AIが実行タイミングをチェックし、どのツールが遅延を引き起こしているかを明らかにします。
ERROR
失敗箇所を特定
AIがエラーを返した特定のツール呼び出しを分離し、その原因を説明します。
HUMAN
手動確認が必要
AIが、ユーザーによる介入やエージェントのロジック・パラメータの修正が必要なトレースをフラグ立てします。
ワークフロー
デバッグ依頼を受けた際のAIの動作
AIがエージェントのログとチャットウィンドウを繋ぐ架け橋となります。
直近のアクティビティをスキャン
AIが直近の実行ログを調査し、関連するツールとのやり取りを見つけ出します。
metorial_list_traces特定のトレースを抽出
エラーや遅延の報告に一致する、正確なトレースを選択します。
metorial_get_trace_detailsツールデータの詳細調査
失敗または遅延した呼び出しで使用された、具体的な入出力内容を読み取ります。
metorial_get_trace_details問題の要約
トレースデータに基づき、ツール呼び出しが失敗した理由を分かりやすく説明します。
metorial_get_trace_details
試してみる
以下のプロンプトをコピーして開始できます。
これらのプロンプトを使ってデバッグを開始しましょう。
出発点
ツール名やエラーの内容を、実際の状況に合わせて書き換えてください。
Metorial Connector
準備完了です。MCPクライアントを選択し、セットアップ手順に従ってください。
https://edge.vinkius.com/vk_preview_u9gVDS60iTHUlTLh8tFcQxn710vU1GGlSnGwhKcw/mcpClaude Desktop
以下の手順で数秒で接続できます。
- 1In Claude Desktop, open Settings → Connectors.
- 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
- 3Click Add and start a new chat — Metorial capabilities are ready to use.
{
"mcpServers": {
"metorial-mcp": {
"url": "https://edge.vinkius.com/vk_preview_u9gVDS60iTHUlTLh8tFcQxn710vU1GGlSnGwhKcw/mcp"
}
}
}エージェントの最新の実行トレースをリストアップして。
'stripe_payment' ツールにおける直近の失敗した呼び出しの詳細を教えて。
'search_docs' ツールが3秒以上かかったトレースを見つけて。
直近のトレースで、なぜ 'send_email' ツールがエラーを返したのですか?
Claude
ChatGPT
Cursor
VS Code
Windsurf
Claude Code
JetBrains
Cline
ここから始める
一度接続すれば、あとは聞くだけです。
アカウントの連携は一度だけで完了します。認証情報は暗号化されて保護されるため、すぐにエージェントへ実行トレースについて質問できるようになります。
MetorialをAIに接続するFAQ
Metorialによるデバッグの仕組み
- 01
AIがツールのコードを修正してくれますか?
いいえ。AIはトレースを読み取って何が起きたかを伝えるのみです。コードの修正はご自身で行う必要があります。
- 02
AIは実行トレースを削除できますか?
いいえ。ツールはAIによるトレースのリスト表示と詳細取得のみを許可しています。ログを削除することはできません。
- 03
AIはどのトレースを見ればよいかどうやって判断しますか?
AIはリスト取得ツールを使用して関連するトレースを探し、その中から指定されたトレースの詳細を取得します。
- 04
あらゆるMCPクライアントで動作しますか?
はい。Claude、Cursor、Windsurfなど、Model Context Protocolをサポートしているあらゆるクライアントで動作します。
- 05
ツール呼び出しで使用された正確な引数を確認できますか?
はい。AIが特定のトレース詳細を取得することで、ツールに送信された正確な入力値を確認できます。
Metorialについてさらに詳しく知りたいですか?コネクターのページで回答しています。 Metorialコネクターの全機能を見る
『Metorial』を Claude、Cursor、ChatGPT などに接続
