Microsoft 365 Copilot용 플러그 인 테스트 및 유효성 검사

플러그 인 패키지를 만들 때 생성한 정확한 버전이 있는 아티팩트를 테스트합니다. 패키지 & 테스트에서 구성 요소 증명 정보를 해당 ZIP에 연결하고, 지원되는 경로를 통해 설치하고, 클레임된 모든 Microsoft 환경에서 제공된 버전, 액세스 및 실제 런타임 동작을 확인합니다.

"이 구성 요소를 테스트하고, 정확한 참조를 패키징하고, 정확한 버전을 설치하고, 시나리오를 실행하고, 결과를 유지했습니다." 다음 증거로 마무리합니다. 성공적인 스키마 검사, 프로비전 명령 또는 그럴듯한 응답은 해당 체인을 설정하지 않습니다.

시작하기 전에

보유:

  • 알려진 테스트 데이터 및 예상 결과를 포함하여 완료된 구성 요소 및 통합 테스트.
  • 후보 ZIP, 해당 패키지 ID/버전 및 포함된 구성 요소 버전, 끝점 및 연결 참조입니다.
  • 개발 테넌트, 비프로덕션 데이터, 패키지의 구성 요소에 대해 지원되는 설치 경로 및 이를 사용할 수 있는 권한입니다.
  • 허용된 사용자와 제한된 사용자의 ID를 테스트합니다. 가용성 및 차단 테스트에 대해 권한 있는 관리자입니다.
  • 각 대상 환경에 필요한 라이선스, 로그인, 동의, 연결 및 외부 서비스.
  • 각 시나리오 및 ID에 대한 테스트 레코드 입니다.

테스트하기 전에 필요한 패키지, 설치, 액세스 및 런타임 검사와 각 결과를 설정하는 증거를 정의합니다. 런타임 클레임에 대한 구성 요소별 증거 기준 과 제공된 버전 확인에 설명된 설치 증거를 사용합니다.

패키지를 업로드하거나, 설치하거나, 동의하거나, 공유하거나, 관리 설정을 변경하기 전에 승인을 받습니다. 이러한 절차는 테넌트 상태를 변경합니다. 제어된 테스트 ID 및 대상 그룹을 사용합니다.

스키마 및 구성 요소 참조 유효성 검사

후보 ZIP을 수정하지 않고 엽니다. 해당 루트 manifest.json, recording id, version, 및 manifestVersion를 읽습니다. 다음 사항을 확인합니다.

  • 매니페스트는 경로에 필요한 Microsoft 365 앱 매니페스트 스키마 를 사용합니다.
  • 포함된 에이전트 정의 및 작업 매니페스트는 적용 가능한 스키마를 사용합니다. API 플러그인 매니페스트는 외부 레지스트리 플러그인이 아닌 에이전트 작업을 설명합니다.
  • 참조된 기술 폴더, 컴패니언 파일, 아이콘 및 도구 설명이 선언된 패키지 경로에 존재합니다.
  • 버전, 식별자, 엔드포인트 및 연결 참조가 구성 요소 테스트 레코드 및 의도된 환경과 일치합니다.
  • 자격 증명, 비밀, 로그 또는 관련 없는 테스트 파일이 포함되지 않습니다.

Work IQ Dev Tools의 경우 이러한 Windows 예제에서 Node.js 24.15+, npm 및 PowerShell 7+를 포함하여 문서화된 CLI 필수 구성 요소를 사용합니다. 기존 프로젝트에서 선택적 오프라인 원본 검사는 다음과 같습니다.

wiqd plugin validate --mode source --env "<test-environment>"

확인: 적용 가능한 소스 검사 통과 및 건너뛰거나 발견되지 않은 기능이 기록됩니다.

원본 모드는 저장된 선언적 에이전트 진단 및 기본 프로젝트 가드를 확인합니다. 앱 스키마, 기술 콘텐츠, 루트 agentConnectors[]또는 참조된 API/OpenAPI 콘텐츠의 유효성을 완전히 검사하지는 않습니다. 기술 전용 또는 커넥터 전용 프로젝트에는 적용 가능한 에이전트 점검이 있을 수 없습니다. 명시적으로 사용source: 기본 모드는 오프라인 검사가 아닌 패키지 유효성 검사입니다.

정확한 패키지 유효성 검사

여러 후보가 있는 빌드 디렉터리에 의존하는 대신 하나의 ZIP 파일을 명시적으로 선택합니다. PowerShell에서 예제 경로를 아티팩트로 바꿉니다.

$packageFile = (Resolve-Path '.\appPackage\build\<candidate>.zip').Path
Get-FileHash -LiteralPath $packageFile -Algorithm SHA256

확인: 확인된 파일이 의도된 후보입니다. 필요에 따라 로컬로 계산된 해시 를 유지하여 후속 변경 내용을 검색합니다. 로컬 해시는 호스트가 실행하는 바이트를 증명하지 않습니다.

  1. 인증된 유효성 검사 전에 의도한 Microsoft 365 ID로 로그인합니다.

    wiqd auth login --interactive
    wiqd doctor
    

    확인: 의도한 테넌트에 대해 인증 및 준비 검사가 성공합니다.

  2. 플랫폼 유효성 검사 서비스에 이 ZIP 파일을 업로드할 수 있는 승인을 얻어 다음을 실행합니다.

    wiqd plugin validate --mode package --package-file "$packageFile"
    

    확인: 이 정확한 ZIP 파일에 대한 결과는 필수 검사를 충족합니다. 반환된 변경할 수 없는 JSON 및 HTML 보고서를 유지합니다.

  3. 게시 경로에 추가 마켓플레이스 정책 및 증거 확인이 필요한 경우 다음을 실행합니다.

    wiqd plugin validate --mode marketplace --package-file "$packageFile"
    

    확인: 필수 패키지, 정책 및 증거 확인이 필수 필수 증거 누락 없이 통과합니다.

package marketplace 및 빌드된 ZIP 파일을 모두 사용하여 업로드하고 로그인이 필요할 수 있습니다. 빌드하거나 자동으로 로그인하지 않습니다. 또한 원본 프로젝트가 없는 ZIP 파일도 허용합니다. 마켓플레이스 모드는 정책 및 증거 확인을 추가합니다. 해당 보고서는 공식적인 스토어 또는 파트너 센터 승인이 아닙니다. 사용되지 않는 deep, static, 또는 manifest 모드 이름이 아닌 현재 WIQD 유효성 검사 계약을 따르세요.

명령의 종료 결과뿐만 아니라 발견 사항, 범위, 건너뛴 검사 및 필수 증거를 읽습니다. 지원되는 에이전트 도구 키트 패키지 경로의 경우 유효성 검사 규칙을 사용 하거나 atk validate --app-package-file-path <path>앱 유효성 검사에 설명된 대로 앱 패키지 유효성 검사를 사용합니다.

ZIP 파일에서 변경되는 사항이 있으면 새 후보를 만들고 유효성 검사를 반복합니다. 원격 서비스 변경에는 ZIP 파일이 변경되지 않은 경우에도 관련 런타임 재테스트가 필요합니다.

패키지 설치 또는 사이드로드

네이티브 Microsoft 365 앱 패키지를 수락하고 해당 구성 요소를 지원하는 경로를 사용합니다. WIQD 프로비전 설치 및 테스트 링크는 배포를 식별합니다. 열어도 최종 유효성이 검사된 ZIP이 설치되었다는 것은 확인되지 않습니다.

개인 정확한 ZIP 설치

해당 패키지 및 대상 환경이 지원되는 경우 CLI 설치, 인증 및 패키지 설치에 대한 Cowork 개인 사이드로드 절차를 따릅니다. Validate the exact package에서 선택한 정확한 파일을 scope의 --file-path 값으로 사용하여 $packageFile 전달 Personal 합니다.

확인: 의도한 계정에 대해 설치가 성공합니다. 반환된 TitleId 패키지 AppId ID/버전 및 설치 관리자 출력과 함께 저장합니다. 지원되는 환경에서 설치된 플러그 인이 예상되는 구성 요소 및 ID를 노출하고 필요한 연결이 완료되었는지 확인합니다.

정책이 개인 경로를 비활성화하거나 후보에 대해 경로가 지원되지 않는 경우 보안 제어를 변경하는 대신 승인된 호환 가능 경로를 사용합니다.

Cowork 패키지 업로드

지원되는 Cowork 패키지의 경우 플러그인 패키지 업로드 및 공유 지침을 따르세요. 정확한 유효성을 검사한 네이티브 Microsoft 365 ZIP 파일을 선택하고 테스트 ID 또는 명시적으로 권한이 부여된 테스트 대상 그룹에 대한 액세스를 제한합니다. Cowork에서 플러그 인 사용을 따라 플러그 인을 사용하도록 설정하고 새 대화에서 필요한 연결을 완료합니다.

확인: 선택한 파일 및 표시된 플러그인 ID가 후보 레코드와 일치합니다. 의도한 ID에 맞게 플러그 인이 설치되고, 예상 기술 및 커넥터 상태가 표시되며, 보호된 작업은 의도한 연결된 계정을 사용합니다.

외국 형식으로 업로드된 경우 자동으로 변환할 수 있습니다. 이러한 변환은 원래 Microsoft 365 ZIP이 변경되지 않고 테스트되었다는 증거가 아닙니다. 경로에서 변환하는 경우 아티팩트 및 유효성 검사 증거를 다시 설정합니다.

제공된 버전 확인

선택한 ZIP 및 매니페스트 id 를 version 성공한 설치, 의도된 계정 및 반환된 설치 ID에 연결하는 설치 레코드를 유지합니다. 문서화된 개인 사이드로드 경로의 경우 확인된 파일 경로, 후보의 매니페스트 메타데이터 및 및 를 포함하는 TitleId 설치 관리자 출력과 함께 명령을 유지합니다 AppId. 지원되는 네이티브 Cowork 업로드의 경우 표시된 플러그인 ID 및 테스트 계정으로 선택한 파일 및 성공적인 업로드/설치 레코드를 유지합니다.

해당 체인을 테스트된 후보에 대한 설치 증거로 사용합니다. 호스트 또는 관리 경로에 의해 노출된 버전 메타데이터를 후보와 연결하고 테스트 전에 불일치를 조사합니다. 호출과 별도로 설치 증거를 기록합니다.

인용된 개인 설치 단계는 유니버설 설치 버전 쿼리 또는 서버 쪽 패키지 해시를 문서화하지 않습니다. 이 절차에서는 둘 다 필요하지 않습니다. 설치 레코드는 호스트가 실행하는 바이트에 대한 독립적인 확인이 아니라 어떤 후보가 제출되어 성공적으로 설치되었는지 설정합니다. 릴리스 기준에 독립적인 호스트 측 버전 또는 바이트 확인이 필요한 경우 해당 증거를 확보합니다. 해당 부재는 확인되지 않은 상태로 유지되며 해당 릴리스 클레임을 차단합니다. 프로비저닝 링크, 플러그인 이름, 성공적인 응답 또는 로컬 해시만으로는 설치 체인이 설정되지 않습니다.

관리자 관리 후보의 경우, 현재 레지스트리 업로드 및 설치 프로시저를 따르고, 테스트 사용자를 scope하고, 허용된 아티팩트 및 설치 레코드를 보존합니다. 경로가 다른 아티팩트 형식을 허용하거나 유효성이 검사된 ZIP과의 관계를 설정할 수 없는 경우 아티팩트 바인딩 검사는 확인되지 않고 동등하지 않은 것으로 처리합니다.

패키지된 플러그인 테스트

이전 개발 배포가 아니라 설치된 후보로 전체 통합 시나리오 를 반복합니다.

  1. 클레임된 각 환경에서 새 대화를 시작합니다. 구성 요소 테스트와 동일한 ID 역할, 알려진 레코드, 입력 및 예상 결과를 사용합니다.

    확인: 설치하려는 구성 요소가 선택됩니다.

  2. 구성 요소별 증거를 수집합니다. 원격 호출의 경우 인증된 서비스 로그를 요청, 입력 및 반환된 데이터와 상관 관계를 지정합니다.

    확인: 호스트 증거는 해당하는 경우 선택되거나 로드된 기술을 식별합니다. 필수 도구 호출에는 상관 관계가 있는 호출 증거가 있으며 반환된 데이터는 응답에 기여합니다.

  3. 출력 파일 및 인용을 검사합니다. 해당 실패 및 경계 사례를 반복합니다.

    확인: 정확성, 액세스 경계, 승인 및 실패 동작은 미리 정의된 기준을 충족합니다.

릴리스 정보 기술의 경우 검사 기능, 수정 사항, 기타 및 약속된 파일을 다시 사용합니다 Added CSV export; Fixed duplicate rows; Updated help text. . MCP 조회의 경우 알려진 문제의 정확한 제목, 상태 및 URL을 서비스 로그와 비교합니다. 구성 요소별 증거 도구를 사용합니다. 에이전트 진단 경로만으로는 독립 실행형 설치된 플러그인이 실행되었는지 여부를 설정할 수 없습니다.

정확성과 호출 결과를 별도로 유지합니다. 필요한 검사에 대한 누락된 증거는 확인되지 않은 상태로 남아 있습니다. 사용할 수 없는 추가 진단은 확인된 실행 세부 정보 또는 자동 오류가 아닌 제한 사항으로 기록합니다. 둘 다 클레임할 때 Chat과 Cowork에서 별도로 검색, 연결, 선택, 런타임 테스트를 반복합니다.

인증 및 액세스 테스트

권한 있는 관리자가 사용자의 플러그인 가용성 설정 과 플러그인 , 기술, MCP 서버 관리를 통해 제어된 테스트 설정을 준비하도록 합니다. 원래 설정을 기록하고 승인된 테스트 후 복원합니다. 무해한 조회 또는 플러그 인에서 지원하는 것과 동일한 시나리오를 사용합니다. 기술 전용 시나리오의 서비스 동의와 같이 적용되지 않는 검사의 경우 기능을 추가하는 대신 이유를 기록합니다.

테스트 설정 및 조치 예상 결과
허용된 사용자 승인된 대상에 테스트 ID를 포함합니다. 해당 사용자로 로그인하고 필요한 동의/연결을 완료합니다. 지원되는 시나리오는 해당 사용자의 원본 권한 내에서 성공합니다. 호출 증거는 예상되는 기능을 식별합니다.
제한된 사용자 승인된 대상 그룹에 대한 가용성을 제한한 다음, 해당 대상 그룹 이외의 계정으로 테스트합니다. 사용자가 플러그 인을 사용할 수 없습니다. Copilot 채널에서 목록은 차단된 상태로 검색 가능한 상태로 유지될 수 있습니다. 적격 사용자가 액세스를 요청할 수 있습니다. 가시성만으로는 실패가 아닙니다.
동의 거부 기존 권한 부여 없이 테스트 ID/연결을 사용합니다. 작업에 필요한 동의를 거부하고 보호된 조회를 다시 시도합니다. 작업은 요청된 보호된 액세스 권한을 얻지 못합니다. 로그인/동의 오류를 기록하고 보호된 결과가 성공으로 표시되지 않는지 확인합니다. 관련 없는 허용 기능은 계속 작동할 수 있습니다.
차단 및 차단 해제 관리자가 후보에 대한 플러그인 또는 기술 차단 을 따르도록 합니다. 이전에 허용된 사용자와 요청을 반복한 다음 관리자가 플러그 인에 대해 차단 해제 를 선택하고 요청을 다시 반복하도록 합니다. 차단된 동안에는 플러그 인과 종속 에이전트를 사용할 수 없습니다. 연결된 MCP 서버/커넥터는 다른 플러그인에서 계속 사용할 수 있습니다. 차단을 해제한 후 이전에 허용된 사용자는 원래 가용성, 사용 권한 및 연결 요구 사항에 따라 플러그 인을 다시 사용할 수 있습니다.

게시자 범주 제한 은 별도의 컨트롤입니다. 하나를 테스트하는 경우 범주 및 해당 정책 결과를 기록합니다. 한 명의 후보를 테스트하기 위해 organization 전체 설정을 변경하지 마세요. 해당하는 경우 로그인 갱신/다시 연결, 원본 권한 및 누락된 연결을 테스트합니다.

Microsoft Entra 인증 코드 인증의 경우 동의 거부는 권한 부여 오류를 반환합니다. 모든 호스트에서 동일한 문구를 예상하는 대신 실제 공급자 오류를 사용합니다.

지원되는 환경 테스트

설치 및 제공된 버전 증거를 포함하여 환경, ID 역할 및 시나리오별로 결과를 기록합니다. Cowork의 통과는 Chat 또는 다른 호스트의 통과를 설정하지 않습니다. 각각에 대해 지원되는 경로를 사용합니다. 확인되지 않은 설치 또는 버전 증거로 인해 해당 환경에 대한 릴리스 클레임을 방지할 수 있습니다.

에이전트 품질 결과 기록

에이전트가 포함되어 있고 릴리스 기준에 품질 평가가 필요한 경우 해당 배포된 버전을 평가하고 해당 결과를 후보 레코드에 연결합니다. 에이전트 평가 개요를 시작합니다. 품질 점수는 패키지, 설치된 버전, 액세스 또는 호출 증거를 대체하지 않습니다.

후보에 대해 회귀 테스트 반복

기록된 기준 시나리오, 액세스 테스트, 실패 사례 및 설치된 후보에 대한 필요한 에이전트 평가를 다시 실행합니다. 기준선을 제거하지 않고 변경 사항별 사례를 추가합니다. 두 테스트 레코드 집합을 모두 유지하고, 결과를 비교하고, 승인 전에 회귀 또는 필수 확인되지 않은 검사를 resolve합니다.

게시, 롤아웃, 교체 및 롤백 결정을 포함한 기준 준비 및 업데이트 수명 주기를 위해 플러그 인 또는 에이전트 모니터링, 업데이트 및 사용 중지를 따릅니다. 자동 업그레이드, 할당 보존 또는 특정 재동의 트리거를 가정하지 마세요. 롤아웃 후에는 제공된 버전 및 런타임 확인을 반복합니다.

릴리스 준비 확인

패키지 ID 및 버전, 정확한 ZIP 파일 및 선택적 해시, 구성 요소 버전 및 엔드포인트, 환경, 테스트 ID 역할, 시나리오, 예상 및 실제 결과, 삭제된 호출 증거, 상태 및 소유자를 사용하여 공유 테스트 레코드를 완료합니다. 유효성 검사 보고서와 설치 및 버전 증거를 첨부합니다.

다음 결과 하나를 할당합니다.

  • 준비 - 정확한 후보는 완전한 증거와 해결되지 않은 릴리스 차단 요소 없이 필요한 모든 검사를 통과했습니다.
  • 차단됨 - 아티팩트 바인딩, 제공된 버전, 액세스 또는 호출을 포함하여 필요한 검사가 실패했거나 확인되지 않은 상태로 남아 있습니다.
  • 제한 사항이 있는 준비 완료 - 필수 검사를 통과했습니다. 나머지 비차단 제한 사항은 문서화되고, 수락되었으며, 공개하기에 적합합니다.

테스트 전에 정의된 필수 검사 및 증거 기준을 적용합니다. 허용된 진단 제한은 누락된 필수 증거를 합격으로 전환할 수 없습니다. 필요한 검사에 이미 충분한 증거가 있는 경우 추가 진단은 필수가 아닙니다. 각 차단자에 대해 소유자 및 해결 방법을 기록합니다. 아티팩트가 변경되면 새 후보를 만들고, 다시 설치하고, 영향을 받는 테스트와 회귀 테스트를 반복합니다.

다음 단계

필요한 증거가 완성되면 게시 & 배포를 계속합니다.