AI コンテキスト
AIコンテキストは、Amplitudeのエージェントにメトリクス、用語、ビジネス上の好みを与える場所です。そのため、エージェントの回答はお客様の組織の仕組みを反映しています。このコンテキストを定義して、すべての回答を組織に合わせてカスタマイズします。
はじめに
コンテキストを追加する前に、必要な情報を収集し、適切な場所に移動してください。
AIコンテキストを見つける
グローバルエージェントやスペシャライズドエージェントを含むエージェントは、組織とプロジェクトという2つのコンテキストレイヤーを使用します。
_[プロジェクト設定] > [AIコントロール]_から両方にアクセスできます。
始める前に収集すべきもの
お客様のビジネスモデル（B2B、B2C、マーケットプレイスなど）。
あなたのノーススターメトリックとその定義方法。
会計年度の開始日（1月以外の場合）。
お客様の主要な顧客セグメントとその特定方法について説明します。
登録や購入など、主要なアクションのためのイベント名。
プランタイプやARRなど、セグメントを定義するプロパティ名。
除外するテスト用または内部用ユーザー識別子。
回避すべき非推奨イベント。
AI コンテキストを理解する
状況によって、エージェントが質問に答える方法が変わります。
ユーザーの質問:
アクティベーション率を表示
ユーザーのアクティベーションを示すチャートを作成します。アクティブ化されたユーザーとは、登録後にイベントを完了したユーザーと定義します...
ユーザーの定義を使用してアクティベーション率を表示します：サインアップから7日以内にfirst_project_createdを実行したユーザー（@test.comのメールアドレスを除く）...
2 つのレベルのコンテキスト
すべてのプロジェクトに適用されます。 全社共通の標準ルールとして利用します。
ビジネスモデルとKPIの定義。
標準的な用語。
テストユーザーの除外など、グローバルフィルタ。
会計カレンダーのルール。
1つのプロジェクトに適用されます。 製品固有の詳細情報に使用します。
製品固有のイベントとファンネル。
このプロダクトに固有のメトリック。
製品固有のセグメント。
必要に応じて組織のデフォルト値を上書きします。
実行時にエージェントは両方のコンテキストソースを結合します。 プロジェクトコンテキストは、競合する場合、組織コンテキストよりも優先されます。
何を書くか
Amplitudeは以下のことを推測できません：
ビジネスモデル: 「B2B SaaS、年間サブスクリプション」
主要セグメント: "エンタープライズ = ARR > $50K"
メトリックの定義: "アクティベーション = 7 日以内の最初のプロジェクト
日付ルール：「会計年度は4月1日から始まる」
除外事項: 「@test.com メールを除外する」
Amplitudeは以下のことを認識しています：
お客様のイベントカタログとプロパティ。
ボリューム別の上位イベント。
公式ダッシュボード。
コホート定義を保存しました。
既存のグラフ設定。
提供するあらゆるコンテキストにおいて、既存のコホートとダッシュボードを名前で参照できます。 例えば：
エンゲージメントユーザーについて質問された場合は、「パワーユーザー」コホートを使用してください。
Amplitude にはデフォルトでそれらの定義が含まれています。
適切な文脈を書く
マークダウンを使用してコンテキストを構造化することで、エージェントが簡単に解析できるようになります。
## 見出しを使用してセクションを区切ります。
- 項目のリストには箇条書きを使用します。
`backticks`イベント名とプロパティ名を囲みます。
**bold** 重要な用語を強調表示します。
ビジネスの概要: モデルとノーススター指標。
主な指標: アクティベーション、エンゲージメント、リテンションの定義。
セグメント：プロパティにマッピングされたカスタマー層。
Do／Don'tルール：デフォルト設定、フィルタ、および避けるべき事項。
日付の規則：会計年度、週の開始日、およびデフォルトの範囲。
10,000 文字未満にしてください。 これは組織とプロジェクトの両方のコンテキストの制限です。 チームが尋ねる質問の80%に対応する20%の情報に焦点を当ててください。
業界テンプレート
まずは業界に合ったテンプレートから始めて、それをカスタマイズしましょう。 これらは完全な例であり、コピーしたり変更したりできます。
このテンプレートをコピーし、イベント名とプロパティ名を独自のものに置き換え、定義をビジネスに合わせて調整してください。
## Business Overview
B2B SaaS platform with annual subscriptions.
North Star: Monthly Active Workspaces (MAW)
## Key Metrics
- **Activation**: User triggers `workspace_created` within 7 days of `signup_completed`
- **Engaged**: 3+ sessions in last 7 days with at least one `feature_used` event
- **Expansion-ready**: `seat_utilization` > 80%
## Segments
- Enterprise: `plan_tier` = "enterprise" OR `arr` > 50000
- Mid-Market: `arr` between 10000 and 50000
- SMB: `plan_tier` in ("starter", "growth")
- Trial: `subscription_status` = "trial"
## Rules
DO:
- Default to last 30 days for time ranges
- Exclude `email` contains "@test.com" or `is_internal` = true
- Use `mrr_change` event for revenue analysis
DON'T:
- Include `environment` = "staging" or "development"
- Use deprecated: `old_signup`, `legacy_workspace_created`
## Date Rules
- Fiscal year starts February 1
- "This quarter" = current fiscal quarter
- Week starts Monday
例
AIコンテキストを効果的にする要因と、回避すべき落とし穴についてご覧ください。
具体的に説明する
## Key Metrics
- **Activation**: User triggers `project_created` event
within 7 days of `signup_completed`
- **Engaged User**: 3+ sessions in the last 7 days
- **Churned**: No activity for 30+ days
Help users understand activation and engagement.
Show relevant metrics when asked about user behavior.
Make sure to use appropriate time ranges.
簡潔にしてください
## Segments
- Enterprise: `plan_tier` = "enterprise"
- SMB: `plan_tier` = "starter" OR "growth"
- Trial: `subscription_status` = "trial"
## Filters
- Exclude: `email` contains "@test.com"
- Exclude: `is_internal` = true
When analyzing our customer base, it's important to
understand that we have several different types of
customers. Enterprise customers are our largest accounts
- they typically have the enterprise plan tier. Small
and medium businesses (SMBs) are customers who use our
starter or growth plans. We also have trial users who
are evaluating the product.
ビジネスコンテキストを含める
## Business Model
B2B SaaS, annual subscriptions.
North Star: Monthly Active Workspaces (MAW)
## Fiscal Calendar
- FY starts April 1
- "This quarter" = current fiscal quarter
- Week starts Monday
We are a software company that sells to businesses.
Our product helps teams collaborate better.
We care about growth and revenue.
明示的なDo／Don'tルールを使用する。
## Rules
DO:
- Default to last 30 days for time ranges
- Group by `platform` when comparing mobile vs web
- Use `Total Revenue` event for revenue metrics
DON'T:
- Include events where `environment` = "staging"
- Use deprecated events: `old_signup`, `legacy_purchase`
Be helpful and show relevant data.
Use appropriate filters when needed.
Be careful with sensitive information.
用語を定義する
## Terminology
- "Conversion" = `checkout_completed` event
- "Signup" = `account_created` (not `user_registered`)
- "Active" = user with 1+ events in last 7 days
## Naming Conventions
Events: snake_case (`button_clicked`)
Properties: camelCase (`userId`, `planType`)
Use the correct terminology for our company.
Use exact event names and correct casing.
Properties follow our naming conventions.
ベストプラクティス
正しい大文字・小文字を含め、正確なイベント名とプロパティ名を使用してください。
具体的に「exclude emailcontains @test.com」のように記述してください。
ユニバーサルルールを組織レベルに設定し、オーバーライドをプロジェクトレベルに設定してください。
保存する前にクエリを実行して変更をテストしてください。
バックアップをウィキやバージョン管理に保存してください。
リストにしないでください。 Amplitudeはすでにこのことを知っています。
「役に立つように」や「適切なフィルターを使用する」といった曖昧な指示を書くこと。
組織とプロジェクトのコンテキスト間で競合するルールを作成します。
まれな状況にのみ適用されるエッジケースルールを追加します。
最初にテストすることなく大きな変更を加える。
経時的にコンテキストを維持
コンテキストを維持するために、次のことに留意してください。
オーナーの割り当て：組織コンテキストのアナリティクスリード。各プロジェクトコンテキストに対して、担当のPMまたはアナリストを指定してください。
定期的にレビューしてください：四半期ごと、大規模な発売後、またはエージェントが予期しない回答をした場合に確認してください。
慎重に変更してください：一度に1つずつ変更します。実際の質問でテストします。 バックアップを保持してください。
よくある質問
これは役に立ちましたか？