피드로 돌아가기
GeekNewsBackend
원문 읽기
Show GN: 토스증권 Open API용 Agent Skill
LLM Agent를 위한 토스증권 Open API 인터페이스 및 CLI 스킬셋 구축
AI 요약
Context
Codex, Claude Code 등 AI Agent가 토스증권 Open API를 직접 제어하기 위한 표준 인터페이스 부재. API 문서와 스키마를 LLM이 효율적으로 해석하고 실행할 수 있는 구조적 가이드라인 필요.
Technical Solution
- OpenAPI 스키마 및 작업 흐름을 Agent Skill 형태로 패키징하여 LLM의 Context Window 최적화
- TOSS_API_KEY 및 TOSS_SECRET_KEY 기반의 OAuth 토큰 인증 프로세스 자동화
- 엔드포인트 탐색 및 데이터 조회를 위한 Python 기반의 전용 CLI 도구 구현
- 주문 생성/정정/취소 기능에 dry-run 기본값 설정 및 --execute 플래그 도입을 통한 Safe-guard 설계
- 주문 추적 및 멱등성 보장을 위한 clientOrderId 필수 요구 구조 적용
실천 포인트
1. LLM Agent 대상 도구 설계 시 단순 API 제공을 넘어 스키마 기반의 Skill Set 정의 검토
2. 상태 변경 API(CUD) 설계 시 dry-run 모드를 기본값으로 설정하여 예기치 못한 실행 방지
3. 분산 환경의 주문 처리 시 clientOrderId를 통한 Idempotency 확보 여부 확인