Microsoft 365 Copilot 커스텀 플러그인 마스터하기: 단계별 가이드
By Mirko Peters ·
Microsoft 365 Copilot 커스텀 플러그인을 마스터하기 위한 종합 가이드에 오신 것을 환영합니다! 반복적인 작업을 자동화하고, 업무 흐름을 간소화하고, 즐겨 쓰는 외부 애플리케이션을 일상적으로 사용하는 생산성 제품군에 직접 연결하고 싶으셨다면 바로 찾아오셨습니다. 커스텀 플러그인을 만들면 기본 제공 기능을 훨씬 넘어 Microsoft 365를 확장할 수 있어, 조직이 더 효율적이고 안전하게 운영될 수 있습니다…
Automatically translated with AI from the original post. Read the English original
Microsoft 365 Copilot 커스텀 플러그인을 마스터하기 위한 종합 가이드에 오신 것을 환영합니다! 반복적인 작업을 자동화하고, 업무 흐름을 간소화하고, 즐겨 쓰는 외부 애플리케이션을 일상적으로 사용하는 생산성 제품군에 직접 연결하고 싶으셨다면 바로 제대로 찾아오셨습니다. 커스텀 플러그인을 만들면 기본 제공 기능을 훨씬 넘어 Microsoft 365의 기능을 확장할 수 있으므로, 조직이 더 효율적이고 안전하게 운영될 수 있습니다.
이러한 개념이 실제 업무 상황에서 어떻게 적용되는지 확인하시려면 동반 팟캐스트 에피소드 Build Custom Microsoft 365 Copilot Plugins를 들어보시기를 권합니다. 이 에피소드에서는 Microsoft 365 커스터마이징 역량을 한 단계 끌어올려 줄 아키텍처, 배포 전략, 실제 활용 사례를 자세히 다룹니다.
커스텀 플러그인이란 무엇인가?
커스텀 플러그인을 사용하면 고유한 요구 사항에 맞게 Microsoft 365를 확장하고 개인화할 수 있습니다. 작업을 자동화하고, 서로 다른 앱을 연결하고, 데이터와 상호 작용하는 새로운 방식을 만들 수 있습니다. 커스텀 플러그인을 구축하면 업무 흐름을 더 세밀하게 제어할 수 있고 생산성도 높아집니다.
Microsoft 365의 플러그인 유형
Microsoft 365에는 여러 유형의 플러그인이 있습니다. 각 유형은 서로 다른 목적을 가지며 시나리오에 따라 적합한 경우가 다릅니다.
- 플러그인: Microsoft Dynamics 365에서 이벤트 핸들러 역할을 합니다. 특정 작업이 발생하면 실행되며, 비즈니스 로직을 추가하거나 변경할 수 있습니다.
- 확장: Dynamics 365에 추가 기능을 더합니다. 이를 활용해 사용자 지정 앱을 만들거나 워크플로를 자동화할 수 있습니다.
- Teams 메시지 확장: Teams 채팅에서 바로 웹 서비스와 상호 작용할 수 있습니다. 자연어를 사용해 검색하거나 작업을 실행할 수 있습니다.
- Microsoft Power Platform 커넥터: Microsoft 365를 다른 앱 및 서비스와 연결하여 자동화를 더 쉽게 만들어 줍니다.
커스텀 플러그인과 표준 확장을 간략히 비교하면 다음과 같습니다.
| 항목 | 커스텀 플러그인 | 표준 확장 |
|---|---|---|
| 범위 | 보다 광범위한 커스터마이징 옵션을 사용할 수 있습니다 | 커스터마이징이 제한적입니다 |
| 통합 | 다양한 서비스와 통합할 수 있지만 인증이 필요할 수 있습니다 | Microsoft 서비스와의 통합이 더 간편합니다 |
| 기능 | 몰입형 경험과 상황에 맞는 작업을 지원합니다 | 주로 표준 기능에 중점을 둡니다 |
사용 사례와 이점
커스텀 플러그인은 일상 업무를 개선하기 위해 다양한 방식으로 활용할 수 있습니다.
- 승인이나 알림과 같은 복잡한 비즈니스 프로세스를 자동화합니다.
- 시스템에 저장되기 전에 데이터를 검증하거나 변경합니다.
- Microsoft 365를 외부 앱이나 데이터베이스와 통합합니다.
- 특정 이벤트 발생 시 데이터가 동작하는 방식을 제어합니다.
- 더 나은 인사이트를 얻기 위해 커스텀 대시보드나 보고서를 만듭니다.
커스텀 플러그인을 사용하면 불필요한 단계를 줄여 시간을 절약할 수 있습니다. 작업이 완료되기를 오래 기다리지 않아도 됩니다. 또한 오류를 줄이고 시스템의 안정성을 높일 수 있습니다. 사용자 주도 작업과 시스템 작업을 분리하면 향후 성장에 대비한 환경을 갖출 수 있습니다.
팁: 급하지 않은 작업은 백그라운드에서 실행되도록 오프로드하세요. 그러면 주요 업무가 빠르고 원활하게 유지됩니다.
Copilot 플러그인 예시
Copilot 플러그인은 Microsoft 365에서 데이터를 통합하고 업무 흐름을 간소화하는 방법을 보여 줍니다. 이 플러그인은 Planner, SharePoint, Teams의 업데이트를 한데 모읍니다. 간단한 질문 하나로 실시간 프로젝트 현황을 확인할 수 있습니다. 예를 들어 "Project Apollo는 어디까지 진행되었나요?"라고 물으면 즉시 정확한 답변을 받을 수 있습니다.
Copilot 플러그인은 Microsoft Graph와 SharePoint REST API를 사용해 최신 정보를 가져옵니다. 외부 데이터 소스에 연결하므로 항상 최신 세부 정보를 확인할 수 있습니다. 또한 명확한 매니페스트와 안전한 인증 방식을 사용합니다. 이를 통해 데이터를 안전하게 보호하고 조직의 규칙을 준수할 수 있습니다.
개발 환경 설정
Microsoft 365용 커스텀 플러그인 구축을 시작하기 전에 개발 환경을 준비해야 합니다. 이 설정을 통해 원활한 작업 흐름에 필요한 도구와 구성을 갖출 수 있습니다.
필수 도구
시작하려면 여러 도구가 필요합니다. 각 도구는 플러그인 개발에서 핵심적인 역할을 합니다.
- Visual Studio 2022 또는 이와 유사한 통합 개발 환경(IDE)을 사용하면 코드를 작성하고 디버그할 수 있습니다.
- Microsoft Dynamics 365 SDK나 Microsoft.CrmSdk.CoreAssemblies 같은 NuGet 패키지는 플러그인 개발을 위한 라이브러리와 템플릿을 제공합니다.
- Dynamics 365 인스턴스를 사용하면 실제 환경에서 플러그인을 등록하고 테스트할 수 있습니다.
- Microsoft 365 Agents Toolkit과 Office 추가 기능용 Yeoman Generator를 사용하면 프로젝트를 구성하고 관리하는 데 도움이 됩니다.
- 최상의 개발 환경을 위해 항상 최신 버전의 Visual Studio를 설치하고 Office/SharePoint 개발 워크로드를 포함하십시오.
개발자 계정
Microsoft 365 개발자 계정이 필요합니다. 이 계정을 통해 플러그인 개발에 필요한 도구와 서비스를 사용할 수 있습니다. 무료 Microsoft 365 개발자 프로그램에 가입하여 시작할 수 있습니다.
IDE 및 확장 기능
작업 방식에 맞는 IDE를 선택하십시오. Visual Studio 2022가 널리 사용됩니다. 적절한 확장 기능을 설치하면 Visual Studio Code도 사용할 수 있습니다. Office 추가 기능 및 SharePoint 개발용 확장 기능을 반드시 추가하십시오.
Node.js 및 npm
컴퓨터에 Node.js와 npm을 설치하십시오. 이 도구들은 프로젝트 종속성을 관리하고 스크립트를 실행하는 데 도움이 됩니다. 많은 Microsoft 365 개발 도구가 플러그인을 빌드하고 패키징하는 데 Node.js를 사용합니다.
필수 구성 요소 설치
다음 단계에 따라 필요한 구성 요소를 설치하십시오.
- Teams 관리 센터에서 사이드로딩을 사용하도록 설정하십시오. Teams 앱으로 이동한 다음 설치 정책으로 이동하고 "사용자 지정 앱 업로드" 토글을 켭니다.
- Teams 클라이언트에서 앱으로 이동한 다음 앱 관리를 선택하여 사이드로드한 사용자 지정 앱을 관리하십시오.
- Power Platform 관리 센터에서 생성형 AI 기능을 사용하도록 설정하려면 Power Platform 관리자에게 요청하십시오.
- Microsoft 365 테넌트 관리자가 Microsoft 365 관리 센터에 Copilot Studio 앱을 배포했는지 확인하십시오.
팁: 이러한 설정에 액세스할 수 없는 경우 관리팀에 문의하십시오.
환경 구성
플러그인 생성에 최적화된 환경을 설정하십시오.
- 할인 검증이나 순 금액 계산처럼 사용 사례를 정의하십시오.
- 사전 작업(pre-operation)과 동기 실행처럼 적절한 단계와 모드를 선택하십시오.
- 방어적인 코드를 작성하십시오. 오류를 방지하려면 null 검사와 깊이 검사를 포함하십시오.
- 필터링 특성과 업데이트용 사전 이미지(pre-image)를 사용하여 플러그인을 등록하십시오. 구성에는 환경 변수를 사용하십시오.
- 다양한 시나리오를 테스트하고 Plugin Trace Log로 성능을 모니터링하십시오. 확장성을 확인하려면 대량 트랜잭션을 시뮬레이션하십시오.
사용자 지정 플러그인 빌드: 프로젝트 생성
Microsoft 365용 사용자 지정 플러그인을 빌드할 때는 올바른 플러그인 유형을 선택하는 것이 첫 단계입니다. 선택에 따라 기능, 통합 옵션, 사용자 경험이 달라집니다. 플러그인 유형마다 적합한 요구 사항이 다르므로 프로젝트 목표에 맞는 옵션을 선택해야 합니다.
플러그인 유형 선택
여러 플러그인 유형 중에서 선택할 수 있습니다. 각 유형은 고유한 사용 사례를 지원하며 서로 다른 이점을 제공합니다.
Office 추가 기능
Office 추가 기능을 사용하면 Word, Excel, PowerPoint 같은 앱을 확장할 수 있습니다. 사용자 지정 작업 창, 콘텐츠 또는 명령을 추가할 수 있습니다. 이러한 추가 기능을 사용하면 Office 앱 안에서 바로 데이터와 상호 작용하고, 작업을 자동화하거나, 외부 서비스에 연결할 수 있습니다.
Teams 확장
Teams 확장을 사용하면 Microsoft Teams에 새로운 기능을 추가할 수 있습니다. 메시지 확장, 탭 또는 봇을 만들 수 있습니다. 이러한 확장을 사용하면 Teams를 벗어나지 않고도 정보에 액세스하거나, 워크플로를 시작하거나, 협업할 수 있습니다.
Outlook 추가 기능
Outlook 추가 기능은 Outlook 환경을 향상합니다. 이메일 작업을 자동화하거나, 사용자 지정 작업을 추가하거나, 다른 앱에 연결할 수 있습니다. 이러한 추가 기능을 사용하면 메시지를 관리하고, 모임을 예약하거나, 외부 소스의 데이터를 가져올 수 있습니다.
팁: 항상 플러그인 유형을 비즈니스 시나리오에 맞추십시오. 예를 들어 채팅 기반 워크플로에는 Teams 확장을, 문서 자동화에는 Office 추가 기능을 사용하십시오.
프로젝트 템플릿 사용
프로젝트 템플릿을 사용하면 빠르게 시작하고 설정 실수를 피할 수 있습니다. Yeoman generator, Visual Studio, Microsoft 365 Agents Toolkit 같은 도구를 사용할 수 있습니다. 이 도구들은 필요한 기본 파일과 폴더를 만들어 줍니다.
프로젝트 구조 초기화
프로젝트를 초기화할 때는 HTML, CSS, JavaScript 또는 TypeScript를 사용하십시오. 많은 개발자가 사용자 인터페이스를 구축하기 위해 React를 선택합니다. 팀의 기술 역량에 따라 JavaScript 또는 TypeScript를 선택할 수 있습니다.
- Microsoft 365 Agents Toolkit 또는 Yeoman Generator를 사용하면 설정을 간소화할 수 있습니다.
- 코드를 스크립트, 스타일, 에셋용 폴더로 명확하게 구성하십시오.
- 플러그인이 Microsoft 365와 상호 작용하는 방식을 정의하는 매니페스트 파일을 포함하십시오.
플러그인 코드 개발
플러그인 아키텍처
먼저 견고한 플러그인 아키텍처를 설계하는 것부터 시작합니다. 이 단계는 플러그인의 동작 방식, 확장성, 보안 수준을 결정합니다. Microsoft 365 플러그인은 흔히 계층형 설계를 사용합니다. 변경되지 않는 핵심 솔루션을 담는 기반 계층을 만들고, 여러 지역에서 공유하는 커스터마이징은 중간 계층에 둡니다. 최상위 계층에서는 프로젝트별로 필요한 변경을 적용할 수 있습니다. 이런 구조는 플러그인을 확장하고 유지 관리하기 쉽게 만들어 줍니다.
핵심 기능 추가
플러그인을 쓸모 있게 만드는 핵심 기능을 추가해야 합니다. 이 기능들은 Microsoft 365 앱을 연결하고, 작업을 자동화하며, 사용자 경험을 개선합니다.
Microsoft Graph 통합
Microsoft Graph 통합을 사용하면 외부 데이터 소스에 접근할 수 있습니다. Planner, SharePoint, Teams 등 Microsoft 365 서비스의 실시간 정보를 가져올 수 있습니다. 이를 통해 데이터의 관련성과 적시성이 높아집니다.
SharePoint REST API
SharePoint REST API를 사용하면 SharePoint 목록과 문서를 다룰 수 있습니다. 업데이트를 자동화하고, 프로젝트 상태를 가져오고, 파일을 관리할 수 있습니다. 이 API는 여러 소스의 데이터를 통합하는 데 도움이 됩니다.
보안 인증
Microsoft 365 플러그인은 강력한 인증으로 보호해야 합니다. 보안 인증은 데이터를 안전하게 지키고 무단 접근을 막습니다. 플러그인을 개발할 때는 사용자와 서비스가 자신의 신원을 증명하는 방법을 직접 정해야 합니다. 이 단계는 모든 조직에 매우 중요합니다.
| 인증 방법 | 설명 |
|---|---|
| Windows Hello for Business | 지문이나 얼굴 인식 같은 생체 데이터를 사용해 암호 없이 안전하게 접근합니다. |
| FIDO2 보안 키 | USB 키와 같은 물리적 장치를 사용해 암호 없이 강력한 인증을 제공합니다. |
| Azure AD 인증서 기반 인증 | 디지털 인증서와 다단계 확인을 사용해 보안을 강화합니다. |
플러그인 배포 및 테스트
빌드 및 패키징
플러그인을 테스트하거나 배포하기 전에 Microsoft 365 플러그인을 빌드하고 패키징해야 합니다. 이 과정을 거치면 코드와 모든 종속 항목이 여러 환경에서 사용할 준비가 됩니다. 다음 단계에 따라 플러그인을 안전하게 빌드하고 패키징하세요.
로컬 테스트
플러그인을 로컬에서 테스트하면 문제를 조기에 발견할 수 있습니다. 이 과정을 쉽게 해 주는 여러 도구를 사용할 수 있습니다. 이 도구들은 로컬 테스트, 통합, 디버깅을 지원합니다.
Microsoft 365에 배포
로컬 테스트를 마치면 플러그인을 Microsoft 365에 배포할 수 있습니다. 파일을 Azure Storage에 업로드하고, 매니페스트 파일을 편집해 호스팅된 파일을 가리키도록 설정한 다음, 중앙 배포를 사용해 Microsoft 365 관리 센터의 통합 앱에서 추가 기능을 게시합니다.
모범 사례 및 문제 해결
호환성 팁
커스텀 플러그인이 Microsoft 365 앱과 디바이스 전반에서 원활하게 작동하기를 원할 것입니다. 먼저 플러그인 유형별로 지원되는 플랫폼을 확인하세요. Office 추가 기능, Teams 확장, Outlook 추가 기능은 각각 고유한 호환성 요구 사항이 있습니다. 다양한 브라우저와 여러 운영 체제에서 플러그인을 테스트하세요.
성능 최적화
플러그인이 빠르게 실행되고 대량의 데이터를 처리하기를 원할 것입니다. 비동기 작업을 사용하고, 데이터 캐싱을 구현하고, 자산을 압축하고, 대규모 데이터 세트에는 페이지 나누기를 활용해 코드를 최적화하세요.
보안 고려 사항
플러그인과 사용자 데이터를 반드시 보호해야 합니다. Microsoft Entra ID를 사용하는 OAuth 같은 보안 인증 방법을 사용하세요. 최소 권한 원칙을 적용하고, 비밀 정보는 Azure Key Vault에 안전하게 저장하며, 사용자 입력은 항상 검증하세요.
자주 발생하는 문제
Microsoft 365용 커스텀 플러그인을 개발하다 보면 스레드 안전성 및 컨텍스트 문제, 대량 작업 중 성능 병목 현상, 예기치 않은 예외 처리 문제를 마주칠 수 있습니다. 항상 철저히 테스트하고, 추적 로그를 활용해 문제를 신속하게 진단하세요.
지금까지 Microsoft 365용 커스텀 플러그인을 만드는 방법을 살펴보았습니다. 환경을 설정하고, 적절한 플러그인 유형을 선택하고, 안전한 코드를 개발하고, 솔루션을 배포하는 과정을 익혔습니다. 더 깊이 알아보고 업계 전문가들의 논의를 듣고 싶다면 관련 에피소드 Build Custom Microsoft 365 Copilot Plugins를 방문하세요.
고급 기능을 계속 살펴보고 Microsoft 365 개발자 커뮤니티에 참여하세요.
- 새로운 API 사용해 보기
- 지식 공유하기
- Microsoft 자료로 최신 정보 얻기
지속적인 학습은 더 나은 플러그인을 만들고 업무 효율을 높이는 데 도움이 됩니다.