BLOG / stable-product-knowledge-vs-live-commerce-data.mdx
안정적인 상품 지식과 실시간 커머스 데이터: 권한 범위 나누기
오래 유지되는 사실, 과거 관측, 동적 오퍼, 개인화 조건, 구속력 있는 거래 상태를 명확히 구분합니다.
안전한 원칙은 간단합니다. 지속적이고 출처가 있는 상품 지식은 정적 문서에 두고, 시간·시장·사용자·거래에 따라 달라지는 값은 다시 확인합니다.
SKU.md는 판매자가 직접 호스팅하는 상품 탐색 및 안정적인 상품 지식 계층입니다. Agent가 상품을 찾고, 출처가 있는 사실을 이해하며, 실시간 상거래 정보를 어디에서 다시 확인해야 하는지 알도록 돕습니다. 새로운 Checkout 프로토콜이 아닙니다.
상품 정보를 다섯 부류로 나누기
| 부류 | 예시 | 올바른 소유자 |
|---|---|---|
| 안정적 사실 | 보고서로 확인한 소재 구성 | 검토된 SKU.md Fact와 근거 |
| 과거 관측 | 2026-09-01에 관측한 79 USD | 시각과 출처가 있는 offer_snapshot |
| 동적 오퍼 | 미국의 현재 가격과 재고 | 라이브 Catalog, 상점, 선언된 live_offer 조회 |
| 개인화 조건 | 회원 가격, 목적지별 배송비 | 인증된 라이브 시스템 |
| 구속력 있는 거래 상태 | 최종 세금, 결제 승인, 주문 확인 | Checkout과 주문 시스템 |
안정적이라는 말은 영원히 변하지 않는다는 뜻이 아닙니다. 게시자가 검토 절차, 출처, 수정 경로를 갖는다는 뜻입니다. 배합, 인증, 호환성, 관리법도 달라질 수 있으므로 verified_at으로 마지막 검토 시각을 보여 줍니다.
좋은 표현과 나쁜 표현
“겉감은 재생 나일론 100%”라고 쓰고 최신 기술 자료와 검토일을 연결하는 것은 Fact의 좋은 예입니다. 반면 “항상 재고 있음”은 Fact로 저장하면 안 됩니다.
“14:00 UTC에 이 URL에서 79 USD로 관측”은 범위를 한정한 offer_snapshot으로 기록할 수 있습니다. 시각, 시장, 출처 없이 “오늘 단 79 USD”라고 적으면 관측 조건을 잃게 됩니다.
live_offer는 선언된 라이브 출처를 가리키며 그 출처에 권한을 남겨 둡니다. 정적 문서가 호출 전부터 조회 응답을 보장한다고 주장해서는 안 됩니다.
실행 시 순환
- Product와 정확한 Variant를 맞춥니다.
- 검토된 Facts, Claims, Disclosures, Limitations를 읽습니다.
offer_snapshot은 과거 근거로만 취급합니다.- 현재 가격, 재고, 배송, 자격 조건을 조회합니다.
- Checkout이 세금, 결제, 구속 조건을 재검증하게 합니다.
- 완료 전 사용자 확인을 받습니다.
라이브 출처가 실패하면 알 수 없음으로 답하거나 인계를 요청합니다. 알리지 않고 오래된 수치로 대체하면 관측을 거짓 약속으로 바꾸게 됩니다.
게시자와 소비자를 위한 설계 규칙
게시자는 변동 필드를 분리하고 출처 URL과 날짜를 붙이며, 안전·법적 고지를 선택형 지식 파일에만 두지 않아야 합니다. 소비자는 식별자 일치를 강제하고 관측의 허용 기간을 제한하며 자유문 지침을 실행 명령으로 취급하지 않고, 답변 부분마다 어느 출처를 사용했는지 기록해야 합니다.
v0.10 사양은 offer_snapshot과 live_offer를 구분하고 둘을 동시에 사용하지 못하게 합니다. Schema 규칙은 도움이 되지만 실제 구매자를 지키는 것은 실행 시 출처 선택입니다.
더 읽기
첫 SKU.md 게시하기에서 이 구분을 구현하고 AI 커머스 권한 인계에서 라이브 작업을 검토하세요.