연동 시작하기

도입을 결정했다면 여기서 시작합니다. ABTO가 어떤 도구인지부터 알고 싶다면 무엇을 해결하나요를 먼저 읽어 보세요.

연동 순서

대시보드에서 프로젝트를 만들고 API 키를 발급받습니다.
AI 호출 코드의 base URL을 게이트웨이로 바꿉니다. 서버든 워커든 배치 작업이든, 모델을 호출하는 곳이면 어디든 같습니다. 공식 SDK에는 featureId/feature_id로 기능 ID를 넣습니다. SDK가 이를 x-abto-feature-id 헤더로 전달하며, Gateway를 직접 호출할 때만 같은 헤더를 직접 넣습니다. 여기까지만 해도 기능별 비용과 응답 속도가 잡히기 시작합니다.
웹이나 앱에 클라이언트 SDK를 넣어 사용자 행동을 수집합니다.
서버 호출에 브라우저의 device_id를 실어 보내, 사용자 행동과 AI 호출이 연결되게 합니다.
대시보드에서 비용과 품질, 성과가 함께 잡히는지 확인합니다.

연동을 실제로 진행할 때는 대시보드의 설치 화면을 따라가는 편이 가장 빠릅니다. 프로젝트 키가 이미 채워진 예제를 단계마다 보여주므로 그대로 복사해 쓰면 됩니다. 이 문서에는 키를 싣지 않으니, 여기 실린 코드는 전체 구조를 파악하는 용도로 읽으세요.

코딩 에이전트에게 맡기기

Codex나 Claude Code가 저장소를 분석해 필요한 SDK만 골라 연동하도록 ABTO SDK Agent Skill을 전역으로 설치할 수 있습니다. Node.js 22.20 이상이 필요합니다.

Codex:

npx --yes skills@latest add https://github.com/greedy-co/abto-sdk/tree/main/abto --skill abto --global --agent codex --copy --yes

Claude Code:

npx --yes skills@latest add https://github.com/greedy-co/abto-sdk/tree/main/abto --skill abto --global --agent claude-code --copy --yes

SDK 설치까지 에이전트에게 맡기려면 아래 프롬프트를 붙여 넣으세요.

ABTO SDK Agent Skill을 이 에이전트의 전역 스킬로 설치하고 이 저장소에 ABTO SDK를 연동해 주세요.

1. Node.js 22.20 이상과 npx를 사용할 수 있는지 확인해 주세요.
2. npx --yes skills@latest add를 사용해 공식 스킬 경로 https://github.com/greedy-co/abto-sdk/tree/main/abto의 abto 스킬을 현재 에이전트에 맞는 --agent 값과 --global --copy --yes 옵션으로 설치해 주세요.
3. npx --yes skills@latest list --global --agent <현재 에이전트>로 설치를 검증하고, 새로 설치한 abto 스킬을 읽어 주세요. 현재 세션에서 스킬 목록을 갱신할 수 없다면 새 세션에서 이어갈 정확한 프롬프트를 알려 주세요.
4. 이 저장소의 런타임과 패키지 매니저를 확인해 Browser, App, Server SDK 중 필요한 것만 설치하고 연동해 주세요.
5. Event Key는 클라이언트에, Calling Key와 provider credential은 서버에만 두고 어떤 자격 증명도 커밋하지 마세요.
6. 빌드와 테스트를 실행하고, 가능하면 ABTO에서 데이터 수신까지 확인한 뒤 변경 사항과 남은 사용자 조치를 알려 주세요.

필요한 키나 권한이 없으면 안전하게 진행할 수 있는 부분까지 먼저 완료하고, 정확히 무엇이 필요한지 물어봐 주세요.

설치 확인과 삭제, 문제 해결 명령은 Agent Skill 설치 가이드에 있습니다.

두 종류의 키

Calling Key ck-abto-…

서버 전용 — 게이트웨이 호출 전체를 인증
서버 환경 변수에만 보관
브라우저 번들과 URL, 코드 저장소에는 절대 노출 금지

Event Key ek-abto-…

브라우저와 앱의 행동 수집 전용
관리 권한이 없어 노출되어도 안전

데이터가 어느 프로젝트에 기록될지는 서버가 받은 키 하나로 정해집니다. 클라이언트가 함께 보내는 값은 분석에만 쓰일 뿐, 권한을 주장하는 근거가 되지 않습니다.

연동 중 낯선 개념이 나오면 핵심 개념을, 언어별 설치 가능 여부는 SDK 지원 현황을 보면 됩니다.