Lab 0-2 — 에이전트 참조자료 추가
▶ 목표: SharePoint에 올라온, 에이전트가 참조할 지식(엑셀·문서) 을 Knowledge로 연결하고, 엑셀 데이터가 실제로 어떻게 처리되는지 확인한다. (M2-3)
1. 두 종류의 참조자료
| 종류 | 성격 | 에이전트가 쓰는 법 |
|---|---|---|
| 데이터 파일(엑셀·CSV) | 숫자 — 집계해야 답이 나옴 | 코드로 계산해 정확한 값 |
| 문서(Word·PDF) | 형식·톤·규정 — 참고용 | 말투·규칙을 인용(출처 명시) |
규칙: 숫자는 항상 데이터 파일에서, 말투·형식은 문서에서. 둘을 섞지 않습니다. 이 실습은 휴가·근태 현황 엑셀(숫자)과 휴가·근태 규정 Word(형식) 둘 다 연결합니다.
2. SharePoint 특정 폴더를 Knowledge로 연결
이 실습은 사이트 전체가 아니라 자료가 모인 특정 폴더 하나를 지정합니다. 그 폴더 안에는 두 종류의 파일이 있습니다:
| 파일 | 형식 | 역할 |
|---|---|---|
| 휴가·근태 현황 더미 데이터 | Excel | 잔여연차일수·연차사용률·월평균초과근무시간·입사연차 등 숫자 — 집계·분석 대상 |
| 내부 규정 문서 | Word | 연차 사용 촉진·경조휴가 가이드 등 규정·형식 — 주의사항 참조용 |
📥 실습 데이터 준비 — 아래 두 파일을 준비해 본인 SharePoint 폴더에 올린 뒤 연결하세요(직접 만들어도 됨).
📦 공개 과정용 실습 파일 패키지는 준비 중입니다. 본문에 포함된 복붙 자료만으로도 전 실습을 진행할 수 있습니다.
휴가·근태 현황 더미데이터.xlsx— 임직원 1,000행 분석 더미 데이터(잔여 연차·사용률·초과근무·부서·직급 등)휴가·근태 규정 안내.docx— 연차 사용 촉진·휴가 종류 내부 규정 문서(더미, 문서번호 HR-LEAVE-POL-2026-03)
- Build 화면 우측 컴포넌트 패널에서 Knowledge → Add knowledge → SharePoint 선택. (Add knowledge 대화 상자에서는 파일 드래그 앤 드롭 업로드도 되지만, 이 실습은 SharePoint 연결을 씁니다. 인증 필요.)
Knowledge → Add knowledge에서 SharePoint 선택
- SharePoint 다이얼로그에서 Browse items로 사이트 라이브러리를 엽니다(또는 URL 직접 입력).
SharePoint 다이얼로그에서 Browse items로 라이브러리 열기
- 자료가 모인 특정 폴더(엑셀·Word가 든 폴더)를 선택하고 Confirm selection.
사이트 라이브러리에서 자료 폴더 선택 후 Confirm selection
- 선택한 폴더를 확인하고 Add to agent로 연결을 저장합니다. 권한 동의(로그인) 후, 연결된 Knowledge 목록에 폴더가 보이면 완료.
선택 폴더 확인 후 Add to agent로 연결 저장
짚고 가기: 엑셀·Word는 원본 파일째 SharePoint에 두고 폴더만 연결합니다. 파일을 일일이 업로드하지 않아도, 에이전트가 필요할 때 해당 폴더에서 찾아 내려받아 처리합니다(권한은 원본 그대로 상속). 원본 문서를 갱신하면 자동 반영되며, 폴더 위치·연결 설정이 바뀔 때만 Knowledge 탭에서 수동 업데이트합니다. 규정 문서(Word)는 6장 프롬프트 #3(연차 사용 촉진 주의사항)에서 실제로 활용됩니다.
3. 동작 원리 — 엑셀은 “검색”이 아니라 “코드”로 처리
연결만 하면 끝이 아니라, 신규 코어가 엑셀을 어떻게 다루는지를 알아야 결과를 신뢰할 수 있습니다(M2-3).
클래식(RAG): "부서별 평균 연차 사용률?" → 청크 검색 → 관련 텍스트 조각 → 근사치 ❌
New CLI: "부서별 평균 연차 사용률?" → 원본 엑셀을 코드로 전체 집계 → 정확값 ✅
- 엑셀(바이너리)은 검색 스니펫이 비어 파일 경로만 옵니다 → 정상입니다. 에이전트가 다운로드해 Python으로 전체 행을 집계합니다.
- “수천 행을 다 읽으면 토큰이 터지지 않나?” → 안 터집니다. 파일을 컨텍스트에 붓는 게 아니라 코드로 처리하고 요약만 보기 때문입니다.
- 메이커가 할 일은 지침에 “눈대중 말고 실제로 계산“이라고 적는 것뿐(1장에서 이미 작성). 나머지(선택 로드·집계·요약)는 에이전트가 알아서.
동작 확인(Preview 탭에서 한 줄 질문):
연결된 SharePoint에서 휴가·근태 현황 엑셀을 찾아서, 부서별 평균 연차 사용률을 정확히 계산해줘.
→ 에이전트가 ① 파일을 검색·다운로드하고 ② “무엇을 계산할지” 한 줄 안내 후 ③ 코드로 집계한 정확한 표를 돌려주면 연결·처리가 정상입니다.
엑셀 검색 → 코드 집계 결과(정확한 표) 확인
짚고 가기: 컬럼 의미가 헷갈릴 수 있으면(예:
연차사용률(%),월평균초과근무시간) “열 설명” 같은 보조 문서를 스킬에 동봉하면 품질이 올라갑니다(없어도 동작). 본격적인 분석·요약 형식은 3장(단일 스킬)·4장(스킬 패키지)에서 정교화합니다.
← 1. 생성·지침 · 다음: 3. 단일 스킬 작성
출처: Add knowledge to an agent — Microsoft Learn · Knowledge overview for agents — Microsoft Learn · 3부 · 참조자료 추가 — Microsoft Copilot Agentic Blog