준비하는 동안 기능 선택 항목을 빌드 계획으로 전환합니다. 전문 개발을 위한 Work IQ Dev 도구로 시작하고, 문서화된 환경을 선택하고, 시나리오에서 필요한 경우에만 Microsoft 365 Agents Toolkit 또는 SDK를 추가합니다. 각 구성 요소에 대한 도구, 소스 위치, 소유자 및 필수 구성 요소로 마무리합니다.
소유한 앱에 Copilot 기능을 빌드하려면 대신 Copilot 기반 앱 빌드를 따르세요.
Work IQ Dev 도구로 시작
Work IQ Dev Tools 는 지원되는 플러그인 시나리오에 대한 기본 전문가-개발자 경로입니다. 안내 워크플로를 사용하여 플러그인을 만들고 작성한 다음 유효성을 검사, 프로비전, 패키징 및 공유합니다. 반복 가능한 실행 또는 스크립팅이 필요한 경우 직접 CLI 명령을 사용합니다.
원본을 소유하는 명령 표면을 선택합니다.
| 원본 및 작업 | 여기에서 시작 | 경계 |
|---|---|---|
| 지원되는 기술, 원격 MCP 서버용 플러그인 커넥터 또는 선택적 선언적 에이전트가 포함된 새 플러그인 | WIQD를 사용하여 플러그인 빌드 |
wiqd plugin add agent 에이전트 구성 요소의 스캐폴드; 기존 에이전트 프로젝트를 가져오지 않습니다. |
| 기존 선언적 에이전트 원본 프로젝트 | 에이전트 구성 요소 수명 주기 | 해당 프로젝트에 대해 문서화된 wiqd agent 워크플로를 사용합니다. |
| 지원되는 Open 플러그인, Claude 플러그인 또는 커서 플러그인 소스 | WIQD 가져오기 및 내보내기 | 형식 변환은 동등한 런타임 동작 또는 호스트 지원을 설정하지 않습니다. |
| 선택한 사용자에 대해 테스트된 공유 배포 | WIQD를 사용하여 플러그인 빌드 | 공유는 액세스 권한을 부여합니다. organization 카탈로그 제출이 아닙니다. |
| organization 카탈로그에 대한 테스트된 플러그 인 | 게시 및 기존 프로젝트 |
wiqd plugin publish 공개 Marketplace 인증이 아닌 관리자 승인을 위해 제출합니다. |
오프라인 검사에 명시적 원본 유효성 검사를 사용합니다. 기본 유효성 검사 모드는 기존 ZIP에 대한 패키지 유효성 검사입니다. 패키지를 업로드하고 인증을 요구할 수 있습니다. 두 모드 모두 의도한 환경에서 실제 기능을 테스트하는 것을 대체하지 않습니다.
환경 선택
다음 표에는 문서화된 WIQD 경로가 나열되어 있습니다. 포괄적인 호환성 매트릭스는 아닙니다.
| 환경 | 용도에 사용 | 설정 및 제약 조건 |
|---|---|---|
| GitHub Copilot CLI | WIQD 코딩 도우미 플러그인을 사용한 단계별 플러그인 작성 | 호스트 및 해당 WIQD 마켓플레이스 플러그 인을 설치한 다음 새 세션을 시작합니다. 마켓플레이스 플러그인이 WIQD CLI를 설치하지 않습니다. |
| Claude 코드 | 해당 호스트에 대한 WIQD 플러그 인을 사용한 단계별 작성 | WIQD 설치의 호스트별 마켓플레이스 단계를 따릅니다. |
| 직접 명령줄 | 유효성 검사 및 반복 가능한 플러그인 또는 에이전트 수명 주기 명령 | 별도의 CLI를 설치합니다. 설치 스크립트 경로에는 Node.js 24.15 이상과 npm; Windows에는 PowerShell 7 이상이 필요합니다. |
| Visual Studio Code | 선택적 WIQD 확장을 통한 프로젝트 편집 및 매니페스트 진단 | 현재 편집기 통합에 대한 WIQD 설치 를 따릅니다. 편집기 진단은 최종 패키지 유효성 검사를 대체하지 않습니다. |
| 신뢰할 수 있는 CI/CD 파이프라인 | 선택한 릴리스의 인증 제한에 따라 코어 지원 프로비전, 게시 및 공유 작업 | 플러그인 CI/CD 지침 및 파이프라인 인증을 따릅니다. 에이전트-프로젝트 파이프라인 예제는 플러그 인을 인식하는 파이프라인 생성기가 아닙니다. |
로컬 테넌트 작업의 경우 프로비저닝하기 전에 대화형으로 로그인합니다. 자동화를 위해 게시된 신뢰할 수 있는 파이프라인 계약 및 비밀 저장소를 사용합니다. CI에서 대화형 wiqd auth login 을 실행하거나 신뢰할 수 없는 끌어오기 요청 작업에 자격 증명을 노출하지 마세요. 핵심 수명 주기 인증은 Work IQ 쿼리, 평가 또는 기타 확장을 인증하지 않습니다. 에이전트 프로젝트 명령 본문을 변경되지 않은 상태로 플러그인 프로젝트에 적용하지 마세요.
계정, 테넌트 및 도구 필수 구성 요소의 경우 개발 환경 설정을 사용합니다. 코딩 도우미는 파일 작성을 도울 수 있지만 구성 요소의 작성 도구, 런타임, 권한 또는 게시 요구 사항을 대체하지는 않습니다.
필요한 경우 구성 요소별 도구 추가
선택한 구성 요소에 특정 작성 또는 프로젝트 컨트롤이 필요한 경우 이러한 제품 경로를 사용합니다. 도구를 호환 가능한 패키지 형식으로 취급하는 대신 제품 자체의 절차를 따릅니다.
| 요구 사항 | 도구 또는 제품 전달 |
|---|---|
| 지원되는 선언적 에이전트 프로젝트, 매니페스트 또는 통합의 하위 수준 제어 | JSON 또는 TypeSpec을 사용하는 Microsoft 365 에이전트 도구 키트 |
| 안내형 관리형 선언적 에이전트 작성 환경 | 에이전트 빌더; 지원되는 기술에 대해 자체 기술 절차 사용 |
| 관리되는 워크플로, Power Platform 커넥터, 환경 및 로우코드 에이전트 논리 | Copilot Studio; 해당되는 경우 Microsoft 365 게시 채널 사용 |
| 선택한 SharePoint 사이트 또는 문서 라이브러리에 기반한 에이전트 | 선택한 형식에 대한 SharePoint 에이전트 지침 및 업그레이드 지침 |
| Copilot Cowork용 기술 또는 플러그 인 커넥터 | 제품별 파일, 런타임 및 테스트 요구 사항에 맞는 Copilot Cowork용 플러그 인 빌드 |
| 외부 콘텐츠를 Microsoft Graph로 수집하는 Copilot 커넥터(동기화됨) | 첫 번째 사용자 지정 Copilot 커넥터 빌드 |
| 선언적 에이전트의 원격 MCP 작업 | MCP 서버에서 플러그인 빌드 |
Copilot Studio의 에이전트 빌더는 현재 기술 추가를 지원하지 않습니다. Microsoft 365 Copilot의 별도의 에이전트 빌더 환경에서 기능 집합을 유추하지 마세요. 독립 실행형 Copilot Studio 에이전트는 플러그 인이 아닌 에이전트 레지스트리에 표시됩니다.
가져온 Cowork 프로젝트의 경우 패키징 또는 게시를 계획하기 전에 Cowork 개발 가이드의 현재 제한 사항을 검사합니다.
자체 오케스트레이션, 모델, 호스팅 또는 런타임이 필요한 경우 앱 경로 에서 SDK를 사용합니다. Microsoft 365 서비스도 사용한다는 이유만으로 사용자 지정 엔진 앱 개발을 플러그 인 워크플로로 이동하지 마세요.
빌드 계획 기록
각 구성 요소에 대해 다음을 기록합니다.
- 작업, 의도된 환경 및 문서화된 구성 요소 형식입니다.
- 새 구성 요소를 빌드하든, 기존 소스를 구성하든, 제품별 재사용 워크플로를 사용하든 상관 없습니다.
- 작성 도구, 원본 리포지토리 또는 관리 환경, 책임 소유자입니다.
- 필수 계정, 구독, 권한, 서비스 및 테스트 사용자.
- 아티팩트를 생성하는 도구와 이를 수락하는 배포 메서드입니다.
- 패키지 & 테스트 전에 필요한 런타임 테스트 및 증거입니다.
공유 패키지가 모든 곳에서 동일한 환경을 의미하지는 않습니다. 지원되는 기능, 가용성 및 필요한 설정은 제품, 게시 경로 및 출시에 따라 다릅니다.
다음 단계
플러그인에 빌드 또는 재사용 기능을 사용하여빌드 또는 재사용합니다. 새 플러그인을 만들려면 WIQD를 사용하여 플러그인 빌드를 따르세요. 선언적 에이전트 원본이 이미 있는 경우 기존 선언적 에이전트를 플러그 인으로 패키징합니다.