예시 실습
이 핸즈온랩은 교육 내용을 보여 드리기 위한 예시입니다. 실제 교육과정에서는 고객사의 산업과 직무를 반영한 실습 시나리오로 구성한 비공개 학습 사이트를 따로 제공합니다.
M2-4b. 커넥터 — 빌트인 · 커스텀 · REST API
한 줄 요약 — 커넥터는 Power Platform 커넥터로 에이전트를 외부 서비스에 연결하는 도구입니다. 기본 제공(빌트인) 커넥터가 있으면 그대로 쓰고, 없으면 커스텀 커넥터로 만듭니다. 커스텀 커넥터의 재료는 REST API + OpenAPI 정의입니다.
1. 세 가지 방식 한눈에 보기
| 구분 | 무엇인가 | 언제 쓰나 |
|---|---|---|
| 빌트인 커넥터 | 미리 만들어진 커넥터 수백 개 (SharePoint, Outlook, Excel Online, Teams, Salesforce, ServiceNow, SAP…) | 잘 알려진 서비스 — 검색해서 바로 Add |
| 커스텀 커넥터 | OpenAPI 정의로 직접 등록하는 커넥터 (make.powerapps.com) | 기본 제공 커넥터가 없는 사내 API·공공 API |
| REST API | HTTP 엔드포인트 자체 — OpenAPI(swagger)로 정의 | 커스텀 커넥터를 만드는 재료. (Standard Harness(구 클래식)의 REST API 도구 유형은 GitHub Copilot Harness에서 지원하지 않음 — 커스텀 커넥터로 연결) |
고르는 순서 — ① 빌트인 커넥터 검색 → ② 없으면 OpenAPI 정의 준비 → ③ 커스텀 커넥터 등록 → ④ 도구로 추가.
2. 빌트인 커넥터
- Build 탭 → Tools → Add a tool → Connectors 탭에서 검색 → Add
- 추가한 뒤 구성할 3가지: 인증(Authenticate) → 작업 선택(Select actions) → 설명 검토(Review description)
- 작업이 여러 개인 커넥터(예: Outlook)는 에이전트가 쓸 작업만 선택 — 필요 없는 작업까지 열어 두면 엉뚱한 호출이 생김
💡 RFP 시나리오 예 —
Excel Online (Business)로 수신자 명단 조회,Office 365 Outlook으로 검토 보고서 발송.
3. 커스텀 커넥터
기본 제공 커넥터가 없는 API를 쓰는 방법 (자세한 실습 → 실습 ③):
- OpenAPI(swagger) 파일 준비 — API 명세를 JSON/YAML로 작성
- make.powerapps.com → Custom connectors → New custom connector → OpenAPI 파일 가져오기
- 보안(인증 방식: API Key 등) 구성 → 테스트 탭에서 호출 확인
- DLP 정책에서 허용하는지 관리자에게 확인 → Copilot Studio Connectors 탭에 표시되는지 확인
4. REST API — OpenAPI 정의가 핵심
- 커스텀 커넥터의 품질은 OpenAPI 정의의 품질에 달려 있습니다:
operationId·summary·description·파라미터description이 곧 오케스트레이터가 읽는 도구 설명이 됩니다. - 파라미터에
default·형식(YYYYMMDD 등)을 명시하면 에이전트가 입력을 더 정확히 채웁니다. - 응답이 JSON이면 에이전트가 표·요약으로 가공하기 쉽습니다 (
_type=json같은 형식 파라미터 활용).
5. 제약·주의 사항
- Standard Harness의 도구 유형이 GitHub Copilot Harness에 모두 있지는 않음 — GitHub Copilot Harness에서 커스텀 도구를 추가하는 공식 방법은 현재 MCP 서버이며, 커넥터는 Power Platform에서 등록하면 Connectors 탭에 나타나는 방식
- 커넥터 인증 자격 증명이 만료되면 Tool details → Details에서 갱신
- 조직 DLP 정책이 커넥터 사용을 차단할 수 있음 — 실습 전 관리자 확인
핵심 정리
- 고르는 순서: 빌트인 검색 → 없으면 OpenAPI → 커스텀 커넥터 → 도구 추가
- 추가한 뒤 구성할 3가지: 인증 · 작업 선택 · 설명 검토 — 쓸 작업은 최소한으로
- OpenAPI의
description이 곧 도구 설명 — 정의 품질 = 호출 품질 - REST API 도구 유형(Standard Harness)은 GitHub Copilot Harness에서 지원하지 않음 — 커스텀 커넥터로 대신 연결
🧪 실습: ③ 커넥터·도구(읽기·커스텀·설명 실험) · 커넥터 심화(쓰기·발송·게시) · REST API 직접 제작
M2-4 도구로 · 다음: M2-4d. MCP
출처: Available tools (MS Learn) · Use connectors as tools (MS Learn) · Custom connectors (MS Learn) · Choose a harness (MS Learn)