• LATENCY
  • ERRORS
  • PAYLOADS
  • HUMAN

Portkey MCPコネクターを使ってAIでLLMの遅延やエラーをデバッグする方法

Portkeyをエージェントに接続して、リアルタイムのゲートウェイログを取得しましょう。リクエストがどこで停滞しているか、あるいはどこで失敗しているかを正確に特定できます。

このページについてAIに聞く

すぐに答え

AIの呼び出しが遅い、または失敗する原因を特定するには?

エージェントがPortkeyのゲートウェイログを使用し、遅延の大きいリクエストや特定のエラーコードを特定します。直近のログ一覧を取得したり、失敗した単一のリクエストの詳細を掘り下げて、ペイロードやレスポンスの内容を確認したりすることが可能です。チャット画面を離れることなく、何が問題だったのかを正確に把握できます。

デバッグの結果

デバッグデータの活用方法

AIがログデータを、実行可能なカテゴリーに整理します。

LATENCY

遅延の特定

AIが直近のログをスキャンし、想定応答時間を超えたリクエストを見つけ出します。遅延の原因となっている特定のエンドポイントをリストアップします。

ERRORS

失敗原因の特定

AIが失敗した呼び出しの正確なエラーメッセージとステータスコードを取得します。モデルのタイムアウトなのか、プロンプトの形式不備なのかを判断できます。

PAYLOADS

リクエスト詳細の調査

AIが特定のログエントリのフルボディを取得します。モデルに送信された正確な入力内容と、返された生の出力内容を確認できます。

HUMAN

手動での対応

AIは失敗のパターンを特定しますが、コードの修正やモデル設定の変更は行えません。修正はアプリケーション側で直接行う必要があります。

ワークフロー

リクエスト失敗時にAIが行うこと

エージェントがチャットとPortkeyゲートウェイの橋渡し役となります。

  1. 直近のアクティビティをスキャン

    エージェントが最新のゲートウェイトラフィックを確認し、問題のあるエントリを探します。

    list_logs
  2. 問題を切り分ける

    遅延や失敗した呼び出しが見つかると、エージェントはそのイベントの特定データを取得します。

    get_log_details
  3. エラーを分析する

    エージェントがエラーメッセージとリクエストのペイロードを読み取り、呼び出しが失敗した理由を説明します。

    get_log_details
  4. 調査結果をまとめる

    エージェントが遅延やエラーのパターンについて、分かりやすい説明を提示します。

    list_logs

試してみる

以下のプロンプトをコピーして開始

これらのプロンプトを使って、すぐにデバッグを開始できます。

出発点

エラーの種類や期間を書き換えることで、より具体的な結果を得られます。

Portkey Connector

準備完了です。MCPクライアントを選択し、セットアップ手順に従ってください。

コネクタリンクhttps://edge.vinkius.com/vk_preview_BpHtQMK896fkGyepmah9cM552NpibU6fUP5BakNG/mcp

Claude Desktop

以下の手順で数秒で接続できます。

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Portkey capabilities are ready to use.
設定 · claude_desktop_config.jsonコピー
{
  "mcpServers": {
    "portkey-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_BpHtQMK896fkGyepmah9cM552NpibU6fUP5BakNG/mcp"
    }
  }
}
チャットにコピー04
  • 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 などに接続