도구 — 커스텀 커넥터

시간	소요	수강생 역할
13:00	35분	🟢 직접 실습

이 모듈에서 만들 것

외부 환율 REST API → OpenAPI 정의로 등록 → 에이전트 도구로 호출

기본과정 M12에서 기본 커넥터(Excel 행 추가)를 사용했습니다. 여기서는 Microsoft가 제공하지 않는 외부 API를 직접 도구로 등록하는 길을 배웁니다.

기본 커넥터 (M12)	커스텀 커넥터 (이번 S4)
Microsoft가 미리 만들어 놓은 것	내가 직접 등록
Excel, Outlook, Teams 등	어떤 외부 REST API든 가능
클릭 몇 번으로 연결	OpenAPI 정의 + 인증 설정

REST API = 질문과 답변

REST API는 어렵게 느껴지지만, 본질은 질문과 답변입니다.

에이전트: "USD → KRW 환율?" (GET /latest?from=USD&to=KRW)
    ↓
환율 API: "1350원입니다"          ({"USD":"KRW":1350})
    ↓
에이전트: "현재 USD/KRW 환율은 1,350원입니다"

일상 대화	REST API
“USD → KRW 환율?”	`GET /latest?from=USD&to=KRW`
“1350원”	`{"rates": {"KRW": 1350}}`

REST API는 컴퓨터끼리 대화하는 약속입니다. 사람이 한국어로 대화하듯, 컴퓨터는 URL과 JSON으로 대화합니다.

OpenAPI 정의 = 설명서

항목	설명	비유
서버 주소	API가 어디에 있는지	전화번호
엔드포인트	어떤 기능이 있는지	메뉴판
파라미터	무엇을 보내야 하는지	주문서
응답 형식	무엇을 받게 되는지	배달 목록

OpenAPI 정의 파일은 사전 제공합니다. 직접 작성할 필요 없습니다.

두 개의 실습으로 분리

실습	주제	시간
실습 ① — OpenAPI로 커스텀 커넥터 등록	OpenAPI 가져오기 + 커넥터 생성 + 단독 테스트	18분
실습 ② — 에이전트에 도구로 연결	Copilot Studio 도구 등록 + 호출 검증	17분

왜 분리하나 — ①은 “Power Platform 영역(커넥터 만들기)”, ②는 “Copilot Studio 영역(도구 연결)”. 두 화면을 오가는 데 혼란이 있어서 한 모듈에 묶으면 길을 잃기 쉽습니다.

왜 환율 API를 쓰나

조건	이유
무인증 / 단순 인증	강의 시간 안에 인증 설정으로 시간 낭비 X
안정적·공식 운영	강의 당일 다운되면 재앙
OpenAPI가 단순	한 엔드포인트 + 단순 JSON
결과가 직관적	“USD/KRW 환율”이 학습자에게 즉각 이해됨

S5의 MCP가 “Microsoft Learn”이라는 강한 임팩트를 가져가니, 커스텀 커넥터 쪽은 메커니즘 자체(OpenAPI → 커넥터 → 도구)를 단순한 API로 깔끔하게 학습하는 데 집중합니다. 응용은 강의 후 “공공데이터포털” 등으로 자기주도 확장 가능.

산출물 체크리스트

항목	내용
OpenAPI 정의 파일	사전 제공 (환율 API용)
커스텀 커넥터	`ExchangeRate`
에이전트 도구 등록	`GetExchangeRate`
테스트 발화	“오늘 달러 환율 알려줘” 등

활용 예시 (강의 이후 응용)

외부 서비스	에이전트 활용
환율 API	“오늘 달러 환율 알려줘”
공공데이터포털	“오늘 박스오피스 1위”, “지하철 도착정보”
사내 ITSM API	“내 티켓 진행 상태”
택배 API	“운송장 번호로 배송 추적”

응용 과제로 공공데이터포털(data.go.kr)의 무료 API를 추천합니다. 단, 회원가입·키 발급 시간이 필요해서 본 실습은 환율 API로 진행합니다.

다음 단계

실습 ① — OpenAPI로 커스텀 커넥터 등록부터 시작합니다.

도구 — 커스텀 커넥터

목차

이 모듈에서 만들 것

REST API = 질문과 답변

OpenAPI 정의 = 설명서

두 개의 실습으로 분리

왜 환율 API를 쓰나

산출물 체크리스트

활용 예시 (강의 이후 응용)

다음 단계

Table of contents