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

호스트 앱이 HTTPS로 AX Flow SaaS를 호출하는 형태. 운영 부담을 최소화한 빠른 PoC 경로이다.

5.1 배포 토폴로지

[Host App] ──HTTPS──▶ [AX Flow SaaS DC]
                                  ├ API GW
                                  ├ ORM RBAC
                                  ├ MCP / REST 엔드포인트
                                  ├ 그래프 저장소 (테넌트 파티션)
                                  ├ 벡터 저장소 (테넌트 네임스페이스)
                                  └ 사내 LLM 서빙 (옵션 외부 폴백)

테넌트 격리 — 그래프와 벡터 저장소는 사용자별 파티션·네임스페이스로 분리된다.

5.2 데이터 흐름

단계어디서 처리되나어디에 저장되나
인입 (업로드)AX Flow SaaS 인입 노드AX Flow 측 객체 스토리지 (테넌트 격리)
인입 (외부 드라이브 연동)AX Flow 커넥터가 호스트 사용자 동의 토글 후 풀링위와 동일
임베딩로컬 추론 (외부 API 호출 없음)벡터 저장소
그래프 추출자체 그래프 빌더그래프 저장소
LLM 호출사내 LLM 우선, 외부 폴백은 사용자 동의 시에만
응답 합성ORM RBAC 통과 노드만 컨텍스트에 진입

5.3 운영 책임 분담 (개요)

영역AX Flow도입사
인프라 운영
모델·임베딩 운영
인증 토큰 발급/회전(호스트 측 사용자 매핑)
모니터링 (서비스 단)
모니터링 (호스트 측 호출 단)
장애 대응 (1차)
장애 대응 (호스트 통합 단)

5.4 SLA

가용성·평균 응답 시간(Smart/Deep)·RPO·RTO 등 운영 SLA는 별도 협의로 확정한다.

5.5 데이터 거버넌스

  • 노드 단위 4단계 공개 범위 — public / team / private / device-only
  • 외부 LLM 폴백은 옵트인 — 테넌트 토글이 켜진 경우에만 동작
  • 감사 로그 — 답변·검색·노드 접근 이력 보존

5.6 종료/철수 절차

  • 데이터 전수 반환 — 그래프 dump, 벡터 dump, 객체 스토리지 export
  • 폐기 증빙 — 폐기 인증서 발급
  • 키·토큰 만료 — 종료 일시 기준 즉시 무효