AX Flow SDK 명세서 v2.0 · 통합 파트너 검토용 — 정식 스키마는 /docs Swagger UI를 단일 기준으로 사용합니다.
Data I/O
실제 동작 예시

도입사 데모 문서 (유산균 발효 시스템 매뉴얼) 와 동일 도메인의 자체 평가에서 측정된 실제 hybrid mode 응답 1건이다 (식별 정보 제거 후 인용). 다중 출처 합성·풍부한 답변·기준치 부합 지연 3가지를 동시에 보여준다.

13.1 질의

"유산균 발효 시스템에서 pH 센서 보정(Calibration) 시 사용되는 두 가지 버퍼 솔루션의 pH 수치와 보관 시 주의사항은 무엇입니까?"

13.2 호출

result = client.call_tool("retriever",
    query="유산균 발효 시스템에서 pH 센서 보정 시 사용되는 두 가지 버퍼 솔루션의 pH 수치와 보관 시 주의사항은?",
    mode="deep",
    top_k=10,
)

13.3 응답 (실측)

13.3.1 필드 요약

필드의미본 응답 값
content답변 본문 (마크다운)pH 보정 절차 + 보관 주의사항 + Slope/Offset 참고 (13.3.3 펼침)
metadata.references[]참조 문서 목록매뉴얼 + SOP 두 출처 (13.3.2)
score[]청크 재정렬 점수 (mode="deep" 호출 시만 채움)[0.94, 0.87, 0.83, 0.78, 0.74] — 5건
latency검색 단계 지연 (초)3.078 (Deep 기준치 ~3.2s 부근)

13.3.2 metadata.references[] 상세

reference_idfile_pathpage
1유산균 발효 시스템 운용 매뉴얼.pdf14
2[SOP] 유산균 발효 시스템.pdf9

호스트 UI는 본 표를 답변 옆 근거 카드 (파일명 + 페이지) 로 렌더링하고, 카드 탭 시 원문 페이지로 딥링크 점프 가능.

13.3.3 content 본문 (펼침)

pH 센서 2점 보정에 사용되는 두 가지 버퍼의 pH 값과 보관 주의사항은 다음과 같습니다.
- 사용 버퍼 pH 값:
  - pH 7.00 (Set Point 1)
  - pH 4.00 (Set Point 2)
- 보관 시 주의사항:
  - 보정액(pH 4.0, pH 7)은 다른 용액과 섞이지 않게 별도 보관해야 합니다.
  - (프로브 관련) 센서는 보관액에 넣어 프로브를 보호하도록 보관합니다.
참고: 보정 후 컨트롤러에 표시되는 Slope는 95%–105% (0.95–1.05) 범위, Offset은 ±0.3 pH(또는 ±30 mV) 이내여야 합니다.

13.3.4 원본 JSON 페이로드

{
  "content": "pH 센서 2점 보정에 사용되는 두 가지 버퍼의 pH 값과 보관 주의사항은 다음과 같습니다.\n\n- 사용 버퍼...",
  "metadata": {
    "references": [
      { "reference_id": "1", "file_path": "유산균 발효 시스템 운용 매뉴얼.pdf", "page": 14 },
      { "reference_id": "2", "file_path": "[SOP] 유산균 발효 시스템.pdf", "page": 9 }
    ]
  },
  "score": [0.94, 0.87, 0.83, 0.78, 0.74],
  "latency": 3.078
}

13.4 이 예시가 보여주는 자산

자산본 응답에서 확인 가능한 부분
다중 출처 합성 (Triple-GraphRAG 앙상블)매뉴얼 + SOP 두 문서를 동시 참조 (metadata.references[] 두 건)
expected 보다 풍부한 답변골든셋 정답(pH 4.0/7.0 + 분리 보관) 대비 답변에 Slope 95~105% / Offset ±0.3 정보까지 포함
Deep mode 기준치 부합latency 3.078초 — Deep 기준치 3.2초와 거의 일치
청크별 재정렬 점수score[] 5건 채워짐 — mode="deep" 호출 시만 채움 (6.2 동일)
출처 페이지 좌표 보존references[].page 두 출처 모두 채워짐 (매뉴얼 14쪽 / SOP 9쪽) — 호스트 UI가 원문 페이지로 딥링크 점프 가능

통합 파트너 PoC 진입 시 — 도입사 측 골든셋·환경으로 동일 패턴 재측정 가능.