[컨텍스트 엔지니어링] 5주차 Day 2 — ★ 응답을 그대로 넣지 않는다

주차 주제: 도구가 돌려주는 것 | 제조 사례: 한 겹을 두고 1/12 이 된 자리

오늘의 목표: 도구와 창 사이에 다듬는 겹을 두고, 무엇을 남길지 정한다.

소요 시간: 30분

---

1. 한 문장으로

시스템이 준 모양과
모델이 읽을 모양은 다릅니다.               ★

---

2. 한 겹을 둡니다

  시스템  →  다듬기  →  창                 ★

다듬기가 하는 일

① 건수를 자릅니다                          ★
② 속성을 고릅니다                          ★
③ 모양을 바꿉니다 (JSON → 표·문장)         ★
④ 이름표를 붙입니다 (2주차 Day 4)          ★
⑤ 없음·더있음을 분명히 합니다              ★

다섯입니다.                                  ★

---

3. ② 속성 고르기 — 가장 큽니다

  원본  품번·품명·규격·재질·단위·수량·        ★
        단가·금액·납기·창고·상태·등록일·
        수정일·등록자·비고                   ★

질문이 "재고" 인데 15개를 다 줍니다.      ★

고르면

  품번 · 품명 · 재고 · 단위                  ★

· 토큰 1/4                               ★
· 그리고 헷갈릴 것이 줄어듭니다           ★

「어느 속성을 줄까」 는 도구마다 정해 두세요. ★

---

4. ★ ③ 모양을 바꾸기

JSON 이 토큰을 많이 먹습니다.             ★

  {"품번":"A001","품명":"브라켓","재고":120}  ★

같은 내용을 표로

  품번    품명     재고                       ★
  A001    브라켓    120                       ★

· 따옴표·중괄호·콜론이 전부 토큰입니다    ★
· 40건이면 차이가 큽니다                    ★

그리고 읽기도 낫습니다.                   ★

다만 — 모델이 돌려줄 때는 JSON 이 낫습니다. ★

  들어갈 때  표                              ★
  나올 때    JSON (검증되니까)               ★

---

5. ⑤ 없음을 분명히

빈 결과를 어떻게 주나                        ★

나쁜 것

  []                                        ★
  null
  (아무것도 안 줌)                          ★

좋은 것

  {                                         ★
    "결과": [],
    "안내": "'브라켓 A형' 으로 찾은 품목이    ★
             없습니다. 검색어를 바꾸거나
             품번을 확인하세요."             ★
  }

왜

  · 빈 배열만 주면 지어냅니다             ★
  · 말로 써 주면 그대로 전합니다          ★

---

6. 오류도 마찬가지

나쁜 것

  스택 트레이스 전문 (2,000 토큰)            ★

좋은 것

  {                                         ★
    "오류": "품목 조회 실패",
    "이유": "품번 형식이 맞지 않습니다",      ★
    "할것": "품번을 확인하고 다시 부르세요",  ★
    "재시도": true                           ★
  }

· 짧습니다                                  ★
· 모델이 무엇을 할지 압니다               ★
· 그리고 지어내지 않습니다                ★

내일 Day 3 이 이것을 자세히 다룹니다.        ★

---

7. 제조 현장의 실제

어느 업체, 기존 API 를 그대로 도구로 냈습니다.

· 화면용 API 였습니다                       ★
· 한 건에 속성 34개                      ★
· 메타데이터·링크·null 필드 포함             ★

  20건 조회 = 9,800 토큰                  ★

다듬는 겹을 뒀습니다

  ① 건수 상한 20                            ★
  ② 속성 34 → 5개                        ★
  ③ JSON → 표                               ★
  ④ 이름표 (출처·시각)                      ★
  ⑤ 없음·더있음 문구                        ★

  9,800 → 820 토큰                        ★

그리고 정확도가 올랐습니다.                  ★

왜

  · 안 쓰는 속성이 헷갈리게 하고 있었습니다  ★
    (등록일을 납기로 읽는 등)               ★

---

8. ★ 「기존 API 를 그대로」 가 함정입니다

· 빠릅니다 (만들 게 없습니다)               ★
· 그래서 그렇게 합니다

그런데 그 API 는

  사람이 볼 화면을 위해 만든 것입니다.     ★

· 화면은 필요한 것만 골라 보여 줍니다      ★
· 모델은 전부 읽습니다                   ★

그래서 모델용으로 다듬어야 합니다.       ★

MCP 과정 2주차 Day 4 — 「적게 돌려준다」.

---

9. 다듬는 겹을 어디에 두나

㉮ 도구 안에                                ★
   도구가 이미 다듬어서 돌려줍니다
   → 가장 깔끔합니다                       ★

㉯ 도구와 창 사이                           ★
   도구는 그대로 두고 받아서 다듬습니다
   → 도구를 못 고칠 때                     ★

㉮ 가 낫습니다.                              ★

㉯ 는 같은 다듬기를 여러 곳에서 하게       ★
됩니다.

---

10. 오늘 해 볼 것 (15분)

① 도구 응답 하나를 꺼내 보세요

  도구  ____________                         ★
  속성 수  ___개  /  쓰는 것  ___개          ★

② 다섯을 점검하세요

  □ 건수 상한  □ 속성 고름                   ★
  □ 표로 바꿈  □ 이름표                      ★
  □ 없음·더있음 문구                         ★

③ 하나를 다듬어 보세요

  전 ______ 토큰 → 후 ______ 토큰            ★
  → 20건 돌려 정확도 비교                    ★

---

11. 내일 할 것

실패한 도구 호출을 어떻게 남길까.

성공한 것보다 실패한 것이 창을 더 더럽힙니다.

---

이 글은 컨텍스트 엔지니어링 과정의 5주차 2일차입니다. 과정 전체 보기

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