- LATENCY
- ERRORS
- PAYLOADS
- HUMAN
すぐに答え
AIの呼び出しが遅い、または失敗する原因を特定するには?
エージェントがPortkeyのゲートウェイログを使用し、遅延の大きいリクエストや特定のエラーコードを特定します。直近のログ一覧を取得したり、失敗した単一のリクエストの詳細を掘り下げて、ペイロードやレスポンスの内容を確認したりすることが可能です。チャット画面を離れることなく、何が問題だったのかを正確に把握できます。
デバッグの結果
デバッグデータの活用方法
AIがログデータを、実行可能なカテゴリーに整理します。
LATENCY
遅延の特定
AIが直近のログをスキャンし、想定応答時間を超えたリクエストを見つけ出します。遅延の原因となっている特定のエンドポイントをリストアップします。
ERRORS
失敗原因の特定
AIが失敗した呼び出しの正確なエラーメッセージとステータスコードを取得します。モデルのタイムアウトなのか、プロンプトの形式不備なのかを判断できます。
PAYLOADS
リクエスト詳細の調査
AIが特定のログエントリのフルボディを取得します。モデルに送信された正確な入力内容と、返された生の出力内容を確認できます。
HUMAN
手動での対応
AIは失敗のパターンを特定しますが、コードの修正やモデル設定の変更は行えません。修正はアプリケーション側で直接行う必要があります。
ワークフロー
リクエスト失敗時にAIが行うこと
エージェントがチャットとPortkeyゲートウェイの橋渡し役となります。
直近のアクティビティをスキャン
エージェントが最新のゲートウェイトラフィックを確認し、問題のあるエントリを探します。
list_logs問題を切り分ける
遅延や失敗した呼び出しが見つかると、エージェントはそのイベントの特定データを取得します。
get_log_detailsエラーを分析する
エージェントがエラーメッセージとリクエストのペイロードを読み取り、呼び出しが失敗した理由を説明します。
get_log_details調査結果をまとめる
エージェントが遅延やエラーのパターンについて、分かりやすい説明を提示します。
list_logs
試してみる
以下のプロンプトをコピーして開始
これらのプロンプトを使って、すぐにデバッグを開始できます。
出発点
エラーの種類や期間を書き換えることで、より具体的な結果を得られます。
Portkey Connector
準備完了です。MCPクライアントを選択し、セットアップ手順に従ってください。
https://edge.vinkius.com/vk_preview_BpHtQMK896fkGyepmah9cM552NpibU6fUP5BakNG/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 — Portkey capabilities are ready to use.
{
"mcpServers": {
"portkey-mcp": {
"url": "https://edge.vinkius.com/vk_preview_BpHtQMK896fkGyepmah9cM552NpibU6fUP5BakNG/mcp"
}
}
}Portkeyの直近10件のログを表示して、最近のエラーがないか確認してください。
完了までに5秒以上かかった最新のリクエストを見つけてください。
過去5分間に発生した失敗リクエストの詳細を取得してください。
500エラーコードを返したすべてのログをリストアップしてください。
Claude
ChatGPT
Cursor
VS Code
Windsurf
Claude Code
JetBrains
Cline
ここから始める
Portkeyを一度接続すれば、あとは聞くだけです。
PortkeyのAPIキーを入力するだけです。認証情報は暗号化され、すぐにエージェント経由でのデバッグを開始できます。
PortkeyをAIに接続するFAQ
Portkeyコネクターの動作について
- 01
AIはコード内のエラーを修正できますか?
いいえ。AIができるのはログを読み取り、何が起きたかを説明することだけです。実際のコード修正は、ご自身の環境で行う必要があります。
- 02
AIはPortkeyのログを削除できますか?
いいえ。このツールでAIができることは、ログの読み取りとリスト表示のみです。Portkeyアカウント内のデータを変更したり削除したりすることはできません。
- 03
ログデータはどのくらい新しいものまで見られますか?
list_logsツールを通じて、Portkeyゲートウェイログに現在存在しているデータであれば、AIはすべて確認できます。
- 04
モデルに送信した正確なプロンプトを確認できますか?
はい。get_log_detailsツールを使用することで、AIはプロンプトを含むリクエストのフルボディを取得できます。
- 05
どのAIクライアントでも動作しますか?
はい。Claude、Cursor、WindsurfなどのMCP対応クライアントを使用していれば動作します。
Portkeyに関するその他の質問 Portkeyコネクターの全機能を見る
『Portkey』を Claude、Cursor、ChatGPT などに接続
