Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Teste o que seu pacote de plug-ins contém ou faz referência: habilidades, conectores MCP remotos e um agente declarativo, se você incluir um. Esta tarefa de teste do Package & estabelece o comportamento e a integração do componente antes de criar o artefato de versão. A validação final do pacote, a instalação e as verificações de experiência de lançamento seguem em Teste e valide seu plug-in. Escolha os testes para seus componentes, mantenha um registro de teste e conclua Antes de embalar.
Escolha seus testes
Verificar componentes no cenário integrado
| No seu plug-in | Testar com | Seção |
|---|---|---|
| Habilidades no nível do plug-in, com ou sem um agente | Sessão de desenvolvimento de Cowork; seleção de habilidades de Chat com suporte | Testar habilidades |
| Conectores de plug-in apontando para servidores MCP remotos | Inspetor, depois a mesma tarefa através do plugin no Cowork | Testar conectores MCP remotos |
| Agente declarativo, se incluído | Ferramentas de desenvolvimento de QI de Trabalho Comando ask e DevUI | Testar um agente declarativo incluído |
| Dependências usadas pela sua solução | Conector diagnóstico e repita a tarefa integrada | Testar dependências |
Saiba qual conector você está testando
-
Conector de plug-in: Uma entrada de manifesto
agentConnectors[]do aplicativo. Este artigo testa o tipo de MCP remoto: o pacote faz referência a um servidor; Ele não contém o serviço em execução. - Conector do Copilot (sincronizado): Insere conhecimento no Microsoft Graph. Teste sua ingestão e recuperação subsequente como dependências.
- Conector do Copilot (federado): Recupera dados dinâmicos sob a identidade conectada. Teste o acesso dinâmico separadamente da ingestão.
- Conector do Power Platform: Uma ferramenta do Copilot Studio. Testá-lo não estabelece que seu agente é um plug-in de registro.
A referência de criação de plug-in também documenta uma rota explícita para referências de conector personalizado OpenAPI existentes. Usar os requisitos dessa rota, se aplicável; o procedimento MCP neste artigo não testa esse tipo de conector.
Como julgar um resultado
Verifique cada componente de forma independente e, em seguida, execute uma tarefa que use os componentes juntos. Uma chamada de serviço direta bem-sucedida estabelece o comportamento do servidor. A tarefa integrada estabelece a seleção, a entrada, a autenticação e o uso dos dados retornados.
Antes de testar, defina as verificações necessárias e as evidências aceitáveis para cada componente e experiência de destino. Incluir a seleção de componentes, resultados corretos e limites de acesso. Usar evidências apropriadas para a reivindicação:
| Componente ou declaração | Evidência a ser mantida |
|---|---|
| Seleção de habilidades e comportamento | Hospede evidências que identifiquem a habilidade selecionada ou carregada, além das saídas e arquivos necessários. No painel lateral do Cowork, oSkills identifica as skills carregadas. A seleção explícita não estabelece a invocação automática. |
| Invocação de MCP remoto | Logs de serviço autenticados correlacionados com a solicitação do host, identificando a operação, as entradas e o resultado. Uma chamada direta do Inspetor não estabelece a invocação por meio do plug-in. |
| Agente incluído | Identidade, solicitação e resposta do agente implantado e diagnósticos de seleção, recuperação e citação de recursos disponíveis. Os diagnósticos do agente por si só não estabelecem a invocação de todas as habilidades ou scripts incluídos. |
| Execução de script de habilidade | Diagnóstico de execução quando exposto. Os arquivos de saída necessários estabelecem o resultado da saída, não a prova de que um script específico foi executado. Se a execução desse script for um requisito de liberação, obtenha evidências que o estabeleçam. |
- Julgue a correção da resposta separadamente da evidência de invocação. Um agente pode produzir notas de lançamento plausíveis sem carregar sua habilidade.
- A evidência ausente para uma marcação necessária permanece Não verificada e bloqueia a prontidão. Não enfraqueça uma marca necessária porque os diagnósticos não estão disponíveis.
- Quando um host não expõe detalhes adicionais de diagnóstico, registre essa limitação sem afirmar que o detalhe foi verificado. Os diagnósticos indisponíveis não são um bloqueador separado quando a evidência já atende às verificações necessárias.
- Trate o fallback silencioso ou um resultado incompleto como falha.
- Salve evidências higienizadas em armazenamento aprovado, nunca credenciais. Os instantâneos do agente podem conter conteúdo confidencial.
Pré-requisitos e dados de teste conhecidos
Use um projeto de plug-in existente, um locatário de desenvolvimento, identidades de teste conhecidas e dados de não produção. Selecione os ambientes e as experiências da Microsoft aos quais você pretende dar suporte. Autorize a entrada necessária, o consentimento, as conexões e os serviços externos antes do teste.
Para os seguintes comandos, instale o Work IQ Dev Tools: Node.js 24.15+ e npm são necessários para sua CLI, além do PowerShell 7+ no Windows.
Preparar:
- Registro conhecido: Problema 123 em um repositório de teste, com seu título exato, status e URL gravados da origem.
-
Entrada de habilidade:
Added CSV export; Fixed duplicate rows; Updated help text.Para uma habilidade de notas de versão, espere Recursos, Correções e Outros, respectivamente, além de qualquer arquivo prometido ou conteúdo produzido por script.
Substitua exemplos, IDs e espaços reservados. Entre e marque a preparação antes dos comandos do locatário:
wiqd auth login --interactive
wiqd doctor
Verificar: As verificações de entrada e preparação são bem-sucedidas para o locatário pretendido.
Para prompts de assistente opcionais, instale a CLI do GitHub Copilot. Se o plug-in de guia WIQD ainda não estiver instalado, execute estes comandos e inicie uma nova sessão em seu projeto de plug-in existente:
copilot plugin install wiqd@awesome-copilot
copilot plugin list --json
copilot
Verificar: O inventário mostra o guia WIQD instalado e habilitado. As instalações existentes devem seguir o guia de instalação em vez de adicionar duplicatas. Este plug-in de guia não instala a CLI do WIQD. Cole os prompts do assistente na sessão do assistente de codificação; as solicitações de agente implantado usam a -q opção em Testar um agente declarativo incluído.
Testar habilidades
Componente de plug-in: Habilidades no nível do plug-in registradas por meio do app-manifest agentSkills.
O que isso prova: A habilidade pretendida carrega e produz a saída esperada em uma implantação de desenvolvimento.
Ainda a provar após a embalagem: O artefato exato é validado, instalado por meio da rota de distribuição e executado em todas as experiências reivindicadas.
Evidências a serem mantidas: Implantação/versão, habilidade carregada, arquivos de entrada, saída e logs de chamadas remotas disponíveis.
Use o Copilot Cowork para a implantação de desenvolvimento. Reutilize seu link de instalação/teste impresso real, quando disponível.
Se o provisionamento for necessário, inspecione
m365agents.ymle o arquivo de ambiente selecionado em seuenvironmentFolderPathconfigurado primeiro. Confirme o locatário e o domínio ;AGENT_SCOPEos scaffolds padrão usamlocalpara escopo pessoal edevpara escopo compartilhado, mas os nomes por si só não são provas. Aprove as alterações propostas e execute:wiqd plugin provision --env "<test-environment>"Verificar: O provisionamento é bem-sucedido e retorna o link de instalação/teste da implantação.
Abra o link retornado e conclua a instalação e as conexões necessárias usando a identidade de teste. Inicie uma sessão do Cowork e solicite notas de versão usando a entrada conhecida.
Verificar: Sua habilidade aparece em Habilidades no painel lateral da sessão.
Inspecione a resposta e qualquer arquivo em Pasta de saída>,Visualizar ou Baixar.
Verificar: Todas as alterações aparecem nas categorias pretendidas e os arquivos prometidos correspondem aos requisitos.
Execute os testes de descoberta e invocação em cada experiência suportada, usando essa implantação e a entrada conhecida.
Verifique: A descoberta, a seleção e o comportamento de falha atendem aos requisitos da habilidade para essa experiência.
Uma habilidade carregada pessoalmente testa um registro diferente do plug-in agentSkills: as habilidades anexadas ao agente são usadas agent_skills no manifesto do agente declarativo. A evidência de habilidade carregada não estabelece a execução por script.
No ciclo de vida documentado, o aprovisionamento cria ou atualiza a implementação do inquilino no âmbito selecionado e escreve as ligações do ambiente. A reutilização de uma identidade de recurso existente pode afetar os utilizadores atuais; Autorize essas alterações. O aprovisionamento não executa os comandos de publicação ou partilha separados. A ligação de instalação não é uma prova da publicação do registo, da disponibilidade para o público ou da instalação do seu ZIP final. Continue separadamente através de Publicar & distribuir e Disponibilizar & governar, incluindo a aprovação, instalação, consentimento e ligações aplicáveis.
Prefere utilizar GitHub Copilot CLI?
Help test <skill-name> in this plugin's existing Cowork development deployment.
Reuse its printed install link. Ask before provisioning; inspect the actual
environment scope first. Don't publish or share. Request release notes for
"Added CSV export; Fixed duplicate rows; Updated help text." Compare categories
and promised files; test missing input. Guide explicit/automatic Chat selection
if supported. Let me operate inaccessible UI and handle sign-in/consent.
Show actual evidence and ask before installs, exposure, or external changes.
Testar conectores MCP remotos
Componente do plugin:agentConnectors[] entradas que apontam para serviços MCP remotos.
O que isto prova: Comportamento do servidor de forma independente e, em seguida, uso autenticado através do seu plug-in de desenvolvimento.
Ainda por comprovar após a embalagem: As declarações do conector, a configuração da conexão e as chamadas de tempo de execução funcionam a partir do artefato instalado exatamente.
Elementos de prova a manter: Ponto final/versão, esquema da ferramenta, entradas/resultados, identidade e registos correlacionados de anfitrião/servidor.
Utilize o MCP Inspector com o Node.js 22.19.0+, o ponto final HTTP Streamable fidedigno, os respetivos detalhes de autenticação e uma operação só de leitura segura.
Inicie o Inspetor, substituindo o URL de exemplo:
$serverUrl = 'https://your-server.example/mcp' npx @modelcontextprotocol/inspector --server-url "$serverUrl" --transport httpVerifique: A autenticação é concluída e a identidade e as capacidades do servidor esperadas são apresentadas.
Liste as ferramentas, selecione a operação de pesquisa, introduza os campos definidos pelo esquema para o registo conhecido e execute-a.
Verifique: O esquema e o título, status e URL devolvidos correspondem às expetativas.
Repita com um registo inexistente e uma identidade restrita.
Verifique: O comportamento de registro ausente é acionável e o conteúdo não autorizado permanece inacessível.
Abra o link de instalação e teste do plug-in de desenvolvimento Cowork usando a etapa de provisionamento em Testar habilidades, se necessário; projetos somente de conector não exigem uma habilidade. Conclua a configuração da ligação e solicite o mesmo registo. Se uma competência utilizar o conector, invoque-a com esse pedido.
Verifique: Os logs de serviço autenticados mostram a operação e as entradas esperadas, e os valores retornados correspondem ao resultado da sessão.
Teste qualquer operação de escrita aprovada apenas em relação a registos descartáveis, incluindo o cancelamento.
Verifique: As alterações aprovadas correspondem ao pedido e o cancelamento deixa os dados de origem inalterados.
Compare o ponto de extremidade e a referência de autenticação na configuração do componente com o que realmente foi executado. Seguir os requisitos do conector, incluindo os requisitos de descrição da ferramenta aplicáveis; O sucesso do servidor por si só não estabelece a prontidão da conexão do host.
Para um serviço local, inicie-o com o comando do projeto. Depois de aprovar a exposição, siga Criar um túnel de desenvolvimento persistente. Para este conector de plug-in, defina remoteMcpServer.mcpServerUrl o ponto de extremidade HTTPS público com seu caminho MCP real; atualize sua implantação de desenvolvimento através do fluxo de trabalho do projeto e teste novamente. Retenha a autenticação do aplicativo e pare o túnel quando o teste for concluído.
Verifique: Os registos de serviço mostram o pedido de anfitrião autenticado no ponto final pretendido.
Prefere utilizar GitHub Copilot CLI?
Help test this plugin's remote MCP connector at <endpoint>. Show the Inspector
command and ask before downloads or launch. Let me authenticate and call
<read-only-tool/input>; compare with <expected-record>. Then guide the same
task in the existing Cowork deployment and correlate sanitized server logs.
Ask before exposure, deployment, or writes; report diagnostics you can't see.
Testar um agente declarativo incluído
Componente do plugin: Um agente declarativo opcional composto no projeto do plugin.
O que isto prova: Respostas do agente e diagnóstico de plug-in selecionado, recuperação e citação disponíveis.
Ainda por comprovar após a embalagem: As referências do agente empacotado e o cenário completo do plug-in instalado funcionam em experiências reivindicadas.
Elementos de prova a manter: Agente/versão, ID do pedido/conversação, capacidade selecionada, entrada e saída real.
Siga o plugin suportado projeto anatomia. Use o Work IQ Dev Tools e o DevUI em relação ao agente já implantado correspondente a esse componente.
Liste agentes e execute a pesquisa:
wiqd agent list wiqd plugin ask --component agent --agent-id "<agent-id>" -q "Find issue 123 in my test repository. Return its title, status, and source URL."Verifique: O agente selecionado e os valores retornados correspondem ao componente e ao registro de origem.
Ative o sinalizador de pré-visualização DevUI documentado e repita:
wiqd config flags set devui true wiqd devui start --agent "<agent-name>" wiqd devui ask --agent "<agent-name>" -q "Find issue 123 in my test repository. Return its title, status, and source URL."Inspecione plug-ins, recuperação, citações e resultados brutos selecionados.
Verifique: Os diagnóstico disponíveis identificam a capacidade pretendida e os dados devolvidos esperados.
Se o agente tiver uma habilidade anexada, marcar sua saída:
wiqd devui ask --agent "<agent-name>" -q "Draft release notes from these changes: Added CSV export; Fixed duplicate rows; Updated help text."Verifique: Alterações e arquivos prometidos satisfazem os requisitos da habilidade.
Pare o servidor de diagnóstico:
wiqd devui stopVerifique: Os relatórios de comando pararam ou não estão em execução.
Os diagnóstico publicados da DevUI não estabelecem uma invocação por competência ou por script. Registre a correção de saída separadamente. Teste instruções específicas do agente, pedidos sugeridos e pedidos fora do âmbito relativamente ao seu comportamento definido também.
Prefere utilizar GitHub Copilot CLI?
Use WIQD to list agents; let me choose the component's deployed <agent-id>.
Ask it for issue 123 in <repository>, comparing with <expected-title/status/URL>.
Open DevUI and repeat; help inspect selected plugins, retrieval, citations,
raw results, and request IDs. If <skill-name> is attached, request release
notes for "Added CSV export; Fixed duplicate rows; Updated help text."
Compare outputs separately from invocation evidence. Show commands/results
and stop DevUI. Ask before configuration, deployment, sharing, or external
writes. Let me handle sign-in and inaccessible UI; don't publish anything.
Veja o fluxo de trabalho de agentes DevUI documentado.
Dependências de teste
Teste os serviços e conhecimentos em que seus componentes dependem e, em seguida, repita a tarefa de plug-in integrada. Estas verificações de dependência não são registos adicionais de componentes de plug-ins.
Conector do Copilot sincronizado
Dependência: Conhecimento indexado usado pelo agente incluído.
O que isto prova: Ingestão, recência, permissões e subsequente recuperação.
Ainda por comprovar após a embalagem: O plug-in instalado usa a conexão pretendida e os registros.
Elementos de prova a manter: ID da ligação, resultado da pesquisa, contagem indexada, citações e valores da origem.
Para o modelo Problemas do GitHub, siga Criar seu primeiro conector sincronizado para verificações de pré-requisitos, configuração do repositório, consentimento, rastreamento e indexação. Para outras implementações, utilize a pesquisa documentada e os procedimentos de diagnóstico.
Confirme se o ID de ligação configurado para o agente incluído corresponde à ligação testada e se o registo conhecido está indexado.
Verifique: Os diagnóstico de ligação identificam a origem pretendida e os itens indexados esperados.
Consulte o agente configurado com essa ligação e, em seguida, atualize um problema descartável, execute novamente o conector e consulte novamente. Teste a eliminação através do respetivo caminho de reconciliação e acesso restrito onde se aplicam permissões de item.
Verifique: Valores, citações, atualizações, processamento de eliminações e requisitos de correspondência de acesso.
Conector do Copilot federado
Dependência: Uma ligação federada disponível utilizada no cenário suportado.
O que isto prova: Recuperação ao vivo sob a identidade conectada.
Ainda por comprovar após a embalagem: Seu cenário completo de plug-in instalado usa o caminho de acesso a dados pretendido.
Elementos de prova a manter: Identidade, registo de origem, respostas/citações e registos de serviço disponíveis.
No Copilot Chat, selecione ...>Configurações>Sources, find the source, select Connect e authenticate.
Verifique: A ligação é efetuada com êxito para a identidade pretendida.
Peça o registo conhecido pelo nome ou ID da origem. Atualizar um registo descartável e repetir. Além disso, teste uma identidade restrita.
Verifique: As alterações em tempo real aparecem e as permissões de origem permanecem impostas.
Cenários de teste completos do utilizador
Execute a mesma tarefa conhecida através da experiência pretendida com todos os componentes necessários ativados. Por exemplo, peça a uma competência para obter o problema conhecido e produzir notas de versão apenas se esse fluxo de trabalho combinado fizer parte da sua solução.
Inicie uma nova conversação com a identidade e entrada de teste pretendidas.
Verifique: A habilidade ou agente esperado lida com a solicitação.
Recolher as provas específicas dos componentes. Para chamadas remotas, correlacione diagnóstico de host disponíveis com logs de serviço autenticados.
Verifique: O componente pretendido é selecionado. Sempre que uma ferramenta é necessária, recebe os dados de entrada e a identidade corretos e os respetivos resultados são utilizados.
Compare a resposta e os ficheiros com o resultado esperado.
Verifique: O conteúdo, as citações e as saídas prometidas correspondem aos requisitos.
Falhas de teste e limites
Repita com entrada ausente ou ambígua, autenticação expirada, consentimento negado, dados restritos, dependências indisponíveis, resultados vazios ou malformados, falhas de script, tempos limite, limitação e tentativas. Confirme o comportamento de falha seguro e acionável e as confirmações necessárias. Registe cada resultado esperado antes de executar o teste.
Gravar resultados da integração
Utilize um registo por cenário e identidade. Traga-o para o teste de embalagem; Preencha os campos do pacote após o empacotamento.
| Campo | Manter em vigor |
|---|---|
| Componentes | Versões, arquivos, pontos de extremidade, referências de conexão e revisão de origem |
| Pacote | Identidade, versão, caminho ZIP e hash SHA256 opcional; pendente antes do empacotamento |
| Contexto | Ambiente, estado da experiência/lançamento, sinalizadores de recursos, função de identidade de teste e data |
| Cenário | Verificações necessárias, evidências aceitáveis, entrada repetível e resultado esperado versus real |
| Evidência | Logs de invocação, IDs de solicitação, saídas e locais de relatório limpos |
| Decisão | Aprovado, reprovado ou não verificado; lacunas de evidências necessárias, limitações de diagnóstico, proprietário e próxima ação |
Antes de empacotar
- Invocação: Confirme a seleção de recursos pretendida e as entradas/saídas esperadas.
- Acesso: Conclua as verificações de acesso autorizado/restrito, consentimento e confirmação.
- Resultados e falhas: Conclua os testes de falha aplicáveis.
- Experiências pretendidas: Registre os resultados do desenvolvimento separadamente para cada experiência de lançamento com suporte; Planejar verificações finais de artefatos instalados no Azure.
- Registro de entrega: Salve os registros de teste e resolve os bloqueadores de implementação antes de empacotar.
- Referências do pacote: Confirme se as versões de componente, arquivos, identificadores, referências de conexão e pontos de extremidade testados são aqueles aos quais o pacote fará referência.
Conteúdo relacionado
- Teste do Copilot Studio e diagnóstico do mapa de atividades para agentes que usam conectores do Power Platform ou ferramentas MCP.
- Teste do Agent Builder e testes de habilidades anexadas. Esses testes de criação não estabelecem uma rota de empacotamento do Registro com suporte.
Próxima etapa
Continuar o pacote & teste: Crie o pacote de plug-ins e, em seguida, valide e teste o pacote usando o mesmo registro de evidências e as referências exatas do pacote.