Testar e validar seu plug-in para o Microsoft 365 Copilot

Teste o artefato com versão exato produzido pela Create the plugin package. No pacote & teste, conecte a evidência do componente a esse ZIP, instale-o por meio de uma rota com suporte e verifique a versão, o acesso e o comportamento real do tempo de execução entregues em todas as experiências reivindicadas da Microsoft.

Termine com esta evidência: "Eu testei esses componentes, empacotei essas referências exatas, instalei essa versão exata, executei esses cenários e mantive esses resultados." Uma verificação de esquema bem-sucedida marcar, comando de provisionamento ou resposta plausível não estabelece essa cadeia.

Antes de começar

Ter:

  • Testes de componentes e de integração concluídos, incluindo dados de teste conhecidos e resultados esperados.
  • O ZIP candidato, sua identidade/versão de pacote e as versões de componente, pontos de extremidade e referências de conexão que ele contém.
  • Um locatário de desenvolvimento, dados de não produção, uma rota de instalação com suporte para os componentes do pacote e permissão para usá-la.
  • Testar identidades para usuários permitidos e restritos; um administrador autorizado para testes de disponibilidade e bloqueio.
  • Licenças necessárias, entrada, consentimento, conexões e serviços externos para cada experiência de destino.
  • Um registro de teste para cada cenário e identidade.

Antes de testar, defina as verificações necessárias de pacote, instalação, acesso e tempo de execução e as evidências que estabelecerão cada resultado. Use os critérios de evidência específicos do componente para declarações de tempo de execução e a evidência de instalação descrita em Confirmar a versão entregue.

Obtenha aprovação antes de carregar um pacote, instalá-lo, conceder consentimento, compartilhá-lo ou alterar as configurações de administração. Esses procedimentos alteram o estado do locatário; Usar identidades e audiências de teste controladas.

Validar esquemas e referências de componentes

Abra o ZIP do candidato sem modificá-lo. Leia sua raiz manifest.json, gravação id, versione manifestVersion. Confirme se:

  • O manifesto usa o esquema de manifesto do aplicativo Microsoft 365 exigido pela sua rota.
  • As definições de agente e os manifestos de ação incluídos usam seus esquemas aplicáveis. Um manifesto de plug-in de API descreve uma ação de agente, não o plug-in de registro externo.
  • Pastas de habilidades referenciadas, arquivos complementares, ícones e descrições de ferramentas existem em seus caminhos de pacote declarados.
  • Versões, identificadores, pontos de extremidade e referências de conexão correspondem aos registros de teste do componente e ao ambiente pretendido.
  • Nenhuma credencial, segredo, log ou arquivo de teste não relacionado estão incluídos.

Para ferramentas de desenvolvimento do Work IQ, use os pré-requisitos da CLI documentados, incluindo Node.js 24.15+, npm e PowerShell 7+ para esses exemplos do Windows. Uma marca de origem offline opcional no projeto existente é:

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

Verificar: As verificações de origem aplicáveis são aprovadas e ignoradas ou descobertas são registradas.

Verificações do modo de origem salvas, diagnósticos de agente declarativo e proteções básicas de projeto. Ele não valida totalmente o esquema do aplicativo, o conteúdo de habilidade, a raiz agentConnectors[]ou o conteúdo de API/OpenAPI referenciado. Um projeto somente de habilidade ou somente conector não pode ter verificações de agente aplicáveis. Use source explicitamente: o modo padrão é a validação de pacote, não um marcar offline.

Validar o pacote exato

Selecione um arquivo ZIP explicitamente em vez de depender de um diretório de compilação com vários candidatos. No PowerShell, substitua o caminho de exemplo pelo artefato:

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

Verificar: O arquivo resolvido é o candidato pretendido. Opcionalmente, retenha o hash calculado localmente para detectar alterações subsequentes; Um hash local não prova quais bytes o host executa.

  1. Antes de uma validação autenticada, entre com a identidade pretendida do Microsoft 365:

    wiqd auth login --interactive
    wiqd doctor
    

    Verificar: As verificações de autenticação e prontidão são bem-sucedidas para o locatário pretendido.

  2. Com a aprovação para carregar esse arquivo ZIP no serviço de validação de plataforma, execute:

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

    Verificar: As descobertas para este arquivo ZIP exato satisfazem as verificações necessárias; reter os relatórios JSON e HTML imutáveis retornados.

  3. Se sua rota de publicação exigir a política de marketplace adicional e verificações de evidência, execute:

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

    Verificar: As verificações necessárias de pacote, política e evidências foram aprovadas, sem a falta de evidências necessárias.

Ambos package e marketplace usar o arquivo ZIP interno, carregá-lo e pode exigir entrada. Eles não o constroem ou entram automaticamente. Eles também aceitam um arquivo ZIP sem seu projeto de origem. O modo Marketplace adiciona verificações de política e evidência. Seu relatório não é a aprovação oficial da Store ou do Partner Center. Siga o contrato de validação WIQD atual, não os nomes obsoletos deep, static, ou manifest de modo.

Leia as descobertas, a cobertura, as verificações ignoradas e as evidências necessárias, não apenas o resultado de saída do comando. Para uma rota de pacote do Agents Toolkit com suporte, use Validar pacote do aplicativo usando regras de validação ou atk validate --app-package-file-path <path> conforme documentado em Validar seu aplicativo.

Se algo mudar no arquivo ZIP, crie um novo candidato e repita a validação. As alterações no serviço remoto exigem um novo teste de tempo de execução relevante, mesmo quando o arquivo ZIP permanece inalterado.

Instalar ou fazer o sideload do pacote

Use uma rota que aceite seu pacote nativo do aplicativo Microsoft 365 e dê suporte a seus componentes. Um link de instalação e teste de provisionamento WIQD identifica uma implantação; abri-la não estabelece que o ZIP validado final foi instalado.

Instalação pessoal do ZIP exato

Siga o procedimento de sideload pessoal do Cowork para instalação, autenticação e instalação do pacote da CLI quando esse pacote e a experiência de destino forem compatíveis. Passe o arquivo exato selecionado em Validar o pacote exato, usando $packageFile como o valor de --file-path e Personal como o escopo.

Verificar: A instalação foi bem-sucedida para a conta pretendida. Salve o retornado TitleId e AppId junto com a identidade/versão do pacote e a saída do instalador. Na experiência com suporte, confirme se o plug-in instalado expõe os componentes e a identidade esperados e se as conexões necessárias foram concluídas.

Se a política desabilitar a rota pessoal ou a rota não tiver suporte para o candidato, use uma rota compatível aprovada em vez de alterar os controles de segurança.

Upload do pacote de Cowork

Para um pacote de Cowork compatível, siga Carregar um pacote de plug-in e suas orientações de compartilhamento. Escolha o arquivo ZIP nativo exato e validado do Microsoft 365 e limite o acesso à identidade de teste ou a um público-alvo de teste explicitamente autorizado. Use plugins com o Cowork para habilitar o plugin e concluir as conexões necessárias em uma nova conversa.

Verificar: O arquivo selecionado e a identidade do plug-in exibida correspondem ao registro do candidato. O plug-in é instalado para a identidade pretendida, as habilidades esperadas e o status do conector aparecem e as operações protegidas usam a conta conectada pretendida.

Carregamentos em formato estrangeiro podem ser convertidos automaticamente. Essa conversão não é prova de que seu Microsoft 365 ZIP original foi testado inalterado. Restabeleça o artefato e a evidência de validação se a rota o transformar.

Confirme a versão entregue

Mantenha um registro de instalação que vincule o ZIP selecionado exato e seu manifesto id e version à instalação bem-sucedida, à conta pretendida e às identidades de instalação retornadas. Para a rota de sideload pessoal documentada, mantenha o comando com seu caminho de arquivo resolvido, os metadados de manifesto do candidato e a saída do instalador contendo TitleId e AppId. Para um upload nativo do Cowork com suporte, mantenha o arquivo selecionado e o registro de upload/instalação bem-sucedido com a identidade do plug-in exibida e a conta de teste.

Use essa cadeia como evidência de instalação para o candidato testado. Correlacione todos os metadados de versão expostos pelo host ou pela rota de administração com o candidato e investigue as incompatibilidades antes de testar. Registre as evidências de instalação separadamente da invocação.

As etapas de instalação pessoal citadas não documentam uma consulta universal de versão instalada ou um hash de pacote do lado do servidor. Nenhum dos dois é exigido por este procedimento: o registro de instalação estabelece qual candidato foi enviado e instalado com êxito, não uma verificação independente dos bytes que o host executa. Se seus critérios de lançamento exigirem verificação independente de versão ou byte do lado do host, obtenha essa evidência; sua ausência permanece Não verificada e bloqueia essa declaração de liberação. Um link de provisionamento, nome do plug-in, resposta bem-sucedida ou hash local por si só não estabelece a cadeia de instalação.

Para um candidato gerenciado pelo administrador, siga o procedimento atual de upload e instalação do Registro, defina o escopo dos usuários de teste e mantenha o artefato aceito e o registro de instalação. Se a rota aceitar um tipo de artefato diferente ou não puder estabelecer sua relação com o ZIP validado, trate a marca de associação de artefato como não verificada, não equivalente.

Testar o plug-in empacotado

Repita os cenários de integração completos com o candidato instalado, não com a implantação de desenvolvimento anterior:

  1. Inicie uma nova conversa em cada experiência reivindicada. Use a mesma função de identidade, registro conhecido, entrada e resultado esperado que os testes de componente.

    Verificar: O componente instalado pretendido é selecionado.

  2. Colete as evidências específicas do componente. Para chamadas remotas, correlacione logs de serviço autenticados com a solicitação, entradas e dados retornados.

    Verificar: A evidência do host identifica a habilidade selecionada ou carregada, quando aplicável. As chamadas de ferramenta necessárias têm evidências de invocação correlacionadas e seus dados retornados contribuem para a resposta.

  3. Inspecione os arquivos de saída e as citações. Repita os casos de falha e limite aplicáveis.

    Verificar: A correção, os limites de acesso, as aprovações e o comportamento de falha atendem aos critérios predefinidos.

Para habilidades de nota de versão, reutilize Added CSV export; Fixed duplicate rows; Updated help text. Verificar recursos, Correções, Outros e arquivos prometidos. Para uma pesquisa MCP, compare o título, status e URL exatos do problema conhecido com os registos de serviço. Utilizar as ferramentas de evidência específicas do componente; Uma rota de diagnóstico de agente por si só não estabelece que um plug-in instalado autônomo foi executado.

Mantenha os resultados da correção e da invocação separados. A falta de provas para uma marcar exigida permanece não verificada. Grave diagnóstico adicionais indisponíveis como limitações, não como detalhes de execução verificados ou falhas automáticas. Repita os testes de deteção, conexão, seleção e tempo de execução separadamente em Chat e Cowork ao reivindicar ambos.

Testar autenticação e acesso

Peça a um administrador autorizado que prepare configurações de teste controladas por meio de Definir disponibilidade de plug-ins para usuários e Gerenciar plug-ins, habilidades e servidores MCP. Grave as configurações originais e restaure-as após o teste aprovado. Use a mesma pesquisa inofensiva ou um cenário equivalente que seu plugin suporta. Para uma marcar inaplicável, como o consentimento do serviço num cenário apenas de competências, registe o motivo em vez de adicionar uma capacidade.

Teste Configuração e ação Resultado esperado
Utilizador permitido Incluir a identidade do teste na audiência aprovada. Inicie sessão como esse utilizador e conclua o consentimento/ligações necessárias. O cenário suportado é bem-sucedido dentro das permissões de origem desse utilizador; As provas de invocação identificam a capacidade esperada.
Utilizador restrito Restringir a disponibilidade à audiência aprovada e, em seguida, testar com uma conta externa a essa audiência. O usuário não pode usar o plug-in. No canal Copilot, a listagem pode permanecer detetável como bloqueada; Os utilizadores elegíveis podem pedir acesso. A visibilidade por si só não é um fracasso.
Consentimento negado Use uma identidade/conexão de teste sem uma concessão existente. Recuse o consentimento necessário da operação e tente novamente a pesquisa protegida. A operação não obtém o acesso protegido solicitado. Registe o erro de início de sessão/consentimento e certifique-se de que nenhum resultado protegido é apresentado como êxito. As capacidades permitidas não relacionadas ainda podem funcionar.
Bloquear e desbloquear Peça ao administrador para seguir Bloqueie um plugin ou habilidade para o candidato. Repita a solicitação com um usuário permitido anteriormente e, em seguida, peça ao administrador que selecione Desbloquear para o plug-in e repita a solicitação novamente. Enquanto estiver bloqueado, o plug-in e os agentes dependentes não poderão ser usados. Os servidores/conectores MCP associados permanecem disponíveis para outros plug-ins. Após o desbloqueio, o usuário anteriormente permitido pode usar o plug-in novamente, sujeito aos requisitos originais de disponibilidade, permissão e conexão.

As restrições da categoria de editor são controlos separados. Se testar um, registre a categoria e o resultado de sua política; Não altere as configurações em toda a organização apenas para testar um candidato. Teste a renovação/religação do início de sessão, as permissões de origem e as ligações em falta, quando aplicável.

Para Microsoft Entra autenticação de código de autorização, o consentimento negado retorna um erro de autorização, use o erro de provedor real em vez de esperar palavras idênticas em todos os hosts.

Testar experiências suportadas

Registre um resultado por experiência, função de identidade e cenário, incluindo evidências de instalação e versão entregue. Um passe em Cowork não estabelece um passe em Chat ou outro anfitrião. Utilize a rota suportada para cada um; Evidências de instalação ou versão não resolvidas impedem uma reivindicação de liberação para essa experiência.

Registre os resultados da qualidade do agente

Se um agente estiver incluído e seus critérios de liberação exigirem avaliação de qualidade, avalie a versão implantada correspondente e vincule seus resultados ao registro de candidato. Comece com a visão geral da avaliação do agente. As pontuações de qualidade não substituem as evidências de pacote, versão instalada, acesso ou invocação.

Repetir testes de regressão para um candidato

Execute novamente os cenários de linha de base gravados, testes de acesso, casos de falha e qualquer avaliação necessária do agente em relação ao candidato instalado. Adicione maiúsculas/minúsculas específicas da alteração sem remover a linha de base. Retenha ambos os conjuntos de registos de teste, compare os resultados e resolve regressões ou verificações não verificadas necessárias antes da aprovação.

Para a preparação da linha de base e o ciclo de vida da atualização, incluindo as decisões de publicação, implementação, substituição e reversão, siga Monitore, atualize e extinga o seu plug-in ou agente. Não assuma atualizações automáticas, atribuições preservadas ou um acionador específico de novo consentimento. Após a implementação, repita a verificação da versão entregue e do tempo de execução.

Determinar a prontidão da liberação

Conclua o registro de teste compartilhado com a identidade e versão do pacote, arquivo ZIP exato e hash opcional, versões de componentes e pontos de extremidade, ambiente, função de identidade de teste, cenário, resultados esperados e reais, evidência de invocação higienizada, status e proprietário. Anexar relatórios de validação e provas de instalação e versão.

Atribuir um resultado:

  • Pronto - O candidato exato passou em todas as verificações exigidas com provas completas e sem bloqueador de liberação não resolvido.
  • Bloqueado - Uma marcar necessária falhou ou permanece não verificada, incluindo a vinculação de artefactos, a versão entregue, o acesso ou a invocação.
  • Pronto com limitações - Cheques obrigatórios aprovados; As restantes limitações de não bloqueio são documentadas, aceites e adequadas para divulgação.

Aplicar os critérios de verificação e evidência exigidos definidos antes do teste. Uma limitação diagnóstica aceita não pode transformar a falta de evidência exigida em um passe; diagnóstico adicionais não são obrigatórias quando as verificações exigidas já têm provas suficientes. Para cada bloqueador, registre um proprietário e uma resolução. Crie um novo candidato quando o artefato for alterado, reinstale-o e repita os testes afetados e de regressão.

Próxima etapa

Quando as provas necessárias estiverem completas, continue a Publicar & distribuir: