Sierra 대화를 에이전트 분석으로 가져오기
Sierra 연동은 완료된 Sierra 대화를 에이전트 분석으로 전달합니다. Sierra는 웹후크, Amazon EventBridge 또는 Google Pub/Sub를 통해 실행하는 핸들러로 대화를 전달하거나, 예약된 작업이 내보내기에서 해당 대화를 가져옵니다. 핸들러는 각 대화를 [Agent] 이벤트에 매핑하고 Amplitude HTTP API로 전송합니다. 그런 다음 Amplitude는 세션, 턴 및 도구 호출을 구축하고 내장 신호를 실행합니다.
AI 코딩 에이전트로 설정(권장)
이 프롬프트를 Cursor, Claude Code, Windsurf, GitHub Copilot 또는 Codex와 같은 AI 코딩 에이전트에 붙여넣으십시오. 에이전트는 가이드를 가져오고, 작업을 빌드한 후 모의 실행(dry run)으로 시작합니다.
Connect our Sierra conversations to Amplitude Agent Analytics.
Fetch https://raw.githubusercontent.com/amplitude/Amplitude-AI-Node/main/docs/integrations/sierra.md
If @amplitude/ai is installed, the same file is under node_modules/@amplitude/ai/docs/integrations/.
Follow links in the guide. If your source isn't listed, start at https://raw.githubusercontent.com/amplitude/Amplitude-AI-Node/main/docs/integrations/README.md
Follow "Part 2: Coding agent procedure". Start with a dry run.
에이전트는 중단하고 사용자 ID를 포함하는 필드와 같이 추론할 수 없는 값을 묻습니다. 변경 사항을 검토한 다음 시작하기의 단계에 따라 확인합니다.
이것이 여러분에게 의미하는 바
- 실행 내용: Sierra의 배포 채널을 위한 핸들러 또는 예약된 내보내기 작업입니다.
- 필요한 항목: Sierra의 고객 문서에 있는 Sierra의 페이로드 형식입니다. Sierra 계정 팀을 통해 액세스를 요청하십시오. Amplitude는 Sierra의 공개 자료를 기반으로 가이드의 매핑을 구축했으므로, 의존하기 전에 계정의 샘플과 비교하여 필드 이름을 확인하십시오.
- 대화에는 다음 항목이 포함되어야 합니다: 프로덕트 분석과 일치하는 사용자 ID.
전송되는 항목
| 데이터 | 전송 |
|---|---|
| 턴 및 세션 그룹화 | 예 |
| 입력 및 출력을 포함하는 도구 호출 | 예, 피드에 포함된 경우 |
| CSAT | 네, 피드에 포함된 경우 [Agent] Score 이벤트로서 표시됩니다 |
| 모델, 토큰 및 비용 | 일반적으로 Sierra의 피드에서 사용할 수 없으므로 비어 있습니다. |
| 실험 | 예, Sierra 내보내기의 대화 필드에 변형이 기록되는 경우. 코딩 에이전트에게 어떤 필드를 알려주십시오. |
신선도 및 제한
- 푸시 전달: Sierra가 전달하는 대로 대화가 도착합니다.
- 예약된 내보내기: 각 실행은 워터마크 시점으로부터 1시간 전 데이터를 다시 읽어 지연된 기록을 포착합니다. Amplitude는 반복 이벤트를 중복 제거합니다.
- 속도 제한: 모든 내보내기 API에서 Sierra의 속도 제한을 준수하십시오.
시작하기
Sierra 연동 가이드를 따르십시오. 샘플 페이로드에 대해 드라이 런으로 시작하고, 라이브 이벤트와 세션 뷰어를 확인한 다음 동일한 대화를 다시 전송하여 중복 항목을 추가하지 않는지 확인하십시오.
가이드는 2026년 10월 6일 Sierra의 공개 자료를 기준으로 마지막으로 확인되었습니다. Sierra는 소유자의 상표입니다. Amplitude는 Sierra와 제휴하지 않으며 Sierra가 보증하지 않습니다.
이 내용이 도움이 되었나요?
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.