> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lynxops.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Lynx SDK

> TypeScript 애플리케이션에서 AI 에이전트의 행동, 도구 호출, 가드레일, 실행 결과를 추적합니다.

Lynx SDK는 AI 에이전트가 왜 그런 판단을 했는지 나중에 다시 따라갈 수 있게 도와줍니다. 실행 컨텍스트, LLM 호출, 도구 사용, 정책 판단, 메모리 접근, 최종 결과를 수집해 Lynx 서버로 보냅니다.

단순히 로그를 더 남기기 위한 도구가 아닙니다. 운영 중인 AI 서비스에서 문제를 빠르게 찾고, 원인을 설명하고, 다시 재현할 수 있도록 만드는 관측 도구입니다.

<CardGroup cols={2}>
  <Card title="몇 분 안에 시작하기" icon="rocket" href="sdk/quickstart">
    SDK를 설치하고 tracer를 만든 뒤 첫 번째 에이전트 실행을 기록합니다.
  </Card>

  <Card title="운영 환경에 맞춘 전송" icon="shield-check" href="sdk/delivery">
    백그라운드 전송, 타임아웃, 재시도, 서킷 브레이커로 서비스 흐름을 보호합니다.
  </Card>

  <Card title="로컬 가드레일" icon="lock" href="sdk/guardrails">
    Lynx 서버 상태와 관계없이 위험한 도구 호출을 로컬에서 차단합니다.
  </Card>

  <Card title="LLM과 도구 계측" icon="sparkles" href="sdk/instrumentation">
    LLM 클라이언트와 도구 함수를 span 단위 수집 데이터로 감쌉니다.
  </Card>
</CardGroup>

## Lynx가 수집하는 정보

* 에이전트 실행, 세션, 워크스페이스 메타데이터
* 사용자 입력과 구조화된 컨텍스트
* 에이전트의 판단과 그 이유
* LLM 호출, 모델 메타데이터, 지연 시간, 토큰 사용량, 오류
* 도구 호출, 도구 결과, 부작용 여부, 위험도 메타데이터
* 로컬 정책 평가와 가드레일 동작
* 메모리 접근과 세션 결과

## Lynx 서버가 내려가면 어떻게 되나요?

기본 설정에서는 AI 서비스가 계속 실행됩니다. SDK는 수집 데이터를 메모리 큐에 잠시 보관하고, 전송에 실패하면 다시 시도합니다. 실패가 반복되면 서킷 브레이커를 열어 일정 시간 동안 전송 시도를 멈춥니다. 가드레일 판단은 계속 로컬에서 이루어집니다.

<Tip>
  Lynx가 수집하는 데이터는 애플리케이션 실행을 관찰하기 위한 것입니다. 기본적으로 사용자 요청을 막지 않습니다. 반드시 전송 결과를 기다려야 하는 환경에서는 blocking flush를 명시적으로 켤 수 있습니다.
</Tip>