이벤트 검색 에이전트

베타

이 기능은 베타 버전이며 계속 발전할 수 있습니다. 이 문서는 최신 업데이트를 반영하지 않을 수 있습니다.

Event Discovery Agent는 프로젝트에서 이미 수집한 웹 Autocapture 데이터를 검토하고, 핵심 제품 흐름을 식별하며, 해당 흐름의 주요 상호 작용에 대해 레이블이 지정된 이벤트를 제안합니다. 매주 실행되며 검토를 위해 제안을 상담원 제안 탭에 표시합니다. Amplitude는 누군가가 제안을 수락할 때까지 택소노미에 아무것도 추가하지 않습니다.

웹 자동 캡처를 실행하고 각 이벤트를 수동으로 정의하지 않고 추적할 가치가 있는 상호 작용을 찾으려면 이벤트 검색 에이전트를 사용하십시오. 사이트의 특정 요소를 직접 대화식으로 선택하고 이름을 지정하려는 경우 Visual Labeling을 사용하십시오.

이벤트 검색 에이전트가 베타입니다. 질문이 있는 경우 Amplitude 고객지원에 문의하십시오. 액세스를 요청하려면 Amplitude 담당자에게 문의하십시오.

Event Discovery Agent의 작동 방식

각 실행에서 Event Discovery Agent는 Page Viewed, Element Clicked, 와 같은 프로젝트의 Autocapture 이벤트를 Element Changed읽습니다. 이러한 이벤트로부터 핵심 제품 흐름을 구성하는 상호 작용 시퀀스를 식별합니다. 추적할 가치가 있는 각 상호 작용에 대해 사이트의 요소와 일치하는 이름, 설명, 범주 및 정의로 레이블이 지정된 이벤트를 초안으로 작성합니다. 그런 다음 해당 정의가 얼마나 신뢰할 수 있는지와 이벤트가 분석에 얼마나 중요한지 확인합니다.

제안은 이벤트 볼륨에 추가되지 않습니다. 레이블이 지정된 이벤트는 이미 수집한 자동 캡처 데이터 위에 계층화된 정의이며, 따라서 제안을 수락하면 새 이벤트를 전송하는 대신 기존 이벤트에 레이블이 지정됩니다. 레이블이 지정된 이벤트가 볼륨과 어떻게 관련되는지에 대한 자세한 내용은 레이블이 지정된 이벤트 및 이벤트 볼륨으로 이동하십시오.

일정 실행

베타 기간 동안 이벤트 검색 에이전트는 일주일에 한 번 실행됩니다. 일반적으로 실행에는 1~2시간이 걸립니다. 에이전트는 추적할 가치가 있는 상호작용을 발견할 때만 제안을 생성하므로 새로운 제안 없이 실행이 완료될 수 있습니다.

에이전트가 중복을 방지하는 방법

이벤트를 제안하기 전에 이벤트 검색 에이전트는 다음과 중복되는지 확인합니다.

  • 계측된 이벤트, 사용자 지정 이벤트 및 레이블이 지정된 이벤트를 포함하여 택소노미에 이미 포함된 이벤트입니다.
  • Agent-Suggested 탭에서 여전히 열려 있는 제안
  • 누군가가 무시한 제안

에이전트는 기존 이벤트를 편집하거나 삭제하지 않습니다. 에이전트가 이전에 제안한 상호 작용에 대한 추가 증거를 발견하면 누군가가 이전 제안을 기각하더라도 이후 실행에서 유사한 이벤트를 제안할 수 있습니다.

요구 사항

Event Discovery 에이전트는 브라우저 SDK의 웹 자동 캡처 데이터와 함께 작동합니다. 페이지 뷰 및 요소 상호작용(Element Clicked 및 Element Changed)을 읽습니다. 원격 구성을 사용하여 요소 상호작용 및 다른 자동 캡처 이벤트 유형을 설정할 수 있습니다. 에이전트가 읽는 이벤트의 경우 웹 자동 캡처 스키마로 이동하십시오. 이 에이전트는 프로젝트에 지난 30일 동안 웹 자동 캡처 이벤트 수가 10,000건 이상인 경우 가장 잘 작동합니다.

현재 자동 캡처 볼륨을 확인하려면 다음 방법 중 하나를 사용하십시오.

  • Amplitude 데이터에서 _이벤트_로 이동하여 Page Viewed및 Element Clicked와 같은 웹 자동 캡처 이벤트에 대해 30일 볼륨 열을 확인합니다.
  • 지난 30일 동안 웹 자동 캡처 이벤트의 이벤트 총 횟수를 측정하는 이벤트 세분화 차트를 구축합니다.

권한 관리

사용자가 이벤트 검색 에이전트로 할 수 있는 작업은 프로젝트에서 수행하는 역할에 따라 다릅니다.

공개 제안은 이벤트 검색 에이전트가 켜져 있는 동안에만 이벤트 드롭다운에 나타납니다. 에이전트가 꺼져 있으면 제안은 Agent-Suggested 탭에 남아 있지만 드롭다운에는 나타나지 않습니다.

Event Discovery Agent 켜기

이벤트 검색 에이전트는 프로젝트별로 실행됩니다. 프로젝트에 대해 켜려면 다음과 같이 하십시오.

  1. Amplitude 데이터에서 _Event Discovery Agent_로 이동합니다.
  2. 이벤트 검색 에이전트 활성화를 켭니다.
  3. 확인 메시지를 검토한 다음, 활성화를 클릭하고 실행을 시작합니다.

첫 번째 실행은 즉시 시작되며 일반적으로 1~2시간이 걸립니다. 그 후에는 에이전트가 매주 실행됩니다. 실행이 이미 진행 중이거나 지난 12시간 내에 실행이 성공적으로 완료된 경우, 에이전트를 켜도 다른 실행이 시작되지 않습니다. 다음 실행은 주간 일정에 따라 시작됩니다.

다른 프로젝트에 대해 에이전트를 켜려면 해당 프로젝트로 전환하고 이 단계를 반복하십시오.

Enable Event Discovery Agent를 끄면 Amplitude는 진행 중인 모든 실행을 중지하고 향후 실행을 취소합니다. 또한 '이벤트 드롭다운에 제안 표시(Show suggestions in event dropdowns before they are accepted)' 설정을 끕니다. 이미 받은 제안은 상담원 제안 탭에 남아 있습니다.

Amplitude Data 외부에서 제안을 볼 수 있는 사람을 제어합니다.

'Show suggestions in event dropdowns before they are accepted' 설정은 Amplitude 전체의 이벤트 드롭다운에 열린 제안이 표시되는지 여부를 제어하며, 이는 agent-suggested로 표시됩니다.

  • 켜기: 모든 사용자가 이벤트 드롭다운에서 열린 제안을 찾아 사용할 수 있습니다.
  • 끄기: 멤버와 뷰어는 Agent-Suggested 탭에서만 제안을 볼 수 있습니다. 관리자와 매니저는 항상 이벤트 드롭다운에서 제안을 사용하여 더 넓은 롤아웃 전에 테스트할 수 있습니다.

이 설정은 이벤트 검색 에이전트가 켜져 있는 경우에만 변경할 수 있습니다.

에이전트에게 제품에 대한 컨텍스트를 제공하십시오.

컨텍스트는 선택 사항이지만, 이를 통해 에이전트는 팀이 하는 방식으로 이벤트를 지정하고 제품의 중요한 부분에 집중할 수 있습니다. 언제든지 컨텍스트를 추가하거나 변경합니다. 저장된 컨텍스트는 이미 진행 중인 실행에 적용되지 않고 향후 실행에 적용됩니다.

이벤트 검색 에이전트는 다음 소스에서 컨텍스트를 읽습니다.

  • 컨텍스트 지침: 이벤트 검색 에이전트 설정 페이지에 입력하는 자유 텍스트입니다. 최대 10,000자입니다. Amplitude는 1,000~3,000자를 권장합니다.
  • 컨텍스트 파일: 데이터 사전, 명명 가이드 또는 제품 사양과 같이 업로드하는 파일입니다. 지원되는 형식은 TXT, MD, HTML, DOC, DOCX, PDF, CSV, XLS 및 XLSX이며, 파일당 최대 25MB입니다.
  • AI Controls 컨텍스트: AI Controls에 설정된 조직 및 프로젝트 컨텍스트입니다.

컨텍스트 지침과 파일은 프로젝트 단위로 지정됩니다. 프로젝트의 다른 Amplitude AI 에이전트도 이를 사용할 수 있습니다. 또한 Amplitude는 업로드된 파일을 사용하여 기존 이벤트 및 속성에 설명과 컨텍스트를 추가할 수도 있습니다. 업로드된 파일을 관리하려면 AI Controls로 이동하십시오.

명명 규칙

제안된 이벤트의 이름을 지정하기 위해 에이전트는 다음 소스 중 명명 규칙을 지정하는 첫 번째 소스를 사용합니다.

  1. 이벤트 검색 에이전트 컨텍스트 지침 및 컨텍스트 파일입니다.
  2. Amplitude Data 설정의 명명 규칙입니다.
  3. AI는 컨텍스트 파일, 프로젝트 컨텍스트, 조직 컨텍스트 순으로 컨텍스트를 고려합니다.
  4. 대부분의 기존 이벤트가 이미 따르고 있는 규칙입니다.
  5. 제품 영역 뒤에 객체와 과거형 액션을 Title Case로 작성하십시오(예: Projects | Project Created).

컨텍스트 지침에 포함할 항목

짧고 구체적인 지침이 가장 효과적입니다. 유용한 주제는 다음과 같습니다.

컨텍스트 지침을 추가하려면 다음을 수행하십시오.

  1. Amplitude 데이터에서 _Event Discovery Agent_로 이동합니다.
  2. 'What should Event Discovery Agent know about your product and taxonomy?' 카드에서 카드에서 편집을 클릭합니다.
  3. Markdown 형식으로 지침을 입력하거나 마크다운 파일 업로드를 클릭합니다.
  4. 저장을 클릭합니다.

컨텍스트 파일을 추가하려면 다음을 수행하십시오.

  1. 컨텍스트 파일 업로드 카드에서 파일 업로드를 클릭합니다.
  2. 파일을 선택한 다음 업로드를 클릭합니다.

모니터링 실행

이벤트 검색 에이전트 설정 페이지의 최근 실행 테이블에는 지난 30일간의 실행과 다음 예약된 실행 시간이 나열됩니다. 각 실행은 다음 상태 중 하나를 표시합니다.

실행을 클릭하여 각 단계의 진행 상황을 확인하고 보고서를 다운로드합니다.

보류 중인 또는 실행 중인 실행을 중지하려면 해당 행에서 실행 취소를 클릭한 다음 확인합니다. Amplitude는 실행이 이미 완료된 단계와 해당 단계에 저장된 보고서를 유지합니다.

실행 보고서

완료된 각 실행은 실행의 세부 정보에서 다운로드할 수 있는 보고서를 생성합니다. 보고서는 에이전트가 발견한 내용과 그 이유를 설명합니다. 이를 사용하여 제안을 대량으로 검토하거나 제안된 이벤트를 엔지니어링 팀과 공유할 수 있습니다.

일부 보고서는 다운로드하기 전에 Amplitude에서 미리 볼 수 있습니다.

새로운 제안에 대해 알림 받기

Amplitude는 기본적으로 이벤트 검색 에이전트에 대한 알림을 전송하지 않습니다. 새로운 제안이 검토 가능해지면 이메일이나 Slack 메시지를 받도록 옵트인하십시오.

  1. _설정 > 알림_으로 이동합니다.
  2. _내 데이터에 대한 업데이트_에서 _새 이벤트 검색 에이전트 제안을 검토할 수 있음_을 확인합니다.
  3. Email, Slack 또는 둘 다를 선택합니다.

제안 검토

각 제안에는 설명, 범주, 정의, 분석적 값 등급, 정의가 얼마나 신뢰할 수 있는지에 대한 판단이 포함됩니다. 각 제안을 검토하고, 필요한 경우 편집한 다음 택소노미에서 원하는 제안을 승인하고 나머지는 무시하십시오.

제안 찾기

  1. Amplitude Data에서 _이벤트_로 이동합니다.
  2. 상담원 추천 탭을 클릭합니다.

열린 보기에는 검토 대기 중인 제안이 나열됩니다. Dismissed 보기는 누군가가 해제한 제안이 나열됩니다. 각 이름 옆에 있는 반짝이는 아이콘은 이벤트를 에이전트가 제안한 것으로 표시합니다.

각 제안에 대해 테이블에는 이름, 범주, 분석 값, 수락 안전성 여부, 선택한 날짜 범위에서 발생한 경우 및 에이전트가 생성한 시기가 표시됩니다. 목록은 분석 값을 기준으로 정렬되며, 가장 높은 값이 먼저 정렬됩니다. 열린 제안을 CSV 파일로 내보내려면 다운로드를 클릭합니다.

제안 검토

제안을 클릭하여 세부 정보 패널을 엽니다. 패널에 포함된 내용은 다음과 같습니다.

  • 분석 값: 등급 및 에이전트가 지정한 이유입니다.
  • 평가 참고: 제안을 수락하기에 안전한지 여부와 그 이유를 나타냅니다.
  • 설명: 이벤트를 트리거하는 요소, 해당 이벤트가 속한 사용자 여정, 분석에서 어떻게 사용할 수 있는지 설명합니다.
  • 범주: 택소노미에 맞는 기존 범주 또는 에이전트가 제안하는 새 범주입니다.
  • 발생: 지난 30일 동안 이벤트가 얼마나 자주 발생했는지 나타냅니다.
  • 스크린샷 / GIF: 상호작용의 시각적 모습(사용 가능한 경우).
  • 정의: 자동 캡처 이벤트와 레이블이 지정된 이벤트가 일치하는 요소 선택기.

에이전트의 증거와 판정을 시작점으로 사용합니다. 그런 다음 설명과 정의가 원하는 상호 작용을 정확하게 나타내는지 확인하십시오.

스크린샷이나 GIF를 빌드하기 위해 에이전트는 이벤트가 발생하는 공개 페이지를 로드하고 컨트롤을 강조 표시합니다. 예를 들어 페이지에 로그인이 필요하기 때문에 이것이 작동하지 않는 경우, 세션 리플레이 기록의 프레임을 사용하며, 이는 '추론된 이벤트 일치'라는 레이블이 붙습니다. 일부 제안은 시각적으로 표시되지 않습니다. 시각적 형태는 이벤트를 대략적으로 표현한 것이므로 정의를 확인하여 원하는 대로 트래킹되는지 확인하십시오.

분석적 가치

분석적 가치는 상호작용이 귀하의 분석에 얼마나 중요할지에 대한 에이전트의 추정치이며, 이는 핵심 제품 흐름에서 해당 상호작용이 얼마나 중심적인지에 기반합니다.

안전하게 받아들일 수 있습니다.

각 제안의 정의는 요소의 속성, ID 또는 클래스와 같이 사이트가 노출하는 식별자에 따라 달라집니다. 일부 식별자는 다른 식별자보다 더 안정적입니다. 수락해도 안전한가요? 열은 정의가 지정된 이벤트와 얼마나 잘 일치하는지, 그리고 사이트가 변경됨에 따라 계속 작동할 가능성을 보여줍니다.

에이전트는 두 가지 사항을 확인합니다.

  • Durability: 사이트에 변경된 후에도 식별자가 유지될 가능성이 있는지 여부를 나타냅니다.
  • 정확도: 정의가 이벤트 이름에 설명된 컨트롤만 계산하는지 여부입니다.

세부 정보 패널에서 판정은 수락해도 안전함 또는 _수락하기 전에 확인 필요_로 표시되며, 그 이유를 평이한 언어로 설명하는 메모가 포함됩니다. 에이전트가 제안을 플래그로 지정하면 메모는 엔지니어링 팀에 고정 식별자를 컨트롤에 추가하도록 요청하는 등 수정 사항도 제안합니다.

요소에 고유하고 변경될 가능성이 낮은 식별자를 사용할 때 정의가 더 내구성이 높아집니다.

정확성 문제는 일반적으로 정의가 이름보다 넓다는 것을 의미합니다. 예를 들어, 이름은 컨트롤을 버튼이라고 지칭하지만 에이전트는 그 주변의 컨테이너에 대한 클릭을 기록했습니다.

Yes 판정은 에이전트가 검토한 시점의 사이트를 반영합니다. 사이트 코드에 대한 변경 사항이 여전히 정의에 영향을 줄 수 있기 때문에 평결은 장기적인 신뢰성을 보장할 수 없습니다. 허용된 이벤트가 데이터 수집을 중지하는 경우 레이블이 지정된 이벤트 복구로 이동하십시오.

제안 편집 및 테스트

제안을 수락하기 전에 세부 정보 패널에서 직접 이름, 설명, 범주 및 정의를 업데이트할 수 있습니다.

제안을 수락하기 전에 데이터를 확인하려면 세부 정보 패널에서 차트 만들기를 클릭합니다. Amplitude는 제안된 이벤트가 포함된 차트를 열어 이벤트 발생량과 추세가 예상과 일치하는지 확인할 수 있도록 합니다. 이벤트 발생량이 예상보다 훨씬 높거나 낮다면 정의가 다른 요소와 일치한다는 의미일 수 있습니다.

관리자와 매니저는 제안이 승인되기 전이라도 언제든지 차트로 시각화할 수 있습니다. 다른 사용자는 '승인 전 이벤트 드롭다운에 제안 표시' 설정이 켜져 있는 경우에만 차트로 작성할 수 있습니다.

제안을 수락 또는 무시

  • 수락: 세부 정보 패널에서 '수락'을 클릭합니다. Amplitude는 해당 이벤트를 '레이블이 지정된 이벤트' 탭에 추가하며 더 이상 '에이전트가 제안한 이벤트'로 표시하지 않습니다.
  • Dismiss: Dismiss를 클릭합니다. 제안이 Dismissed 보기로 이동합니다.

무시된 제안을 복원하려면 닫음 보기에서 해당 제안을 열고 복원을 클릭한 다음 확인합니다. 제안이 검토를 위해 열기 보기로 돌아갑니다.

에이전트는 동일한 이벤트를 즉시 다시 제안하지 않도록 무시된 제안을 확인합니다. 이후 실행에서 상호작용에 대한 더 많은 증거가 발견되면 에이전트는 유사한 이벤트를 제안할 수 있습니다.

긴 목록을 처리하려면 'Add Filter'를 클릭하여 범주, '30 Day Occurrences', '30 Day Queries', 'Analytical Value', 'Safe to Accept?' 또는 'Created Date'별로 'Open' 뷰의 범위를 좁힙니다. 예를 들어 'Analytical Value' 필터를 'High'로, 'Safe to Accept?' 필터를 'Yes'로 설정하여 가장 가치 있고 신뢰할 수 있는 제안을 먼저 검토합니다. 여러 제안을 한 번에 해제하려면 목록에서 해당 제안을 선택한 다음 해제를 클릭합니다.

피드백 공유

Amplitude의 제품 팀은 모든 피드백을 읽어 이벤트 디스커버리 에이전트를 구성합니다.

  • 제안 평가: 제안의 세부 정보 패널에서 엄지 아이콘을 클릭하고 'Good suggestion', 'Neutral suggestion' 또는 'Not a good suggestion'을 선택합니다. 코멘트를 추가한 다음 피드백 제출을 클릭합니다.
  • 전체 피드백 공유: 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.

이 페이지에서