Integrar e testar os componentes do plug-in

Empacotar e testar transforma componentes funcionais em um artefato de versão testado. Conclua o trabalho nesta ordem:

Etapa O que você confirma Começar com
Integrar funcionalidades Os componentes concluídos trabalham juntos no ambiente de desenvolvimento ou teste pretendido. Este artigo
Criar o pacote Uma rota de empacotamento com suporte produz o artefato com versão exato que você pretende lançar. Criar o pacote de plug-ins
Validar e testar o pacote O artefato exato passa na validação do pacote, é instalado com êxito e funciona em todas as experiências reivindicadas da Microsoft. Validar e testar o pacote
Avalie a qualidade do agente, quando necessário O agente implantado atende aos critérios de qualidade de resposta para a versão. Visão geral da avaliação do agente

Este artigo aborda a primeira etapa. Ele não testa o pacote final. A validação do pacote e o teste do plugin instalado começam depois que você cria o artefato.

Preparar o ambiente de teste

Antes do teste:

  • Use as versões pretendidas de cada componente.
  • Configure as identidades, permissões, consentimento e conexões de desenvolvimento ou teste.
  • Inicie ou disponibilize os serviços remotos necessários no ambiente de desenvolvimento ou teste.
  • Confirme se os usuários de destino e as contas de teste podem acessar as experiências pretendidas da Microsoft.
  • Use dados de teste representativos que não exponham segredos de produção ou informações pessoais desnecessárias.
  • Registre o resultado esperado, o ambiente, o proprietário e as evidências necessárias para cada cenário.

Verificar componentes no cenário integrado

Componente Verificações de integração
Agente declarativo Identidade, instruções, iniciadores de conversa, conhecimento, seleção de recursos, respostas, limites e prompts sem suporte
Habilidade Descoberta ou anexo, instruções, recursos, scripts, entradas, saídas, solicitações sem suporte e falhas
Conector Autenticação, esquema, indexação ou recuperação, atualização, filtragem de segurança, permissões, atualizações, exclusões e falhas de origem
Servidor MCP Descoberta de ferramentas ou recursos, autenticação, entradas, resultados estruturados, confirmações, erros, tempos limite, disponibilidade e logs

Use as orientações de teste específicas do produto aplicáveis:

O Work IQ DevUI é uma superfície de depuração baseada em navegador de visualização que pode mostrar plug-ins selecionados, recuperação, citações, identificadores de solicitação e resultados brutos. Os comandos WIQD Work IQ são experimentais e podem listar agentes declarativos implantados ou enviar um prompt de teste por ID ou nome do agente. Essas rotas testam um agente declarativo implantado; Eles não substituem a validação do pacote ou o teste do plugin final instalado.

Cenários de teste de usuário concluídos

Teste os cenários de ponta a ponta do resumo da solução em vez de testar apenas recursos individuais.

  1. Comece com um prompt ou tarefa de usuário representativo.
  2. Confirme se o agente pretendido ou a experiência da Microsoft lida com a solicitação.
  3. Confirme se a habilidade, conector, ação ou ferramenta MCP correta está selecionada.
  4. Verifique o comportamento de autenticação, consentimento, confirmação e permissão.
  5. Confirme se o componente recebe as entradas pretendidas e retorna o resultado esperado.
  6. Confirme se a resposta final é precisa, útil e compreensível.
  7. Verifique se os logs e os diagnósticos identificam os componentes envolvidos.

Ao testar no Microsoft 365 Copilot, você pode inserir -developer on no Copilot Chat para inspecionar os metadados do agente e a seleção de ações. Insira -developer off quando terminar.

Testar falhas e limites

Inclua:

  • Autenticação ausente ou expirada.
  • Permissões insuficientes ou consentimento negado.
  • Dados indisponíveis, conexões, APIs ou serviços remotos.
  • Entrada de usuário inválida, ambígua ou sem suporte.
  • Resultados vazios, parciais, atrasados ou malformados.
  • Tempos limite, limitação e comportamento de repetição.
  • Tentativas de acessar dados fora das permissões do usuário.
  • Instruções que devem impedir ou redirecionar uma operação sem suporte.

Não trate um fallback silencioso como sucesso. O usuário e a equipe de suporte devem ser capazes de entender o que falhou e qual ação é necessária.

Registrar resultados da integração

Para cada cenário de teste, registre:

  • ambiente e a experiência da Microsoft.
  • Versões de componente e serviço.
  • Configuração de identidade, permissão e conexão.
  • Resultado esperado e real.
  • Registros ou evidências.
  • Limitação conhecida, proprietário e resolução ou decisão de aceitação.

Registre os arquivos, configurações, pontos de extremidade, versões de componentes, proprietários e evidências exatos que o autor do pacote deve usar.

Confirmar a preparação para o pacote

O teste de integração é concluído quando:

  • Cada componente necessário é criado, configurado, estendido ou reutilizado.
  • Cada componente funciona de forma independente no ambiente de desenvolvimento ou teste.
  • Os componentes funcionam juntos para os cenários de ponta a ponta.
  • As identidades, permissões, conexões, dados e serviços necessários estão disponíveis.
  • O comportamento esperado de autenticação, confirmação, erro e falha é implementado.
  • A propriedade do componente, as dependências, as versões, as limitações e as responsabilidades de suporte são documentadas.
  • Os arquivos de implementação e configuração estão identificados e prontos para serem montados.
  • Nenhum bloqueador de implementação não resolvido impede a criação de pacotes.

Continue a empacotar seu plug-in.

Conteúdo relacionado

  • Last updated on