빌드 3 — 도구(Tools) · 참고자료(Knowledge)
한 줄 요약 — 도구는 에이전트의 손발(실제 외부 행동), 참고자료는 읽는 지식입니다. 도구는 목적당 하나, 막힐 때 추가가 원칙이고, 참고자료는 RAG 조각이 아니라 원본 파일을 코드로 처리하는 것이 New의 핵심 변화입니다.
1. 도구 — 개념
도구가 없으면 에이전트는 “생각만 하는 머리”입니다. 메일 발송·파일 업로드·데이터 조회 같은 실제 외부 실행은 전부 도구를 통합니다 (1부의 관찰·판단 루프와 대비되는 “행동” 축).
보충 (MS Learn) — 오케스트레이터가 대화 컨텍스트와 도구 이름·설명을 보고 어떤 도구를 쓸지 결정합니다(명시적 트리거·토픽 없음). 그래서 “언제 사용하고 무엇을 반환하는지”를 설명에 명시하는 것이 도구 호출 정확도의 결정적 요인입니다.
2. 도구 선택 기준
| 도구 유형 | 선택 기준 | 비고 |
|---|---|---|
| 코드 실행(인터프리터) | 데이터 계산·파일 생성이 있으면 필수 | 엑셀 집계·문서 생성의 엔진 |
| 지식 연결(SharePoint 등) | 참조할 파일·문서가 있으면 포함 | 문서 반입 경로 (4장) |
| 메일·메시지(MCP/커넥터) | 외부 커뮤니케이션이 필요하면 추가 | 발송 전 확인 게이트 필수 |
| 파일 저장(OneDrive 등) | 산출물을 링크·첨부로 공유하면 포함 | 대용량 첨부 한계 우회 |
| 문서 생성 커넥터 | 대개 불필요 ❌ | docx·pptx·HTML은 코드+내장 라이브러리가 더 잘 만듦 |
| 같은 기능 중복 도구 | 금지 ❌ | 기능 겹침 = 에이전트 선택 혼란 |
3. 핵심 원칙 — 최소 큐레이션
짚고 가기 (Anthropic) — “사람 엔지니어가 어느 도구를 쓸지 딱 못 정하면, AI도 못 정한다.”
- 목적당 최소한의 도구만 — 10개를 붙이면 매 턴 도구 선택부터 헷갈립니다.
- 기능 중복 금지 — 메일 커넥터 + 메일 MCP처럼 같은 일을 하는 도구 둘은 모호함만 만듭니다. 목적당 하나.
- 코드로 되는 일에 도구를 달지 않기 — 문서 생성은 내장 라이브러리로 충분, 커넥터 불필요.
실전 교훈 — 도구는 미리 다 계획하는 게 아니라 시나리오가 막히는 지점에서 추가됩니다. (예: 직접 첨부가 토큰 한계로 막힘 → OneDrive 링크 첨부로 우회하며 저장 도구 추가)
4. 커넥터 vs MCP
| 축 | 커넥터 | MCP |
|---|---|---|
| 정체 | 1,000+ 검증된 Power Platform 연결 | 업계 표준 에이전트-도구 연결 프로토콜 |
| 예 | SharePoint · Outlook | Work IQ Mail · OneDrive MCP |
둘 다 Microsoft 보안·거버넌스 경계 안에서 실행됩니다. MCP는 커넥터로 닿지 않는 도구까지 표준 방식으로 확장합니다. (Add a tool 대화 상자의 필터 탭: Featured / MCP / Connectors / Workflows)
보충 — 기성 커넥터에 없는 공공 성격의 API(공공데이터포털의 날씨·공휴일 API 등)는 커스텀 커넥터로 직접 등록합니다 → 실습 ③.
5. 참고자료 — RAG에서 코드 처리로
New의 근본 변화: 클래식은 검색 조각(스니펫) 을 돌려주지만, New는 원본 파일을 열어 코드로 처리합니다.
5.1 지식의 2분류
| 분류 | 특성 | 사용법 |
|---|---|---|
| 데이터 파일 (Excel·CSV) | 집계해야 답이 나오는 수치 | 코드 계산으로 정확한 값 |
| 문서 (Word·PDF) | 형식·톤·정책 참고 | 출처 표기하며 인용 |
지배 규칙 — 숫자는 항상 데이터 파일에서, 톤·형식은 문서에서 — 절대 섞지 않는다.
5.2 왜 코드 처리가 정확한가 — RAG의 한계
- 클래식(RAG): 질문 → 관련 텍스트 조각만 추출 → 근사치 ❌
- New: 질문 → 원본 엑셀을 열고 전체 행을 계산 → 정확한 값 ✅
- “제조사별 평균 가격” 같은 집계 질문은 조각 검색으로는 구조적으로 못 풉니다.
5.3 토큰 걱정은 오해
대용량 파일도 컨텍스트에 통째로 넣지 않습니다 — 코드로 처리하고 요약만 반환합니다.
메이커가 할 일은 지침에 추정하지 말고 실제 값으로 계산을 명시하는 것뿐, 선택 로드·집계·요약은 에이전트가 합니다.
5.4 SharePoint 연결 프로토콜
- Excel·Word를 SharePoint 사이트에 두고, 사이트를 Knowledge로 연결합니다(Build 탭 → Knowledge → Add knowledge).
- 엑셀(바이너리)은 검색 스니펫이 빈 값으로 보여도 정상 — 에이전트가 내려받아 코드로 처리합니다.
- (선택) 열 의미가 모호하면 “열 설명” 보조 문서를 스킬에 동봉하면 품질이 좋아집니다(필수 아님).
보충 (MS Learn) — 소스 종류: 파일 업로드(PDF·Word·Excel·PowerPoint) · 공개 웹사이트 · SharePoint · ServiceNow · Confluence · Dataverse · Azure AI Search · Copilot 커넥터 등(환경·라이선스에 따라 표시가 다름). New에는 일반 지식 on/off 토글이 없고(소스 단위로만 관리 + Web search 토글), 메일·회의·파일 등 M365 조직 데이터는 Microsoft IQ(Work IQ) 로 연결합니다. 원본 문서 갱신은 자동 반영되며, 위치·연결 설정이 바뀔 때만 수동 업데이트합니다.
✅ 원칙 — 정책서 Q&A는 지식으로, 정확한 값(수수료·명단)은 도구로. 도구·지식 모두 최소·비중복.
🧪 이 세션의 실습 → 실습 ③ — 사례 폴더·공휴일 API 커넥터(관통) + Excel 도구·Learn MCP(기본)
M2 빌드로 → 다음: 연결된 에이전트·메모리
출처: 2부 · 도구 & 참고자료 (Agentic Blog) · Tools overview for agents (MS Learn) · Add a tool to an agent (MS Learn) · Available knowledge sources for agents (MS Learn) · Effective context engineering — tools (Anthropic)