AX Flow SDK 명세서 v2.0 · 통합 파트너 검토용 — 정식 스키마는 /docs Swagger UI를 단일 기준으로 사용합니다.
Concepts
4개 통합 모드

1.1 모드 비교 매트릭스

항목(A) MCP 서브에이전트 ★(B) REST API(C) Python SDK(D) SaaS 사이드카
우선순위1순위2순위2순위3순위
통합 패턴호스트 LLM/에이전트 ↔ AX Flow MCP 서버호스트 백엔드 → API GW (MCP 도구를 RESTful 노출)호스트 인프라 내 패키지 임베드호스트 앱 → AX Flow SaaS
데이터 위치도입사 사내 / 온프레 가능호스트 백엔드 측호스트 인프라 내 (폐쇄)AX Flow SaaS DC
외부 호출옵션 (옵트인 폴백)옵션 (옵트인 폴백)0 (사내 폐쇄)사용자 동의 시
인증OAuth 2.0 Client Credentials Grant동 (3.3)SDK 내부 OAuth 래핑동 + 도메인 등록
운영 책임양 측 분담도입사도입사AX Flow
통합 공수착수 단계에서 산정착수 단계에서 산정착수 단계에서 산정착수 단계에서 산정
대표 사례동일 패턴으로 산업단지 SOP 통합 운영 중

1.2 모드 선택 기준

  • 보안 등급 — 데이터가 호스트 인프라 밖으로 나갈 수 있는가? 밖으로 나갈 수 없다 → (A·온프레) 또는 (C). 옵트인 가능 → (A) 또는 (B). 클라우드 허용 → (D).
  • 통합 깊이 — 호스트 앱과 어디까지 통합하는가? 호스트 에이전트가 결과 활용 → (A). 호스트 백엔드가 직접 호출 → (B). 호스트 인프라 내 임베드 → (C). 사이드 화면/별도 통신 → (D).
  • PoC 일정 — 첫 가시적 결과까지의 시간. 가장 빠른 1차 검증은 (D) → 호스트 통합 (A)·(C) → 백엔드 통합 (B) 순서.

1.3 의사결정 트리

호스트 인프라 안에서만 처리해야 하는가?
├─ 예
│   ├─ 호스트 LLM/에이전트와 결합 → (A) MCP 서브에이전트 (온프레)
│   └─ 호스트 인프라 내 임베드  → (C) Python SDK
└─ 아니오
    ├─ 즉시 PoC                  → (D) SaaS 사이드카
    ├─ 호스트 앱과 깊은 통합    → (A) MCP 서브에이전트
    └─ 다양한 백엔드와 통합     → (B) REST API