이 페이지에서

AI 컨텍스트

AI 컨텍스트는 Amplitude 에이전트에게 지표, 용어 및 비즈니스 선호도를 제공하는 곳으로, 그들의 답변은 조직의 운영 방식을 반영합니다. 이 컨텍스트를 정의하여 모든 답변을 조직에 맞게 조정하십시오.

시작하기

컨텍스트를 추가하기 전에 필요한 정보를 수집하고 올바른 위치로 이동하십시오.

AI 컨텍스트 찾기

글로벌 및 전문 에이전트를 포함한 에이전트는 조직과 프로젝트라는 두 가지 컨텍스트 계층을 사용합니다.

_프로젝트 설정 > AI 컨트롤_에서 둘 다 액세스할 수 있습니다.

시작하기 전에 수집해야 할 사항

비즈니스 기본 사항

B2B, B2C 또는 마켓플레이스와 같은 비즈니스 모델.

귀하의 북극성 지표와 이를 정의하는 방법.

회계연도 시작일(1월이 아닌 경우)입니다.

주요 고객 부문과 이를 식별하는 방법.

기술 세부 사항

등록 및 구매와 같은 주요 작업에 대한 이벤트 이름입니다.

세그먼트를 정의하는 속성 이름(예: 계획 유형 및 ARR)입니다.

제외할 테스트 또는 내부 사용자 식별자입니다.

피해야 할 사용되지 않는 이벤트입니다.

AI 컨텍스트 이해

컨텍스트에 따라 상담원이 질문에 대답하는 방식이 달라집니다.

사용자가 다음과 같은 질문을 합니다.

활성화 비율 보기

컨텍스트가 없으면
에이전트가 추측합니다. 잘못된 이벤트와 잘못된 기간을 사용하고 테스트 사용자를 포함시킵니다.

사용자 활성화를 보여주는 차트를 만들겠습니다. 활성화 사용자를 가입 후 이벤트를 완료한 사용자로 정의하겠습니다...

컨텍스트를 통해
에이전트는 사용자의 정확한 정의, 시간 프레임 및 필터를 알고 있습니다.

사용자의 정의를 사용하여 활성화율을 표시하겠습니다. @test.com 이메일을 제외하고 first_project_created가입 후 7일 첫 사용 후 트리거된 사용자들...

두 가지 수준의 컨텍스트

조직 컨텍스트
제한: 10,000자

모든 프로젝트에 적용됩니다. 회사 전체의 표준에 사용됩니다.

비즈니스 모델 및 KPI 정의입니다.

표준 용어입니다.

테스트 사용자 제외와 같은 글로벌 필터.

회계 달력 규칙.

프로젝트 컨텍스트
제한: 10,000자

하나의 프로젝트에 적용됩니다. 제품별 세부 정보에 사용하십시오.

제품별 이벤트 및 퍼널.

이 제품에 고유한 지표입니다.

제품별 세그먼트입니다.

필요한 경우 조직의 기본값을 재정의합니다.

런타임에 에이전트는 두 컨텍스트 소스를 결합합니다. 프로젝트 컨텍스트는 조직 컨텍스트와 충돌할 경우 조직 컨텍스트보다 우선합니다.

무엇을 쓸지

이것을 적으세요

Amplitude는 다음을 추론할 수 없습니다.

비즈니스 모델: "B2B SaaS, 연간 구독"

주요 부문: "엔터프라이즈 = ARR > 5만 달러

지표 정의: ""활성화 = 첫 사용 후 7일 이내 첫 번째 프로젝트"

날짜 규칙: "회계 연도가 4월 1일에 시작됨"

제외 사항: "@test.com 이메일을 필터링"

이 항목을 건너뛰세요

Amplitude는 다음을 인식합니다.

귀하의 이벤트 카탈로그 및 속성.

볼륨별 상위 이벤트.

공식 대시보드.

불러오기 코호트 정의.

기존 차트 구성입니다.

제공한 전체 컨텍스트에서 기존 코호트와 대시보드를 이름으로 참조하십시오. 예를 들면 다음과 같습니다.

참여도에 대한 질문을 받을 때 '고급 사용자' 코호트를 사용하십시오.

진폭에는 기본적으로 해당 정의가 포함됩니다.

적절한 맥락 작성

마크다운을 사용하여 컨텍스트를 구조화하여 에이전트가 쉽게 분석할 수 있도록 하세요.

포맷

## 제목을 사용하여 섹션을 구분하십시오.

- 항목 목록에는 글머리 기호를 사용하십시오.

`backticks` 이벤트 및 속성 이름을 감싸십시오.

**bold** 핵심 용어를 강조하십시오.

공통 섹션

비즈니스 개요: 사용자의 모델과 북극성 지표.

핵심 지표: 활성화, 참여 및 리텐션 정의.

세그먼트: 속성에 매핑된 고객 계층입니다.

해도 되거나 해서는 안 되는 규칙: 기본값, 필터, 그리고 피해야 할 것들입니다.

날짜 규칙: 회계 연도, 주 시작 및 기본 범위입니다.

10,000자 이하로 유지하십시오. 이는 조직 및 프로젝트 컨텍스트 모두에 대한 제한입니다. 팀이 묻는 질문의 80%를 다루는 20%의 정보에 집중하십시오.

산업 템플릿

먼저 해당 업종에 맞는 템플릿으로 시작하여 사용자 지정하십시오. 이것들은 복사하고 조정할 수 있는 완전한 예제입니다.

이 템플릿을 복사하여 이벤트 및 속성 이름을 본인의 것으로 바꾸고, 비즈니스에 맞게 정의를 조정하십시오.

text
## 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 컨텍스트를 효과적으로 만드는 요소와 피해야 할 위험을 알아보십시오.

구체적으로 설명하세요

좋음
상담원이 직접 사용할 수 있는 정확한 이벤트, 시간 범위 및 임계값을 정의합니다.
text
## 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
나쁨
구체적인 정의가 없습니다. 상담원은 ‘활성화’가 무엇을 의미하는지, ‘적절한’ 시간 범위는 무엇인지 추측해야 합니다.
text
Help users understand activation and engagement.
Show relevant metrics when asked about user behavior.
Make sure to use appropriate time ranges.

간결하게 사용하세요

Good
Dense, 스캔 가능한 형식입니다. 각 줄은 정확한 속성 이름을 사용하여 조치가 가능합니다.
text
## 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
나쁨
같은 정보가 장황한 문장에 묻혀 있습니다. 토큰을 낭비하며 분석하기가 더 어렵습니다.
text
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.

비즈니스 컨텍스트 포함

좋음
회계 연도 및 비즈니스 모델과 같이 Amplitude가 추론할 수 없는 컨텍스트를 설정합니다.
text
## 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
상담원
이 귀하의 특정 비즈니스를 이해하는 데 도움이되지 않는 잘못된 일반적인 문장입니다.
text
We are a software company that sells to businesses.
Our product helps teams collaborate better.
We care about growth and revenue.

명시적인 행/금지 규칙 사용

정확한 속성 값을 포함한 Good" description="Clear 지침

. 에이전트들은 무엇을 해야 하고 무엇을 피해야 하는지 알고 있습니다.
text
## 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`
상담원
에게 어떤 구체적인 조치를 취해야 하는지 알려주지 않은 불쾌한 지침입니다.
text
Be helpful and show relevant data.
Use appropriate filters when needed.
Be careful with sensitive information.

용어 정의

Good
Maps는 비즈니스 용어를 정확한 이벤트 이름에 매핑합니다. 명명 규칙을 설명합니다.
text
## 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`)
나쁨
올바른 용어나 규칙이 실제로 무엇인지 지정하지 않습니다.
text
Use the correct terminology for our company.
Use exact event names and correct casing.
Properties follow our naming conventions.

모범 사례

Do

정확한 이벤트 및 속성 이름을 올바른 대문자로 사용하십시오.

구체적으로 입력하십시오: "exclude email contains @test.com".

조직 수준에는 범용 규칙을 적용하고 프로젝트 수준에는 재정의를 적용하십시오.

저장하기 전에 질문을 통해 변경 사항을 테스트하십시오.

위키 또는 버전 관리에 백업을 보관하십시오.

이벤트나

속성을 나열하지 마십시오. Amplitude는 이미 이것을 알고 있습니다.

‘도움이 되십시오’ 또는 ‘적절한 필터를 사용하십시오’ 같은 모호한 지침을 작성하십시오.

조직과 프로젝트 컨텍스트 대상 구간 충돌하는 규칙을 생성합니다.

드문 경우에만 적용되는 에지케이스 규칙을 추가하십시오.

먼저 테스트하지 않고 큰 변화를 시도하십시오.

시간별 컨텍스트 유지

컨텍스트를 유지하는 데 도움이 되도록 다음 사항을 유의하십시오.

  • 소유자 지정: 조직 컨텍스트에 대한 분석 리드입니다. 각 프로젝트 컨텍스트의 PM 또는 분석가.

  • 정기적으로 검토하십시오: 분기별로, 주요 출시 후 또는 상담원이 예기치 않은 답변을 했을 때 검토하십시오.

  • 신중하게 변경하십시오: 한 번에 하나씩 변경하십시오. 실제 질문으로 테스트하십시오. 백업을 유지하십시오.

자주 묻는 질문

이 내용이 도움이 되었나요?