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.
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
- Abra o procedimento de empacotamento para a rota do plug-in selecionada.
- Selecione o ambiente pretendido e as versões exatas dos componentes testadas.
- Execute o comando documentado, a ação da IU ou o fluxo de trabalho automatizado.
- 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.