• ログ
  • ペイロード
  • 修正
  • 手動操作

AIを活用してLLM APIのエラーをデバッグする方法 Keywords AI MCP

Keywords AIをエディタに一度接続するだけ。失敗したリクエストの特定からペイロードの検証まで、AIエージェントが調査作業を代行します。

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

すぐに答え

エディタを離れずにLLM APIのエラーをデバッグするには?

AIエージェントがKeywords AIを使用して最新のリクエストログを取得し、失敗した呼び出しの詳細を抽出します。ダッシュボードに切り替えることなく、エラーの原因を直接把握できるため、プロンプトの修正やペイロードの不一致への対応を即座に行えます。

調査の対象となる項目

デバッグの成果

エージェントは調査結果を以下の項目に分類して提示します。

ログ

失敗した呼び出しの特定

list_requests を使用して、エラーが発生した正確なタイムスタンプとIDを特定します。何が起きたのかを整理されたリストで確認できます。

ペイロード

リクエスト詳細の検証

get_request を通じて、特定の入出力データを取得します。モデルが実際に何を受け取り、何を返したのかを正確に把握できます。

修正

根本原因の特定

エラーメッセージとペイロードを照合します。JSONの形式不正やモデルのタイムアウトなど、問題の所在を指摘します。

手動操作

コードの修正

エージェントはエラーを特定しますが、実際の修正はローカルのコードベースで行う必要があります。ソースファイルが直接書き換えられることはありません。

ワークフロー

エラー発生時にAIが行うこと

ログを自ら探し回る必要はありません。調査はAIエージェントが実行します。

  1. エラーの発見

    直近の履歴をスキャンし、指定された失敗リクエストを特定します。

    list_requests
  2. データの取得

    対象のIDが見つかると、リクエストとレスポンスの全文を取得します。

    get_request
  3. 失敗の分析

    ステータスコードやエラー文字列を確認し、プロンプトの拒絶かタイムアウトかを判断します。

    get_request
  4. 修正案の提示

    エラーの内容を分かりやすく説明し、プロンプトやパラメータの調整方法を提案します。

    list_requestsget_request

試してみる

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

調査を開始するためのプロンプト例です。

出発点

これらは入力の例です。状況に合わせて、エラーの種類や期間を書き換えて使用してください。

Keywords AI Connector

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

コネクタリンクhttps://edge.vinkius.com/vk_preview_R4VkEIrwLVvP7dLw0Fdy9vfjO7WqxWYeI2hDwlBU/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 — Keywords AI capabilities are ready to use.
設定 · claude_desktop_config.jsonコピー
{
  "mcpServers": {
    "keywords-ai-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_R4VkEIrwLVvP7dLw0Fdy9vfjO7WqxWYeI2hDwlBU/mcp"
    }
  }
}
チャットにコピー04
  • Keywords AIの直近10件のリクエストをリストアップし、どれが失敗したか教えてください。

  • IDが req_12345 のリクエストの詳細を取得し、エラーの内容を説明してください。

  • 直近の失敗したリクエストを確認し、エラーメッセージに共通のパターンがあるか教えてください。

  • completion エンドポイントへの最新のリクエストを確認し、なぜ 400 エラーが返されたのか教えてください。

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

ここから始める

Keywords AIを接続して、すぐに質問を開始

リンクをクリックしてアカウントを接続するだけです。認証情報は暗号化され、安全に管理されます。接続完了後、エージェントはすぐにログの取得を開始できます。

Keywords AIをAIに接続する

FAQ

動作に関する詳細

  • 01

    AIがコードを自動的に修正することはできますか?

    いいえ。エージェントはエラーを特定して修正案を提示することはできますが、実際の変更はエディタ上で自分自身で行う必要があります。

  • 02

    AIが古いログを削除することはできますか?

    いいえ。提供されるツールは、リクエストデータのリスト取得と詳細取得のみを許可しています。Keywords AI内のデータを削除または変更することはできません。

  • 03

    エージェントはどうやって正しいエラーを見つけるのですか?

    まず list_requests ツールを使用して履歴をスキャンし、次に get_request を使用して特定したエラーの詳細データを取得します。

  • 04

    どのLLMでも動作しますか?

    使用するモデルに関わらず、Claude、Cursor、Windsurf など、MCPに対応しているクライアントであれば動作します。

  • 05

    エージェントはAPIキーを見ることができますか?

    いいえ。エージェントはツールを通じて提供されるリクエストとレスポンスのデータのみにアクセスできます。シークレットキーにアクセスすることはありません。

  • Keywords AIについてさらに詳しく知りたいですか? Keywords AI Connector の全機能を見る

『Keywords AI』を Claude、Cursor、ChatGPT などに接続