임베드된 에이전트가 실제로 무엇을 하는지 확인하세요
지난 10년간 프로덕트 애널리틱스는 사람들이 무엇을 탭했는지, 어떤 경로를 택했는지, 어디서 이탈했는지에 대해서 집중했씁니다.
그러나 이제 AI 에이전트가 툴을 호출하고, 경로를 따라가고, 토큰을 소비하며, 행동에 실패하기도 합니다. 이 모든 일이 앱 안에서 일어나지만, 사용자 행동 분석은 이를 전혀 보지 못합니다. 이 과정이 안개 속에 있으면 에이전트가 제대로 일하고 있는지, 비용이 어디서 발생하는지, 어떤 단계를 고쳐야 하는지 알 수 없습니다.
Agentic SDK가 캡처하는 것
Agentic SDK는 임베드되거나 기기 위에서 실행되는 에이전트가 남기는 런타임 기록을 읽습니다. 호출 트레이스, 타이밍, 그리고 각 단계의 성공 여부가 여기에 포함됩니다.
에이전트 작업에서 중요한 순간들을 모두 포괄합니다:
- 에이전트 등록 및 시작
- 스킬 실행 (스킬은 에이전트가 수행하는 작업의 단위)
- 툴 호출 (MCP 툴과 로컬 툴 모두)
- 에이전트 간(A2A) 조율 (한 에이전트가 다른 에이전트에게 작업을 넘길 때)
- 임베드된 UI 내의 세션
AI 에이전트가 행할 수 있는 수많은 행동을을 포착할 수 있습니다.
동작 방식: 하나의 작업, 하나의 트레이스
하나의 에이전트 작업은 몇 가지 레이어를 거칩니다. Intent가 사용자의 언어를 받아 파라미터를 추출합니다. 스킬이 실제 작업을 실행합니다. 그 과정에서 툴이 호출됩니다.
Agentic SDK는 이 모든 것을 하나의 trace_id로 묶습니다. 같은 작업의 모든 호출이 이 ID에 연결되어, 흩어진 로그 줄 대신 실제 계층 구조를 가진 호출 체인을 얻을 수 있습니다. 각 단계는 자동으로 쌍을 이루어 자체적인 타이밍과 성공·실패 여부를 담은 완전한 이벤트로 기록됩니다.
결과는 단순합니다. 흩어진 로그를 손으로 이어 붙일 필요가 없습니다. 하나의 체인을 따라가며 처음부터 끝까지 전체 작업을 확인할 수 있습니다.
에이전트 행동과 사용자 행동의 만남
동일한 SDK가 두 가지를 모두 담습니다. 사용자 측 행동과 에이전트 측 런타임이 같은 세션에 정렬됩니다.
하나의 세션을 따라 내러티브가 이어집니다. 사용자가 무언가를 요청하면 에이전트가 스킬을 실행하고, 경로를 택하고, 비용을 씁니다. 작업이 완료되거나 그렇지 않고, 사용자는 남거나 떠납니다. 사용자 측과 에이전트 측이 동일한 분석 퍼널에 담깁니다.
왜 중요한가요?: 두 부분을 연결하기 위해 별도의 이벤트를 추가하지 않아도, 실행 가능한 리텐션·퍼널·비용에 대한 정보를 얻을 수 있습니다.
프로덕션을 위한 설계: 가볍고, 기본적으로 프라이빗
Agentic SDK는 코드를 전면 재작성하지 않고도 실제 앱에 들어갈 수 있도록 설계되었습니다.
- 가벼운 통합: 프레임워크가 이미 노출하는 인터페이스 경계를 감싸는 방식으로, 프레임워크 자체를 변경하지 않습니다. 모듈 하나를 추가하는 것은 작은 변경입니다. 빠른 확인부터 프로덕션 배포까지 세 가지 연결 방식이 있으며, 가장 가벼운 방식은 코드가 거의 필요 없습니다.
- 기본적으로 프라이빗: 사용자의 원시 대화 내용을 보고하지 않습니다. 어떤 툴이 실행됐는지, 얼마나 걸렸는지, 성공했는지 등 구조화된 런타임 사실만 기록합니다. 민감한 필드는 자동으로 마스킹되고, 지나치게 긴 값은 잘리며, 사용자는 수집을 거부할 수 있습니다.
- 격리와 자가 복구: 수집 레이어는 에이전트 자체 작업과 분리되어 있습니다. 수집에 문제가 생기면 스스로 물러나고 에이전트는 계속 실행됩니다.
- 완전 자체 호스팅: 전체 경로를 자체 배포 환경 안에서 실행할 수 있어 데이터가 내부를 벗어나지 않습니다.
활용 방법
- 장애 재현: 에이전트가 잘못됐을 때 전체 경로를 재생할 수 있습니다. 어떤 단계가 틀어졌는지, 어떤 툴을 호출했는지, 각각의 입력·결과·타이밍·상태가 모두 기록되어 있습니다. 로그를 헤집을 필요가 없습니다.
- 비용 귀속: 세션·작업·시나리오별로 얼마가 어디에 쓰였는지 확인해, 어떤 기능과 어떤 사용자가 비용을 높이는지 파악할 수 있습니다.
- 전체 퍼널 추적: 사용자가 요청한 순간부터 에이전트가 결과를 전달하는 순간까지 추적하고, 어디서 이탈하는지 얼마나 남는지를 처음부터 끝까지 볼 수 있습니다.
- 운영으로 확장(선택, 예정): 동일한 기반이 A/B 실험 및 클라이언트 측 트리거 전략과 연결될 수 있어, 발견한 문제를 롤아웃 전에 검증할 수 있습니다.
오픈 출력과 시작하기
데이터는 출구를 가집니다. 자체 백엔드, Webhook, OpenTelemetry로 보내거나 Agentic Engine으로 라우팅할 수 있습니다. 퍼블릭 클라우드와 자체 호스팅 모두 지원합니다.
시작할 때는 가장 가벼운 통합 방식으로 단일 모듈에서 먼저 확인해 보세요. 이 경로는 코드가 거의 필요 없어 범위를 넓히기 전에 트레이스가 올바르게 보이는지 확인할 수 있습니다. 확인이 되면 프로덕션에 배포하세요. 클라우드 또는 완전 자체 호스팅, 여러분의 환경에 맞는 방식으로 배포하면 됩니다.
Share