Melhorar e atualizar seu plug-in

Melhore seu plug-in usando evidências de monitoramento e avaliações para descobrir o que precisa mudar. Aplique a correção ou a melhoria, libere o pacote exato testado e confirme se o plug-in atualizado continua funcionando para os usuários pretendidos.

Os construtores mantêm e testam o pacote. Os administradores do Microsoft 365 concluem ações de distribuição organizacional quando necessário. Os proprietários de serviços mantêm os conectores, servidores MCP remotos, identidades e serviços externos que o plug-in usa.

Antes de começar

Ter:

• A identidade atual do plug-in e a versão do pacote.
• Como a versão atual chegou aos usuários: compartilhamento direto, upload de administrador ou Microsoft Marketplace.
• Monitorando evidências, comentários dos usuários, casos de suporte ou uma melhoria planejada.
• Tarefas representativas e critérios de aceitação.
• Os usuários afetados e as experiências do Microsoft 365.
• Acesso à origem do plug-in e aos recursos afetados.
• Proprietários das conexões necessárias e dos serviços externos.

Se você ainda não sabe o que precisa mudar, comece com Monitore seu plug-in.

Estabelecer uma linha de base

1. Declare o problema ou a melhoria que você deseja resolver.
2. Identifique a versão do pacote, os usuários, as experiências, as funcionalidades e as dependências afetadas.
3. Defina tarefas representativas e critérios de aceitação mensuráveis.
4. Execute as tarefas no pacote atual e registre os resultados.
5. Se sua organização administra o plug-in, registre seu status atual, disponibilidade do usuário e estado de instalação emPlug-insde Ferramentas> de Agentes>.
6. Preserve as evidências necessárias para comparar o comportamento atual e atualizado.

Para um plug-in que inclui um agente, use a visão geral da avaliação do agente para criar uma avaliação quando a qualidade da resposta, as instruções, o conhecimento ou o uso da ferramenta fizerem parte da alteração. A avaliação pode fornecer evidências de pré-lançamento e ajudar a investigar questões de qualidade pós-implantação, incluindo aquelas levantadas por sinais de uso, comentários do usuário ou alterações de agente e dependência.

A avaliação do agente não é necessária para todos os plugins. Ele não substitui o teste de capacidade, a validação de pacote ou o teste completo da experiência do usuário.

Para agentes declarativos implantados, use o fluxo de trabalho guiadowiqd agent eval. Para controle direto de linha de comando ou pipeline, consulte Visão geral da CLI de avaliações de agentes.

Aplicar e testar a alteração

1. Atualize a origem do plug-in ou o recurso afetado.
2. Atualize os serviços operados separadamente ou a configuração quando a alteração exigir.
3. Teste cada funcionalidade alterada e dependência afetada.
4. Execute as tarefas e avaliações básicas novamente.
5. Compare os resultados com os critérios de aceitação.
6. Investigue regressões antes de criar o pacote de lançamento.

Quando a alteração afetar um conector, servidor MCP remoto, identidade, permissão ou serviço externo, envolva o proprietário dessa dependência. Não presuma que a alteração do pacote atualiza um serviço operado separadamente.

Criar e validar o pacote

1. Atribua uma nova versão do pacote e marque os requisitos de identidade do seu método de publicação.
2. Crie o pacote de plugins.
3. Valide e teste o pacote exato que você pretende lançar.
4. Teste exigiu entrada, consentimento, conexões e serviços externos.
5. Teste o pacote em cada experiência do Microsoft 365 que você pretende dar suporte.
6. Registre as limitações conhecidas, a configuração necessária e a opção de reversão ou substituição disponível.

Não publique um pacote diferente do pacote validado.

Publicar e distribuir a atualização

Escolha um método de publicação ou compartilhamento com suporte para o pacote atualizado e o público-alvo. Verifique suas instruções sobre como atualizar um plugin existente; Não presuma que compartilhar ou carregar uma nova versão substitui sua entrada do Registro ou transfere as configurações de disponibilidade.

Antes do lançamento, confirme se o método reutiliza a identidade do pacote ou cria uma entrada separada, se a disponibilidade do usuário anterior e as configurações de instalação são mantidas e como substituir ou restaurar uma versão, se necessário. Se uma segunda entrada for exibida, verifique se os usuários pretendidos mudaram para a nova versão antes de restringir a antiga. Não remova uma entrada ainda em uso.

Depois:

1. Publique, carregue ou compartilhe o pacote testado exato pelo método selecionado e registre se ele foi enviado, publicado, compartilhado, rejeitado ou bloqueado.
2. Informe ao administrador ou ao proprietário da distribuição a versão exata do pacote, os usuários pretendidos, a configuração necessária, as limitações conhecidas e o contato de suporte.
3. Conclua apenas as etapas aplicáveis para disponibilizar o plug-in atualizado. Os requisitos de aprovação, atribuição e instalação dependem do método e das configurações da organização.
4. Atualize agentes, conexões, identidades, servidores MCP remotos ou serviços externos controlados separadamente quando necessário.
5. Confirme qual versão do pacote atingiu cada público.

Para um plug-in wiqd plugin share alfa das Ferramentas de Desenvolvimento do Work IQ, publica no registro do plug-in para o público selecionado; o envio do repositório público acontece separadamente no Partner Center. Siga o guia de plug-ins do Work IQ Dev Tools para provisionar, empacotar, validar e compartilhar a sequência ao preparar outra versão.

Antes da distribuição, confirme se o método dá suporte à restauração de uma versão anterior. Substituir o pacote não restaura automaticamente um serviço externo, conexão, identidade, dados ou alteração de permissão.

Verificar a atualização

1. Teste as tarefas representativas com um usuário pretendido em cada experiência com suporte.
2. Confirme se o usuário recebeu a versão esperada do pacote.
3. Confirme se a entrada, o consentimento, as conexões, as chamadas de ferramentas e os serviços externos funcionam.
4. Quando o plug-in for administrado em sua organização, marque se seu status, disponibilidade do usuário e estado de instalação correspondem ao público-alvo emPlug-ins deferramentas> de agentes>. Verifique se há alguma versão substituída ainda em uso.
5. Repita as avaliações usadas para aprovar a alteração.
6. Examine os sinais de uso, comentários, erros e casos de suporte após a distribuição.
7. Se a atualização não cumprir seus critérios de aceitação, siga o procedimento de reversão ou substituição com suporte e restaure as dependências afetadas quando necessário.

A atualização é concluída quando o público-alvo tem a versão correta do pacote, suas configurações de acesso correspondem à distribuição pretendida, as tarefas representativas atendem aos seus critérios de aceitação e cada problema não resolvido tem um proprietário e a próxima ação.

Grave a atualização

Registro:

• Versões de pacote anteriores e atualizadas.
• Mudança, motivo, recursos afetados e dependências.
• Linha de base, avaliação, validação e resultados do teste do usuário.
• Método de publicação, público-alvo, status de distribuição e estado do Registro aplicável.
• Alterações de configuração ou serviço.
• Limitações conhecidas, opção de reversão e proprietário do suporte.

Conteúdo relacionado

• Monitore seu plug-in
• Empacotar seu plug-in
• Validar e testar seu plug-in
• Publicar ou compartilhar seu plug-in
• Disponibilize seu plug-in
• Gerenciar plug-ins, habilidades e servidores MCP
• Desative seu plug-in