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.
Usa monitoraggio, feedback e prove di supporto per decidere se correggere, aggiornare, consegnare o ritirare il plug-in o l'agente. Testare le modifiche prima del rilascio e verificare il risultato con gli utenti previsti.
I costruttori mantengono e testano la soluzione. Gli amministratori di Microsoft 365 completano le azioni di implementazione e accesso dell'organizzazione quando necessario. I proprietari dei servizi gestiscono i connettori, i server MCP remoti, le identità e i servizi esterni usati. Queste responsabilità non vengono trasferite automaticamente insieme.
Scegliere un'attività
Usa la sezione per il lavoro che devi fare. Il monitoraggio, il supporto, l'handover e il ritiro non richiedono il completamento del flusso di lavoro di aggiornamento.
| Come procedere | Inizia con |
|---|---|
| Rivedere l'adozione, il feedback o i risultati delle attività | Monitorare l'utilizzo e i risultati delle attività |
| Analizzare un problema dell'utente | Supporta gli utenti e analizza i problemi |
| Modifica e rilascia la soluzione | Aggiorna il plug-in o l'agente |
| Trasferire le responsabilità di manutenzione | Cedere la proprietà e il supporto |
| Terminare la distribuzione o l'accesso | Ritirare il plug-in o l'agente |
Prima di iniziare
Identificare:
- Identità e versione corrente del plug-in o dell'agente.
- Gli utenti interessati e le esperienze di Microsoft 365.
- Proprietario responsabile dell'attività e di eventuali connessioni o servizi coinvolti.
Per un agente autonomo, usare le procedure di monitoraggio e rilascio supportate dal prodotto di creazione. Non dare per scontato che una procedura di pacchetto di plugin si applichi ad esso.
Monitorare l'utilizzo e i risultati delle attività
Scegliere un periodo di riferimento, una versione, un gruppo di destinatari e attività rappresentative. Usa l'esperienza di monitoraggio per il prodotto proprietario dell'attività.
| Cosa stai monitorando | Da dove iniziare | Ambito da tenere presente |
|---|---|---|
| Un agente integrato in Agent Builder | Monitorare gli agenti in Generatore agente | La scheda Monitor dell'agente ne illustra l'utilizzo e il feedback. La visibilità del feedback ha prerequisiti distinti. |
| Un agente di Copilot Studio che usa il cablaggio standard | Monitorare le prestazioni dell'agente in Copilot Studio | Usa le analisi supportate per quell'agente; non dare per scontato che gli stessi report esistano in Generatore di agenti o in altri percorsi di compilazione. |
| Accesso ai plug-in, attività utente ed errori | Monitorare il plug-in | Controllare la disponibilità del pacchetto, i risultati delle attività rappresentative, il feedback degli utenti e i casi di supporto. |
| Utilizzo e attività di controllo di Microsoft 365 | Scegliere gli elementi da controllare | Usare ogni report per l'attività coperta. Un evento di controllo non stabilisce che un'attività è riuscita o che una risposta è stata corretta. |
| Un connettore o un servizio MCP remoto | Analizzare gli errori e le indicazioni per il monitoraggio del servizio | Controllare lo stato della connessione, le autorizzazioni di origine, l'integrità degli endpoint, i log e gli errori con il proprietario del servizio. La disponibilità del pacchetto non dimostra l'integrità del runtime. |
Non dare per scontato che la telemetria o la copertura del report sia condivisa tra i percorsi di compilazione del plug-in e dell'agente. Il report di un agente incluso copre quell'agente, non necessariamente tutte le funzionalità del plug-in.
Registra le modifiche nell'adozione, il successo delle attività, la qualità delle risposte, gli errori di accesso o degli strumenti e il volume di supporto laddove le prove disponibili supportino tali conclusioni. Confrontare le attività rappresentative e il feedback degli utenti, nonché i conteggi degli utilizzi.
Supporta gli utenti e analizza i problemi
Per ogni problema, acquisire la versione interessata, il prodotto, il pubblico, il risultato previsto, il risultato osservato e i dettagli dell'errore rilevanti. Assegnare un proprietario e azione successiva.
- Chiedere all'amministratore di esaminare la disponibilità, l'installazione, i criteri o le richieste di accesso in sospeso.
- Chiedi al costruttore o al proprietario dell'agente di indagare su istruzioni, conoscenze, selezione degli strumenti o regressioni.
- Chiedere al proprietario dell'identità, della connessione o del servizio di analizzare gli errori di autenticazione, consenso, accesso all'origine e runtime.
Per gli errori di accesso alle azioni API o MCP, usare Risoluzione dei problemi di autenticazione del plug-in. Per i controlli delle attività e delle dipendenze, usare Analizza errori.
Conferma la correzione con un utente interessato e registra il risultato. Una configurazione corretta o una chiamata di strumento riuscita non stabilisce di per sé che l'attività completa dell'utente ora funzioni.
Aggiorna il plug-in o l'agente
Segui questo flusso di lavoro quando devi modificare la soluzione. Utilizzate i passaggi del pacchetto per un plug-in composto. Usare la procedura di rilascio del prodotto di creazione per un agente autonomo.
Prima dell'aggiornamento
Avere:
- Prove di monitoraggio, feedback degli utenti, casi di supporto o miglioramenti pianificati.
- Compiti rappresentativi e criteri di accettazione.
- Accesso all'origine e alle funzionalità interessate.
- Il record di pubblicazione, inclusi la versione corrente, il gruppo di destinatari e la route di distribuzione.
- Proprietari di eventuali modifiche di connessione, identità o servizio.
Stabilire una linea di base
- Indicare il problema o il miglioramento che si desidera affrontare.
- Identificare il pacchetto o la versione dell'agente interessato, gli utenti, le esperienze, le funzionalità e le dipendenze.
- Definire compiti rappresentativi e criteri di accettazione misurabili.
- Eseguire le attività sulla base della versione corrente e registrare i risultati.
- Se l'organizzazione amministra il plug-in, registrarne lo stato corrente, la disponibilità degli utenti e lo stato di installazione neiplug-indegli strumenti>degli agenti>. Per i controlli applicabili di un agente, usa il>registro ditutti gli agenti>.
- Conserva le prove necessarie per confrontare il comportamento corrente e aggiornato.
Per un plug-in che include un agente, usa Panoramica della valutazione dell'agente per progettare una valutazione quando la qualità della risposta, le istruzioni, le conoscenze o l'uso degli strumenti fanno parte del cambiamento. La valutazione può fornire prove pre-rilascio e aiutare a indagare i problemi di qualità post-distribuzione, inclusi quelli sollevati da segnali di utilizzo, feedback degli utenti o modifiche di agenti e dipendenze.
La valutazione dell'agente non è necessaria per tutti i plug-in. Non sostituisce i test delle funzionalità, la convalida dei pacchetti o il test dell'esperienza utente completa.
Per gli agenti dichiarativi distribuiti, usare il flusso di lavoro guidatowiqd agent eval. Per il controllo diretto della riga di comando o della pipeline, vedi Panoramica dell'interfaccia della riga di comando di Microsoft 365 Copilot Evaluations.
Applicare e testare la modifica
Tornare a Creare o riutilizzare quando è necessario modificare una funzionalità, un'integrazione o un'origine. Restituire al pacchetto & testare quando è necessario preparare e convalidare la release candidate. Mantieni le dipendenze interessate e le esperienze supportate nell'ambito.
- Aggiornare l'origine o la funzionalità interessata.
- Aggiornare i servizi o la configurazione gestiti separatamente quando la modifica lo richiede.
- Testare ogni funzionalità modificata e dipendenza interessata.
- Eseguire di nuovo le attività e le valutazioni previste.
- Confrontare i risultati con i criteri di accettazione.
- Esaminare le regressioni prima di creare il pacchetto di rilascio.
Quando la modifica interessa un connettore, un server MCP remoto, un'identità, un'autorizzazione o un servizio esterno, coinvolgere il proprietario della dipendenza. Non dare per scontato che la modifica del pacchetto aggiorni un servizio gestito separatamente.
Creare e convalidare il pacchetto
Per un agente autonomo, seguire le istruzioni di controllo delle versioni, test e pubblicazione del prodotto di creazione. I passaggi seguenti del pacchetto si applicano ai plug-in composti.
- Assegnare una nuova versione del pacchetto e verificare i requisiti di identità per il metodo di pubblicazione.
- Crea il pacchetto del plug-in.
- Convalidare e testare il pacchetto esatto che si intende rilasciare.
- Verificare l'accesso, il consenso, le connessioni e i servizi esterni richiesti.
- Testa il pacchetto in ogni esperienza di Microsoft 365 che intendi supportare.
- Registrare le limitazioni note, la configurazione necessaria e qualsiasi opzione di ripristino documentata.
Non pubblicare un pacchetto diverso da quello convalidato.
Pubblicare e distribuire l'aggiornamento
Scegliere la procedura di aggiornamento per il prodotto e il percorso di distribuzione. I percorsi di pubblicazione distinguono la condivisione, l'invio dell'organizzazione e la pubblicazione nel Marketplace.
| Percorso di distribuzione | Linee guida documentate o limitazioni | Chi agisce |
|---|---|---|
| Un plug-in condiviso tramite Cowork | Segui la procedura di caricamento e ricondivisione documentata per una versione più recente di un plug-in già condiviso. Questa procedura si applica alla condivisione di Cowork, non alla sostituzione generale del Registro di sistema. | Proprietario del plug-in |
| Invio del catalogo delle app dell'organizzazione tramite gli strumenti di sviluppo di Work IQ |
Seguire Invia un aggiornamento approvato al catalogo app dell'organizzazione. Mantenere l'identità e lo stato dell'ambiente esistenti della destinazione della versione, testare la versione aggiornata, inviare e wiqd plugin publishottenere l'approvazione dell'amministratore. |
Proprietario e amministratore del plug-in |
| Caricamento manuale nel Registro di sistema o altro metodo di condivisione diretta | Confermare la procedura di aggiornamento dell'elemento esistente specifica del prodotto prima del rilascio. Questo articolo non fornisce i passaggi manuali per la sostituzione dei pacchetti del Registro di sistema. Non dare per scontato che un nuovo caricamento sostituisca una voce esistente o ne conservi le impostazioni di disponibilità. | Proprietario e amministratore del plug-in |
| Microsoft Marketplace | Seguire le indicazioni di aggiornamento per il tipo di offerta usate dall'offerta pubblicata. Iniziare con le indicazioni del Centro per i partner collegate da Pubblicare il plug-in in Microsoft Marketplace. Completare le eventuali revisioni e pubblicazioni necessarie prima di indirizzare i clienti all'aggiornamento. | Editore e amministratore del cliente, se necessario |
Per un aggiornamento di WIQD, mantenere gli ID risorsa e pubblicazione stabiliti. Un nuovo provisioning usa l'identità di ambiente esistente e può modificare le risorse usate dagli utenti correnti prima dell'approvazione del catalogo. Testare le modifiche tenendo presente questo effetto. Verificare il ciclo di vita di pubblicazione del progetto rispetto alle indicazioni di WIQD per i progetti esistenti. l'aggiornamento dell'interfaccia della riga di comando non aggiorna i file di progetto.
wiqd plugin publish invia un progetto e un ambiente, non uno ZIP acquisito tramite --package-file. Mantenere fissi lo stato di origine e ambiente approvati tramite l'invio e verificare la versione inviata. La convalida del pacchetto da sola non dimostra che la pubblicazione invii esattamente quei byte.
Per una route con una procedura di aggiornamento documentata:
- Utilizzare la procedura di pubblicazione o condivisione confermata per la versione di test e registrare se è stata inviata, pubblicata, condivisa, rifiutata o bloccata.
- Fornire all'amministratore o al proprietario dell'implementazione la versione esatta, gli utenti previsti, la configurazione richiesta, le limitazioni note e il contatto del supporto tecnico.
- Completare solo i passaggi applicabili per rendere disponibile il plug-in o l'agente aggiornato. I requisiti di approvazione, assegnazione e installazione dipendono dal metodo e dalle impostazioni dell'organizzazione.
- Aggiorna agenti, connessioni, identità, server MCP remoti o servizi esterni controllati separatamente quando necessario.
- Conferma la versione che ha raggiunto ogni gruppo di destinatari.
Pianificare il ripristino senza presumere il rollback
Gli amministratori possono bloccare e sbloccare un plug-in nell'interfaccia di amministrazione di Microsoft 365. Usa l'azione Sblocca del plug-in per rimuovere un blocco, quindi verifica l'accesso per gli utenti previsti. Si applicano ancora altri requisiti di disponibilità, installazione, autorizzazione e connessione. Lo sblocco non ripristina una versione precedente del pacchetto o annulla le modifiche al servizio.
Le linee guida attuali non documentano una procedura generale di rollback della versione del pacchetto di plug-in. Utilizzare un'operazione di rollback specifica del prodotto solo quando il prodotto la documenta.
Prima del rilascio, registrare l'opzione di ripristino documentata e i relativi prerequisiti oppure registrare il gap nella procedura e il proprietario responsabile di un'implementazione non riuscita.
La sostituzione di un pacchetto non ripristina automaticamente un servizio esterno, una connessione, un'identità, dati o una modifica delle autorizzazioni. Pianifica queste dipendenze separatamente.
Verificare l'aggiornamento
- Testare le attività rappresentative con un utente previsto in ogni esperienza supportata.
- Verifica che l'utente abbia ricevuto la versione prevista.
- Conferma che l'accesso, il consenso, le connessioni, le chiamate agli strumenti e i servizi esterni funzionino.
- Posizione in cui il plug-in è amministrato nell'organizzazione, verifica che lo stato, la disponibilità degli utenti e lo stato di installazione corrispondano al pubblico previsto inPlug-indegli strumenti>degli agenti>. Verifica se sono presenti versioni obsolete ancora in uso.
- Ripetere le valutazioni usate per approvare la modifica.
- Esamina i segnali di utilizzo, il feedback, gli errori e i casi di supporto dopo l'implementazione.
- Se l'aggiornamento non soddisfa i criteri di accettazione, sospendere l'implementazione, registrare l'errore e coinvolgere il proprietario responsabile. Utilizzare un'operazione di ripristino solo quando il prodotto la documenta.
L'aggiornamento è completo quando il gruppo di destinatari previsto dispone della versione corretta, le impostazioni di accesso corrispondono all'implementazione prevista, le attività rappresentative soddisfano i criteri di accettazione e ogni problema non risolto ha un proprietario e un'azione successiva.
Registrare l'aggiornamento
Registra:
- Versioni precedenti e aggiornate di pacchetti o agenti.
- Modifica, motivo, funzionalità interessate e dipendenze.
- Risultati di base, valutazione, convalida e test utente.
- Metodo di pubblicazione, gruppo di destinatari, stato di implementazione e stato del Registro di sistema applicabile.
- Modifiche alla configurazione o al servizio.
- Limitazioni note, opzioni di ripristino documentate o lacune nella procedura e proprietario del supporto.
Cedere la proprietà e il supporto
Prima che il proprietario attuale lasci il ruolo, assegna al proprietario successivo:
- L'identità dell'origine, del pacchetto o dell'agente, la versione corrente, i record di rilascio e la route di pubblicazione.
- Posizioni di monitoraggio, test rappresentativi, problemi noti e casi di supporto aperti.
- Il gruppo di destinatari previsto, i contatti di amministrazione, le connessioni necessarie e i proprietari dei servizi esterni.
- Le procedure documentate di aggiornamento, recupero e ritiro, incluse eventuali lacune.
Per un agente condiviso integrato in Agent Builder o Copilot Studio, usare Assegna nuovo proprietario a un agente quando si applica questa procedura. Generatore agente supporta anche l'aggiunta di un proprietario. Esaminare gli effetti sull'accesso del proprietario precedente prima di apportare una modifica.
Queste sono procedure di proprietà dell'agente, non una procedura di trasferimento generale per il pacchetto di plug-in esterno. Confermare separatamente l'accesso all'origine, l'accesso alla pubblicazione, le connessioni, le credenziali e le responsabilità del servizio. Chiedere al proprietario successivo di verificare che sia possibile monitorare, gestire e supportare la soluzione.
Ritirare il plug-in o l'agente
Ritirare la soluzione quando non è più necessario usarla. Decidere se terminare la distribuzione per tutti i clienti o rimuovere l'accesso solo all'interno dell'organizzazione. Questi ambiti sono diversi.
- Identificare le versioni attive, gli utenti, i percorsi di pubblicazione e condivisione e le dipendenze condivise.
- Inviare notifiche agli utenti e ai team di supporto, incluse eventuali sostituzioni e la data di ritiro.
- Arrestare la distribuzione e l'accesso attraverso la route supportata e rimuovere le installazioni di amministratore, se necessario.
- Chiedere ai proprietari del servizio di rimuovere l'accesso e le risorse specifiche del plug-in preservando le risorse utilizzate da altre soluzioni.
- Verificare il risultato con un utente autorizzato in precedenza e registrare le risorse conservate, le eccezioni e i proprietari.
Per ritirare un pacchetto, vedere Ritirare il plug-in. Per un agente singolo, utilizzare la procedura di prodotto applicabile, ad esempio Elimina agenti. Non dare per scontato che la rimozione di un agente o di un pacchetto revochi ogni connessione, autorizzazione o servizio esterno.
Contenuti correlati
- Monitorare il plug-in
- Monitorare gli agenti in Generatore agente
- Funzionalità di compilazione o riutilizzo per il plug-in
- Creare un pacchetto del plug-in
- Convalidare e testare il plug-in
- Scegliere come pubblicare e distribuire il plug-in
- Rendi disponibili plug-in e agenti
- Gestire l'accesso, gli strumenti e le connessioni
- Gestisci plug-in, abilità e server MCP
- Ritirare il plug-in