Amplitude（データ分析プラットフォーム）のチャートやダッシュボードに関する質問に答えます。定義の確認、データの取得、結果の説明や応用ができます。 次のような場合に使用: - ユーザーがAmplitudeのURLを貼り付けた - 「このチャートは何を表しているのか」と尋ねられた - ダッシュボードから最新のデータで報告書を更新したい - 既存の分析を複製または応用したい
Answers questions from an Amplitude chart or dashboard link — fetch the definition, pull the data, explain or adapt it. Use when the user pastes an Amplitude URL, asks "what does this chart show", wants a report refreshed from a dashboard, or wants to clone/adapt an existing analysis.
最も一般的な2番目の作業：ユーザーがリンクを貼り付けて、その内容を理解したり、最新の状態に更新したり、別の形に変更してほしいというもの。
URLを解析する
get_from_url でエンティティの種類、ID、および（チャートの場合）現在の定義が得られます。チャート、ダッシュボード、実験、ノートブック、コホート（特定条件に合うユーザーグループ）のリンクを1回の呼び出しで処理できるため、ユーザーに ID の入力を求める必要はありません。
定義を読み込む
get_amplitude_charts を include: 'typed' で呼び出します。typed パラメータはチャートビルダーの UI と同じ構造であり、プロジェクトがイベント（行動）やプロパティ（属性）をどう定義しているかを最も素早く確認できます。もし typed が失敗した場合（「高度な機能はモデル化されていません」というエラー）、代わりに include: 'definition' で生の形式を取得してください。use_amp_dashboards と action: 'get' で（一度に3件まで）ダッシュボード内のチャート一覧を取得してから、必要なチャートを読み込みます。データを取得する
get_amplitude_charts を include: 'data' で呼び出し、チャート ID を指定します（1回の呼び出しにつき最大3件の ID）。レポートを更新する場合は、レポートに必要な時間単位でデータをリクエストしてください（週比較なら日単位、月次なら週単位）。
変更または複製する
typed パラメータを編集してから、編集済みの chart と、保存済みチャートの ID を chartId にセットして query_amplitude_data を呼び出します。親チャートのパラメータが typed モデルで省略された部分を補い、編集内容が親と結びついたままになります。結果を render_amplitude_chart で表示すれば、ユーザーはウィジェットの「チャートを保存」ボタンから保存できます（モデル側に保存ツールはありません）。ダッシュボード全体を別の環境で複製する場合は、参照元のダッシュボードを読み込んでから各チャートを再構築してください。1回の呼び出しで「コピー」しようとしないでください。
get_from_url はチャートを実行しません。メタデータと定義を返すだけです。データは常に get_amplitude_charts の include: 'data'（保存済みチャート）または query_amplitude_data（その場限りの分析）から取得されます。
include: 'data' は UI に表示されるのと同じ数字を返します。これには Amplitude のタイムゾーン単位でのデータ集計が含まれるため、外部ソース（BigQuery など）と比較する場合は、タイムゾーンと日付の端数の違いを明確に述べてください。
定義の読み込みは軽い処理ですが、データの読み込みは重い処理です。最初にすべての定義を読み込んでから、実際にデータが必要な 1～3 個のチャートを判断してください。
リンクだけ必要な場合は、include: 'link'（デフォルト）で ID を検証して、何も実行せずに URL を返してください。
Second most common job: the user pastes a link and wants the analysis understood, refreshed, or adapted.
get_from_url returns the entity type, IDs, and
(for charts) the current definition. One call handles chart, dashboard,
experiment, notebook, and cohort links — use it instead of asking the
user for IDs.get_amplitude_charts with
include: 'typed' — the typed params mirror the chart-builder UI and are
the fastest way to see how the project spells events/properties. If
typed fails to lower the chart ("advanced features are not modeled"),
fall back to include: 'definition' for the raw form. For a dashboard:
use_amp_dashboards action: 'get' (batch ≤3) to get its chart list,
then read the charts that matter.get_amplitude_charts include: 'data' with the
chart IDs, ≤3 IDs per call. For a report refresh, request the granularity
the report needs (daily for week-over-week, weekly for monthlies).query_amplitude_data with the edited chart and chartId set to
the saved chart's id — the parent's params fill gaps the typed model
omits, and the edit stays linked to its parent. Render the result with
render_amplitude_chart; the user saves it from the widget's Save
chart button (there is no model-facing save tool). To replicate a whole
dashboard in a new context: read the reference dashboard, then rebuild
each chart — do not try to "copy" in one call.get_from_url does not run the chart — it returns metadata/definition.
Data always comes from get_amplitude_charts include: 'data' (saved
charts) or query_amplitude_data (ad hoc).include: 'data' returns the same numbers the UI shows, including
Amplitude's timezone bucketing — when comparing against external sources
(e.g. BigQuery), call out timezone and partial-day differences explicitly.include: 'link' (the default) validates
the ids and returns URLs without running anything.原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。