M3-3. 지식(Knowledge) 소스와 한도
한 줄 요약 — 에이전트당 최대 20개 지식 소스를 추가할 수 있고, 소스 종류마다 정확한 개수·용량 한도가 다릅니다. Only use specified sources를 켜도 모델의 일반 지식은 완전히 차단되지 않습니다.
1. 소스별 정확한 한도
| 지식 소스 | 한도 |
|---|---|
| 공개 웹사이트 URL | 최대 4개 (경로 최대 2단계, 쿼리 파라미터 불가) |
| SharePoint 파일·폴더·사이트 | 에이전트당 최대 100개 SharePoint 파일 |
| SharePoint 목록 | 에이전트당 1개 목록, 최대 20,000개 항목/50MB 원본 텍스트(초과분 잘림), Attachments 열 색인 안 됨, 사이트 선택만으로는 목록이 포함되지 않음 |
| OneDrive 파일 | 최대 50개 |
| Teams 채팅 | 최대 5개 특정 채팅 범위 지정 |
| Teams 회의 | 특정 회의로 범위 지정 가능(명시된 개수 상한 없음) |
| 첨부(Embedded) 파일 | 최대 20개, 개별 파일만(폴더 불가) |
| 메일(Outlook) | 범위 지정 불가 — 메일함 전체 사용, Copilot 부가 라이선스 필요, 에이전트를 공유받은 사용자와는 공유되지 않음 |
| OneNote 페이지 | 개별 페이지만(전체 노트북 선택 불가), 파일 선택기로만 추가(URL 입력 불가) |
| People 데이터 | Copilot 라이선스 사용자는 기본 켜짐, 토글로 끌 수 있음, 부가 라이선스 필요 |
| Copilot connectors | 관리자가 Microsoft 365 관리 센터에서 사전 활성화 필요, 일부 커넥터만 범위 지정 가능 |
첨부 파일 크기 한도(형식별): .doc/.docx/.pdf/.ppt/.pptx/.txt = 512MB, .xls/.xlsx = 30MB, .html은 SharePoint에서만 지원.
2. 라이선스·기능 매트릭스
| 기능/지식 소스 | Agent Builder | 라이선스·계량 필요 여부 |
|---|---|---|
| Code interpreter | 지원 | 불필요 |
| Image generator | 지원 | 불필요 |
| Copilot connectors | 지원 | 필요 |
| SharePoint | 지원 | 필요 |
| OneDrive | 지원 | 필요 |
| 첨부 파일 콘텐츠 | 지원 | 필요 |
| 웹 검색(범위 지정 포함) | 지원 | 불필요 |
| Dataverse | 미지원 | 필요(Agents Toolkit만 지원) |
| 메일 | 지원 | 필요(라이선스만) |
| People | 지원 | 필요(라이선스만) |
| OneNote 페이지 | 지원 | 불필요 |
| Teams 메시지·회의 | 지원 | 필요(라이선스만) |
Dataverse는 Copilot Studio 에이전트와 혼동하기 쉽지만, Agent Builder에서는 지원되지 않고 Agents Toolkit(프로 코드)에서만 지원됩니다.
3. Only use specified sources
지식 기반 질의에서 구성된 소스만 우선하도록 강제하는 토글입니다. 다만 Agent Builder는 이 토글로도
모델의 일반(사전 학습) 지식을 완전히 차단하지 못합니다. 더 엄격한 차단이 필요하면 Copilot Studio로
옮겨 discourage_model_knowledge 등 생성형 액션 설정을 사용해야 합니다.
4. Copilot connectors 범위 지정 예시
일부 Copilot connectors는 특정 범위로 좁혀 연결할 수 있습니다.
- Azure DevOps Work Items → area path
- Azure DevOps Wiki → project
- Confluence → space
- Google Drive → folder
- GitHub Cloud PRs/Issues/Knowledge → repository
- Jira → project
- ServiceNow Knowledge → KB
- ServiceNow Catalog → catalog
- ServiceNow Tickets → entity type
5. 따라하기 — SharePoint 사이트 + 웹사이트 1개 추가
- Configure 탭에서 Knowledge 섹션 → Add 선택
- SharePoint 선택 → 사이트 하나를 검색해 추가(파일 100개 한도 안에서 관리됩니다)
- 다시 Add → Website 선택 → 참고할 공개 웹사이트 URL 1개 입력(경로 2단계 이내, 쿼리 파라미터 없이)
- 필요하면 Only use specified sources 토글을 켜서 두 소스를 우선하도록 설정
- Try it 탭에서 두 소스 모두에서 근거를 찾는지 질문으로 확인
핵심 정리
- 지식 소스는 최대 20개, 종류별로 개수·용량 한도가 정확히 정해져 있습니다(예: 웹사이트 4개, SharePoint 파일 100개)
- Dataverse는 Agent Builder에서 지원되지 않으며 Agents Toolkit에서만 사용할 수 있습니다
- Only use specified sources를 켜도 모델의 일반 지식을 완전히 차단할 수는 없습니다
M3 허브로 → 다음: M3-4. 기능(Capabilities) · 응답 모드 · 시작 프롬프트
출처: Add knowledge to your agent (MS Learn) · Knowledge sources overview (MS Learn)