Empacotar seu plug-in para o Microsoft 365 Copilot

Crie o artefato com versão exato que você pretende testar e lançar. Esta é a segunda etapa em Empacotar e testar, depois que seus componentes concluídos trabalharem juntos no ambiente de desenvolvimento ou teste pretendido.

Importante

Um .zip produzido para um agente ou aplicativo do Microsoft 365 não é automaticamente um pacote de plug-in para cada combinação de componentes. Use uma rota somente quando ela der suporte aos componentes e experiências do Microsoft 365 que você pretende publicar.

O empacotamento é específico da ferramenta. Algumas ferramentas criam o artefato automaticamente, enquanto outras exigem que você monte manifestos, metadados, configuração e ativos. Servidores MCP remotos, APIs, serviços de conector e outros serviços externos são referenciados pelo pacote em vez de serem incluídos fisicamente nele.

Antes de começar

Conclua o teste de integração. Confirme se:

• Os componentes são construídos e testados individualmente e em conjunto.
• Dependências, autenticação, permissões, conexões, pontos de extremidade e serviços externos estão configurados.
• Você sabe a quais experiências do Microsoft 365 o plug-in deve dar suporte.
• As versões dos componentes, as limitações conhecidas e os problemas não resolvidos são registrados.

Não use empacotamento para resolver um componente inacabado ou integração. Retorne para Compilar ou reutilize quando um componente necessário não funcionar.

Escolha o caminho da embalagem

O que você construiu?	Criar o pacote	Resultado
Um projeto de agente declarativo com suporte do Work IQ Dev Tools	Execute wiqd agent validate para validação de projeto estático e, em seguida, execute wiqd agent package. Valide profundamente o pacote resolvido na próxima etapa.	Uma implantação para .zip sideload ou upload.
Um projeto de plug-in alfa WIQD que compõe agentes, habilidades ou conectores MCP remotos compatíveis	Executar wiqd plugin validate, provisionar o ambiente selecionado para associar a identidade do pacote e, em seguida, executar wiqd plugin package. Valide profundamente o pacote criado na próxima etapa. Consulte Criar um plug-in com as Ferramentas de Desenvolvimento do Work IQ.	Uma implantação .zip para compartilhamento com suporte ou upload de administrador.
Um projeto de manifesto do aplicativo do Microsoft 365 com suporte criado com o Kit de Ferramentas de Agentes do Microsoft 365	Selecione Zip Pacote de Aplicativos do Teams ou use a ação de teamsApp/zipAppPackage ciclo de vida. Consulte Personalizar um manifesto do aplicativo no Kit de ferramentas para agentes.	appPackage/build/appPackage.<environment>.zip.
Um agente do Microsoft 365 Copilot criado no Copilot Studio	Selecione Publicar e use Baixar como .zip nas opções de disponibilidade. Consulte Publicar e configurar um agente para o Microsoft 365 Copilot.	A .zip para upload ou envio manual para um administrador.
Componentes suportados por outro fluxo de trabalho específico do plug-in	Siga o comando documentado, a ação da interface do usuário ou o fluxo de trabalho automatizado.	O artefato instalável identificado por esse procedimento.

Se uma rota não der suporte aos componentes pretendidos e às experiências de destino, pare. Escolha uma rota com suporte ou revise o plug-in. Não combine ou renomeie artefatos para criar um pacote sem suporte.

Observação

A estática wiqd plugin validate verifica apenas a superfície do agente declarativo e os arquivos de plug-in de API ou OpenAPI referenciados. Um plug-in somente de habilidade ou somente conector pode passar na marca estática sem que seus recursos de nível superior sejam validados. A validação profunda do pacote em primeiro lugar é necessária para marcar o pacote do aplicativo criado.

Criar o pacote

1. Abra o procedimento para a rota selecionada.
2. Selecione o ambiente pretendido e as versões exatas dos componentes que você testou.
3. Execute o comando documentado, a ação da interface do usuário ou o fluxo de trabalho automatizado.
4. Registre o nome do artefato, o local, a versão, o ambiente e a versão da ferramenta.

Verificar o artefato gerado

Verifique se:

• A identidade do plug-in e a versão do pacote estão corretas.
• O pacote contém os manifestos, metadados, configuração e ativos esperados.
• As declarações de componente, arquivos, identificadores, pontos de extremidade e referências de serviço correspondem às versões testadas.
• O pacote usa a configuração de ambiente pretendida.
• Os requisitos de autenticação, permissão, consentimento e conexão são declarados sem credenciais, tokens ou segredos.
• O pacote não contém arquivos temporários, logs, dados de teste ou artefatos não relacionados.

Prontidão para publicação de registros

Leve um registro de preparação para publicação em teste e validação e conclua-o antes da publicação. Registro:

• Identidade do pacote ou artefato e versão exata.
• Componentes, serviços remotos e referências externas.
• Ferramenta de empacotamento e rota de publicação pretendida.
• Experiências e ambientes testados do Microsoft 365.
• Requisitos de autenticação, permissão, consentimento e conexão.
• Evidência e resultado da validação.
• Limitações conhecidas, combinações incompatíveis e riscos aceitos.
• Proprietário da versão e data de validação.

Próximo: Teste e valide seu plug-in

Continue para validar e testar o pacote exato. Não publique o artefato até que ele passe nas verificações aplicáveis de pacote, instalação, acesso, cenário, experiência e qualidade do agente.