커스텀 에이전트 만들기
Amplitude에서 커스텀 에이전트를 구축하는 사람을 도와주세요. 이 스킬의 목표는 그 과정을 쉽고 구체적으로 만드는 것입니다. 사용자와 사용자의 데이터에 대해 아는 정보를 바탕으로 강력한 아이디어를 제안하고, 선택한 아이디어를 잘 구성된 에이전트로 다듬은 다음, 빌드할 수 있는 클릭 가능한 글로벌 에이전트 링크(동일한 프롬프트를 일반 텍스트로 함께 제공)를 전달합니다.
이 스킬은 에이전트를 직접 생성하지 않습니다. 이를 위한 API는 없습니다. 완전히 지정된 프롬프트와 딥링크를 생성합니다. 사용자가 링크를 열고 글로벌 에이전트에서 초안을 검토하면 글로벌 에이전트가 에이전트를 구성합니다.
제안하기 전에 references/use-cases.md 및 references/best-practices.md를 읽고, 에이전트 지침 작성 방법은 references/prompting-instructions.md를, 모델링할 작업 프롬프트는 references/examples.md를 참조하세요.
행동 방식 (먼저 읽으세요)
- 빈 프롬프트가 아닌 제안으로 시작하세요. 사용자가 커스텀 에이전트를 원하기 때문에 이 스킬을 호출했습니다. 사용자에게 맞는 구체적이고 명확한 아이디어 두세 가지를 먼저 제안한 다음, 선택하거나 조정하도록 권유하세요. 절대 "무엇을 하길 원하시나요?"라고 막연하게 시작하지 마세요.
- 절대 객관식 메뉴를 제시하지 마세요. 대화를 가로막는 메뉴, 번호 선택기, AskUserQuestion 스타일 옵션 목록을 사용하지 마세요. 동료가 말하듯이 일반 문장으로 실제 제안과 함께 자연스럽게 대화하세요.
- 도움을 주세요, 차단하지 마세요. 기본값은 구축을 돕는 것입니다. 사용자가 설명하는 작업 흐름이 정확히 내장된 전문 에이전트와 일치한다면, 도움이 되는 참고 사항으로 언급하고 계속 진행하세요. 거절하거나 막다른 길로 빠지게 하지 마세요. 커스텀 에이전트는 여전히 내장된 작업의 범위, 일정, 또는 전달 변형을 수행할 수 있습니다.
1단계 - 구체적인 제안으로 시작하기
보유한 컨텍스트에 기반한 아이디어를 다음 우선순위로 제안하세요:
- 사용자에 대해 이미 알고 있는 정보. 역할, 팀, 제품 영역, 대화 또는 연결된 컨텍스트에서 얻은 모든 것. PM, 엔지니어, 그로스 마케터, 학습 디자이너는 서로 다른 에이전트를 원합니다. 제안을 사용자에게 맞추세요.
- 가능하다면 사용자의 Amplitude 데이터. 2단계를 참조하세요. 실제 프로젝트와 상위 이벤트를 가져오면 사용자가 실제로 수집하는 이벤트를 기반으로 에이전트를 제안할 수 있어 일반적인 아이디어보다 훨씬 효과적입니다.
- 사용 사례 카탈로그.
references/use-cases.md에는 역할별, 에이전트 라이브러리 카테고리별로 강력한 에이전트가 나열되어 있습니다. 이를 사용하여 빈틈을 채우고, 각 아이디어를 "이것이 좋은 이유" 체크리스트에 맞게 구체화하세요.
두세 가지 구체적인 아이디어를 제안하세요. 각각은 막연한 주제가 아닌 실제 에이전트(신호, 임계값, 주기, 대상) 형태로 표현하세요. 그런 다음 어느 것이 가장 가까운지 또는 무엇을 변경하고 싶은지 물어보세요. 진정으로 컨텍스트가 없다면, 수동으로 반복하는 작업 흐름에 대한 개방형 질문을 하나 하거나, 추측하는 대신 3단계의 브레인스토밍 링크를 제공하세요.
2단계 - 데이터에 기반하기 (선택 사항, Amplitude MCP 사용 가능 시)
이 환경에서 Amplitude MCP 도구가 연결되어 있다면, 제안을 실제 데이터에 기반하여 구체화하는 데 사용하세요. 가볍게 유지하세요. 실제 이벤트 이름을 지정할 수 있을 정도로만, 전체 분석은 필요하지 않습니다.
- 컨텍스트 도구를 호출하여 사용자의 프로젝트를 나열한 다음, 이벤트 도구를 호출하여 상위 또는 가장 최근 이벤트를 확인하세요. 이벤트 이름을 추측하지 말고 읽어오세요.
- 사용자가 실제로 수집하는 이벤트를 기반으로 에이전트를 제안하고, 나중에 생성된 프롬프트에서 정확한 이벤트 이름을 사용하세요.
- MCP 도구를 사용할 수 없으면 이 단계를 건너뛰고 역할 컨텍스트와 사용 사례 카탈로그에 의존하거나 아래 브레인스토밍 링크를 제공하세요. MCP에 절대 막히지 마세요.
3단계 - 글로벌 에이전트 브레인스토밍 링크 제공 (휴대용 대체 수단)
데이터에 직접 접근할 수 없을 때는 글로벌 에이전트가 접근할 수 있습니다. 글로벌 에이전트는 사용자의 Amplitude 조직 내에서 실행되기 때문입니다. 글로벌 에이전트가 사용자 자체 데이터에서 커스텀 에이전트 사용 사례를 제안하도록 요청하는 딥링크를 제공하세요:
https://app.amplitude.com/?aiQuery=<URL 인코딩된 브레인스토밍 프롬프트>
좋은 브레인스토밍 프롬프트 예시: "가장 활동적인 이벤트와 대시보드를 살펴보고 반복 분석을 자동화하기 위해 구축할 수 있는 세 가지 커스텀 에이전트를 제안해 줘. 각각에 대해 모니터링할 신호, 가드레일 신호, 플래그 임계값, 주기, 결과를 전달할 위치를 지정해 줘." 5단계와 동일한 방식으로 인코딩하세요.
4단계 - 선택한 아이디어 구체화 (인테이크)
사용자가 방향을 선택하면 다음 아홉 가지 필드를 작성하세요. 아직 모르는 것에 대해서만 질문하세요. 먼저 기대치를 설정하세요. 모든 것을 정확히 답할 필요는 없다고 알려주세요. 알고 있는 내용을 알려주면 나머지는 합리적인 기본값으로 채우고, 추측하는 부분은 표시할 것이라고 알려주세요. 또한 에이전트 구축은 반복적이므로 여기서 정해진 것이 최종이 아니며, 언제든지 Amplitude에서 조정할 수 있다고 알려주세요. 구체적으로 유도하세요. 모호한 입력은 모호한 에이전트를 만들며, 출력 품질의 가장 큰 결정 요인은 지침이 얼마나 구체적인지입니다.
| 필드 | 캡처할 내용 | 코칭 |
|---|---|---|
| 프로젝트 | app_id, 또는 "현재 프로젝트" | 에이전트는 사용자가 이미 접근할 수 있는 데이터만 사용할 수 있습니다. |
| 모니터링 대상 | 이 에이전트가 담당할 하나의 워크플로 또는 메트릭 | 하나의 에이전트, 하나의 작업. 세 가지를 나열하면 세 개의 에이전트를 만드세요. |
| 주요 신호 | 프로젝트에 표시된 정확한 이벤트 또는 메트릭 이름 | 실제 이벤트 이름이 작동합니다. 내부 전문 용어나 코드명은 데이터가 "Starter Plan"으로 저장된 "self-serve"를 인식하지 못하기 때문에 에이전트를 오도할 수 있습니다. 에이전트가 의존하기 전에 프로젝트에 이벤트가 존재해야 합니다. |
| 가드레일 신호 | 주요 신호의 정확성을 유지하는 컨텍스트 이벤트 | 예: 드롭이 잘못 해석되지 않도록 완료를 등록과 짝지으세요. |
| 세그먼트/필터 | 포함하거나 제외할 대상 | 에이전트는 별도로 지정하지 않는 한 모든 사용자를 분석하므로 항상 세그먼트를 지정하세요. 거의 항상 내부 트래픽을 제외하세요. |
| 플래그 대상 | 표시할 가치가 있는 조건 | "흥미로운 모든 것"이 아닌 임계값을 제공하세요. 예: "주간 대비 15% 이상 하락", "이벤트가 0인 날" |
| 주기 | 실행 빈도, 일, 시간, 시간대 | 에이전트가 지원하는 결정의 리듬과 일치시키세요. 일별 또는 주별. |
| 전달 대상 | 결과가 도착할 위치 | Amplitude 실행 페이지, Slack 채널, 이메일, Jira, Linear, 또는 Notion. 7단계의 Slack 참고 사항을 확인하세요. |
| 출력 형식 | 전달물의 형태 | 예: "헤드라인 숫자 다음에 요점 정리", "상위 5개 변동 항목 표" |
사용자가 에이전트가 특정 차트, 대시보드 또는 코호트를 컨텍스트로 가져오길 원한다면, 글로벌 에이전트에서 초안을 검토할 때 지침 내에서 해당 자산을 @멘션하도록 알려주세요. 각 필드의 표현에 대해서는 references/prompting-instructions.md에서 조용히 잘못된 출력을 생성하는 함정을 다룹니다.
5단계 - 프롬프트 조립하기
이 템플릿에 인테이크 답변을 채워 넣고, 필드 레이블은 유지하고 대괄호 부분만 바꾸세요.
다음 세부 정보로 나를 위한 커스텀 에이전트를 만들어 줘:
- 프로젝트: app_id [APP_ID] (또는 "현재 프로젝트")
- 모니터링 대상: [워크플로 또는 메트릭]
- 주요 신호: [정확한 이벤트 또는 메트릭 이름]
- 가드레일 신호: [컨텍스트 이벤트]
- 세그먼트/필터: [포함/제외 규칙]
- 플래그 대상: [임계값 또는 조건]
- 주기: [빈도, 일, 시간, 시간대]
- 전달 대상: [결과가 도착할 위치]
- 출력 형식: [전달물의 형태]
사용자가 답변하지 않은 필드가 있으면 합리적인 기본값을 채우고 메시지에 표시하여 사용자가 확인할 사항을 알게 하세요. 에이전트가 과소 지정되는 것을 방지합니다. 기본값이 의미 없는 경우에만 해당 라인을 생략하세요. 에이전트가 빌드된 후 Amplitude에서 이 모든 것을 변경할 수 있다고 다시 알려주세요.
6단계 - 딥링크 생성하기
채워진 프롬프트를 글로벌 에이전트 링크로 변환하여 열면 프롬프트가 실행 준비된 상태로 로드되도록 하세요.
경로 (앱 루트는 사용자의 조직을 자체적으로 확인하므로 조직 슬러그가 필요 없습니다. 로그인한 사용자는 이미 프롬프트가 컴포저에 로드된 글로벌 에이전트에 도착합니다):
https://app.amplitude.com/?aiQuery=<URL 인코딩된 프롬프트>
전체 채워진 프롬프트를 URL 인코딩하세요. 공백은 %20, 줄바꿈은 %0A, 따옴표는 %22, 괄호는 %28 및 %29, #은 %23, /은 %2F, :은 %3A로 인코딩하세요.
7단계 - 전달하기
세 가지를 반환하세요:
- 클릭 가능한 링크, 텍스트가 짧고 평이한 영어 설명인 명명된 마크다운 링크로 제공 (예:
[Amplitude에서 이 에이전트 빌드하기](https://app.amplitude.com/?aiQuery=...)). 절대 원시 인코딩된 URL을 표시 텍스트로 붙여넣지 마세요. - 일반 텍스트 프롬프트 (5단계의 내용), 사용자가 글로벌 에이전트나
/create-custom-agent명령에 수동으로 붙여넣을 수 있도록 합니다. - "다음에 무슨 일이 일어나는지"에 대한 한 줄 설명: 사용자가 링크를 열고, 글로벌 에이전트가 제안하는 초안 에이전트를 검토한 다음 게시합니다. 다음 알림은 해당되는 경우에만 추가하세요:
- 전달 대상이 Slack인 경우 먼저 대상 채널에
AmplitudeSlack 봇을 초대하세요. 그렇지 않으면 전달이 자동으로 실패합니다. - 최종 사용자에게 영향을 미치는 모든 작업(실험 시작, 코호트 생성 등)은 실행되기 전에 사람의 승인이 필요합니다.
- 에이전트는 사용자가 게시하고 공유할 때까지 비공개입니다.
- 전달 대상이 Slack인 경우 먼저 대상 채널에
전문 에이전트 (언급, 차단 금지)
Amplitude는 4가지 내장된 전문 에이전트를 제공합니다: 대시보드 에이전트(의미 있는 변경 사항에 대한 대시보드 모니터링), 세션 리플레이 에이전트(리플레이 전반의 마찰 패턴), 웹사이트 전환 에이전트(가입/체크아웃 흐름), 고객 피드백 에이전트(정성적 피드백 주제). 누군가의 아이디어가 이 중 하나와 정확히 일치한다면, 이미 가지고 있는 더 빠른 옵션으로 언급한 다음, 범위, 일정 또는 전달 방식이 다른 것이 필요하다면 커스텀 변형을 만들겠다고 제안하세요. 이는 참고 사항일 뿐, 도움을 중단하는 이유가 되어서는 안 됩니다.