기존 선언적 에이전트의 로컬 소스와 함께 Work IQ Dev 도구를 사용하여 플러그 인으로 유효성을 검사, 프로비저닝, 패키징 및 공유할 수 있습니다. 이 빠른 시작은 새 에이전트 스캐폴드가 아닌 기존 원본 프로젝트에서 시작합니다.
이 연습에서는 새 에이전트를 만들거나 설치된 에이전트에서 원본을 재구성하지 않습니다. 대신 새 플러그인을 시작하는 경우 Work IQ Dev 도구를 사용하여 플러그인 빌드를 따르세요.
팁
Watch Work IQ Dev Tools는 프롬프트에서 Copilot 플러그 인을 빌드하고 대화형 데모에서 에이전트 스토어에 게시합니다.
필수 구성 요소
- 활성 Copilot 구독이 있는 GitHub Copilot CLI
- GitHub Copilot CLI용 WIQD 코딩 도우미 플러그 인(이 섹션의 설치 명령 참조)
- Node.js 24.15 이상 및 npm, 사용자
PATH또는 에서 사용 가능, WIQD CLI 및 설치 스크립트에 대해 - PowerShell 7 이상(Windows만 해당)
- Copilot에 액세스할 수 있는 Microsoft 365 계정
- 테넌트에서 사용자 지정 앱 업로드 사용
- 지원되는 선언적 에이전트 원본 프로젝트
GitHub Copilot CLI를 설치한 후 WIQD 코딩 도우미 플러그 인을 설치합니다.
copilot plugin install wiqd@awesome-copilot
또는 WIQD 마켓플레이스를 추가하고 여기에서 플러그인을 설치합니다.
copilot plugin marketplace add microsoft/wiqd
copilot plugin install wiqd@wiqd
설치 스크립트를 사용하여 WIQD CLI를 설치합니다.
설치 후 새 GitHub Copilot CLI 세션을 시작합니다.
코딩 도우미 플러그인은 작성 지침을 제공합니다. CLI는 wiqd 설치하지 않습니다. 유효성 검사 및 수명 주기 명령을 실행하기 전에 CLI를 별도로 설치합니다. 를 사용하여 wiqd --version CLI 설치를 확인하고 전제조건을 검사합니다.wiqd doctor
지원되는 시작 프로젝트가 있는지 확인
로컬 선언적 에이전트 원본 프로젝트의 루트 폴더에서 시작합니다. 폴더에는 최소한 다음이 포함되어야 합니다.
contoso-support-agent/
|-- appPackage/
| |-- manifest.json
| |-- declarativeAgent.json
| `-- <the instruction and action files referenced by the manifests>
`-- <a supported lifecycle file>
수명 주기 파일은 , , m365agents.local.ymlteamsapp.yml, 또는 teamsapp.local.yml일 수 있습니다m365agents.yml. 프로젝트에는 다른 폴더와 환경 파일이 포함될 수 있습니다.
이 빠른 시작은 다음과 같은 경우에는 적용되지 않습니다.
- 게시된 에이전트 또는 설치된 패키지만 있고 로컬 소스 프로젝트가 없습니다. Work IQ Dev 도구는 배포된 타이틀에서 원본 프로젝트 재구성을 지원하지 않습니다. 원본 원본 리포지토리를 복구하거나 원본 작성 도구를 사용합니다.
- 에이전트는 Agent Builder 또는 Copilot Studio와 같은 관리되는 작성 환경에만 존재합니다. 해당 도구의 게시 및 공유 절차를 사용합니다.
- 사용자 지정 엔진 에이전트가 있습니다. 이 Work IQ Dev Tools 경로는 선언적 에이전트를 지원합니다.
- 에이전트 패키지
.zip만 있습니다. 수명 주기 명령에는 원본 프로젝트와 해당 수명 주기 파일이 필요합니다.
기존 프로젝트가 없는 경우 WIQD 빠른 시작 부터 시작하여 플러그 인을 만들고 선언적 에이전트를 추가합니다. WIQD는 지원되는 시나리오에 권장되는 프로 코드 시작점입니다.
참고
wiqd plugin import지원되는 가져오기는 Open 플러그인, Claude 플러그인 또는 커서 플러그인 형식을 지원합니다. 기존 Microsoft 365 선언적 에이전트 프로젝트 또는 패키지를 가져오지 않습니다. 자세한 내용은 가져오기/내보내기(interop)를 참조하세요.
플러그인 만들기
아직 설치하지 않았다면 Work IQ Dev Tools를 설치합니다.
플러그 인을 만들려는 디렉터리에서 CLI를 열고 다음 명령을 사용하여 로그인합니다.
wiqd auth login --interactiveCLI에서 명령을 사용하여 GitHub Copilot을 시작합니다.
copilotGitHub Copilot에 기존 선언적 에이전트, 기술 또는 MCP 서버를 사용하여 플러그 인을 만들도록 요청합니다. 예를 들면 다음과 같습니다.
Create a plugin named My Plugin by using the agent in "..\My Agent"
플러그 인 프로젝트 유효성 검사
플러그 인을 프로비전하거나 패키징하기 전에 오프라인 원본 유효성 검사를 명시적으로 선택합니다. GitHub Copilot CLI에서 다음을 질문합니다.
Validate the plugin source offline in the dev environment
플러그인 프로비저닝
중요
이 예제에서는 표준 공유 dev 환경을 사용합니다. 공유를 프로비저닝하기 전에 (기본값env)에서 environmentFolderPathAGENT_SCOPE=shared 유효한 수명 주기 구성 및 선택한 환경 파일을 확인하세요. 단독으로 명명된 dev 환경은 공유 scope를 설정하지 않습니다. 프로비저닝, 패키징, 유효성 검사 및 공유를 위한 동일한 환경을 유지합니다.
GitHub Copilot에 플러그 인을 프로비전하도록 요청합니다.
Provision the plugin using the dev environment
프로비전이 완료될 때까지 기다립니다. 프로비저닝은 Copilot Chat에서 모든 플러그 인 기능을 사용할 수 있음을 설정하지는 않습니다. 지원은 구성 요소 및 대상 Microsoft 365 환경에 따라 달라집니다.
플러그인 패키지
GitHub Copilot에 플러그 인을 패키징하도록 요청합니다.
Package the plugin using the dev environment
중요
플러그인을 패키지하기 전에 프로비전해야 합니다. 프로비저닝하기 전에 패키지를 만들면 결과 패키지가 유효하지 않습니다.
패키지 유효성 검사
패키징 후 생성된 ZIP을 찾아 파일이 있는지 확인합니다. GitHub Copilot CLI에서 실제 경로를 제공하고 다음을 물어보세요.
Validate this existing plugin ZIP in package mode using the dev environment
패키지 유효성 검사는 자동 빌드가 아니라 를 통해 --package-file제공하는 기존 ZIP을 사용합니다--mode package. 반환된 판정 및 결과를 검토합니다. 종료 코드 0 는 선택한 검사가 통과되었음을 의미합니다. 경고는 계속 보고할 수 있습니다. 차단 결과 또는 불완전한 결과는 통과가 아니며 패키지 유효성 검사는 런타임 동작을 증명하지 않습니다.
현재 유효성 검사 모드는 source, , package및 marketplace입니다.
source명시적 오프라인 검사입니다. 기본값인 package에는 기존 ZIP이 필요하고 캡처된 복사본을 Microsoft 365 유효성 검사 서비스에 업로드하며 인증이 필요할 수 있습니다.
marketplace 정책 및 증거 확인을 추가합니다. 공식 스토어 승인이 아닙니다. 유효성 검사는 자동으로 ZIP을 빌드하거나, 사용자가 로그인하거나, 플러그인을 프로비저닝하지 않습니다. 자세한 내용은 유효성 검사 및 MVL을 참조하세요.
플러그 인 공유
이제 GitHub Copilot에 organization 내부의 특정 사용자 또는 전체 organization과 플러그 인 배포를 공유하도록 요청할 수 있습니다. 공유하기 전에 선택한 환경에서 확인합니다 AGENT_SCOPE=shared . 공유 대상 그룹(--scope users또는 --scope tenant)은 배포 scope를 변경하지 않습니다.
Share the plugin with AmberR@contoso.com using the dev environment
또는:
Share the plugin with my organization using the dev environment
중요
사용자 지정 플러그인 공유는 플러그인 공유를 허용하거나 차단하는 organization의 설정에 따라 달라집니다. 이 단계에서 오류가 발생하면 관리자에게 검사하세요. 자세한 내용은 에이전트 공유 및 게시 설정을 참조하세요.
organization의 플러그인 레지스트리에 플러그인 게시
플러그인을 공유하는 대신 플러그인을 organization의 플러그인 레지스트리에 게시하도록 요청할 수 있습니다. organization 관리자는 플러그인을 검토하고 요청을 승인하거나 거부할 수 있습니다.
Submit my plugin to the organization catalog for admin approval using the dev environment
공유는 직접 액세스 권한을 부여합니다. 카탈로그 제출은 별도의 작업이며 관리자 승인 또는 완료된 사용자 설치가 아닙니다.
패키지 삭제(선택 사항)
이 플러그 인이 테스트 플러그 인인 경우 GitHub Copilot에 플러그 인을 제거하도록 요청합니다. 이 작업을 수행하면 프로비저닝된 클라우드 리소스가 삭제됩니다.
Delete the plugin using the dev environment