Monitorar, atualizar e desativar seu plug-in ou agente

Use monitoramento, comentários e evidências de suporte para decidir se deve corrigir, atualizar, entregar ou desativar seu plug-in ou agente. Teste as alterações antes do lançamento e verifique o resultado com os usuários pretendidos.

Os construtores mantêm e testam a solução. Os administradores do Microsoft 365 concluem a distribuição organizacional e acessam ações quando necessário. Os proprietários do serviço mantêm os conectores, servidores MCP remotos, identidades e serviços externos que ele usa. Essas responsabilidades não são transferidas automaticamente juntas.

Escolher uma tarefa

Use a seção para o trabalho que você precisa fazer. Monitoramento, suporte, entrega e desativação não exigem que você siga o fluxo de trabalho de atualização.

O que é necessário fazer Comece com
Revisar adoção, comentários ou resultados da tarefa Monitorar o uso e os resultados das tarefas
Investigar um problema de usuário Ofereça suporte aos usuários e investigue problemas
Altere e libere a solução Atualizar seu plug-in ou agente
Transferir as responsabilidades de manutenção Transferir a propriedade e o suporte
Encerrar distribuição ou acesso Desativar o plug-in ou agente

Antes de começar

Identificar:

  • A identidade e a versão atuais do plugin ou agente.
  • Os usuários afetados e as experiências do Microsoft 365.
  • O proprietário responsável pela tarefa e quaisquer conexões ou serviços envolvidos.

Para um agente autônomo, use os procedimentos de monitoramento e lançamento compatíveis com seu produto de criação. Não presuma que um procedimento de pacote de plug-in se aplica a ele.

Monitorar o uso e os resultados das tarefas

Escolha um período de relatório, versão, audiência e tarefas representativas. Use a experiência de monitoramento para o produto proprietário da atividade.

O que você está monitorando Por onde começar Escopo a ter em mente
Um agente integrado no Agent Builder Monitorar agentes no Agent Builder A guia Monitor do agente abrange seu uso e feedback. A visibilidade de comentários tem pré-requisitos separados.
Um agente do Copilot Studio usando o arnês padrão Monitorar o desempenho do agente no Copilot Studio Use as análises com suporte para esse agente; não presuma que os mesmos relatórios existam no Agent Builder ou em outros caminhos de compilação.
Acesso a plug-ins, tarefas do usuário e falhas Monitore seu plug-in Verifique a disponibilidade do pacote, os resultados das tarefas representativas, os comentários dos usuários e os casos de suporte.
Atividade de auditoria e uso do Microsoft 365 Escolha o que marcar Use cada relatório para a atividade que ele abrange. Um evento de auditoria não estabelece que uma tarefa foi bem-sucedida ou se uma resposta foi correta.
Um conector ou serviço MCP remoto Investigue falhas e as diretrizes de monitoramento do serviço Verifique o estado de conexão, permissões de origem, integridade do ponto de extremidade, logs e erros com o proprietário do serviço. A disponibilidade do pacote não prova a integridade do runtime.

Não presuma que a telemetria ou a cobertura de relatório sejam compartilhadas entre os caminhos de build do plug-in e do agente. O relatório de um agente incluído abrange esse agente, não necessariamente todos os recursos do plug-in.

Registre as alterações na adoção, sucesso da tarefa, qualidade da resposta, falhas de entrada ou ferramenta e volume de suporte quando as evidências disponíveis derem suporte a essas conclusões. Compare tarefas representativas e comentários do usuário, bem como contagens de uso.

Ofereça suporte aos usuários e investigue problemas

Para cada problema, capture a versão afetada, o produto, o público-alvo, o resultado esperado, o resultado observado e os detalhes relevantes do erro. Atribuir um proprietário e a próxima ação.

  • Peça ao administrador para investigar a disponibilidade, a instalação, a política ou as solicitações de acesso pendentes.
  • Peça ao construtor ou proprietário do agente para investigar instruções, conhecimento, seleção de ferramentas ou regressões.
  • Peça à identidade, conexão ou proprietário do serviço para investigar falhas de autenticação, consentimento, acesso de origem e tempo de execução.

Para falhas de entrada de ação API ou MCP, use Solucionar problemas de autenticação de plug-in. Para verificações de tarefas e dependências, use Investigar falhas.

Confirme a correção com um usuário afetado e registre o resultado. Uma configuração corrigida ou uma chamada de ferramenta bem-sucedida não estabelece, por si só, que a tarefa completa do usuário agora funciona.

Atualizar seu plug-in ou agente

Siga este fluxo de trabalho quando precisar alterar a solução. Use as etapas do pacote para um plug-in composto. Use o procedimento de liberação do produto de criação para um agente autônomo.

Antes de atualizar

Ter:

  • Monitorando evidências, comentários dos usuários, casos de suporte ou uma melhoria planejada.
  • Tarefas representativas e critérios de aceitação.
  • Acesso à origem e aos recursos afetados.
  • O registro de publicação, incluindo a versão atual, o público-alvo e a rota de distribuição.
  • Proprietários de quaisquer alterações de conexão, identidade ou serviço.

Estabelecer uma linha de base

  1. Declare o problema ou a melhoria que você deseja resolver.
  2. Identifique o pacote ou a versão do agente afetada, os usuários, as experiências, os recursos e as dependências.
  3. Defina tarefas representativas e critérios de aceitação mensuráveis.
  4. Execute as tarefas na versão 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>. Para os controles aplicáveis de um agente, use o Registro de agentes>Todos os 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 do Microsoft 365 Copilot.

Aplicar e testar a alteração

Retorne ao Build ou reutilize quando precisar alterar um recurso, integração ou origem. Retorne ao Pacote & teste quando precisar preparar e validar o release candidate. Mantenha as dependências afetadas e as experiências com suporte no escopo.

  1. Atualize a origem ou a funcionalidade afetada.
  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

Para um agente autônomo, siga as instruções de versão, teste e publicação do produto de criação. As etapas do pacote a seguir se aplicam a plug-ins compostos.

  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 qualquer opção de recuperação documentada.

Não publique um pacote diferente do pacote validado.

Publicar e distribuir a atualização

Escolha o procedimento de atualização para o seu produto e rota de distribuição. As rotas de publicação distinguem compartilhamento, envio à organização e publicação no Marketplace.

Rota de distribuição Diretrizes ou limitações documentadas Quem age
Um plugin compartilhado por meio do Cowork Siga o procedimento documentado de upload e compartilhamento novamente para uma versão mais recente de um plug-in já compartilhado. Este procedimento se aplica ao compartilhamento de Cowork, não à substituição geral do registro. Proprietário do plug-in
Envio do catálogo de aplicativos da organização por meio do Work IQ Dev Tools Siga Envie uma atualização aprovada para o catálogo de aplicativos da organização. Preserve a identidade e o estado do ambiente existentes do destino da versão, teste a versão atualizada, envie com wiqd plugin publishe obtenha aprovação do administrador. Proprietário e administrador do plug-in
Upload manual do Registro ou outro método de compartilhamento direto Confirme o procedimento de atualização de item existente específico do produto antes do lançamento. Este artigo não fornece etapas manuais de substituição de pacote do Registro de Ferramentas. Não presuma que um novo upload substitua uma entrada existente ou preserve suas configurações de disponibilidade. Proprietário e administrador do plug-in
Microsoft Marketplace Siga as diretrizes de atualização para o tipo de oferta usado pela oferta publicada. Comece com as diretrizes do Partner Center vinculadas de Publicar seu plug-in no Microsoft Marketplace. Conclua todas as revisões e publicações necessárias antes de direcionar os clientes para a atualização. Administrador do fornecedor e do cliente, quando necessário

Para uma atualização do WIQD, guarde os IDs de recurso e publicação estabelecidos. O reprovisionamento usa a identidade de ambiente existente e pode alterar os recursos usados pelos usuários atuais antes da aprovação do catálogo. Teste as alterações com esse efeito em mente. Verifique o ciclo de vida de publicação do projeto em relação à orientação do WIQD para projetos existentes; atualizar a CLI não atualiza os arquivos do projeto.

wiqd plugin publish envia um projeto e um ambiente, não um ZIP capturado por meio do --package-file. Mantenha a origem aprovada e o estado do ambiente corrigidos por meio do envio e verifique a versão enviada. A validação do pacote por si só não prova que a publicação envia esses bytes exatos.

Para obter uma rota com um procedimento de atualização documentado:

  1. Use o procedimento de publicação ou compartilhamento confirmado para a versão testada e registre se ela foi enviada, publicada, compartilhada, rejeitada ou bloqueada.
  2. Informe ao administrador ou ao proprietário da distribuição a versão exata, 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 ou agente 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 atingiu cada público.

Planejar a recuperação sem pressupor a reversão

Os administradores podem bloquear e desbloquear um plug-in no Centro de administração do Microsoft 365. Use a ação Desbloquear do plug-in para remover um bloqueio e, em seguida, verifique o acesso dos usuários pretendidos. Outros requisitos de disponibilidade, instalação, permissão e conexão ainda se aplicam. O desbloqueio não restaura uma versão anterior do pacote nem desfaz alterações no serviço.

As diretrizes atuais não documentam um procedimento geral de reversão do pacote de plug-ins. Use uma operação de reversão específica do produto somente quando o produto a documentar.

Antes do lançamento, registre a opção de recuperação documentada e seus pré-requisitos ou registre a lacuna do procedimento e o proprietário responsável por uma distribuição com falha.

Substituir um pacote não restaura automaticamente um serviço externo, conexão, identidade, dados ou alteração de permissão. Planeje essas dependências separadamente.

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.
  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, pause a distribuição, registre a falha e envolva o proprietário responsável. Use uma operação de recuperação somente quando o produto a documentar.

A atualização é concluída quando o público-alvo tem a versão correta, 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 anteriores e atualizadas do pacote ou agente.
  • 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 recuperação documentada ou lacuna de procedimento e proprietário do suporte.

Transferir a propriedade e o suporte

Antes que o proprietário atual deixe a função, informe ao próximo proprietário:

  • A origem, a identidade do pacote ou do agente, a versão atual, os registros de versão e a rota de publicação.
  • Locais de monitoramento, testes representativos, problemas conhecidos e casos de suporte abertos.
  • O público-alvo, contatos administrativos, conexões necessárias e proprietários de serviços externos.
  • Os procedimentos documentados de atualização, recuperação e aposentadoria, incluindo quaisquer lacunas.

Para um agente compartilhado integrado no Agent Builder ou no Copilot Studio, use Atribuir novo proprietário a um agente quando esse procedimento se aplicar. O Agent Builder também oferece suporte à adição de um proprietário. Examine os efeitos no acesso do proprietário anterior antes de fazer uma alteração.

Esses são procedimentos de propriedade do agente, não um procedimento geral de transferência para o pacote de plug-in externo. Confirme o acesso de origem, o acesso de publicação, as conexões, as credenciais e as responsabilidades de serviço separadamente. Peça ao próximo proprietário que verifique se ele pode monitorar, manter e dar suporte à solução.

Desativar o plug-in ou agente

Retire a solução quando ela não puder mais ser usada. Decida se você está encerrando a distribuição para todos os clientes ou removendo o acesso apenas em sua organização; Esses escopos são diferentes.

  1. Identifique versões ativas, usuários, locais de publicação e compartilhamento e dependências compartilhadas.
  2. Notifique os usuários e as equipes de suporte, incluindo qualquer substituição e a data de desativação.
  3. Pare a distribuição e o acesso através da rota suportada e remova as instalações do administrador quando necessário.
  4. Peça aos proprietários do serviço para removerem o acesso e os recursos específicos do plug-in, preservando os recursos utilizados por outras soluções.
  5. Verifique o resultado com um utilizador previamente autorizado e registe os recursos, exceções e proprietários retidos.

Para aposentar um pacote, consulte Aposentar seu plugin. Para um agente autônomo, use o procedimento de produto aplicável, como Excluir agentes. Não assuma que a remoção de um agente ou pacote revoga todas as ligações, permissões ou serviços externos.