Empacote seu plugin para Microsoft 365 Copilot

Crie o pacote de plug-in com versão exata que você pretende testar e lançar. Esta etapa vem depois que os componentes do plug-in trabalham juntos no ambiente de desenvolvimento ou teste pretendido.

Importante

Um .zip ficheiro não é automaticamente um pacote de plug-in suportado. Utilize uma rota de empacotamento apenas quando suportar os componentes do plug-in e as experiências do Microsoft 365 que pretende publicar.

Este artigo descreve o pacote de aplicação do Microsoft 365 utilizado pelo fluxo de trabalho de plug-in do Copilot Cowork documentado. Algumas ferramentas criam o pacote para você; Outros fluxos de trabalho permitem-lhe montá-lo manualmente. Utilize a orientação do produto selecionado para os componentes suportados, a versão do manifesto e a rota de publicação. Um formato de pacote partilhado não garante que todos os produtos suportem as mesmas capacidades.

Servidores MCP remotos, APIs e outros serviços conectados são executados separadamente. O pacote inclui as declarações ou referências suportadas necessárias para se conectar a eles, não os serviços em execução.

Antes de começar

Conclua os testes de integração. Confirme se:

  • Construiu e testou os componentes individualmente e em conjunto.
  • Configurou dependências, autenticação, permissões, ligações, pontos finais e serviços externos.
  • Sabe quais as experiências do Microsoft 365 que o plug-in tem de suportar.
  • Gravou as versões dos componentes, as limitações conhecidas e os problemas não resolvidos.

Não utilize a embalagem para resolve um componente ou uma integração inacabados. Volte a Compilar ou reutilizar quando um componente necessário não funcionar.

Compreender o pacote de aplicações do Microsoft 365

O pacote é um arquivo ZIP com manifest.json e os ícones referenciados em sua raiz. O esquema de manifesto da aplicação Microsoft 365 define as respetivas declarações de identidade, metadados e capacidade.

Conteúdo do pacote Finalidade
manifest.json Identifica a aplicação, versão, programador, nomes, descrições, ícones e capacidades suportadas.
Ícones Os ficheiros de imagem a cores e contornos referenciados pelo manifesto da aplicação. Os Cowork documentos color.png de fluxo de trabalho e outline.png.
Habilidades do agente Quando incluídas, as pastas de competências contêm SKILL.md ficheiros complementares suportados. O manifesto do aplicativo faz referência às pastas através do agentSkills.
Configuração do conector remoto Quando incluídas, agentConnectors as entradas no manifesto do aplicativo identificam os pontos de extremidade MCP remotos e a configuração de autorização aplicável. O servidor em si não está empacotado.
Arquivos de componentes referenciados Inclua os arquivos exigidos pelos componentes selecionados, como um arquivo de descrição de ferramenta quando a configuração do conector faz referência a uma ou definições de agente em um pacote de agente suportado.

Por exemplo, a documentação Cowork mostra um pacote com este layout:

manifest.json
color.png
outline.png
skills/
  contract-analysis/
    SKILL.md
    references/
      clause-taxonomy.md
tools/
  contoso-legal-tools.json

As pastas de habilidades estão presentes apenas quando o plugin inclui habilidades. O arquivo de descrição da ferramenta é necessário somente quando referenciado pela configuração do conector. Siga os plug-ins do Build para Copilot Cowork para os requisitos atuais de arquivo, versão do esquema, ícone e habilidade, em vez de tratar o exemplo como um modelo para cada produto.

Observação

O esquema de manifesto de plug-in 2.4 descreve um componente de ação de API ou MCP para um agente declarativo, não o pacote de aplicativo externo do Microsoft 365. Essas ações estão disponíveis apenas para o agente de contenção. Use o esquema de manifesto do aplicativo para o pacote externo.

Escolher um caminho de embalagem suportado

Rota do pacote de plug-ins Criar o pacote Resultado
Um projeto de plug-in do Work IQ Dev Tools (rota pró-código recomendada para cenários suportados) Siga as etapas documentadas de validação e provisionamento de origem para o ambiente selecionado e execute wiqd plugin package. Consulte Criar um plugin com o Work IQ Dev Tools. Um pacote de aplicação com versões para validar antes de partilhar ou publicar.
Um pacote de plug-in criado com o Microsoft 365 Agents Toolkit, quando o fluxo de trabalho selecionado suporta os componentes e as experiências alvo do plug-in Selecione Zip Teams App Package ou utilize a ação ciclo teamsApp/zipAppPackage de vida. Consulte Personalizar um manifesto de aplicativo no Agents Toolkit. O pacote de plug-in produzido pelo fluxo de trabalho suportado.
Um pacote de plug-in Cowork montado manualmente Siga as instruções do esquema manifesto, habilidade, conector, ícone e ZIP em Build plugins for Copilot Cowork. Um pacote de aplicações do Microsoft 365 para o percurso de Cowork documentado.

Se nenhuma rota de empacotamento suportar os componentes e as experiências de destino do seu plugin, pare. Escolha um método suportado ou reveja o plugin. Não combine ou mude o nome de artefactos para criar um pacote não suportado.

Para habilidades usadas diretamente no Copilot Chat, empacote as habilidades no nível do plug-in por meio da propriedade do manifesto do agentSkills aplicativo. Isso difere da propriedade do manifesto do agent_skills agente declarativo. Um ZIP independente SKILL.md ou de habilidade aceito por Chat não é um pacote completo de aplicativos de plugins. Consulte Empacotar uma habilidade em um plugin.

Para automatizar as verificações de origem WIQD, o empacotamento de candidatos e a validação package-first, consulte Configurar o CI/CD do plug-in com o Work IQ Dev Tools.

Observação

A validação do código-fonte WIQD não é a validação completa do pacote compilado. Valide o ZIP exato após o empacotamento, usando o procedimento de validação de pacote atual em Testar e validar seu plug-in.

Identificar o pacote e suas dependências

Escolha a rota de publicação e distribuição pretendida antes de montar o artefato de versão. Para cada rota, identifique:

  • Identidade: O ID da aplicação, a versão do pacote e os identificadores de componente.
  • Metadados: Nomes, descrições, informações de programador, ícones e ligações de privacidade e termos aplicáveis.
  • Autenticação: O modelo de identidade, a configuração de autorização suportada, as necessidades de permissão e consentimento e as referências de credenciais.
  • Conexões: Os pontos finais, as referências de ligação e a configuração específica do ambiente.
  • Dependências externas: Serviços remotos, fontes de dados, proprietários e configuração necessários fora do pacote.

Coloque apenas declarações e referências suportadas por esquema no pacote. Mantenha os detalhes operacionais no registo de disponibilidade para publicação e não inclua credenciais ou segredos.

Rota de distribuição O que confirmar para este pacote
Partilha direta para testes A audiência selecionada, o ambiente de teste, a identidade e os metadados do pacote e a autenticação, as ligações e os serviços externos de que os testadores precisam.
Distribuição da organização A identidade do pacote e os metadados para revisão do administrador, além da autenticação, conexão, permissão e configuração de serviço externo necessários na organização.
Distribuição pública A identidade do pacote e os metadados para a rota de submissão escolhida, além da autenticação, ligações e dependências externas que as organizações de cliente e os utilizadores têm de configurar.

Partilhar ou publicar o pacote não conclui a instalação, a atribuição, o consentimento ou a configuração da ligação. Siga os requisitos atuais da rota escolhida; Este artigo não define um contrato de submissão.

Criar o pacote

  1. Abra o procedimento de empacotamento para a rota do plug-in selecionada.
  2. Selecione o ambiente pretendido e as versões exatas dos componentes testadas.
  3. Execute o comando documentado, a ação da IU ou o fluxo de trabalho automatizado.
  4. Registre o nome do artefato, local, versão, ambiente e versão da ferramenta.

Verificar o artefacto 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

Traga 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 método de publicação pretendido.
  • 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óxima etapa