Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Valide e teste o artefato com versão exato que você criou em Empacotar seu plug-in. Esta é a terceira etapa em Pacote e teste: valide o pacote, instale-o e confirme seu acesso, comportamento e experiências com suporte do Microsoft 365.
Os componentes e serviços externos referenciados pelo plug-in já devem funcionar individualmente e em conjunto. Este artigo testa o plug-in empacotado; Ele não substitui o teste ou a certificação no nível do componente.
Importante
Use o artefato exato que você pretende publicar. Se a rota de empacotamento não der suporte aos componentes pretendidos e às experiências de destino, retorne ao Empacotar o plug-in e escolha uma rota com suporte.
Antes de começar
Preparar:
- O pacote de plug-in com versão exata que você pretende lançar.
- O procedimento de instalação ou sideload para sua rota de embalagem.
- Um ambiente de teste e identidades com o acesso necessário.
- Cenários representativos e resultados esperados para cada experiência de destino do Microsoft 365.
Validar o pacote
Use o procedimento de validação para sua rota de embalagem.
| Rota de empacotamento | Procedimento de validação |
|---|---|
| Ferramentas de desenvolvimento do Work IQ | Depois de criar o pacote, use wiqd agent validate --mode deep para validar o pacote do aplicativo resolvido. Em fluxos de trabalho automatizados, inspecione o resultado JSON data.valid em vez de depender apenas do código de saída do processo. Consulte Validação e Camada de Validação da Microsoft. |
| Pacote de plug-ins alfa WIQD | Depois de wiqd plugin package criar o artefato, execute wiqd plugin validate --mode deep. Essa validação do pacote primeiro verifica o manifesto do aplicativo de nível superior, as habilidades e os conectores MCP remotos que a validação de plug-in estático não cobre. Em fluxos de trabalho automatizados, inspecione o resultado da validação estruturada em vez de depender apenas do código de saída do processo. Consulte Criar um plug-in com as Ferramentas de Desenvolvimento do Work IQ. |
| Microsoft 365 Agents Toolkit | Use Validar pacote de aplicativos usando regras de validação ou execute atk validate --app-package-file-path <path>. Consulte Validar seu aplicativo. |
| Copilot Studio | Conclua o fluxo de trabalho publicar e configurar e resolve erros antes de baixar o .ziparquivo . |
| Outro fluxo de trabalho específico do plug-in | Siga o procedimento de validação documentado para esse tipo de pacote. |
Confirme se o artefato gerado atende aos requisitos definidos para seu tipo de pacote, usa a identidade, a versão e o ambiente pretendidos e não contém credenciais, segredos, dados de teste, logs ou arquivos não relacionados.
Corrija erros de pacote, crie uma nova versão de pacote e repita a validação antes de instalá-lo.
Instalar ou fazer o sideload do pacote
- Use o procedimento de instalação ou sideload para sua rota de embalagem.
- Instale o artefato exato que passou na validação do pacote.
- Registre a versão do artefato, o ambiente de teste, a identidade e o resultado da instalação.
- Confirme se o plug-in instalado e os componentes esperados são reconhecidos.
Se a instalação falhar, corrija o pacote, crie uma nova versão, reinstale-o e teste novamente.
Testar o plug-in empacotado
- Execute os cenários de usuário completos por meio do plug-in instalado.
- Confirme se os componentes esperados são carregados e se os componentes corretos estão selecionados.
- Teste os cenários de sucesso, falha e recuperação exigidos pelos componentes e experiências do Microsoft 365 compatíveis com o plug-in.
- Registre o resultado esperado e real de cada cenário.
Se um componente falhar em seus próprios requisitos, retorne à orientação de validação de build ou componente. Não redefina uma falha de componente como um sucesso de pacote de plug-ins.
Testar autenticação e acesso
Teste:
- Login, consentimento, renovação de token e reconexão.
- Acesso negado, permissões insuficientes, conexões ausentes e serviços indisponíveis.
- Dados e ações fora das permissões do usuário.
Registre as identidades, permissões, autenticação, consentimento, conexões, pontos de extremidade e versões de serviço testadas.
Testar experiências com suporte
Instale e teste o pacote em cada experiência do Microsoft 365 que você pretende dar suporte. Não deduza apoio em uma experiência dos resultados em outra.
Registre as experiências, os ambientes, as limitações, as combinações sem suporte e os riscos aceitos para a versão.
Avalie a qualidade do agente quando necessário
Se o pacote incluir um agente e a avaliação de qualidade do agente fizer parte dos critérios de lançamento, avalie a versão implantada exata e adicione os resultados ao registro de preparação para publicação. Comece com a visão geral da avaliação do agente.
A avaliação do agente mede a qualidade da resposta e regressões. Ela não substitui a validação de pacote, o teste de instalação, o teste de acesso ou o teste em todas as experiências da Microsoft com suporte.
Determinar a preparação para lançamento
Atribua um resultado:
- Pronto - O pacote de plug-in exato passou em todas as verificações necessárias e não tem bloqueador de versão não resolvido.
- Bloqueado - Uma falha de pacote, referência, acesso, compatibilidade ou tempo de execução impede a publicação.
- Pronto com limitações - As verificações necessárias foram aprovadas e as limitações restantes são documentadas, aceitas e adequadas para divulgação no processo de publicação.
Para cada falha de bloqueio, registre o proprietário e a resolução necessária. Corrija o problema, reempacote o plug-in, reinstale o novo artefato e repita os testes afetados.
O plug-in estará pronto para publicação somente quando esse artefato exato tiver passado no pacote necessário, na instalação, no acesso, no cenário, na experiência e nas verificações de qualidade do agente aplicáveis.
Continue a publicar e distribuir o plug-in.