플러그인 구성 요소를 함께 테스트

플러그인 패키지에 기술, 원격 MCP 커넥터, 선언적 에이전트(포함된 경우)가 포함되어 있거나 무엇을 참조하는지 테스트합니다. 이 패키지 & 테스트 태스크는 릴리스 아티팩트를 만들기 전에 구성 요소 동작 및 통합을 설정합니다. 최종 패키지 유효성 검사, 설치 및 릴리스 환경 검사는 플러그 인 테스트 및 유효성 검사에서 따릅니다. 구성 요소에 대한 테스트를 선택하고 테스트 레코드를 유지한 다음 패키지하기 전에 완료합니다.

테스트 선택

통합 시나리오에서 구성 요소 확인

플러그인에서 테스트 대상 구역
에이전트 유무에 관계없이 플러그인 수준의 기술 Cowork 개발 세션, Chat 기술 선택 지원 기술 테스트
원격 MCP 서버를 가리키는 플러그 인 커넥터 Inspector를 클릭한 다음 Cowork의 플러그인을 통해 동일한 작업을 수행합니다. 원격 MCP 커넥터 테스트
선언적 에이전트(포함된 경우) Work IQ Dev Tools ask 명령 및 DevUI 포함된 선언적 에이전트 테스트
솔루션에서 사용하는 종속성 커넥터 진단, 통합 작업 반복 테스트 종속성

테스트 중인 커넥터 파악

  • 플러그인 커넥터: 앱 매니페스트 agentConnectors[] 항목입니다. 이 문서에서는 원격 MCP 종류를 테스트합니다. 패키지는 서버를 참조합니다. 실행 중인 서비스가 포함되어 있지 않습니다.
  • Copilot 커넥터(동기화됨): Microsoft Graph로 정보를 수집합니다. 수집 및 후속 검색을 종속성으로 테스트합니다.
  • Copilot 커넥터(페더레이션): 연결된 ID에서 라이브 데이터를 검색합니다. 라이브 액세스를 수집과 별도로 테스트합니다.
  • Power Platform 커넥터: Copilot Studio 도구입니다. 테스트해도 해당 에이전트가 레지스트리 플러그인인지 확인되지 않습니다.

플러그 인 작성 참조는 기존 OpenAPI 사용자 지정 커넥터 참조에 대한 명시적 경로도 문서화합니다. 해당되는 경우 해당 경로의 요구 사항을 사용하세요. 이 문서의 MCP 절차에서는 해당 커넥터 종류를 테스트하지 않습니다.

결과를 판단하는 방법

각 구성 요소를 독립적으로 확인한 다음 구성 요소를 함께 사용하는 작업을 실행합니다. 성공적인 직접 서비스 호출은 서버 동작을 설정합니다. 통합 작업은 반환된 데이터의 선택, 입력, 인증 및 사용을 설정합니다.

테스트하기 전에 각 구성 요소 및 대상 환경에 필요한 검사와 허용 가능한 증거를 정의합니다. 구성 요소 선택, 올바른 결과 및 액세스 경계를 포함합니다. 주장에 적합한 증거 사용:

구성 요소 또는 클레임 보관할 증거
스킬 선택 및 동작 선택되거나 로드된 기술과 필요한 출력 및 파일을 식별하는 호스트 증거입니다. Cowork의 측면 패널에서기술은 로드된 기술을 식별합니다. 명시적 선택은 자동 호출을 설정하지 않습니다.
원격 MCP 호출 호스트 요청과 상관 관계가 있는 인증된 서비스 로그는 작업, 입력 및 결과를 식별합니다. 직접 Inspector 호출은 플러그 인을 통해 호출을 설정하지 않습니다.
포함된 에이전트 배포된 에이전트 ID, 요청 및 응답, 사용 가능한 기능 선택, 검색 및 인용 진단. 에이전트 진단만으로는 포함된 모든 기술 또는 스크립트의 호출을 설정할 수 없습니다.
기술 스크립트 실행 노출된 경우 실행 진단입니다. 필수 출력 파일은 특정 스크립트가 실행되었다는 증거가 아니라 출력 결과를 설정합니다. 해당 스크립트의 실행이 릴리스 요구 사항인 경우 이를 입증하는 증거를 확보합니다.
  • 응답 정확성 은 호출 증거와 별도로 판단합니다. 에이전트는 기술을 로드하지 않고도 그럴듯한 릴리스 정보를 생성할 수 있습니다.
  • 필수 검사에 대한 누락된 증거는 확인되지 않은 상태로 유지되며 준비 상태를 차단합니다. 진단을 사용할 수 없기 때문에 필수 검사를 약화시키지 마세요.
  • 호스트가 추가 진단 세부 정보를 노출하지 않는 경우 세부 정보가 확인되었다고 주장하지 않고 해당 제한을 기록합니다. 증거가 이미 필요한 검사를 충족하는 경우 사용할 수 없는 진단은 별도의 차단 요소가 아닙니다.
  • 자동 대체 또는 불완전한 결과를 실패로 처리합니다.
  • 자격 증명이 아닌 승인된 저장소에 삭제된 증거를 저장합니다. 에이전트 스냅샷에는 중요한 콘텐츠가 포함될 수 있습니다.

필수 구성 요소 및 알려진 테스트 데이터

기존 플러그 인 프로젝트, 개발 테넌트, 알려진 테스트 ID 및 비프로덕션 데이터를 사용합니다. 지원하려는 환경과 Microsoft 환경을 선택합니다. 테스트 전에 필요한 로그인, 동의, 연결 및 외부 서비스에 권한을 부여합니다.

다음 명령의 경우 Work IQ Dev Tools를 설치합니다. CLI에는 Node.js 24.15+ 및 npm이 필요하며 Windows에는 PowerShell 7+가 필요합니다.

준비하다:

  • 알려진 레코드: 테스트 리포지토리의 문제 123. 정확한 제목, 상태 및 URL이 원본에서 기록되었습니다.
  • 기술 입력:Added CSV export; Fixed duplicate rows; Updated help text. 릴리스 정보 기술의 경우 각각 기능, 수정 사항 및 기타와 함께 약속된 파일 또는 스크립트 생성 콘텐츠를 기대합니다.

예제 이름, ID 및 자리 표시자를 바꿉니다. 테넌트 명령 전에 로그인 및 준비 상태 검사:

wiqd auth login --interactive
wiqd doctor

확인: 의도한 테넌트에 대한 로그인 및 준비 상태 확인이 성공합니다.

선택적 도우미 프롬프트의 경우 GitHub Copilot CLI를 설치합니다. WIQD 가이드 플러그인이 아직 설치되지 않은 경우 다음 명령을 실행한 다음 기존 플러그인 프로젝트에서 새 세션을 시작합니다.

copilot plugin install wiqd@awesome-copilot
copilot plugin list --json
copilot

확인: 인벤토리에 설치되고 활성화된 WIQD 가이드가 표시됩니다. 기존 설치는 중복 항목을 추가하는 대신 설치 가이드를 따라야 합니다. 이 가이드 플러그 인은 WIQD CLI를 설치하지 않습니다. 도우미 프롬프트를 코딩 도우미 세션에 붙여넣습니다. deployed-agent 요청은 대신 포함된 선언적 에이전트 테스트의 옵션을 사용합니다-q.

기술 테스트

플러그인 구성 요소: app-manifest agentSkills를 통해 등록된 플러그인 수준 기술입니다.

이것이 증명하는 것: 의도한 기술은 개발 배포에서 예상되는 출력을 로드하고 생성합니다.

포장 후에도 아직 증명해야 할 부분: 정확한 아티팩트는 유효성을 검사하고, 배포 경로를 통해 설치되며, 클레임된 모든 환경에서 실행됩니다.

보관할 증거: 배포/버전, 로드된 기술, 입력, 출력 파일 및 사용 가능한 원격 통화 로그.

개발 배포에 Copilot Cowork를 사용합니다. 사용 가능한 경우 실제 인쇄된 설치/테스트 링크를 다시 사용합니다.

  1. 프로비전이 필요한 경우 먼저 구성된 environmentFolderPath 환경에서 선택한 환경 파일을 검사 m365agents.yml 합니다. 테넌트 및 유효 AGENT_SCOPE여부를 확인합니다. 표준 스캐폴드는 personal scope 및 dev shared scope에 사용 local 되지만 이름만으로는 증거가 되지 않습니다. 제안된 변경 사항을 승인한 후 다음을 실행합니다.

    wiqd plugin provision --env "<test-environment>"
    

    확인: 프로비전이 성공하고 배포의 설치/테스트 링크가 반환됩니다.

  2. 반환된 링크를 열고 테스트 ID를 사용하여 설치 및 필수 연결을 완료합니다. Cowork 세션을 시작하고 알려진 입력을 사용하여 릴리스 정보를 요청합니다.

    확인: 스킬은 세션 사이드 패널의 스킬 아래에 표시됩니다.

  3. 출력 폴더>미리 보기 또는 다운로드 아래에 있는 응답 및 파일을 검사합니다.

    확인: 모든 변경 내용이 의도한 범주에 표시되고 약속된 파일이 요구 사항과 일치합니다.

  4. 이 배포 및 알려진 입력을 사용하여 지원되는 각 환경에서 검색 및 호출 테스트를 실행합니다.

    확인: 검색, 선택 및 실패 동작은 해당 경험에 대한 기술의 요구 사항을 충족합니다.

개인적으로 업로드한 기술은 플러그인과 다른 등록을 agentSkills테스트합니다. 에이전트 연결 기술은 선언적 에이전트 매니페스트에서 대신 사용합니다 agent_skills . 로드된 기술 증거는 스크립트별 실행을 설정하지 않습니다.

문서화된 수명 주기에서 프로비전은 선택한 scope에서 테넌트 배포를 만들거나 업데이트하고 환경 바인딩을 작성합니다. 기존 리소스 ID를 다시 사용하면 현재 사용자에게 영향을 줄 수 있습니다. 변경에 권한을 부여합니다. 프로비전은 별도의 게시 또는 공유 명령을 실행하지 않습니다. 설치 링크는 레지스트리 게시, 대상 그룹 가용성 또는 최종 ZIP 설치를 증명하지 않습니다. 게시 & 배포 및 해당 승인, 설치, 동의 및 연결을 포함하여 관리& 사용할 수 있도록 개별적으로 진행합니다.

GitHub Copilot CLI를 사용하시겠습니까?

Help test <skill-name> in this plugin's existing Cowork development deployment.
Reuse its printed install link. Ask before provisioning; inspect the actual
environment scope first. Don't publish or share. Request release notes for
"Added CSV export; Fixed duplicate rows; Updated help text." Compare categories
and promised files; test missing input. Guide explicit/automatic Chat selection
if supported. Let me operate inaccessible UI and handle sign-in/consent.
Show actual evidence and ask before installs, exposure, or external changes.

원격 MCP 커넥터 테스트

플러그인 구성 요소:agentConnectors[] 원격 MCP 서비스를 가리키는 항목입니다.

이것이 증명하는 것: 서버 동작이 독립적으로 작동한 다음 개발 플러그 인을 통해 인증된 사용입니다.

포장 후에도 아직 증명해야 할 부분: 커넥터 선언, 연결 설정 및 런타임 호출은 설치된 정확한 아티팩트에서 작동합니다.

보관할 증거: 엔드포인트/버전, 도구 스키마, 입력/결과, ID 및 상관 관계 호스트/서버 레코드.

신뢰할 수 있는 스트리밍 가능 HTTP 엔드포인트, 해당 인증 세부 정보 및 안전한 읽기 전용 작업인 Node.js 22.19.0+와 함께 MCP Inspector 를 사용합니다.

  1. Launch Inspector, 예제 URL 대체:

    $serverUrl = 'https://your-server.example/mcp'
    npx @modelcontextprotocol/inspector --server-url "$serverUrl" --transport http
    

    확인: 인증이 완료되고 예상된 서버 ID 및 기능이 나타납니다.

  2. 도구를 나열하고 조회 작업을 선택하고 알려진 레코드에 대한 스키마 정의 필드를 입력하고 실행합니다.

    확인: 스키마 및 반환된 제목, 상태 및 URL이 예상과 일치합니다.

  3. 존재하지 않는 레코드와 제한된 ID를 사용하여 반복합니다.

    확인: 레코드 누락 동작은 조치가 취할 수 있으며 승인되지 않은 콘텐츠는 액세스할 수 없습니다.

  4. 필요한 경우 기술 테스트의 프로비저닝 단계를 사용하여 개발 플러그인의 Cowork 설치 및 테스트 링크를 엽니다. 커넥터 전용 프로젝트에는 기술이 필요하지 않습니다. 연결 설정을 완료하고 동일한 레코드를 요청합니다. 기술이 커넥터를 사용해야 하는 경우 해당 요청으로 호출합니다.

    확인: 인증된 서비스 로그에는 예상 작업 및 입력이 표시되고 반환된 값은 세션 결과와 일치합니다.

  5. 승인된 쓰기 작업은 취소를 포함하여 일회용 레코드에 대해서만 테스트합니다.

    확인: 승인된 변경 내용은 요청과 일치하며 취소하면 원본 데이터는 변경되지 않은 상태로 유지됩니다.

구성 요소 구성의 엔드포인트 및 인증 참조를 실제로 실행된 것과 비교합니다. 해당 도구 설명 요구 사항을 포함하여 커넥터 요구 사항을 따르십시오. 서버 성공만으로는 호스트 연결 준비 상태가 설정되지 않습니다.

로컬 서비스의 경우 프로젝트의 명령으로 시작합니다. 노출을 승인한 후 영구 개발 터널 만들기를 따릅니다. 이 플러그 인 커넥터의 경우 실제 MCP 경로를 사용하여 공용 HTTPS 엔드포인트로 설정 remoteMcpServer.mcpServerUrl 하고 프로젝트의 워크플로를 통해 개발 배포를 업데이트하고 다시 테스트합니다. 애플리케이션 인증을 유지하고 테스트가 완료되면 터널을 중지합니다.

확인: 서비스 로그는 의도한 끝점에서 인증된 호스트 요청을 표시합니다.

GitHub Copilot CLI를 사용하시겠습니까?

Help test this plugin's remote MCP connector at <endpoint>. Show the Inspector
command and ask before downloads or launch. Let me authenticate and call
<read-only-tool/input>; compare with <expected-record>. Then guide the same
task in the existing Cowork deployment and correlate sanitized server logs.
Ask before exposure, deployment, or writes; report diagnostics you can't see.

포함된 선언적 에이전트 테스트

플러그인 구성 요소: 플러그인 프로젝트에 구성된 선택적 선언적 에이전트입니다.

이것이 증명하는 것: 에이전트 응답 및 사용 가능한 선택한 플러그인, 검색 및 인용 진단.

포장 후에도 아직 증명해야 할 부분: 패키지된 에이전트 참조 및 전체 설치 플러그인 시나리오는 클레임된 환경에서 작동합니다.

보관할 증거: 에이전트/버전, 요청/대화 ID, 선택한 기능, 입력 및 실제 출력.

지원되는 플러그 인 프로젝트 해부학을 따르세요. 해당 구성 요소에 해당하는 이미 배포된 에이전트에 대해 Work IQ Dev Tools 및 DevUI 를 사용합니다.

  1. 에이전트 나열 및 조회 실행:

    wiqd agent list
    wiqd plugin ask --component agent --agent-id "<agent-id>" -q "Find issue 123 in my test repository. Return its title, status, and source URL."
    

    확인: 선택한 에이전트 및 반환된 값이 구성 요소 및 원본 레코드와 일치합니다.

  2. 문서화된 DevUI 미리 보기 플래그를 사용하도록 설정하고 반복합니다.

    wiqd config flags set devui true
    wiqd devui start --agent "<agent-name>"
    wiqd devui ask --agent "<agent-name>" -q "Find issue 123 in my test repository. Return its title, status, and source URL."
    

    선택한 플러그 인, 검색, 인용 및 원시 결과를 검사합니다.

    확인: 사용 가능한 진단은 의도한 기능과 예상되는 반환 데이터를 식별합니다.

  3. 에이전트에 연결된 기술이 있는 경우 출력을 검사합니다.

    wiqd devui ask --agent "<agent-name>" -q "Draft release notes from these changes: Added CSV export; Fixed duplicate rows; Updated help text."
    

    확인: 변경 사항 및 약속된 파일이 기술 요구 사항을 충족합니다.

  4. 진단 서버를 중지합니다.

    wiqd devui stop
    

    확인: 명령이 중지되었거나 실행되고 있지 않다고 보고합니다.

DevUI에 게시된 진단은 기술별 또는 스크립트별 호출을 설정하지 않습니다. 출력 정확도를 별도로 기록합니다. 정의된 동작에 대한 에이전트별 지침, 제안된 프롬프트 및 scope 외 요청을 테스트합니다.

GitHub Copilot CLI를 사용하시겠습니까?

Use WIQD to list agents; let me choose the component's deployed <agent-id>.
Ask it for issue 123 in <repository>, comparing with <expected-title/status/URL>.
Open DevUI and repeat; help inspect selected plugins, retrieval, citations,
raw results, and request IDs. If <skill-name> is attached, request release
notes for "Added CSV export; Fixed duplicate rows; Updated help text."
Compare outputs separately from invocation evidence. Show commands/results
and stop DevUI. Ask before configuration, deployment, sharing, or external
writes. Let me handle sign-in and inaccessible UI; don't publish anything.

문서화된 DevUI 에이전트 워크플로를 참조하세요.

테스트 종속성

구성 요소가 의존하는 서비스와 지식을 테스트한 다음, 통합 플러그인 작업을 반복합니다. 이러한 종속성 검사는 추가 플러그 인 구성 요소 등록이 아닙니다.

동기화된 Copilot 커넥터

종속성: 포함된 에이전트에서 사용하는 인덱싱된 지식입니다.

이것이 증명하는 것: 수집, 새로 고침, 사용 권한 및 후속 검색입니다.

포장 후에도 아직 증명해야 할 부분: 설치된 플러그인이 의도한 연결을 사용하고 기록합니다.

보관할 증거: 연결 ID, 크롤링 출력, 인덱싱된 개수, 인용 및 소스 값입니다.

GitHub 문제 템플릿의 경우 필수 구성 요소, 리포지토리 구성, 동의, 크롤링 및 인덱싱 검사를 위해 첫 번째 동기화된 커넥터 빌드 를 따르세요. 다른 구현의 경우 문서화된 크롤링 및 진단 절차를 사용합니다.

  1. 포함된 에이전트에 대해 구성된 연결 ID가 테스트된 연결과 일치하고 알려진 레코드가 인덱싱되었는지 확인합니다.

    확인: 연결 진단은 의도된 원본 및 예상되는 인덱싱된 항목을 식별합니다.

  2. 해당 연결로 구성된 에이전트를 쿼리한 다음, 일회용 문제를 업데이트하고, 커넥터를 다시 실행하고, 다시 쿼리합니다. 조정 경로와 항목 권한이 적용되는 제한된 액세스를 통해 삭제를 테스트합니다.

    확인: 값, 인용, 업데이트, 삭제 처리 및 액세스 일치 요구 사항.

페더레이션 Copilot 커넥터

종속성: 지원되는 시나리오에서 사용되는 사용 가능한 페더레이션 연결 입니다.

이것이 증명하는 것: 연결된 ID에서 라이브 검색.

포장 후에도 아직 증명해야 할 부분: 전체 설치 플러그인 시나리오는 의도한 데이터 액세스 경로를 사용합니다.

보관할 증거: ID, 원본 레코드, 응답/인용 및 사용 가능한 서비스 로그.

  1. Copilot Chat에서 다음을 선택합니다.>설정>원본을 찾아 연결을 선택하고 인증합니다.

    확인: 의도한 ID에 대한 연결이 성공합니다.

  2. 원본 이름 또는 ID로 알려진 레코드를 요청합니다. 일회용 레코드를 업데이트하고 반복합니다. 또한 제한된 ID도 테스트합니다.

    확인: 라이브 변경 내용이 표시되고 원본 권한은 계속 적용됩니다.

전체 사용자 시나리오 테스트

필요한 모든 구성 요소가 활성화된 상태에서 의도한 환경을 통해 동일한 알려진 작업을 실행합니다. 예를 들어, 기술자에게 알려진 문제를 검색하고 결합된 워크플로가 솔루션의 일부인 경우에만 릴리스 정보를 생성하도록 요청합니다.

  1. 의도한 테스트 ID 및 입력으로 새 대화를 시작합니다.

    확인: 예상 기술 또는 에이전트가 요청을 처리합니다.

  2. 구성 요소별 증거를 수집합니다. 원격 통화의 경우 사용 가능한 호스트 진단과 인증된 서비스 로그의 상관 관계를 지정합니다.

    확인: 원하는 구성 요소가 선택됩니다. 도구가 필요한 경우 올바른 입력과 ID를 수신하고 실제 출력이 사용됩니다.

  3. 응답 및 파일을 예상 결과와 비교합니다.

    확인: 콘텐츠, 인용 및 약속된 결과물이 요구 사항과 일치합니다.

테스트 실패 및 경계

누락되거나 모호한 입력, 만료된 인증, 거부된 동의, 제한된 데이터, 사용할 수 없는 종속성, 비어 있거나 형식이 잘못된 결과, 스크립트 실패, 시간 제한, 제한 및 재시도가 있는 경우 반복합니다. 안전하고 실행 가능한 오류 동작 및 필수 확인을 확인합니다. 테스트를 실행하기 전에 예상되는 각 결과를 기록합니다.

통합 결과 기록

시나리오 및 ID당 하나의 레코드를 사용합니다. 패키지 테스트로 가져옵니다. 패키지 후 패키지 필드를 채웁니다.

필드 유지
구성 요소 버전, 파일, 엔드포인트, 연결 참조 및 소스 수정 버전
패키지 ID, 버전, ZIP 경로 및 선택적 SHA256 해시 패키징 전에 보류 중
컨텍스트 환경, 환경/릴리스 상태, 기능 플래그, 테스트 ID 역할 및 날짜
시나리오 필수 검사, 허용 가능한 증거, 반복 가능한 입력 및 예상 결과와 실제 결과 비교
증거 호출 로그, 요청 ID, 출력 및 보고서 위치의 삭제됨
의사 결정 통과, 실패 또는 확인되지 않음 필수 증거 간격, 진단 제한 사항, 소유자 및 다음 조치

패키지 전에

  • 호출: 의도한 기능 선택 및 예상 입력/출력을 확인합니다.
  • 오시는 길: 권한 있음/제한된 액세스, 동의 및 확인 검사를 완료합니다.
  • 결과 및 실패: 해당 오류 테스트를 완료합니다.
  • 의도한 환경: 지원되는 모든 릴리스 환경에 대해 개발 결과를 별도로 기록합니다. 설치된 아티팩트 검사를 계획합니다.
  • 핸드오프 레코드: 패키징하기 전에 테스트 레코드를 저장하고 구현 차단기를 resolve합니다.
  • 패키지 참조: 테스트된 구성 요소 버전, 파일, 식별자, 연결 참조 및 엔드포인트가 패키지에서 참조할 버전인지 확인합니다.

다음 단계

패키지 & 테스트 계속: 플러그 인 패키지를 만든 다음 동일한 증거 레코드와 정확한 패키지 참조를 사용하여 패키지의 유효성을 검사하고 테스트합니다.