이 핸즈온랩은 교육 내용을 보여 드리기 위한 예시입니다. 실제 교육과정에서는 고객사의 산업과 직무를 반영한 실습 시나리오로 구성한 비공개 학습 사이트를 따로 제공합니다.
M2-4. 도구 — 커넥터·MCP·워크플로 연결
한 줄 요약 — 도구(tools) 는 대화 중 에이전트가 호출하는 외부 기능입니다. 트리거나 토픽을 따로 정하지 않아도 오케스트레이터가 대화 맥락과 도구 설명을 보고 호출 여부를 정합니다 — 그래서 도구 설명이 곧 트리거입니다.
1. 도구로 할 수 있는 것
- 외부 시스템(CRM, ITSM, DB)에서 실시간 데이터 조회
- 작업 수행 — 레코드 생성, 알림 발송, 데이터 업데이트
- 서드파티 서비스·API 연동
- 자동화 워크플로 실행
호출을 정하는 방식 — 오케스트레이터(orchestrator)가 사용자 메시지마다 도구를 호출해야 하는지 판단합니다. 가장 중요한 것은 도구 이름과 설명이며, 에이전트 지침도 언제 쓸지에 영향을 줍니다. GitHub Copilot Harness(구 ‘새 경험’)에서는 트리거를 따로 정하지 않아도 대화 중에 도구를 씁니다(conversational tool use).
2. 도구 유형
tools-available 문서에 나온 세 가지 유형:
| 유형 | 설명 | 알맞은 경우 |
|---|---|---|
| Connectors(커넥터) | 수백 개 외부 서비스의 작업을 쓸 수 있게 해 주는 Power Platform 커넥터 (SharePoint, Outlook, Salesforce, ServiceNow, SAP 등) | 미리 만들어진 커넥터가 있는 잘 알려진 서비스 |
| MCP servers | Model Context Protocol 표준으로 도구 제공 — 기존 서버를 연결하거나 새로 만듦 | MCP 표준을 쓰는 커스텀/내부 서비스·DB·API |
| Workflows(워크플로) | Copilot Studio 흐름 디자이너(flow designer)로 만든 자동화 흐름 | 승인 흐름·데이터 변환 등 다단계·결정적(deterministic) 프로세스 |
참고 — 통합 안내 페이지(
tools-skills-legacy)의 유형 표에는 커넥터·MCP·REST API·에이전트 흐름(agent flows)·프롬프트(prompts) 5가지가 나옵니다. Standard Harness(구 클래식)의 도구 유형이 GitHub Copilot Harness에 모두 있는 것은 아닙니다.
3. 도구 추가 절차
기존 도구 추가
- copilotstudio.com 로그인, 에이전트 열기 → Build 탭
- 컴포넌트 패널에서 Tools 버튼 선택 (“Connect the agent to external systems and actions”)
- Add a tool 대화 상자에서 찾아보거나 검색 — 필터 탭: Featured / Model Context Protocol (MCP) / Connectors / Workflows
- 도구 선택 → 세부 정보(설명·사용 가능한 작업) 확인 → Add
추가 후 구성
| 구성 작업 | 내용 |
|---|---|
| Authenticate(인증) | 일부 도구는 로그인·자격 증명 필요 — 안내 창이 뜨면 진행 |
| Select actions(작업 선택) | 작업이 여러 개인 커넥터는 에이전트가 쓸 작업 선택 |
| Review description(설명 검토) | 런타임이 설명을 보고 호출 여부를 판단하므로, 설명이 기능을 정확히 나타내는지 확인 |
MCP 서버로 커스텀 도구 추가 (전제: 접속할 수 있는 MCP 서버가 이미 있어야 함)
- Tools 버튼 → Add a tool 대화 상자에서 검색창 옆 + Add 선택
- Model Context Protocol (MCP) 버튼 선택
- Add MCP Server 페이지에서 서버 이름·설명·URL·인증 정보 입력 → 하단 Add
새 워크플로를 만들어 도구로 쓰기
- Tools → Add a tool → + Add → Workflow 옵션 선택
- 워크플로 디자이너에서 작성 → 우측 상단 Save 아이콘 → Publish
- 에이전트의 Build 탭으로 돌아와 테스트
4. 도구 관리·삭제
구성 보기·업데이트 — Build 탭 → Tools 아래 도구 선택 → Tool details 대화 상자:
| 패널 | 내용 |
|---|---|
| Details | 도구 이름·설명 수정(설명을 다듬을수록 도구를 정확히 고름), 만료된 인증 자격 증명 갱신 |
| Inputs | 호출할 때 도구에 넘기는 값 구성, 작업이 여러 개인 커넥터는 작업 추가·제거 |
| Outputs | 도구가 플래너(planner)에 반환하는 출력 확인 |
수정 후 Save 선택.
제거 — 도구 옆 X 버튼 → 확인 창에서 Remove 선택. 제거해도 연결만 끊길 뿐, 바탕이 되는 커넥터·MCP 서버·API 구성은 삭제되지 않습니다.
5. 모범 사례와 문제 해결
도구 설명 작성
- 무슨 일을 하는지 분명한 이름 — 좋은 예: “Create support ticket” / 나쁜 예: “Ticket tool”
- 설명에 언제 쓰는지 + 무엇을 돌려주는지 적기
- 도구끼리 설명이 모호하거나 겹치지 않게 하기
문제 해결
| 문제 | 해결 |
|---|---|
| 연결 오류 | 인증 자격 증명이 유효한지, 서비스가 정상인지 확인 |
| 도구가 호출되지 않음 | 설명에 언제 쓰는지가 분명히 적혀 있는지 검토 |
| 잘못된 결과 | 매개변수·선택한 작업 등 도구 구성 점검 |
핵심 정리
- 도구 = 외부 기능 호출 — 트리거 없이 오케스트레이터가 설명을 보고 호출 여부 결정
- 세 가지 유형: 커넥터 / MCP 서버 / 워크플로 (+통합 문서에는 REST API·프롬프트도 언급)
- 추가한 뒤 인증 → 작업 선택 → 설명 검토 순으로 구성
- 좋은 설명 = 좋은 호출 — “언제 + 무엇을 돌려주는지”를 쓰고 중복은 피하기, 제거해도 바탕 구성은 남음
(기능·화면·명칭은 프리뷰 기준이며 바뀔 수 있음)
M2 허브로 · 이전 ← M2-3. Microsoft IQ · 다음 → M2-5. 스킬
출처: Tools overview (MS Learn) · Available tools (MS Learn) · Add a tool to an agent (MS Learn) · Manage and delete tools (MS Learn) · Add tools and skills (MS Learn) · Choose a harness (MS Learn)