자주 찾는 이름을 한자리에 모았습니다.
개념별 배경 설명은 핵심 개념과 이벤트 설계에 있습니다.
| 헤더 | 역할 |
|---|
Authorization: Bearer ck-abto-… | ABTO Calling Key로 프로젝트를 식별합니다. 필수입니다. |
x-abto-key-openai 등 | 직접 계약한 모델 제공사의 API 키입니다. 필수입니다. |
x-abto-feature-id | 기능 ID입니다. 필수이며, 없는 요청은 거절됩니다. |
x-abto-device-id | 사용자 기기 식별자입니다. 선택이며, 없어도 호출과 호출 분석은 그대로 되지만 행동 연결과 sticky 배정, 사용자 기준 지표에서는 그 요청이 빠집니다. |
| 헤더 | 역할 |
|---|
x-abto-request-id | 방금 호출의 식별자입니다. 개별 상호작용을 특정 호출에 연결할 때 쓰며, 하나만 기억한다면 이것입니다. |
x-abto-attempt | 몇 번째 시도가 이 응답을 만들었는지 나타내는 1 기반 서수입니다. |
x-abto-provider | 실제로 배정된 모델 제공사입니다. 같은 모델 ID가 여러 제공사에 걸칠 수 있어 응답 본문만으로는 복구되지 않습니다. |
x-abto-error-source | 실패 응답의 출처로 provider, transport, internal 중 하나입니다. 노출 이전 admission 거절에는 붙지 않으므로, 부재 자체가 문전 처리 신호입니다. |
| SDK 이름 | Analytics event_name |
|---|
$pageview | pageview |
$pageleave | pageleave |
$ai_prompt_submitted | llm_prompt_submitted |
$ai_response_rendered | llm_response_rendered |
$ai_response_interacted | llm_response_interacted |
| 이름 | 의미 |
|---|
uuid / event_id | SDK가 자동 생성하는 이벤트 식별자 |
device_id | 브라우저 설치 식별자. 제품 행동과 AI 사용을 잇는 기본 축 |
$user_id | identify로 얹는 로그인 사용자 식별자 (선택) |
session_id | 논리 세션 식별자 |
$pageview_id | page/route 관찰 구간 식별자 |
$feature_id | 기능 ID(a.b.c). 게이트웨이 호출 헤더 x-abto-feature-id 와 같은 값 |
$request_id | 게이트웨이가 발급하는 AI 요청 식별자. 호출과 응답 상호작용을 잇는 상관 키 |
$response_id | 개별 AI 응답 식별자 |