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.
Un plug-in è un pacchetto installabile che aggiunge nuove funzionalità a Microsoft 365 Copilot e ad altre esperienze di Microsoft AI. Riunisce le competenze, gli strumenti e gli agenti opzionali necessari per un lavoro in un'unica unità che le persone possono trovare, installare, condividere e gestire.
Ad esempio, un plug-in di supporto potrebbe usare un agente per rispondere a domande, una capacità per guidare la risoluzione dei problemi, un connettore per trovare contenuti di supporto e un server MCP per fornire strumenti.
Un plugin può contenere una o più funzionalità; Una singola competenza impacchettata è anche un plug-in. I servizi esterni, come i server MCP remoti, possono essere eseguiti separatamente dal pacchetto.
Prima di creare un nuovo plug-in, esplora il catalogo dei plug-in di Copilot, un registro pubblico dei plug-in disponibili.
Cosa può includere un plug-in?
Scegli ciò di cui il tuo plugin ha bisogno in base all'attività che dovrebbe aiutare gli utenti a completare.
| Funzionalità | Risultato | Altre informazioni |
|---|---|---|
| Competenze | Fornire istruzioni riutilizzabili per un'attività, impacchettate in una directory che contiene SKILL.md. |
Competenze negli agenti dichiarativi |
| Strumenti | Connettiti ad app e dati, inclusi i connettori Copilot supportati e le integrazioni MCP remote. | Connettori Copilot e server MCP |
| Agenti | Fornire assistenti specializzati per un ruolo o un flusso di lavoro; Oggi, questi sono agenti dichiarativi. | Panoramica degli agenti dichiarativi |
Un plugin non ha bisogno di tutti e tre i tipi di funzionalità. È possibile creare nuove funzionalità o riutilizzare quelle esistenti.
Il supporto varia in base al prodotto. Controlla le indicazioni per Generatore di agenti, Copilot Studio e Copilot Cowork per l'esperienza di destinazione prima di creare o creare un pacchetto del plug-in.
Plug-in e azioni dichiarative dell'agente
Un plug-in di Microsoft 365 Copilot è un pacchetto installabile. Un plug-in API o plug-in MCP è un'integrazione che fornisce azioni a un agente dichiarativo. Quando un pacchetto di plug-in include tale agente, le relative azioni API e MCP rimangono disponibili tramite l'agente; non diventano funzionalità disponibili in modo indipendente del pacchetto. Il server API o MCP viene eseguito separatamente.
I manifesti descrivono diversi livelli della soluzione:
| Manifesto | Quello che descrive |
|---|---|
Manifesto dell'app Microsoft 365, manifest.json |
Identità, metadati e funzionalità supportate del pacchetto installabile. |
| Manifesto dell'agente dichiarativo | Le istruzioni, le conoscenze e le azioni dell'agente. Le sue actions voci fanno riferimento a manifesti di plug-in API o MCP inline. |
API o manifesto del plug-in MCP, ad esempio ai-plugin.json |
Integrazione di un'azione dell'agente, inclusa la connessione al server API o MCP e la configurazione di funzioni, strumenti e autenticazione applicabili. Non è il manifesto dell'app. |
Utilizza i plug-in MCP e API per gli agenti dichiarativi per aggiungere azioni a un agente. Per connettere invece un server MCP remoto a livello di pacchetto, utilizzare la configurazione MCP remota nel manifesto dell'app. Tale route utilizza agentConnectors, non l'API di un agente o il manifesto del plug-in MCP. Scegli il percorso supportato dall'esperienza di destinazione.
Percorso del plug-in
- Preparazione: Definisci il risultato, gli utenti previsti, i prodotti di destinazione e i requisiti per il plug-in.
- Crea o riutilizza: Scegli e integra le funzionalità di cui hai bisogno, quindi verifica come funzionano insieme.
- Package & test:Impacchetta il plug-in, quindi testalo e convalidalo per il percorso di pubblicazione previsto.
- Pubblicare & distribuire: Condividi o pubblica il plug-in testato attraverso un percorso supportato per il tuo pubblico.
- Rendere disponibili & regolare: Completare la revisione dell'amministratore, l'installazione, la disponibilità degli utenti e la configurazione dell'accesso.
- Monitorare, aggiornare & ritirare: Rivedi le prestazioni, supporta gli utenti, rilascia gli aggiornamenti e ritira il plug-in quando non è più necessario.
- Scopri & utilizzare: Esplora i plug-in disponibili nel catalogo dei plug-in di Copilot. Aiutare gli utenti a trovare e utilizzare il plug-in nel prodotto di destinazione; per Cowork, vedi Utilizzare i plug-in con Copilot Cowork.
Dopo aver pubblicato o condiviso il plug-in, gli utenti potrebbero comunque aver bisogno dell'approvazione, dell'installazione o della configurazione della connessione prima di poterlo utilizzare. I passaggi dipendono dal modo in cui è stato condiviso e dalle impostazioni dell'organizzazione.
Termini chiave
| Termine | Significato |
|---|---|
| Catalogo dei plug-in di Copilot | Un registro pubblico per scoprire i plug-in disponibili. |
| Registro dei plug-in | Una destinazione per i plug-in pubblicati o condivisi con un pubblico selezionato. |
| Strumenti Registro di sistema | Visualizzazione in Strumenti agenti>> nelRegistro nell'interfaccia di amministrazione di Microsoft 365 per plug-in, competenze, server MCP e visibilità dei connettori. |
| Registro degli agenti | La vista in Agenti>Tutti gli agenti>Registro per i controlli specifici dell'agente; un agente in pacchetto può anche avere un record Registro agenti. |
| Microsoft Marketplace | Un percorso di pubblicazione per raggiungere i clienti in tutte le organizzazioni. |
L'individuazione pubblica, la pubblicazione e l'amministrazione del tenant sono separate. Un'inserzione nel catalogo dei plug-in Copilot non stabilisce l'approvazione o la disponibilità dell'organizzazione. Registro strumenti, Registro agenti e Microsoft Marketplace non sono nomi intercambiabili per un catalogo.
Passaggio successivo
Contenuti correlati
- Si dispone di un progetto di origine agente dichiarativo esistente? Segui la guida introduttiva: crea il tuo primo plug-in con gli strumenti di sviluppo di Work IQ.
- Vuoi creare e impacchettare un plugin con strumenti pro-code? Segui Crea un plug-in con gli strumenti di sviluppo di Work IQ nella documentazione di GitHub.
- Stai creando un motore, un'app o un agente personalizzato? Segui il percorso di sviluppo dell'app.
- Hai bisogno di amministrare un plugin? Vedere la mappa di amministrazione Gestisci plug-in con Microsoft Agent 365.
- Vuoi pubblicare per i clienti? Consulta Creare e pubblicare plug-in per i clienti.