CanRobot · 캔로봇
Microsoft Certified Trainer Microsoft MVP 2025

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

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

3. 도구 호출 — 토픽 수준

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

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

4. MCP 서버 추가

  1. Tools 페이지 → Add a toolModel 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)

이 과정은 Microsoft Learn 공식 문서(Copilot Studio 개요 · 하네스 선택 · 토픽 · 에이전트 플로우)를 참고하여 제작했습니다.