[MCP] 1주차 Day 3 — ★ 마스터를 창에 넣지 말고 조회하게 한다

주차 주제: 무엇을 도구로 낼 것인가 | 제조 사례: 9만 토큰이 도구 하나로

오늘의 목표: 가장 먼저 도구로 내릴 것을 정하고, 검색이 맞게 만든다.

소요 시간: 30분


1. 가장 먼저 만들 도구

마스터 조회입니다.                         ★
· 품목 · 거래처 · 설비 · 계정과목            ★
이유는 컨텍스트 과정 3주차 Day 4 와 같습니다. ★
· 큽니다                                    ★
· 매일 바뀝니다
· 비슷한 게 많아 헷갈립니다                 ★
· 쓰는 건 한두 건입니다                   ★

2. 어떤 모양으로

  품목검색(키워드, 옵션)                     ★
인자
  키워드   이름·품번·규격 아무거나           ★
  종류     제품/반제품/자재  (선택)          ★
  상태     사용중만  (기본값)                ★
  상한     20                                ★
「상태」 의 기본값이 중요합니다.              ★
· 사용중지된 것이 섞이면 헷갈립니다        ★
· 기본으로 빼세요                        ★
  (기준정보 과정 11주차 Day 4)             ★

3. ★ 검색이 맞아야 합니다

도구로 내리면 못 찾는 일이 생깁니다.      ★
그래서 검색부터 고치세요.                    ★
□ 순서 무시                                ★
   "M8 볼트" = "볼트 M8"
□ 부분 일치                                ★
□ 정규화                                   ★
   공백·기호·대소문자·전각
□ 동의어                                   ★
   (온톨로지 5주차 결과를 그대로)
□ 품번·이름·규격 어디로든                  ★
다섯입니다.                                  ★
그리고 이게 기준정보 과정 10주차 Day 3    ★
의 중복 검사와 같은 기능입니다.           ★
한 번 만들면 둘 다 좋아집니다.               ★

4. 못 찾음을 세세요

컨텍스트 과정 3주차 Day 4 에서 본 것.        ★
  못 찾음 비율  ___%                         ★
· 처음엔 10~20% 가 보통입니다               ★
· 3% 아래로 내리는 게 목표입니다           ★
그리고 못 찾은 것을 모아 보세요.          ★
  못 찾은 검색어  ____________               ★
  실제로는 있었나  ○/✗                       ★
「있었는데 못 찾음」 이 고칠 목록입니다.   ★

5. 돌려줄 것 — 적게

  품번 · 품명 · 규격 · 단위 · 상태           ★
다섯이면 대개 됩니다.                        ★
그리고 더 필요하면 따로 부르게 하세요.    ★
  품목상세(품번)                             ★
· 검색은 고르기 위한 것입니다             ★
· 고른 뒤에 상세를 봅니다                 ★
검색에 전부 돌려주면
20건 × 34속성이 됩니다.                   ★

6. 여러 개를 한 번에

컨텍스트 과정 5주차 Day 4 에서 본 것.        ★
  품목상세(품번[])                           ★
· 하나씩 10번 → 한 번                    ★
· 응답 토큰도 줄어듭니다 (머리가 한 번)    ★
그리고 이건 설계할 때 정해야 합니다.      ★
나중에 바꾸면
부르던 쪽을 다 고쳐야 합니다.             ★

7. 제조 현장의 실제

어느 업체, 품목 마스터를 창에 넣고 있었습니다.
  4,200건 × 12속성 = 약 9만 토큰          ★
도구로 내렸습니다
  품목검색(키워드, 상한 20) → 5속성          ★
  품목상세(품번[])                           ★
  창에서  9만 → 0                          ★
  도구 설명  180 토큰                      ★
그런데 첫 달 못 찾음이 14% 였습니다.      ★
못 찾은 검색어를 보니
  · 규격 표기 차이   "M8" / "M-8" / "m8"    ★
  · 순서 차이       "볼트 M8"               ★
  · 현장 용어       "가다"                  ★
  · 오타                                    ★
고친 뒤
  못 찾음  14% → 3%                       ★
그리고 뜻밖에
  기준정보팀이 그 목록을 가져갔습니다.      ★
    "못 찾는 검색어" = 정리 대상            ★

8. ★ 「못 찾은 검색어」 가 자산입니다

· 어떤 말로 찾는지 알려 줍니다              ★
· 마스터에 없는 표기를 알려 줍니다          ★
· 동의어로 넣을 것을 알려 줍니다            ★
그래서 꼭 남기세요.                       ★
  못 찾은 검색어 · 시각 · 누가              ★
그리고 주마다 보세요.                     ★
· 반복되는 것은 동의어로                  ★
· 마스터에 없으면 기준정보로              ★

9. 마스터 말고 또

같은 이유로 도구로 내릴 것
□ 실적·재고       매일 바뀝니다            ★
□ 진행 상태       지금 값이어야 합니다      ★
□ 긴 문서         필요한 절만              ★
□ 과거 이력       가끔 봅니다              ★
□ 정의된 질의     집계 (온톨로지 10주차)   ★
마지막이 중요합니다.                         ★
· 모델에게 SQL 을 짜게 하지 말고            ★
· 정의된 질의를 도구로 내세요             ★
    "라인별불량률(기간, 작업장)"            ★

10. 오늘 해 볼 것 (15분)

① 창에 있는 마스터를 찾으세요

  무엇  ____________  토큰 ______            ★
  건수  ____건 / 쓰는 건 ___건               ★
② 검색 다섯을 점검하세요

  □ 순서 무시  □ 부분 일치  □ 정규화         ★
  □ 동의어    □ 어느 칸으로든                ★
③ 못 찾음을 남기게 하세요

  □ 검색어를 로그에 남기나                   ★
  □ 결과 0건을 표시하나                      ★

11. 내일 할 것

이미 있는 API 를 그대로 내면 생기는 일.

빨라서 그렇게 하는데 가장 흔한 실패입니다.


이 글은 MCP 과정의 1주차 3일차입니다. 과정 전체 보기

진도와 검색이 되는 판: AXPulse 기술따라가기

댓글

이 블로그의 인기 게시물

자재관리는 잘 쓰는데 BOM은 엑셀입니다

협력사 AI 로봇 도입, 공급망 스마트 제조 생태계 대응 전략

개발 테스트 자동화, AI 에이전트와 MCP 도입 전략