[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 기술따라가기
댓글
댓글 쓰기