エージェント修復スキルは、エージェントアナリティクスでフラグが立てられた問題を、AIエージェントに適用できる具体的で証拠に基づく変更に変えるのに役立ちます。Pendo MCPサーバーでこのスキルを実行すると、修正概要が生成されます。これは、行うべき変更内容と、その変更の根拠となる会話の証拠を構造的にまとめたものです。
修正案の概要に従うかどうかはご自身でご判断ください。承認された変更は、ご自身で適用することも、コーディングエージェントに渡すことも、エンジニアが対応するためのチケットに変換することもできます。Pendoがお客様のAIエージェントや環境に変更を加えることはありません。
このスキルは、技術的なバックグラウンドを持つ人だけでなく、あらゆるプロダクトマネージャーがAIエージェントの診断と改善を行えるように設計されています。エージェントアナリティクスのUIではなくPendo MCPサーバーを介して動作するため、問題を特定するために必要なコンテキストを統合し、具体的な次のアクションを提示することができます。
ユースケース
エージェントアナリティクスで、以下のような対処したいパターンが見つかった場合は、エージェント修復スキルを使用してください。
- ツール呼び出しエラー、役に立たない応答、フローの不具合、エージェントの予期せぬ動作など、会話全体を通して繰り返し発生する問題の種類。
- 既に特定されている、具体的な解決策に落とし込みたい一連の会話。
- 優先すべき重要な問題をスキルで明らかにするAIエージェントの健全性の定期的な見直し。
仕組み
このスキルはPendo MCPサーバーを介して実行されます。Pendo MCPサーバーは、Claude、Cursor、ChatGPTなどの外部AIツールをPendoデータに接続します。このスキルを実行すると、エージェントアナリティクスから問題に関連する会話とエージェントのプロパティを照会し、そのコンテキストに基づいて修正概要を生成します。スキルがより関連性の高い会話をもとに活用すればするほど、修正概要はより包括的になります。少数の会話に基づくブリーフは、不完全になる場合があります。
ヒント：CursorやClaude Codeなど、コードベースにアクセスできるAIツールでスキルを実行してください。これにより、スキルを発揮するためのより多くの背景情報が得られ、より具体的な修正概要が作成されます。
このスキルは推奨事項を生成します。変更を自動的に適用するものではなく、PendoがAIエージェントのデプロイメントに変更をプッシュするものでもありません。修正概要に基づいて行動するかどうかはユーザーが決定し、承認された変更は各自の環境で行います。
始める前に
エージェント修復スキルを実行するには、以下が必要です。
- レビュー対象のAIエージェントに対して会話キャプチャ機能を有効にしたエージェントアナリティクスが設定されていること。
- Pendo MCPサーバーがお好みのAIツールに接続されていること。
- 問題に関する十分な会話があり、スキルが意味のあるパターンを見つけられること。
スキルをインストールする
agent-repairスキルファイルをダウンロードして、AIクライアントに追加してください。インストール手順については、お使いのツールのマニュアルを参照してください。以下はその例です。
修正概要を生成する
MCP経由でPendoデータに接続し、AIクライアントを開きます。エージェントアナリティクスで既にどれだけ探索したかに応じて、このスキルを2つのモードのいずれかで実行できます。どちらのモードでも修正概要が作成されます。
まず、スラッシュコマンド/agent_repairを使用するか、アシスタントに直接agent_repairスキルを使用するように依頼してください。
完全な探索
このモードは、スキルに問題の特定と優先順位付けを自動で行わせたい場合に使用します。
- レビューしたいAIエージェントのIDでスキルを実行してください。会話を最初に選択する必要はありません。
- エージェントアナリティクスからスキルが検出する主な問題の種類と、それぞれの問題に対応する代表的な会話例を確認してください。
- 対応したい問題を選択してください。
- スキルが生成する修正概要を確認してください。
対象を絞った修正
エージェントアナリティクスを既に確認し、特定の問題を特定した場合は、このモードを使用してください。
- エージェントアナリティクスで、問題の種類と会話例を確認し、修正したいパターンを特定します。
- 選択した会話セットまたは特定の会話IDを使用してスキルを実行します。
- スキルが生成する修正概要を確認してください。
修正概要を確認して適用する
修正概要は、推奨される変更内容とその根拠となる証拠を構造的にまとめたものです。説明には以下の内容が含まれます。
- 変更する内容。可能な限り、全面的な書き直しではなく、特定の対象を絞った変更。
- 裏付けとなる証拠。その会話の例や、推薦に至った兆候。
修正概要に対しては、いくつかの方法で対応できます。
- コードベースに接続されたコーディングエージェントで直接変更を適用します。
- 修正内容をJiraやLinearなどのツールでチケットに変換し、エンジニアが対応できるようにします。
修正概要を確認後、適用するかどうかを決定し、承認された変更を自身の環境で行います。Pendoは変更を適用しません。
スキルをスケジュールに基づいて実行する
AIエージェントの状態を長期的に監視するには、スキルを定期的に実行することができます。AIツールに、エージェント修復スキルを希望する間隔（例えば週単位）で実行するように指示します。スケジュール管理はAIツールによって行われるため、具体的な手順は使用するツールによって異なります。
トラブルシューティング
スキルが有用な修正概要を返さない場合、フラグが立てられたデータセットが小さすぎるか、あるいは多様すぎるため、スキルが明確なパターンを見つけられない可能性があります。より多くの会話をキャプチャした後で、もう一度スキルを実行するか、より絞り込んだ会話セットを選択してください。
それでも結果が不明確であったり役に立たない場合は、Pendoのアカウント担当者またはサポートチームまでご連絡いただき、スキルの改善にご協力ください。