M2-6. 도구 — 커넥터·프롬프트·REST·MCP·플로우

한 줄 요약 — 도구는 에이전트의 행동입니다. 프리빌트/커스텀 커넥터·프롬프트·REST API·MCP 서버· 에이전트 플로우를 도구로 붙이며, 생성형 오케스트레이션에서는 이름·설명이 곧 호출 조건입니다.

1. 도구 종류

종류	무엇	대표 사례
프리빌트 커넥터	Power Platform 커넥터 (1,000+)	Outlook 메일 발송 · SharePoint 항목 생성 · Teams 게시
커스텀 커넥터	우리 API를 커넥터로 래핑	사내 시스템 조회
프롬프트	AI Builder 프롬프트 — 모델 호출 한 번을 도구로	요약·분류·추출
REST API	OpenAPI 스펙 기반 직접 연결	외부 서비스 호출
MCP 서버	Model Context Protocol 도구·리소스	표준화된 외부 도구 셋
에이전트 플로우	다단계 결정적 자동화	승인 절차 · 데이터 처리 (M5)

2. 도구 추가 — 에이전트 수준

1. 에이전트의 Tools 페이지 → Add a tool
2. 목록에서 검색·선택 (또는 New tool → Prompt / Agent flow / Custom connector / MCP / REST API)
3. 필요 시 연결(connection) 생성·인증
4. Add and configure → 구성 페이지에서:
   • 이름·설명 — 오케스트레이터가 언제 쓸지 판단하는 기준
   • Inputs — 각 입력을 어떻게 채울지 (대화에서 자동 / 작성 시 고정)
   • Completion — 도구 실행 후 동작
5. Save

화면 구성 예시 — 실제 화면·명칭은 버전에 따라 다를 수 있습니다

3. 도구 호출 — 토픽 수준

클래식 오케스트레이션이거나 정형 구간에서 쓸 때는 토픽 안에서 명시적으로 호출합니다:

1. 캔버스에서 + → Add a tool → Connector 등 선택
2. 연결 설정 → 입력을 변수로 매핑 → 출력 변수를 다음 노드에서 사용

화면 구성 예시 — 실제 화면·명칭은 버전에 따라 다를 수 있습니다

4. MCP 서버 추가

1. Tools 페이지 → Add a tool → Model Context Protocol 선택
2. 목록에서 MCP 커넥터 선택 (프리빌트 또는 구성해 둔 연결)
3. 연결 인증 → Add and configure
4. 서버가 노출하는 도구 목록 확인 — 설명이 부실한 도구는 신뢰성이 떨어집니다

5. 인증 — 누구 자격으로 실행되나

방식	동작
사용자 자격 증명 (기본)	에이전트 사용자가 자기 계정으로 연결 — 권한도 사용자 기준
메이커 자격 증명	도구 Overview → Additional details → Maker-provided credentials — 인증된 채널 필요

No authentication 채널에서는 사용자 자격 증명 도구를 쓸 수 없습니다 (M3-3).

6. 이름·설명 작성 팁 (생성형 오케스트레이션)

• 이름은 구체적으로 — “Ticket tool” ❌ → “지원 티켓 생성” ✅
• 설명에는 언제 써야 하는지 + 무엇을 반환하는지
• 도구 간 설명이 겹치지 않게 — 겹치면 오호출·미호출이 생깁니다

실습 체크리스트

1. Outlook “메일 보내기(V2)” 커넥터를 도구로 추가
2. 이름·설명을 한국어로 구체적으로 작성
3. 테스트 — “테스트 메일 보내줘” → 입력 슬롯 자동 질문 확인

핵심 정리

1. 도구 6종 — 커넥터·커스텀 커넥터·프롬프트·REST·MCP·플로우
2. 생성형에서는 이름·설명이 호출 조건 — 구체적으로, 겹치지 않게
3. 자격 증명 방식(사용자 vs 메이커)과 채널 인증을 함께 설계하세요

---

M2 빌드로 · 다음: M2-7. 생성형 답변

출처: Add tools to custom agents (MS Learn) · Use Power Platform connectors as tools (MS Learn) · Add MCP tools to your agent (MS Learn)