Amplitude MCPの一般的なタスク
Amplitude MCPサーバーをAIクライアントに接続した後は、自然な言語でそれを実行するため、ツールに名前を付けることはめったにありません。このページでは、よくあるタスクを、それに対応するプロンプトと、それに回答するためにサーバーが実行するツールとを対応付けています。これにより、サーバーが該当タスクをサポートしているかを確認し、リクエストを適切な形で表現できます。
完全なリストについては、利用可能なツールと機能を参照してください。
目的をわかりやすい言葉で説明すると、クライアントがツールを選択します。_使用するツール_列にあるツール名から、どのツールが実行されているかがわかります。これにより、結果を検証したり、特定のツールをリクエストしたりできます。
ユーザーとそのアクティビティを検索する
| 目的 | 質問例 | 使用するツール |
|---|---|---|
| ユーザーの最近のイベントを検索する | 「12345ユーザーが過去7日間に実行したアクションは?」 | get_amp_user_data, query_amplitude_data |
| ユーザーのプロファイルを検索する | 「ユーザー12345のユーザープロパティを表示して。」 | get_amp_user_data |
| 2つのユーザーグループを比較する | 「オンボーディングフローのコンバーターとドロップオフを比較して。」 | query_amplitude_data, use_amplitude_cohorts |
イベントとプロパティを検査する
| 目的 | 質問例 | 使用するツール |
|---|---|---|
| イベントプロパティと値を検査する | 「Checkout Started上のプロパティと、plan_typeが取る値をリストアップして。」 | get_amp_taxonomy, query_amplitude_data |
| イベントまたはプロパティを検索する | 「『チェックアウト』に言及したイベントはどれ?」 | search, get_amp_taxonomy |
| カスタムイベントを確認する | 「登録イベントをマージするカスタムイベントを表示して。」 | get_amp_taxonomy, get_transformations, get_group_types |
| タクソノミーの名前変更またはドキュメント化を行う | 「plan_typeの説明を『サブスクリプション階層』に設定して」 | manage_amp_properties, manage_amp_events |
タクソノミーをクリーンアップする
| 目的 | 質問例 | 使用するツール |
|---|---|---|
| 冗長なイベントを削除する | 「トラッキングプランからold_checkoutおよびlegacy_signupイベントを削除して。」 | get_amp_taxonomy, manage_amp_events |
| 1つのイベントまたはすべての場所からプロパティを削除します。 | 「page_urlをPage Viewedイベントだけから削除して。」 | get_amp_taxonomy, manage_amp_properties |
| 削除したものを復元する | 「削除したユーザープロパティplan_typeを復元して。」 | get_amp_taxonomy, manage_amp_properties |
クライアントは、実行される前に各削除を確認するよう求めます。Amplitudeは、取り込み済みのイベントとプロパティを削除済みとしてマークして復元できるようにし、取り込まれることのなかった計画済みアイテムを削除します。ルールの詳細については、イベントとプロパティの削除と復元を参照してください。
データを分析する
| 目的 | 質問例 | 使用するツール |
|---|---|---|
| アドホックなデータの質問に回答する | 「今月のトラフィックソース別に登録コンバージョンを表示して。」 | query_amplitude_data, render_amplitude_chart |
| チャートまたはダッシュボードを参照する | 「このダッシュボードをエグゼクティブミーティング用に要約して。[ダッシュボードのURLを貼り付ける]」 | get_from_url, use_amp_dashboards, get_amplitude_charts |
| スパイクまたはドロップを調査する | 「先週の火曜日に週間アクティブユーザーが減少した理由は?」 | query_amplitude_data, get_deployments, get_experiments |
| 実験を分析する | 「チェックアウト実験をリリースしたほうがよい?結果を分析して。」 | get_experiments, query_experiment |
セッションの再生を視聴する
| 目的 | 質問例 | 使用するツール |
|---|---|---|
| 動作のリプレイを検索する | 「ユーザーがチェックアウトページでレイジクリックした際のリプレイを表示して。」 | get_session_replays, list_session_replays |
| 報告されたバグを再現する | 「このユーザーのセッションを見つけて、何が起きたのかを説明して。」 | get_session_replays, get_session_replay_events |
コンテンツの作成と編集
| 目的 | 質問例 | 使用するツール |
|---|---|---|
| チャートまたはダッシュボードを作成する | 「プロダクト発売向けのエグゼクティブダッシュボードを構築して。」 | use_amp_dashboards, use_amp_notebooks, render_amplitude_chart |
| ダッシュボードまたはノートブックを編集する | 「KPIダッシュボードにリテンションチャートを追加して。」 | use_amp_dashboards, use_amp_notebooks |
| 実験またはフラグを作成する | 「新しいチェックアウトフローの50/50実験を作成して。」 | create_experiment、create_flags、create_metric、update_flag |
| コホートを作成し、それを同期する | 「パワーユーザーのコホートを作成して、Iterableと同期して。」 | use_amplitude_cohorts |
トラッキングプランのブランチを管理
| 目的 | 質問例 | 使用するツール |
|---|---|---|
| ブランチのタクソノミーを変更する | 「q3-cleanupブランチを作成してCheckout Startedイベントを追加して。」 | manage_amp_taxonomy, manage_amp_events, manage_amp_properties |
| ブランチの変更を反映または破棄する | 「q3-cleanupをメインにマージして。」 | manage_amp_taxonomy |
読み取り/書き込みタクソノミーツールの完全なセットと、RBACに基づくアクション書き込みコールに必要な要件については、トラッキングプランの変更を参照してください。
カスタマーのフィードバックを確認する
| 目的 | 質問例 | 使用するツール |
|---|---|---|
| 顧客のリクエストをまとめる | 「今月、カスタマーから最も多かった苦情は?」 | use_amplitude_ai_feedback |
| テーマを経時的に追跡する | 「過去90日間のモバイルアプリに関するフィードバックの傾向は?」 | use_amplitude_ai_feedback |
AIエージェントのパフォーマンスを分析する
| 目的 | 質問例 | 使用するツール |
|---|---|---|
| エージェントの品質とコストを測定する | 「AIエージェントの機能はどう?品質、コスト、エラー率を表示して。」 | get_amplitude_agent_analytics_info |
| 不良なエージェントセッションを調査する | 「昨日の低品質なAIセッションについて調査して。」 | get_amplitude_agent_analytics_info |
| evaluatorをテストするためのデータセットを作成する | 「先週の失敗したエージェントセッションをデータセットに収集します。」 | agent-analyticsデータセットコマンドを使用したrun_amp |
| データセットをスコアリングする | 「そのデータセットに対してrefund-policy evaluatorを実行し、結果を表示してください」。 | agent-analytics eval-runコマンドを使用したrun_amp |
データウェアハウスの接続とジョブを確認する
| 目的 | 質問例 | 使用するツール |
|---|---|---|
| インポートソースをリストする | 「このプロジェクトにはどのようなウェアハウスインポートとその他のデータソースが設定されていますか?」 | get_data_ingestion_sources |
| ソースの設定を確認する | 「Snowflakeインポートの設定を表示してください。」 | get_data_source_details |
| エクスポート先をリストする | 「このプロジェクトはデータをどこにエクスポートしますか?」 | get_data_warehouse_destinations |
| 最近のインポート/エクスポートジョブを確認する | 「私のSnowflakeソースの最近のジョブを表示してください。失敗したか、エラーで完了したのはどれですか? | get_data_ingestion_sourcesまたはget_data_warehouse_destinations、その次にget_data_warehouse_jobs |
| 手動バックフィルエクスポートを確認する | Snowflakeの送信先に対する手動バックフィルエクスポートジョブを表示してください。 | get_data_warehouse_jobs |
パラメータ、レスポンスフィールド、ステータスの意味については、データウェアハウスの MCP ツールを参照してください。
他の手段を使用すべき場合
Amplitude MCPサーバーは、お客様のアカウント権限を使用してAmplitudeコンテンツを読み取りおよび編集します。 タスクによっては、別の手段を使用する必要があります:
- 独自の外部ツールまたはサードパーティのMCPサーバーをAmplitudeエージェントに接続する場合:Amplitude MCPサーバーではなく、カスタムエージェントとエージェントコネクタを使用してください。
- クライアントを設定することなく、Amplitude内のデータについてAIとチャットする場合:グローバルエージェントまたはダッシュボードエージェントを使用します。
- イベントデータを送信する場合:Amplitude SDKまたはHTTP V2 APIを使用します。 MCPサーバーは取り込み用のエンドポイントではありません。
- AIクライアントからAmplitudeの公開ドキュメントを読み取る場合:読み取り専用のDocs MCPサーバーを使用してください。
ツールが存在するか、または必要なものが何であるかわからない場合は、クライアントで、「_[タスク]_に利用できるAmplitude MCPツールは何?」と尋ねてください。または、プログレッシブツール検出を有効にすると、ツールカテゴリを参照したり、呼び出す前に各ツールのパラメーターを検査したりできます。
これは役に立ちましたか?
For AI agents: a documentation index is available at /docs/llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.