SDK 지원 현황

Available: 공개 레지스트리에서 설치 가능. 설치 검증까지 통과
Preview: 설치 가능. 단 API 변경 여지
Planned: 공개 설치 전. 예제는 출시 전 미리보기

ABTO SDK는 실행 위치에 따라 두 갈래로 나뉩니다. 사용자 화면(웹, 모바일 앱)에서 도는 클라이언트 SDK와 모델을 호출하는 코드(서버, 워커, 배치)에서 도는 서버 SDK입니다. 쓰는 키가 다르고 관찰하는 사실도 달라 서로의 자리를 바꿔 쓸 수 없습니다.

클라이언트 SDK와 서버 SDK

구분	클라이언트 SDK	서버 SDK
실행 위치	브라우저, 모바일과 데스크톱 앱	애플리케이션 서버, 워커, CI
사용하는 키	Event Key (`ek-abto-…`)	Calling Key (`ck-abto-…`)
하는 일	사용자 행동과 화면에서 일어난 일을 수집	게이트웨이 호출에 사용자와 기능 컨텍스트를 전달
대표 SDK	Browser JavaScript, Android, iOS, Flutter	Node / Server JavaScript, Python

모델과 토큰, 비용, 응답 속도는 어느 SDK도 직접 재지 않습니다. 이 사실들은 게이트웨이가 호출을 전달하면서 기록합니다. 각자 직접 관찰한 사실만 보고한다는 원칙은 동작 원리에서 다룹니다.

두 키를 섞어 쓰지 않는 것이 무엇보다 중요합니다. Calling Key는 서버 환경 변수에만 두어야 하고, Event Key로는 게이트웨이 호출을 인증할 수 없습니다. 키의 구분은 연동 시작하기에 정리해 두었습니다.

어느 쪽을 먼저 연동하나요

AI 기능의 비용과 품질부터 보고 싶다면 서버 SDK로 게이트웨이 호출을 연결합니다. 사용자가 그 기능을 실제로 쓰고 전환까지 이어 갔는지 보고 싶다면 클라이언트 SDK로 행동을 수집합니다. 효과 대비 비용을 함께 판단하려면 양쪽을 모두 연동합니다. 제품 행동과 AI 사용은 device_id로 잇고, 개별 요청은 게이트웨이가 발급한 request_id로 잇습니다.