Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Crea il pacchetto di plug-in con versione esatta che intendi testare e rilasciare. Questo passaggio avviene dopo che i componenti del plug-in lavorano insieme nell'ambiente di sviluppo o di test previsto.
Importante
Un .zip file non è automaticamente un pacchetto di plug-in supportato. Usa una route di creazione pacchetti solo quando supporta i componenti del plug-in e le esperienze Microsoft 365 che intendi pubblicare.
Questo articolo descrive il pacchetto dell'app Microsoft 365 usato dal flusso di lavoro documentato del plug-in Copilot Cowork. Alcuni strumenti creano il pacchetto per te; Altri flussi di lavoro consentono di assemblarla manualmente. Utilizzare le indicazioni del prodotto selezionato per i componenti supportati, la versione del manifesto e il percorso di pubblicazione. Un formato di pacchetto condiviso non garantisce che tutti i prodotti supportino le stesse funzionalità.
I server MCP remoti, le API e altri servizi connessi funzionano separatamente. Il pacchetto include le dichiarazioni supportate o i riferimenti necessari per la connessione a essi, non i servizi in esecuzione.
Prima di iniziare
Completare il test di integrazione. Conferma che:
- Hai costruito e testato i componenti singolarmente e insieme.
- Sono state configurate dipendenze, autenticazione, autorizzazioni, connessioni, endpoint e servizi esterni.
- Sai quali esperienze di Microsoft 365 il plug-in deve supportare.
- Sono state registrate le versioni dei componenti, le limitazioni note e i problemi non risolti.
Non utilizzare la creazione di pacchetti per risolvere un componente o un'integrazione non completata. Torna a Crea o riutilizza quando un componente richiesto non funziona.
Informazioni sul pacchetto dell'app Microsoft 365
Il pacchetto è un file ZIP con manifest.json le icone a cui si fa riferimento nella radice. Lo schema del manifesto dell'app Microsoft 365 definisce le dichiarazioni di identità, metadati e funzionalità.
| Contenuto della confezione | Scopo |
|---|---|
manifest.json |
Identifica l'app, la versione, lo sviluppatore, i nomi, le descrizioni, le icone e le funzionalità supportate. |
| Icone | I file di immagine del colore e del contorno a cui fa riferimento il manifesto dell'app. I documenti color.png del flusso di lavoro di Cowork e outline.png. |
| Competenze agente | Una volta incluse, le cartelle delle competenze contengono SKILL.md file complementari supportati. Il manifesto dell'app fa riferimento alle cartelle tramite agentSkills. |
| Configurazione del connettore remoto | Se incluse, agentConnectors le voci nel manifesto dell'app identificano gli endpoint MCP remoti e la configurazione dell'autorizzazione applicabile. Il server stesso non è confezionato. |
| File dei componenti a cui si fa riferimento | Includere i file richiesti dai componenti selezionati, ad esempio un file di descrizione dello strumento quando la configurazione del connettore fa riferimento a uno o le definizioni dell'agente in un pacchetto dell'agente supportato. |
Ad esempio, la documentazione di Cowork mostra un pacchetto con questo layout:
manifest.json
color.png
outline.png
skills/
contract-analysis/
SKILL.md
references/
clause-taxonomy.md
tools/
contoso-legal-tools.json
Le cartelle delle competenze sono presenti solo quando il plug-in include competenze. Il file di descrizione dello strumento è necessario solo se la configurazione del connettore fa riferimento. Segui i plug-in di compilazione per Copilot Cowork per i requisiti correnti di file, versione dello schema, icone e competenze piuttosto che trattare l'esempio come un modello per ogni prodotto.
Nota
Lo schema del manifesto del plug-in 2.4 descrive un componente di azione API o MCP per un agente dichiarativo, non il pacchetto esterno dell'app Microsoft 365. Queste azioni sono disponibili solo per l'agente contenitore. Usa lo schema manifesto dell'app per il pacchetto esterno.
Scegliere un percorso di creazione del pacchetto supportato
| Percorso del pacchetto plug-in | Creare il pacchetto | Risultato |
|---|---|---|
| Un progetto di plug-in Work IQ Dev Tools (percorso pro-code consigliato per gli scenari supportati) | Seguire i passaggi documentati di convalida e provisioning dell'origine per l'ambiente selezionato, quindi eseguire wiqd plugin package. Consulta Creare un plug-in con gli strumenti di sviluppo di Work IQ. |
Pacchetto dell'app con versione da convalidare prima della condivisione o della pubblicazione. |
| Un pacchetto di plug-in creato con Microsoft 365 Agents Toolkit, quando il flusso di lavoro selezionato supporta i componenti del plug-in e le esperienze di destinazione | Selezionare Comprimi il pacchetto dell'app di Teams o usare l'azione del teamsApp/zipAppPackage ciclo di vita. Consulta Personalizzare il manifesto di un'app in Agents Toolkit. |
Il pacchetto di plug-in prodotto dal flusso di lavoro supportato. |
| Un pacchetto di plug-in di Cowork assemblato manualmente | Segui le istruzioni di manifesto, competenza, connettore, icona e layout ZIP in Compilare plug-in per Copilot Cowork. | Pacchetto di app Microsoft 365 per la route di Cowork documentata. |
Se nessuna route di creazione di pacchetti supporta i componenti del plug-in e le esperienze di destinazione, fermatevi. Scegli un metodo supportato o modifica il plug-in. Non combinare o rinominare gli artefatti per creare un pacchetto non supportato.
Per le competenze usate direttamente in Copilot Chat, creare pacchetti di competenze a livello di plug-in tramite la proprietà del manifesto dell'appagentSkills. Questo valore è diverso dalla proprietà del manifesto dell'agente agent_skills dichiarativo. Un file ZIP autonomo SKILL.md o di competenza accettato da Chat non è un pacchetto completo dell'app plug-in. Consulta Creare un pacchetto di una competenza in un plug-in.
Per automatizzare i controlli dell'origine WIQD, la creazione di pacchetti di candidati e la convalida package-first, vedere Configurazione del plug-in CI/CD con Work IQ Dev Tools.
Nota
La convalida dell'origine WIQD non è la convalida completa del pacchetto compilato. Convalidare lo ZIP esatto dopo la creazione del pacchetto, usando la procedura di convalida del pacchetto corrente in Testare e convalidare il plug-in.
Identificare il pacchetto e le relative dipendenze
Scegli il percorso di pubblicazione e distribuzione previsto prima di assemblare l'artefatto di rilascio. Per ogni percorso, identifica:
- Identità: ID app, versione del pacchetto e identificatori dei componenti.
- Metadati: Nomi, descrizioni, informazioni sullo sviluppatore, icone e collegamenti a privacy e condizioni applicabili.
- Autenticazione: Il modello di identità, la configurazione dell'autorizzazione supportata, le esigenze di autorizzazione e consenso e i riferimenti alle credenziali.
- Connessioni: Gli endpoint, i riferimenti di connessione e la configurazione specifica dell'ambiente.
- Dipendenze esterne: Servizi remoti, origini dati, proprietari e configurazione necessari all'esterno del pacchetto.
Inserire solo dichiarazioni e riferimenti supportati dallo schema nel pacchetto. Mantieni i dettagli operativi nel record di conformità alla pubblicazione e non includere credenziali o segreti.
| Percorso di distribuzione | Cosa confermare per questo pacchetto |
|---|---|
| Condivisione diretta per i test | Il gruppo di destinatari selezionato, l'ambiente di test, l'identità e i metadati del pacchetto, nonché l'autenticazione, le connessioni e i servizi esterni necessari ai tester. |
| Distribuzione dell'organizzazione | L'identità del pacchetto e i metadati per la revisione dell'amministratore, oltre all'autenticazione, alla connessione, all'autorizzazione e alla configurazione del servizio esterno necessari nell'organizzazione. |
| Distribuzione pubblica | L'identità e i metadati del pacchetto per la route di invio scelta, oltre all'autenticazione, alle connessioni e alle dipendenze esterne che le organizzazioni e gli utenti del cliente devono configurare. |
La condivisione o la pubblicazione del pacchetto non completa l'installazione, l'assegnazione, il consenso o la configurazione della connessione. Seguire i requisiti attuali del percorso scelto; Questo articolo non definisce un contratto di invio.
Creare il pacchetto
- Apri la procedura di packaging per il percorso del plug-in selezionato.
- Seleziona l'ambiente previsto e le versioni esatte dei componenti che hai testato.
- Eseguire il comando documentato, l'azione dell'interfaccia utente o il flusso di lavoro automatizzato.
- Registrare il nome dell'elemento, la posizione, la versione, l'ambiente e la versione dello strumento.
Controllare l'artefatto generato
Verificare che:
- L'identità del plugin e la versione del pacchetto sono corrette.
- Il pacchetto contiene i manifesti, i metadati, la configurazione e le risorse previsti.
- Le dichiarazioni dei componenti, i file, gli identificatori, gli endpoint e i riferimenti al servizio corrispondono alle versioni testate.
- Il pacchetto usa la configurazione di ambiente prevista.
- I requisiti di autenticazione, autorizzazione, consenso e connessione vengono dichiarati senza credenziali, token o segreti.
- Il pacchetto non contiene file temporanei, log, dati di test o artefatti non correlati.
Preparazione alla pubblicazione dei record
Sottoporre un record di conformità alla pubblicazione per il test e la convalida e completarlo prima della pubblicazione. Registra:
- Identità del pacchetto o dell'artefatto e versione esatta.
- Componenti, servizi remoti e riferimenti esterni.
- Strumento di creazione del pacchetto e metodo di pubblicazione previsto.
- Esperienze e ambienti di Microsoft 365 testati.
- Requisiti di autenticazione, autorizzazione, consenso e connessione.
- Prove e risultati della convalida.
- Limitazioni note, combinazioni non supportate e rischi accettati.
- Proprietario del rilascio e data di convalida.