제품 찾기
이 스킬을 사용하여 "파란색 위젯"이나 스캔된 바코드를 구체적인 SKU.io 제품(해당 id, sku, 이름 및 세부 정보)으로 변환하세요. 그러면 다운스트림 스킬이 명확한 참조를 가질 수 있습니다.
올바른 조회 선택
| 입력 유형 | 호출 | 설명 |
|---|---|---|
| 정확한 SKU | GET /api/products/by-sku?sku=WIDGET-BLUE-01 | 직접적이며 단일 결과 반환 |
| 스캔된 바코드 (UPC/EAN/GTIN) | GET /api/products/barcode-lookup?code=0123456789012 | 바코드를 제품으로 변환 (파라미터는 code) |
| 부분 이름 또는 SKU | GET /api/products/search?query=blue widget | 퍼지 검색, 여러 결과 반환 가능 |
| 숫자 제품 ID | GET /api/products/{id} | ID를 이미 알고 있을 때 전체 레코드 조회 |
항상 가장 구체적인 조회를 사용하세요. 정확한 SKU나 바코드가 없는 경우에만 search를 사용하세요. 이 경우 여러 후보가 반환될 수 있으므로 명확히 구분해야 합니다.
단계
-
제공된 정보를 바탕으로 위 조회 방법 중 하나를 선택합니다.
-
Bearer 토큰(
products:read스코프 필요)과 함께 요청을 보냅니다:curl -sS "https://$SKU_TENANT.sku.io/api/products/by-sku?sku=WIDGET-BLUE-01" \ -H "Authorization: Bearer $SKU_PAT" -H "Accept: application/json" -
결과 처리:
- 정확히 하나의 일치 → 해당
id와sku를 캡처합니다. 완료입니다. - 검색 결과 여러 개 반환 → 정확한
sku를 일치시키거나, 상위 후보(이름 + sku)를 사용자에게 제시하여 선택하도록 합니다. 첫 번째 결과를 자동으로 선택하지 마십시오. - 일치하는 항목 없음 → 제품이 존재하지 않거나 보관 처리되었을 수 있습니다. ID를 임의로 생성하지 말고 그 사실을 보고합니다. 포기하기 전에 더 광범위한
search쿼리를 고려하세요.
- 정확히 하나의 일치 → 해당
참고 사항
search는 페이지네이션됩니다. 자세한 내용은shared/pagination.md를 참조하세요. 가장 적합한 결과는 첫 페이지에 있습니다. 조회 목적으로 페이지를 넘길 필요는 거의 없습니다.- 제품
id는 다른 스킬에서 기대하는 안정적인 키입니다(예: 판매 주문 라인의product_id). 매번 SKU로 다시 확인하는 것보다id를 다운스트림으로 전달하는 것이 좋습니다.
API 연산
| 메서드 | 경로 | 기능 |
|---|---|---|
GET | /api/products/search | 제품 이름 또는 SKU 조각으로 퍼지 검색 |
GET | /api/products/by-sku | 정확한 SKU로 단일 제품 조회 |
GET | /api/products/barcode-lookup | 스캔된 바코드(UPC/EAN/GTIN)를 제품으로 변환 |
GET | /api/products/{id} | 숫자 ID로 전체 제품 레코드 조회 |
인증
모든 요청은 SKU.io 개인 액세스 토큰을 Bearer 토큰으로 전송하여 인증합니다:
Authorization: Bearer <YOUR_SKU_PAT>
- 기본 URL:
https://{tenant}.sku.io({tenant}를 계정 서브도메인으로 바꾸세요) - 필요한 스코프:
products:read
SKU.io 웹 앱의 설정 → 개발자 → 개인 액세스 토큰에서 토큰을 생성하세요. 전체 흐름은 shared/authentication.md를 참조하세요.
이 스킬 개선하기
이 스킬이 부족한 점이 있었나요? 명확하지 않은 단계, 잘못된 엔드포인트, 또는 완료하지 못한 작업이 있다면 그냥 우회하지 말고, 문제점을 기록하고 풀 리퀘스트를 열어 다음 에이전트가 더 잘할 수 있도록 하세요.
- 저장소: https://github.com/skuio/sku-skills
- 정식 스킬은
skills/<domain>/<name>/아래에서 편집한 후(이 생성된 파일이 아닙니다),npm run build를 실행하고 PR을 여세요. 외부 기여자는 저장소를 포크한 후 PR을 보내주세요. - 전체 에이전트 워크플로는
AGENTS.md에 있습니다.
여러분의 에이전트가 이 모든 것을 처음부터 끝까지 할 수 있습니다. 누군가가 수정 사항을 보낼 때마다 라이브러리는 더 좋아집니다.