イベント Discovery Agent
この機能はベータであり、今後も進化していく可能性があります。 このドキュメントには最新の更新情報が反映されていない場合があります。
Event Discovery Agentは、プロジェクトがすでに収集したウェブ上のAutocaptureデータを確認し、コアプロダクトフローを特定し、そのフロー内の主要なインタラクションに対してラベル付きのイベントを提案します。この機能は毎週実行され、その提案を「Agent-Suggested」タブに配置してレビュー用に設定します。Amplitudeは、誰かが提案を受け入れるまで、あなたのタクソノミーに何も追加しません。
Web Autocaptureを実行し、各イベントを手動で定義することなく、追跡する価値のあるインタラクションを見つけたい場合に、イベント検出エージェントを使用します。ビジュアルラベル付けは、サイト上の特定の要素をインタラクティブに選択して名前を付けたい場合に使用します。
イベント検出エージェントはベータ版です。任意のご質問がある場合は、Amplitude サポートまでお問い合わせください。Amplitudeの担当者に連絡して、アクセス権をリクエストしてください。
イベント検出エージェントの仕組み
各実行時、イベントDiscovery Agentは、プロジェクト内のAutocaptureイベント(Page Viewed、Element Clicked、Element Changedなど)を読み取ります。これらのイベントから、プロダクトの中核的なフローを構成するインタラクションのシーケンスを特定します。 追跡する価値のある各インタラクションについて、ラベル付きのイベントをドラフトします。これは、名前、説明、カテゴリ、サイト上の要素と一致する定義です。 次に、その定義の信頼性、およびそのイベントが分析にとってどの程度重要かを確認します。
提案はイベントボリュームに追加されません。ラベル付きイベントは、すでに収集したAutocaptureデータの上に階層化された定義です。そのため、提案を受け入れると、新しいイベントを送信するのではなく、既存のイベントにラベルが付けられます。ラベル付きイベントとボリュームとの関係の詳細については、ラベル付きイベントとイベントボリュームを参照してください。
実行スケジュール
ベータ期間中、イベント検出エージェントは週に1回実行されます。通常、実行には1~2時間かかります。エージェントは、追跡する価値のあるインタラクションを発見した場合にのみ提案を作成するため、新しい提案なしで実行を終了できます。
エージェントが重複を防ぐ方法
イベントを提案する前に、イベント検出エージェントは次のものとの重複を確認します:
- インストルメント化されたイベント、カスタムイベント、ラベル付きイベントなど、すでにタクソノミーに存在するイベント。
- Agent-Suggestedタブでまだ開いている提案。
- 誰かが却下した提案。
エージェントは、既存のイベントを編集または削除しません。 エージェントが以前に提案したインタラクションについてさらに多くの証拠を発見した場合、誰かが以前の提案を却下した場合でも、後の実行で同様のイベントを提案できます。
要件
イベントディスカバリーエージェントは、Browser SDKのウェブAutocaptureデータと連携します。これは、ページビューと要素の操作(Element ClickedおよびElement Changed)を読み取ります。リモート設定を使用して、要素の相互作用やその他のAutocaptureイベントタイプを有効にできます。 エージェントが読み取るイベントについては、Web Autocaptureスキーマを参照してください。このエージェントは、プロジェクトに過去30日間に少なくとも10,000件のウェブ Autocapture イベントが発生した場合に最も効果的に機能します。
現在のAutocaptureボリュームを確認するには、次のいずれかの方法を使用します。
- Amplitudeデータで、_イベント_に移動し、
Page ViewedやElement Clickedなどのウェブ自動キャプチャイベントの_30日ボリューム_列をチェックします。 - 過去30日間のウェブAutocaptureイベントのイベント合計を測定するセグメント化チャートを作成します。
権限
ユーザーがイベント検出エージェントでできることは、プロジェクト内でのユーザーの役割によって異なります。
| アクション | 誰がそれを実行できるか |
|---|---|
| イベント検出エージェントの設定ページとAgent-Suggestedタブを表示します。 | プロジェクトへのアクセス権を持つすべてのユーザー |
| エージェントのオンまたはオフ、設定の変更、コンテキストの追加、実行のキャンセルまたは再試行を行います。 | 管理者とマネージャー |
| 提案を編集、承認、却下、復元する | 管理者とマネージャー |
| Amplitude全体のイベントドロップダウンでオープンサジェストを使用してください。たとえば、チャートでのテストなどに使用します。 | 管理者とマネージャーは常に行えます。メンバーおよび閲覧者が利用できるのは、管理者またはマネージャーが「承認前にイベントドロップダウンに提案を表示」をオンにした場合のみです。 |
オープンサジェストは、イベントディスカバリーエージェントがオンになっている場合にのみ、イベントドロップダウンに表示されます。エージェントがオフの場合、提案はAgent-Suggestedタブに残りますが、誰のドロップダウンにも表示されません。
Event Discovery Agentを有効にします。
イベント検出エージェントはプロジェクトごとに実行されます。 プロジェクトに対してこの設定を有効にするには:
- Amplitude データで、_イベント検出エージェント_に移動します。
- イベント検出エージェントを有効にします。
- 内容を確認し、有効化をクリックして実行を開始します。
最初の実行はすぐに開始され、通常1~2時間かかります。 その後、エージェントは毎週実行されます。 実行がすでに進行中である場合、または過去12時間以内に実行が正常に終了した場合、エージェントを有効にしても、別の実行は開始されません。 次の実行は毎週のスケジュールで開始されます。
別のプロジェクトに対してエージェントを有効にするには、そのプロジェクトに切り替え、この手順を繰り返します。
「Event Discovery Agentを有効」をオフにすると、Amplitudeは進行中のすべての実行を停止し、今後の実行をキャンセルします。また、「承認される前にイベントドロップダウンに提案を表示」もオフにします。すでに受信した提案は、Agent-Suggestedタブに残ります。
Amplitudeデータ外で提案を閲覧するユーザーを制御します。
「Show suggestions in event dropdowns before they are accepted」設定は、Amplitude全体のイベントドロップダウンに、「エージェントによる提案」とマークされた未承認の提案が表示されるかどうかを制御します。
- On:すべてのユーザーは、イベントドロップダウンでオープン提案を検索して使用できます。
- オフ:メンバーと閲覧者には、「エージェントによる提案」タブでのみ提案が表示されます。管理者とマネージャーは、イベントドロップダウン内の提案をいつでも使用して、より広範なロールアウト前にテストできます。
この設定を変更できるのは、イベント検出エージェントがオンになっている場合のみです。
エージェントにプロダクトに関するコンテキストを提供します
コンテキストはオプションですが、これは、エージェントがチームと同じ方法でイベントを命名し、プロダクトの重要な部分に集中するのに役立ちます。 いつでもコンテキストを追加または変更できます。保存済みのコンテキストは、すでに進行中の実行ではなく、将来の実行に適用されます。
イベント Discovery Agentは、次のソースからコンテキストを読み取ります。
- コンテキストの指示:イベント Discovery Agent 設定ページで入力する自由テキスト(最大10,000文字)。Amplitudeは、1,000~3,000文字を推奨しています。
- コンテキストファイル:データディクショナリ、命名ガイド、プロダクト仕様など、アップロードしたファイル。 サポートされている形式は、TXT、MD、HTML、DOC、DOCX、PDF、CSV、XLS、XLSXです。1ファイルあたりの最大容量は25MBです。
- AI Controlsのコンテキスト:AI Controlsで設定された組織とプロジェクトのコンテキスト。
コンテキストの指示とファイルはプロジェクト単位です。プロジェクト内の他のAmplitude AIエージェントもこれらを使用できます。Amplitudeはまた、アップロードされたファイルを使用して、既存のイベントやプロパティに説明とコンテキストを追加することもできます。アップロードされたファイルを管理するには、AI Controlsに移動します。
命名規則
提案されたイベントに名前を付けるために、エージェントは命名規則を規定したこれらのソースの最初のものを使用します。
- Your Event Discovery Agentのコンテキスト指示とコンテキストファイル。
- Amplitudeデータ設定内の命名規則。
- AIは、コンテキストファイル、次にプロジェクトコンテキスト、その次に組織コンテキストの順で制御します。
- 既存のほとんどのイベントがすでに従っている規則。
- プロダクト領域の後にオブジェクトと過去形のアクションが続きます(タイトルケース表記。例:
Projects | Project Created)。
コンテキストの手順に含めるべきもの
短く、具体的な指示が最も効果的です。 役立つトピックは次のとおりです。
| トピック | 例 |
|---|---|
| 命名規則 | Project CreatedまたはPlan Upgradedのように、「オブジェクト+アクション」でタイトルケースを使用してください。 |
| プロダクト用語 | 「ワークスペース」とは、顧客アカウントを意味します。 「ボード」は弊社のダッシュボードです。 |
| コアフロー | 登録、オンボーディングチェックリストの作成、プロジェクトの作成、チームメンバーの招待を行います。 |
| 詳細レベル | 項目タイプをプロパティとして、Item Viewedを使用してトラッキングし、Shoes Viewedのように項目ごとに個別のイベントを発生させないでください。 |
| 無視する領域 | ページタイトルに「クラシック」が含まれるレガシー管理ページ。 |
| トラッキング設定 | 要素にdata-track-idとdata-testidの両方がある場合は、data-track-idを使用します。イベント定義にスタイルクラスを使用しないでください。 |
コンテキスト指示を追加するには:
- Amplitude データで、_イベント検出エージェント_に移動します。
- 「Event Discovery Agentはプロダクトとタクソノミーについて何を知っておくべきでしょうか?」について。カード、編集をクリックします。
- Markdownに指示を入力するか、markdownファイルをアップロードをクリックします。
- 保存をクリックします。
コンテキストファイルを追加するには:
- 「コンテキストファイルのアップロード」カードで、ファイルをアップロードをクリックします。
- ファイルを選択し、アップロードをクリックします。
モニタリングの実行
イベント Discovery Agentの設定ページにある「Recent runs」テーブルには、過去30日間の実行状況と次に予定されている実行状況が一覧表示されます。各実行では、次のいずれかのステータスが表示されます。
| ステータス | 意味 |
|---|---|
| 保留中 | 実行が開始されるようにキューに入っています。 |
| 実行中 | エージェントはデータを確認しています。 実行の各ステップが完了した後に、提案が表示されます。 |
| 完了 | 実行が完了しました。この行は、作成された提案の数を示しています。 |
| 失敗 | 実行が終了する前に停止しました。 **「実行を再試行」**をクリックして、再度開始します。 |
| キャンセル済み | 完了前に、誰かが実行を停止しました。 |
実行をクリックすると、各ステップの進捗状況が表示され、レポートをダウンロードできます。
保留中の実行または実行中の実行を停止するには、その行で「実行をキャンセル」をクリックし、確認します。Amplitudeは、実行がすでに完了したステップと、それらの保存されたレポートを保持します。
実行レポート
完了した各実行には、実行の詳細からダウンロードできるレポートが生成されます。 このレポートには、エージェントが検出した内容とその理由が説明されています。これらを使用して、提案を一括で確認したり、提案されたイベントをエンジニアリングチームと共有したりできます。
| レポート | その内容 |
|---|---|
| トラッキングプランのエクスポートバンドル | 実行からエクスポートされたすべてのレポートとデータのZIPファイル。 |
| タクソノミーレポート | 実行のHTMLサマリー:検出結果、ユーザーのジャーニー、提案イベント、およびエージェントが提案しないことを選択したインタラクションとその理由。 |
| 実装ガイド | エンジニア向けのガイド。提案された各イベントの背後にある正確な定義、セレクターの信頼性、エージェントが測定したボリューム、イベントが期待どおりの要素で発生したことを確認する方法、コードに固定識別子を追加することで追跡の信頼性が向上する場所。 |
| タクソノミーイベント CSV | 提案された各イベントに、名前、ソース Autocaptureイベント、定義を1行ずつ対応させたもの。 |
| タクソノミーイベントJSON | JSONでの同じイベント定義。 |
| トラッキングプラン | Runの実行基準となる質問、測定されたフロー、実行が読み取るコンテキスト、および提案された各イベントの完全な仕様(カテゴリ、セレクター、耐久性、分析値など)です。 |
一部のレポートは、ダウンロードする前にAmplitudeでプレビューできます。
新しい提案について通知を受け取る
Amplitudeは、デフォルトではイベント・ディスカバリー・エージェントに関する通知を送信しません。新しい提案がレビュー可能になったときにメールまたはSlackメッセージを受け取るには、以下からオプトインしてください:
- _設定 > 通知_に移動します。
- _データに関する更新_の下で、新規イベント検出エージェントの提案がレビュー可能であることを確認します。
- Email、Slack、またはその両方を選択します。
提案を確認する
各提案には、説明、カテゴリ、定義、分析値の評価、およびその定義の信頼性に関する評定が含まれています。 各提案を確認し、必要に応じて編集し、タクソノミーで必要な提案を受け入れ、残りを却下します。
提案を検索する
- Amplitudeデータで、_イベント_に移動します。
- Agent-Suggestedタブをクリックします。
「オープン」ビューには、レビューを待っている提案が一覧表示されます。 「Dismissed」ビューには、誰かが却下した提案の一覧が表示されます。 各名前の横にあるスパークルアイコンは、そのイベントをagent-suggestedとしてマークします。
各提案について、表にはその名前、カテゴリ、分析値、受け入れるのが安全かどうか、選択した日付範囲での発生状況、およびエージェントが作成した日付が表示されます。 このリストは分析値に基づいて、高い順にソートされます。開いている提案をCSVファイルとしてエクスポートするには、ダウンロードをクリックします。
提案をレビューする
提案をクリックすると、詳細パネルが開きます。このパネルには以下が含まれます:
- 分析値:評価と、エージェントがそれを割り当てた理由。
- 評決メモ:提案を受け入れて安全かどうか、その理由。
- 説明:イベントのトリガー、イベントが属するユーザーのジャーニー、および分析での使用方法。
- カテゴリ:タクソノミーから該当する既存のカテゴリ、またはエージェントが提案した新しいカテゴリ。
- 発生回数: 過去30日間にイベントが発生した頻度。
- スクリーンショット / GIF:インタラクションのビジュアル(利用可能な場合)。
- 定義: Autocaptureイベントおよびラベル付きイベントが一致する要素セレクター。
エージェントの証拠と判定を出発点として使用してください。次に、説明と定義が、必要なインタラクションを正確に捉えていることを確認します。
スクリーンショットまたは GIF を作成するために、エージェントは イベントが発生した公開ページをロードし、コントロールを強調表示します。 うまくいかない場合(たとえば、ページでログインが必要な場合)、セッションリプレイ記録からのフレームが使用されます。このフレームには「Inferred event match」というラベルが付けられます。一部の提案にはビジュアルがありません。ビジュアルはイベントの近似表現であるため、定義をチェックして、目的のものに沿っていることを確認してください。
分析値
分析値は、あるインタラクションが分析にとってどの程度重要である可能性が高いかについてのエージェントの推定値であり、これはコアプロダクトフローの中心的な位置付けに基づきます。
| レーティング | 意味 |
|---|---|
| ハイ | このインタラクションは、アクティベーション、オンボーディング、または主要なコンバージョンパスなどのコアユーザーフローにとって重要です。それを追跡することは、分析に大きな影響を与える可能性があります。 |
| ミディアム | このインタラクションは、重要だが二次的なフローの一部です。これは、プロダクトの発見、エンゲージメント、または機能の導入を支援する可能性があり、包括的な分析のために追跡する価値があります。 |
| ロー | このインタラクションは、サポートフローまたは周辺フローで発生します。 これはエッジケース分析には役立つかもしれませんが、コアメトリクスに影響を与える可能性は低いです。 |
受け入れても安全です
各提案の定義は、サイトが公開している識別子(属性、ID、要素上のクラスなど)に依存します。 一部の識別子は他の識別子よりも安定しています。 承諾しても安全ですか? 列は、その定義がその名前のイベントとどの程度一致しているか、およびサイトの変更に合わせてその定義が機能し続ける可能性の程度を示します。
エージェントは次の2つのことを確認します。
- 耐久性:識別子がサイトの変更後も存続する可能性が高いかどうか。
- 正確さ:定義がイベント名が説明するコントロールのみをカウントするかどうか。
| 判定 | 意味 |
|---|---|
| はい | この定義は両方のチェックに合格します。提案を受け入れた後でも、データが破損したり失われたりする可能性は低いです。 |
| チェックする価値あり | この定義は、少なくとも1つのチェックに失敗します。 サイトの変更後に一致しなくなる場合や、その名前で示されているコントロール数よりも多くカウントされる場合があります。提案を受け入れる前に、定義を確認してください。 |
詳細パネルでは、評定は_Safe to accept_または_Check before accepting_と表示され、その理由をわかりやすい言葉で説明したメモが記載されます。エージェントが提案にフラグを立てると、このノートはエンジニアリングチームにコントロールへ固定識別子を追加するよう依頼するなど、修正案も提示します。
定義は、要素に固有であり、変更される可能性のない識別子を使用する場合、より耐久性があります。
| 耐久性がより高い | 耐久性が低い |
|---|---|
チームがテストまたは追跡のために追加した属性(例:data-testidまたはdata-track)。 | 複数のボタンで使用されるクラスなど、他の要素と共有されている識別子です。 |
要素上の安定したid属性。 | スタイルクラスとビルド生成されたクラス名またはID。これは、次のデプロイまたは再設計時に変更される可能性があります。 |
リンクの送信先(href)または特定のページルート。 | 表示可能なテキスト、aria-labelなどのラベル、価格またはカウントを含む値。 |
正確さの問題は、通常、定義が名前よりも広範であることを意味します。たとえば、名前はコントロールを「ボタン」と呼びますが、エージェントはその周囲のコンテナにクリックを記録します。
「はい」の評定は、エージェントがレビューした時点でのサイトを反映します。この評決は、サイトのコードを変更しても定義に影響を与える可能性があるため、長期的な信頼性を保証するものではありません。受け入れられたイベントでデータの収集が停止した場合は、ラベル付きイベントを修復するに移動します。
提案を編集してテストする
提案を受け入れる前に、詳細パネルでその名前、説明、カテゴリ、定義を直接更新できます。
提案を受け入れる前にデータを確認するには、詳細パネルでチャートを作成をクリックします。 Amplitudeは、提案されたイベントを含むチャートを開きます。これにより、ボリュームとトレンドが期待どおりに一致することを確認できます。 予想されるボリュームを大幅に上回るか下回る場合、その定義が別の要素に一致している可能性があります。
管理者とマネージャーは、提案が承認される前に、いつでもチャートを作成できます。他のユーザーは、**「受け入れられる前にイベントドロップダウンに提案を表示」**設定がオンになっている場合にのみ、チャートを作成できます。
提案を受け入れるか、却下します
- 承認:詳細パネルで「承認」をクリックします。Amplitudeはイベントを「Labeled Events」タブに追加し、エージェントが提案したものとしてマークしなくなります。
- 解除:解除をクリックします。提案は、_Dismissed_ビューに移動します。
却下された提案を復元するには、_Dismissed_ビューからその提案を開き、Restoreをクリックして確認します。提案は、レビューのために_Open_ビューに戻ります。
エージェントは、却下された提案をチェックするので、同じイベントをすぐに再び提案することはありません。 後の実行でインタラクションの証拠がさらに見つかった場合、エージェントは同様のイベントを提案できます。
長いリストを操作するには、「Add Filter」をクリックして、カテゴリ、30 Day Occurrences、30 Day Queries、Analytical Value、Safe to Accept?、またはCreated Dateごとに_Open_ビューを絞り込みます。たとえば、「高い分析値」を「はい」にフィルタリングすると、価値が高く最も信頼性の高い提案を最初に確認できます。一度に複数の提案を削除するには、リストで提案を選択し、「削除」をクリックします。
フィードバックを共有する
Amplitudeのプロダクトチームは、すべてのフィードバックを読んでEvent Discovery Agentを改善しています。
- 提案を評価する:提案の詳細パネルで、親指アイコンをクリックし、「良い提案」、「中立な提案」、または「良くない提案」を選択します。コメントを追加し、フィードバックを送信をクリックします。
- 全体的なフィードバックを共有する:Agent-Suggestedタブで、「フィードバックを送信」をクリックし、何が機能していて何が機能していないかについての簡単なアンケートに回答します。
これは役に立ちましたか?
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.