플러그 인에 대한 개발 환경 설정

준비하는 동안 개발 도구 선택에서 개발 계획을 사용하여 플러그인 구성 요소에 필요한 환경, 계정, 도구, ID, 권한, 연결 및 서비스를 설정합니다. 빌드 또는 다시 사용으로 돌아갈 수 있도록 확인된 액세스 및 도구 필수 구성 요소로 완료합니다.

구성 요소를 빌드, 구성, 확장 또는 다시 사용하기 전에 이 설정을 완료합니다. 플러그인이 에이전트, 기술, 커넥터 및 MCP 기반 기능을 결합할 때 둘 이상의 환경이나 도구가 필요할 수 있습니다.

개발 계획으로 시작

모든 구성 요소에 대해 다음을 확인합니다.

  • 개발 도구 및 소스(source-of-truth) 리포지토리 또는 관리되는 환경입니다.
  • 개발 또는 테스트 테넌트, 환경, 지역 및 대상 Microsoft 환경입니다.
  • 제품 라이선스, 사용량 기반 청구, 구독 및 서비스 플랜이 필요합니다.
  • 관리자 역할, 애플리케이션 등록, ID, 사용 권한 및 동의가 필요합니다.
  • 필수 데이터 원본, API, 원격 서비스, 호스팅, 네트워크 액세스 및 비밀.
  • 테스트 사용자 및 대표적인 비프로덕션 데이터.
  • 각 종속성을 제공할 책임이 있는 소유자입니다.

액세스 권한이 없는 상태에서 구현을 시작하거나 다른 환경을 자동으로 대체하지 마세요. 해결되지 않은 필수 구성 요소를 개발 계획의 차단 요소로 기록합니다.

Microsoft 365 Copilot Chat은 모든 Microsoft 365 사용자가 사용할 수 있는 광범위하게 액세스할 수 있는 AI 채팅 인터페이스입니다. Copilot Chat 사용자는 기능을 확장하고 지침 또는 웹에 기반할 수 있는 에이전트에 액세스할 수 있습니다. Copilot Studio 종량제 청구를 사용하도록 설정한(Copilot 크레딧으로 사용) 테넌트의 사용자와 Microsoft 365 Copilot 라이선스가 있는 사용자는 SharePoint 데이터 기반 다지기 및 Microsoft 365 Copilot 커넥터와 같은 향상된 기능을 갖춘 에이전트에 액세스할 수 있습니다.

Microsoft 365 Copilot 라이선스 정보는 라이선스 옵션을 참조하세요.

Copilot 개발 환경

Copilot 개발 환경에는 다음 옵션이 있습니다.

  • Microsoft 365 개발자 프로그램 샌드박스 구독. 개발자 구독 자격이 있는 Microsoft 365 개발자 프로그램 멤버는 구독을 사용하여 에이전트를 개발할 수 있습니다.

    즉석 샌드박스를 선택하면 몇 분 안에 프로비전되고 샘플 사용자, Microsoft Teams 데이터 팩 및 미리 구성된 사용자 지정 앱이 미리 로드된 미리 구성된 E5 개발자 환경을 얻을 수 있습니다. 즉석 샌드박스 옵션에는 추가 기능 구매가 활성화되어 있습니다. 샌드박스 내에서 직접 Microsoft 365 Copilot을 비롯한 추가 서비스를 구매할 수 있습니다. 설정 요구 사항에 대한 자세한 내용은 Microsoft 365 개발자 샌드박스 구독 설정을 참조하세요.

    구성 가능한 샌드박스를 프로비저닝하는 경우 구독은 상거래를 지원하지 않습니다. Copilot 라이선스를 구입할 수 없으므로 이 옵션을 선택할 때 조직 데이터에 에이전트를 구축하거나 다른 기능을 추가할 수 없습니다.

    중요

    Microsoft 365 개발자 프로그램 자격은 Visual Studio Professional 또는 Enterprise 구독자, ISV 성공 프로그램 멤버, 적격 MAICPP(Microsoft AI Cloud Partner Program) 파트너, 프리미어 또는 통합 지원 고객으로 제한됩니다.

  • 적격 Microsoft Microsoft 365 Copilot 라이선스가 있는 Office 365 프로덕션 환경.

    참고

    프로덕션 환경에서 에이전트를 빌드할 때 관리자가 부과하는 제한 사항이 발생할 수 있습니다. 예를 들어 관리자는 사용자 지정 앱의 사이드로드를 차단하거나 Copilot 커넥터를 빌드하는 데 필요한 권한을 부여하지 않을 수 있습니다.

  • 기능이 제한된 Microsoft 365 Copilot Chat용 에이전트를 빌드하고 테스트하려는 경우 Copilot 라이선스가 없는 Microsoft 365 구독(예: Microsoft 365 Business Basic).

Microsoft 365 Copilot 라이선스를 구입하고 프로덕션 환경과 독립적으로 개발 환경을 설정할 수도 있습니다. 여기에서 직접 관리자가 될 수 있습니다.

Microsoft 365 Copilot 라이선스가 있는 조직

Microsoft 365 Copilot 라이선스를 사용하여 Microsoft 365 프로덕션 환경에서 직접 작업하여 Microsoft 365 Copilot 확장성 솔루션을 개발할 수 있습니다.

Microsoft 플랜에 Copilot을 추가하려면 Microsoft 담당자에게 문의하세요. 엔터프라이즈 고객이 Copilot에 액세스하려면 Microsoft 365 앱용 현재 채널 또는 월간 엔터프라이즈 채널에 있어야 합니다.

Microsoft 365 Copilot 라이선스가 없는 조직

Copilot 라이선스가 없는 조직의 사용자를 위한 Copilot 확장성 솔루션을 개발할 수 있지만 에이전트 기능에 몇 가지 제한이 있습니다. 조직 데이터 기반과 같은 에이전트 기능을 활용하려는 경우 Copilot Studio 종량제 청구(Copilot 크레딧)를 사용하도록 설정할 수 있습니다.

Copilot 확장성 옵션에 대한 요구 사항

여러 가지 방법으로 외부 서비스 및 데이터의 인텔리전스로 Microsoft 365 Copilot을 확장할 수 있습니다.

자세한 내용을 알아보고 사용자에게 가장 적합한 확장성 경로를 선택하려면 Copilot 확장성 계획 가이드 및 에이전트 개요를 참조하세요.

에이전트에 대한 요구 사항

에이전트를 빌드하려면 사용하려는 도구에 따라 필수 구성 요소를 완료해야 합니다.

참고

일부 에이전트 기능은 Copilot Studio 종량제 청구가 활성화된 테넌트의 사용자 또는 Microsoft 365 Copilot 라이선스가 있는 사용자만 사용할 수 있습니다. 예를 들어 조직 데이터에 기반한 에이전트를 빌드하려면 종량제 청구를 사용하도록 설정하거나 Microsoft 365 Copilot 라이선스를 구매해야 합니다.

Work IQ Dev 도구 요구 사항

Work IQ Dev Tools 는 일반적으로 사용 가능하며 지원되는 선언적 에이전트 및 플러그인 시나리오에 대한 기본 전문가-개발자 경로입니다. 먼저 검토 플러그인에 대한 개발 도구를 선택한 다음 시나리오에서 필요한 경우에만 도구 키트 또는 다른 구성 요소별 도구를 추가합니다. 확인하다:

  • Node.js 24.15 이상 및 CLI 및 설치 스크립트 실행을 위한 npm PATH 입니다. 설치 관리자가 Node.js 설치하지 않습니다. 대화형 또는 파일 기반 작성을 시작하는 데만 필요한 것은 아닙니다.
  • Windows에서 PowerShell 7 이상.
  • Copilot에 액세스할 수 있는 Microsoft 365 계정입니다.
  • 선택한 시나리오에서 Azure 리소스를 프로비저닝하는 경우 Azure 구독입니다.
  • 필요한 사용자 지정 앱 설치, 공유 또는 카탈로그 작업을 허용하는 개발 또는 테스트 테넌트입니다.

설치 스크립트는 이러한 통합을 건너뛰지 않는 한 검색된 지원되는 호스트에 대해 WIQD CLI, 선택적 Visual Studio Code 확장 및 공용 WIQD 코딩 도우미 플러그인을 설치합니다. 호스트를 설치하지 않습니다. 대신 마켓플레이스에서 코딩 도우미 플러그인을 설치할 수 있지만 CLI는 설치되지 않습니다. 설치 후 새 호스트 세션을 시작합니다. GitHub Copilot CLI 및 Claude Code 설정용 Work IQ Dev 도구 설치를 참조하세요.

확인:wiqd --version 필수 구성 요소의 상태를 시작하고 wiqd doctor 보고합니다. 보고된 오류를 해결합니다. 테넌트 프로비저닝의 경우 계속 진행하기 전에 의도한 계정 및 테넌트를 실행 wiqd auth login --interactive 하고 확인합니다.wiqd auth status Work IQ Dev Tools 인증을 따릅니다.

연속 통합의 경우 지원되는 핵심 수명 주기 명령에 대해 문서화된 신뢰할 수 있는 파이프라인 인증을 사용합니다. 파이프라인에서 실행 wiqd auth login 하거나 신뢰할 수 없는 끌어오기 요청 작업에 자격 증명을 노출하지 마세요. Work IQ 모니터링, 평가 및 기타 확장에는 별도의 인증 요구 사항이 있습니다. CI/CD 인증을 참조하세요.

Microsoft 365 에이전트 도구 키트 요구 사항

이러한 요구 사항은 유지된 도구 키트 기반 연습에 적용됩니다. 지원되는 새 선언적 에이전트 및 플러그인 프로젝트의 경우 Work IQ Dev 도구로 시작합니다.

Microsoft 365 에이전트 도구 키트를 사용하여 Microsoft 365 Copilot 라이선스 없이 에이전트를 빌드할 수 있습니다. 조직 데이터에 기반한 에이전트를 빌드하려면 테넌트에서 종량제 청구를 설정하거나 Microsoft 365 Copilot 라이선스를 구매해야 합니다.

에이전트 도구 키트 및 기타 IDE를 사용하여 에이전트를 빌드하려면 관리자가 사용자 지정 앱을 테넌트에 테스트용으로 로드할 수 있도록 설정해야 합니다.

테스트용 로드를 사용하도록 설정하려면 Teams 관리 센터에서 Teams 앱>정책 설정(>전역(조직 전체 기본값)을 선택하고 사용자 지정 앱 업로드 토글을 켜기로 전환합니다.

확인: 관리자는 정책이 개발 계정 및 의도된 테스트 시나리오에 적용되는지 확인합니다.

Teams 관리 센터에서 '사용자 지정 앱 업로드' 토글이 활성화된 조직 전체 설정 정책의 스크린샷

Teams 클라이언트에서 에이전트를 포함하여 사이드로드된 사용자 지정 앱을 관리하려면 앱>앱으로 이동합니다.

Copilot Studio 요구 사항

Copilot Studio는 모든 Microsoft 365 사용자가 사용할 수 있습니다. Copilot Studio를 사용하여 에이전트 및 작업을 만들 수 있습니다. SharePoint 또는 Copilot 커넥터를 통해 조직 데이터에 기반한 에이전트를 빌드하려면 테넌트에서 종량제 청구를 설정하거나 Copilot Studio 라이선스를 구매해야 합니다. 자세한 내용은 청구 요금 및 관리를 참조하세요.

Copilot Studio를 사용하여 에이전트를 빌드하려면 다음 단계가 필요합니다.

확인: 선택한 Copilot Studio 환경, 작성 액세스, 채널 필수 구성 요소 및 필수 커넥터를 테스트 계정에 사용할 수 있습니다. 독립 실행형 Copilot Studio 에이전트는 플러그 인이 아닌 에이전트 레지스트리에 표시됩니다.

개발자 모드 활성화

Copilot에서 개발자 모드를 사용하여 오케스트레이터가 지정된 프롬프트에 대한 응답으로 플러그 인을 선택하는지 여부와 방법을 테스트할 수 있습니다.

개발자 모드를 사용하도록 설정하려면 Copilot Chat에 다음을 입력합니다-developer on. 개발자 모드를 사용하지 않도록 설정하려면 다음을 입력합니다 -developer off.

확인: 라이선스가 부여된 Copilot 환경은 개발자 모드가 요청에 따라 활성화 또는 비활성화되었다고 보고합니다. 이 진단은 다른 환경에서 플러그인 검색 또는 설치를 설정하지 않습니다.

개발자 모드를 성공적으로 활성화하기 위해 사용자가 '-developer on'을 입력한 'Microsoft 365 Copilot' 세션의 스크린샷

개발자 모드는 라이선스가 부여된 Microsoft 365 Copilot 환경 내에서만 사용할 수 있습니다. 구성 요소 통합 테스트 중에 사용합니다. 자세한 내용은 에이전트 디버깅을 참조하세요.

Microsoft 365 Copilot 개발자 라이선스

조직 데이터에 기반하거나 향상된 기능을 포함하는 에이전트를 테스트하는 데 사용되는 계정에는 Microsoft 365 Copilot 개발자 라이선스가 필요합니다. 관리자는 Microsoft 365 관리 센터에서 Microsoft 365 Copilot 개발자 라이선스를 관리할 수 있습니다(청구 > 라이선스 아래). PowerShell을 사용하여 사용자 계정에 Microsoft 365 라이선스를 할당할 수도 있습니다.

에이전트 기능 및 라이선스 모델

Copilot용 에이전트는 각각 다른 수준의 기능을 제공하는 여러 라이선스 모델을 통해 사용할 수 있습니다.

  • Microsoft 365 Copilot 추가 기능 라이선스가 있는 Microsoft 365 - Microsoft 365 구독 및 Copilot 추가 기능 라이선스가 있는 사용자는 지원되는 앱 및 플랫폼에서 Copilot 에이전트 환경에 대한 모든 권한을 갖습니다.
  • Microsoft 365 Copilot Business - 중소기업을 위해 도입된 독립 실행형 SKU입니다. Microsoft 365 비즈니스 플랜에 맞춰 Copilot 에이전트 액세스를 제공합니다.
  • Microsoft 365 E7(Frontier Suite) - 엔터프라이즈 고객을 위한 Microsoft 365 E5, Microsoft 365 Copilot 및 Agent 365 기능을 포함하는 번들입니다.
  • 사용량 기반 청구(종량제) - 테넌트는 에이전트 구성 옵션에 몇 가지 제한이 있는 전체 라이선스 없이 에이전트 액세스를 사용하도록 설정할 수 있습니다. 사용량은 Copilot 크레딧으로 측정됩니다.
  • Copilot 추가 기능 라이선스가 없는 Microsoft 365 - 일부 앱에서 사용자에게 Copilot Chat 진입점이 표시될 수 있지만 테넌트 설정에 따라 에이전트 환경에 대한 액세스가 제한되거나 비활성화됩니다.

다음 표에는 사용자 라이선스 유형에 따른 에이전트 액세스가 요약되어 있습니다.

라이선스 모델 에이전트 액세스
라이선스가 있는 사용자 Microsoft 365 구독과 Copilot 추가 기능 라이선스(해당하는 경우 Microsoft 365 Copilot Business 및 E7 Frontier Suite 포함)가 모두 있어야 합니다. 지원되는 앱과 플랫폼에서 Copilot Chat 및 에이전트 환경에 대한 모든 권한을 갖습니다. 또한 이 라이선스를 사용하면 테넌트 데이터(SharePoint, Microsoft Graph)에 기반한 에이전트를 사용할 수 있으며 Copilot Studio에서 에이전트를 작성하는 데 필요합니다.
사용량 기반 청구(종량제 사용자) 종량제 청구가 사용하도록 설정된 테넌트에 속합니다(Copilot 크레딧으로 사용). 사용자는 전체 Copilot 라이선스 없이 Copilot Chat 및 에이전트에 액세스할 수 있습니다. 사용량 청구는 테넌트 데이터에 기반한 에이전트에게 적용되며, 공용 데이터 또는 지침에 기반한 에이전트는 무료로 사용할 수 있습니다. 에이전트 상호 작용 또는 기반과 같은 일부 고급 기능에는 추가 구성이 필요할 수 있습니다. Microsoft 365 관리 센터에서 Azure 구독 및 청구 정책을 설정해야 합니다. SharePoint 파일을 지식 원본으로 사용하는 에이전트의 경우 청구 정책이 SharePoint 에이전트 서비스에 연결 되어야 하며 사용자는 청구 정책에 할당된 보안 그룹에 있어야 합니다.
Copilot 추가 기능 라이선스가 없는 Microsoft 365 구독자 일부 앱에서 Copilot Chat 진입점이 표시될 수 있지만 테넌트 구성 및 출시 상태에 따라 액세스가 제한되거나 비활성화됩니다. 이러한 사용자는 에이전트 작성 또는 고급 에이전트 환경에 액세스할 수 없습니다.

다음 표에는 테넌트의 라이선스 및 사용량 청구 구성에 따라 사용자가 사용할 수 있는 에이전트 유형 및 에이전트 기능이 나열되어 있습니다. 사용량 청구 요금에 대한 자세한 내용은 청구 요금 및 관리 단원을 참조하십시오.

참고

사용량 기반 청구는 Microsoft 365 GCCH(정부 커뮤니티 클라우드 High) 및 GCC(정부 커뮤니티 클라우드) 환경에서 지원되지 않습니다.

기능 Copilot Chat(사용량 기반 청구 없음)* Copilot Chat(사용량 기반 청구)** Microsoft 365 Copilot(라이선스)
Microsoft 365 Copilot ✅ ✅ ✅
Copilot Studio ✅ ✅ ✅
선언적 에이전트
     사용자 지정 작업 ✅ ✅ ✅
     사용자 지정 지침 ✅ ✅ ✅
     코드 인터프리터 ✅ ✅ ✅
     이미지 생성기 ✅ ✅ ✅
     MCP 앱
(대화형 UI 위젯)
✅ ✅ ✅
     사용자 지정 지식:
웹 검색
✅ ✅ ✅
     사용자 지정 지식:
범위 웹 검색
✅ ✅ ✅
     사용자 지정 지식:
Copilot 커넥터
❌ ✅ ✅
     사용자 지정 지식:
SharePoint 데이터
❌ ✅ ✅
     사용자 지정 지식:
포함된 파일 콘텐츠
❌ ✅ ✅
     사용자 지정 지식:
Dataverse
❌ ✅ ✅
     사용자 지정 지식:
Email
❌ ❌ ✅
     사용자 지정 지식:
People
❌ ❌ ✅
     사용자 지정 지식:
Teams 메시지
❌ ❌ ✅
     사용자 지정 지식:
Teams 모임
❌ ❌ ✅
사용자 지정 엔진 에이전트 ✅ ✅ ✅

* 사용 제한은 포함된 모든 기능에 적용됩니다.

** 사용량 기반 청구 없이 사용자가 사용할 수 있는 지식 원본에 액세스하는 데 비용이 발생하지 않습니다.

참고

Microsoft 365 Copilot Chat 및 Microsoft 365 Copilot에서 웹 검색에 대한 데이터, 개인 정보 및 보안에 대한 자세한 내용은 웹 검색에 대한 데이터, 개인 정보 및 보안을 참조하세요.

참고

공유 테넌트 작업 데이터에 기반한 에이전트는 현재 Microsoft 365 GCC(정부 커뮤니티 클라우드), GCCH(정부 커뮤니티 클라우드 High) 또는 DoD(국방부) 환경에서 사용할 수 없습니다.

질문과 대답

Microsoft 365 개발자 프로그램 구독을 사용하여 Copilot을 사용하여 개발할 수 있나요?

예, Microsoft 365 개발자 프로그램 구독을 사용하여 에이전트를 빌드할 수 있습니다. 인스턴트 샌드박스를 프로비전하는 경우 추가 기능 구매가 활성화됩니다. 샌드박스 내에서 직접 Microsoft 365 Copilot을 비롯한 추가 서비스를 구매할 수 있습니다. 이 옵션을 사용하면 조직 데이터에 기반한 에이전트를 빌드하고 다른 향상된 기능에 액세스할 수 있습니다. 구성 가능한 샌드박스를 프로비전하는 경우 구독은 상거래를 지원하지 않으므로 Microsoft 365 Copilot 라이선스를 구매하거나 종량제 청구를 활성화할 수 없습니다. 에이전트 기능은 웹 검색 기반으로만 제한됩니다. 자세한 내용은 Microsoft 365 개발자 샌드박스 구독 설정을 참조하세요.

저는 ISV가 아니며 Microsoft 365 Copilot 라이선스도 없습니다. Microsoft 365 Copilot 개발 환경을 얻을 수 있나요?

Microsoft 365 구독이 있는 경우 제한된 기능으로 Microsoft 365 Copilot Chat에서 에이전트를 빌드하고 테스트할 수 있습니다. 조직 데이터에 기반한 에이전트를 빌드하려면 테넌트에서 종량제 청구를 사용하도록 설정하거나 Microsoft 365 Copilot 라이선스를 구매해야 합니다.

환경 준비 확인

환경은 다음과 같은 경우에 준비됩니다.

  • 선택한 모든 개발 도구는 의도한 기여자가 사용할 수 있습니다.
  • 개발 또는 테스트 테넌트 및 대상 Microsoft 환경에 액세스할 수 있습니다.
  • 필수 라이선스, 청구, 구독, 환경 및 지역이 구성되어 있습니다.
  • 애플리케이션 ID, 역할, 권한, 동의, 연결 및 비밀을 사용할 수 있습니다.
  • 필요한 데이터 원본, API, 원격 서비스 및 호스팅 환경에 연결할 수 있습니다.
  • 테스트 사용자 및 대표적인 비프로덕션 데이터를 사용할 수 있습니다.
  • 각 종속성에는 소유자가 있으며 해결되지 않은 차단기가 문서화되어 있습니다.

보안 및 개인 정보

Copilot은 기존 권한 및 정책을 사용하여 엔터프라이즈의 데이터 보안 및 데이터 개인 정보 보호에 대한 기존 약정을 기반으로 가장 관련성이 높은 정보를 제공합니다. Copilot이 조직 데이터를 사용하고 보호하는 방법에 대한 자세한 내용은 Microsoft 365 Copilot에 대한 데이터, 개인 정보 및 보안을 참조하세요. 다양한 Copilot 확장성 솔루션 개발에 대한 데이터 개인 정보 보호 및 보안 고려 사항은 Microsoft 365 Copilot 확장에 대한 데이터, 개인 정보 및 보안 고려 사항을 참조하세요.

다음 단계

플러그인에 빌드 또는 재사용 기능을 사용하여빌드 또는 재사용합니다. Work IQ Dev Tools를 선택한 경우 시작점에 따라 기존 에이전트 빠른 시작 을 계속하거나 새 플러그인을 만듭니다.