연동 시작하기

먼저 AI 호출 하나를 ABTO에 연결하세요. 대시보드에 응답, 비용, 응답 시간이 보이면 연결이 완료된 것입니다. 이후 모델과 프롬프트를 바꾸고, 구매나 페이지 조회, 클릭과 같은 사용자 행동까지 연결할 수 있습니다.

1. 연결 방법 선택하기

연결 방법	시작하는 곳
Codex나 Claude Code에 맡기기	Agent Skill 설치 후 아래 요청 전달
직접 코드에 연결하기	아래에서 현재 사용하는 환경 선택

스킬을 설치했다면 에이전트에 이렇게 요청하세요.

ABTO 스킬로 이 프로젝트의 AI 호출 하나를 연결해 주세요.
최신 공식 문서와 설치된 SDK 버전을 확인하고, 기존 호출 방식과 추적 설정을 유지해 주세요.
먼저 연결할 호출 지점을 알려주고, 적용 후 첫 요청이 ABTO에 기록되는지 확인해 주세요.
키나 권한이 없어 확인하지 못한 단계는 구분해 알려 주세요.

직접 연결한다면 현재 AI 호출 방식에 맞는 가이드를 선택하세요.

현재 사용 환경	가이드
Node.js에서 OpenAI SDK 사용	Node.js JavaScript
Node.js에서 LangChain의 ChatOpenAI 사용	LangChain 연결
Node.js에서 CommonJS 사용	CommonJS 설정
Python에서 OpenAI SDK 사용	Python
HTTP로 직접 호출	Gateway Chat Completions

현재 서버 연동은 OpenAI Chat Completions 요청을 지원합니다. Streaming이나 Responses API를 사용한다면 지원 범위부터 확인하세요.

2. 키 준비하고 첫 호출 보내기

대시보드에서 프로젝트를 만들고 Calling Key를 발급받으세요. Calling Key와 OpenAI 등 LLM 제공사 API 키는 서버 환경변수에 설정합니다. 선택한 가이드의 설치와 호출 예제를 실행하세요.

featureId는 AI 기능을 구분하는 이름입니다. 첫 호출 예제에서는 review.summary를 사용합니다. 실제 서비스에 연결할 때는 해당 기능을 알아볼 수 있는 이름으로 바꾸세요.

두 종류의 키

키	사용하는 곳	필요한 시점
Calling Key (`ck-abto-…`)	서버, 워커, 백그라운드 작업	AI 호출을 연결할 때
Event Key (`ek-abto-…`)	브라우저, 모바일 앱	사용자 행동을 연결할 때

Calling Key와 LLM 제공사 API 키는 브라우저 코드나 Git 저장소에 넣지 마세요. Event Key로는 AI 호출을 인증할 수 없습니다.

3. 첫 요청 확인하기

대시보드의 요청 화면에서 예제에 지정한 기능 이름을 찾으세요. 요청을 열어 응답 내용, 실행 모델, 비용, 응답 시간을 확인합니다. 앱에서 응답을 받았고 같은 호출이 요청 목록에 나타나면 연결이 완료된 것입니다.

확인되지 않는 것	먼저 확인할 내용
앱에서 호출 실패	서버 환경변수의 Calling Key와 LLM 제공사 API 키, 반환된 오류 메시지
응답은 왔지만 요청이 안 보임	대시보드 프로젝트와 조회 기간, 기능 이름, 직접 폴백 실행 여부
다른 모델로 실행됨	해당 기능에 저장된 라우팅 설정

직접 폴백으로 제공사를 호출한 경우에는 ABTO 요청 목록에 기록되지 않습니다. 계속 확인되지 않으면 문제 해결을 참고하세요.

4. 모델이나 프롬프트 바꿔 보기

연결을 확인했다면 테스트용 기능에서 모델 또는 프롬프트 하나를 바꿔 보세요.

테스트에서 첫 호출의 기능을 선택하고 변경할 모델이나 프롬프트를 시험합니다.
결과를 확인한 뒤 에이전트 설정으로 저장합니다.
라우팅에서 새 옵션을 만들어 노드에 저장한 에이전트 설정을 고르고, 비율을 정해 저장합니다. 테스트용 기능에서는 새 옵션을 100%로 설정하면 변경 결과를 확인하기 쉽습니다.
같은 기능 이름으로 앱에서 다시 호출하고, 요청 화면에서 실제 실행 모델과 응답을 확인합니다.

다른 제공사의 모델을 선택했다면 해당 제공사의 API 키도 서버에 설정해야 합니다. 운영 중인 기능의 트래픽을 바꿀 때는 단계적으로 비율을 올리는 방법을 따르세요.

5. 사용자 행동 연결하기

AI 응답이 구매나 가입으로 이어졌는지 보려면 클라이언트 SDK를 추가하세요.

사용자 화면	가이드
웹 브라우저	Browser JavaScript
Android 앱	Android
iOS 앱	iOS
Flutter 앱	Flutter

클라이언트 SDK가 만든 device_id를 서버의 AI 호출에도 전달해야 같은 기기의 행동과 호출이 연결됩니다. 백그라운드 작업으로 AI를 호출한다면 작업 데이터에 이 값을 함께 저장해 전달하세요. 로그인 사용자 ID로 대체하거나 서버에서 새 기기 ID를 만들지 마세요.

측정할 행동은 이벤트 설계에 따라 등록하고 전송합니다. 그다음 성과 지표에서 기준을 정하고 비교에서 옵션별 결과를 확인하세요. 실제 사용자 행동 데이터가 쌓인 뒤 성과를 판단할 수 있습니다.