S4 · 커스텀 커넥터

표준 커넥터에 없는 사내 자체 시스템과 연결하려면 커스텀 커넥터를 만듭니다. 통신사의 사내 운영 API(예: 사번 조회, 릴리즈 관리)와 에이전트를 잇는 다리입니다.

커스텀 커넥터란?

REST API를 Copilot Studio·Power Platform이 이해할 수 있는 도구 형태로 래핑한 것입니다. 한 번 만들면 여러 에이전트·흐름에서 재사용합니다.

준비물

• 연결할 API 엔드포인트 (Base URL)
• 인증 방식 (API 키 / OAuth 2.0 등)
• OpenAPI(Swagger) 정의 또는 수동으로 동작 정의

실습 — 사내 “사번→부서 조회” 커넥터

1. Power Apps/Automate → 사용자 지정 커넥터 → 새로 만들기
2. 일반: Base URL, 호스트 입력
3. 보안: 인증 방식 설정 (예: API Key 헤더). 키는 환경 변수/시크릿으로 안전 보관
4. 정의: 동작 추가
   • 동작명: GetDepartmentByEmpNo
   • 요청: GET /employees/{empNo}/department
   • 응답 스키마: { empNo, name, department, manager }
5. 테스트: 샘플 사번으로 호출 확인
6. 에이전트 → 도구 추가 → 이 커스텀 커넥터 선택, 설명 작성

보안 체크리스트

• 인증 정보를 하드코딩하지 않는다 (환경 변수/시크릿 사용)
• 최소 권한 범위의 API 키 사용
• DLP 정책으로 데이터 유출 경로를 점검
• 응답에 민감정보 과다 포함 여부 확인

활용 예

• “사번 12345 담당 부서 알려줘” → 커넥터 호출 → 부서·매니저 응답
• 멀티스텝: 사번 조회 → 담당자 메일 발송(흐름 결합)

핵심 정리: 커스텀 커넥터 = 사내 API를 도구로 래핑. 인증·DLP·최소 권한이 핵심입니다.

---

이전 ← S3 · 12가지 활용 패턴 · 다음 → S5 · MCP 연동