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.
Testa l'esatto artefatto con versione prodotto da Crea il pacchetto del plug-in. Nel test & pacchetto connettere l'evidenza del componente a tale file ZIP, installarlo tramite una route supportata e verificare la versione recapitata, l'accesso e il comportamento di runtime reale in ogni esperienza Microsoft dichiarata.
Concludi con questa evidenza: "Ho testato questi componenti, confezionato questi riferimenti esatti, installato questa versione esatta, eseguito questi scenari e conservato questi risultati". Un controllo dello schema riuscito, un comando di provisioning o una risposta plausibile non stabilisce quella catena.
Prima di iniziare
Avere:
- Test di integrazione e dei componenti completati, inclusi i dati di test noti e i risultati previsti.
- ZIP candidato, identità/versione del pacchetto e versioni dei componenti, endpoint e riferimenti di connessione che contiene.
- Un tenant di sviluppo, dati non di produzione, una route di installazione supportata per i componenti del pacchetto e l'autorizzazione per usarlo.
- Verificare le identità per gli utenti autorizzati e con restrizioni. un amministratore autorizzato per la disponibilità e i test di blocco.
- Licenze, accesso, consenso, connessioni e servizi esterni necessari per ogni esperienza di destinazione.
- Un record di test per ogni scenario e identità.
Prima di testare, definire il pacchetto richiesto, l'installazione, l'accesso e i controlli di runtime e le prove che stabiliranno ogni risultato. Usare i criteri di evidenza specifici del componente per le attestazioni di runtime e l'evidenza di installazione descritti in Confermare la versione consegnata.
Ottenere l'approvazione prima di caricare un pacchetto, installarlo, concedere il consenso, condividerlo o modificare le impostazioni di amministrazione. Queste procedure cambiano lo stato del tenant; Utilizzare identità e gruppi di destinatari di test controllati.
Convalidare schemi e riferimenti ai componenti
Aprire il file ZIP del candidato senza modificarlo. Leggi la sua radice manifest.json, registrazione id, versione manifestVersion. Conferma che:
- Il manifesto usa lo schema del manifesto dell'app Microsoft 365 richiesto dalla route.
- Le definizioni degli agenti e i manifesti delle azioni inclusi usano gli schemi applicabili. Il manifesto di un plug-in API descrive un'azione dell'agente, non il plug-in del registro esterno.
- Le cartelle di abilità a cui si fa riferimento, i file complementari, le icone e le descrizioni degli strumenti esistono nei percorsi dichiarati del pacchetto.
- Le versioni, gli identificatori, gli endpoint e i riferimenti di connessione corrispondono ai record di test del componente e all'ambiente previsto.
- Non sono incluse credenziali, segreti, log o file di test non correlati.
Per gli strumenti di sviluppo di Work IQ, usa i prerequisiti CLI documentati, tra cui Node.js 24.15+, npm e PowerShell 7+ per questi esempi di Windows. Un controllo facoltativo dell'origine offline nel progetto esistente è:
wiqd plugin validate --mode source --env "<test-environment>"
Verifica: I controlli della fonte applicabile vengono superati e le funzionalità ignorate o scoperte vengono registrate.
La modalità di origine controlla la diagnostica dell'agente dichiarativo salvata e le protezioni di progetto di base. Non convalida completamente lo schema dell'app, il contenuto delle competenze, la radice agentConnectors[]o il contenuto API/OpenAPI a cui si fa riferimento. Un progetto di sola competenza o solo connettore non può avere controlli agente applicabili. Usare source esplicitamente: la modalità predefinita è la convalida del pacchetto, non un controllo offline.
Convalidare il pacchetto esatto
Selezionare un file ZIP in modo esplicito anziché basarsi su una directory di compilazione con più candidati. In PowerShell sostituire il percorso di esempio con l'artefatto:
$packageFile = (Resolve-Path '.\appPackage\build\<candidate>.zip').Path
Get-FileHash -LiteralPath $packageFile -Algorithm SHA256
Verifica: Il file risolto è il candidato previsto. Facoltativamente, mantenere l'hash calcolato localmente per rilevare le modifiche successive; Un hash locale non dimostra quali byte esegue l'host.
Prima di una convalida autenticata, accedere con l'identità di Microsoft 365 prevista:
wiqd auth login --interactive wiqd doctorVerifica: I controlli di autenticazione e conformità hanno esito positivo per il tenant previsto.
Con l'approvazione per caricare questo file ZIP nel servizio di convalida della piattaforma, esegui:
wiqd plugin validate --mode package --package-file "$packageFile"Verifica: I risultati per questo esatto file ZIP soddisfano i controlli richiesti; conservare i report JSON e HTML non modificabili restituiti.
Se il percorso di pubblicazione richiede i criteri di marketplace aggiuntivi e i controlli delle prove, esegui:
wiqd plugin validate --mode marketplace --package-file "$packageFile"Verifica: I controlli dei pacchetti, dei criteri e delle prove richiesti vengono superati, senza prove richieste mancanti.
Entrambi package usano marketplace il file ZIP integrato, lo caricano e possono richiedere l'accesso. Non la compilano o non accedono automaticamente. Accettano anche un file ZIP senza il relativo progetto di origine. La modalità Marketplace aggiunge controlli di criteri e prove. Il report non è l'approvazione ufficiale dello Store o del Centro per i partner. Seguire il contratto di convalida WIQD corrente, non i nomi obsoleti deep, static, o manifest della modalità.
Leggere i risultati, la copertura, i controlli ignorati e le prove richieste, non solo il risultato di uscita del comando. Per un percorso del pacchetto Agents Toolkit supportato, utilizza Convalida pacchetto app utilizzando regole di convalida o atk validate --app-package-file-path <path> come documentato in Convalidare l'app.
In caso di modifiche nel file ZIP, creare un nuovo suggerimento e ripetere la convalida. Le modifiche al servizio remoto richiedono un nuovo test di runtime rilevante anche quando il file ZIP rimane invariato.
Installare o trasferire localmente il pacchetto
Usare una route che accetti il pacchetto nativo dell'app Microsoft 365 e ne supporti i componenti. Un collegamento per l'installazione e il test del provisioning WIQD identifica una distribuzione. l'apertura non stabilisce che è stato installato il file ZIP convalidato finale.
Installazione personale exact-ZIP
Seguire la procedura di sideloading personale di Cowork per l'installazione, l'autenticazione e l'installazione del pacchetto quando il pacchetto e l'esperienza di destinazione sono supportati. Passare il file esatto selezionato in Convalidare il pacchetto esatto, utilizzando $packageFile come valore di --file-path e Personal come ambito.
Verifica: L'installazione è riuscita per l'account previsto. Salva l'identità/versione del pacchetto restituita TitleId e AppId insieme all'output del programma di installazione e all'identità/versione del pacchetto. Nell'esperienza supportata verifica che il plug-in installato espone i componenti e l'identità previsti e che le connessioni necessarie siano complete.
Se il criterio disabilita la route personale o la route non è supportata per il candidato, usare una route compatibile approvata anziché modificare i controlli di sicurezza.
Caricamento del pacchetto Cowork
Per un pacchetto Cowork supportato, segui Carica un pacchetto di plug-in e le relative indicazioni per la condivisione. Scegli il file ZIP nativo di Microsoft 365 esattamente convalidato e limita l'accesso all'identità di test o a un gruppo di destinatari di test esplicitamente autorizzato. Segui Usa i plug-in con Cowork per abilitare il plug-in e completare le connessioni necessarie in una nuova conversazione.
Verifica: Il file selezionato e l'identità del plug-in visualizzata corrispondono al record candidato. Il plug-in viene installato per l'identità prevista, vengono visualizzate le competenze previste e lo stato del connettore e le operazioni protette usano l'account connesso previsto.
I caricamenti in formato straniero possono essere convertiti automaticamente. Tale conversione non è la prova che lo ZIP originale di Microsoft 365 sia stato testato senza modifiche. Ristabilire l'elemento e l'evidenza di convalida se la route lo trasforma.
Conferma la versione consegnata
Mantieni un record di installazione che colleghi l'esatto file ZIP selezionato e il relativo manifesto id , nonché version all'installazione andata a buon fine, all'account previsto e alle identità di installazione restituite. Per il percorso di sideloading personale documentato, conservare il comando con il percorso del file risolto, i metadati del manifesto del candidato e l'output del programma di installazione contenente TitleId e AppId. Per un caricamento nativo di Cowork supportato, conservare il file selezionato e il record di caricamento/installazione riusciti con l'identità del plug-in e l'account di test visualizzati.
Usa quella catena come prova di installazione per il candidato testato. Correlare i metadati della versione esposti dall'host o dalla route di amministrazione con il candidato e analizzare le mancate corrispondenze prima del test. Registrare le prove di installazione separatamente dalla chiamata.
I passaggi di installazione personali citati non documentano una query universale sulla versione installata o un hash del pacchetto lato server. Nessuno dei due è richiesto da questa procedura: il record di installazione stabilisce quale candidato è stato inviato e installato correttamente, non una verifica indipendente dei byte eseguiti dall'host. Se i criteri di rilascio richiedono una versione indipendente sul lato host o la verifica dei byte, ottenere tale prova; la sua assenza rimane non verificata e blocca tale rivendicazione di rilascio. Un collegamento di provisioning, il nome del plug-in, la risposta riuscita o l'hash locale da soli non stabiliscono la catena di installazione.
Per un candidato gestito dall'amministratore, seguire la procedura di caricamento e installazione del Registro di sistema corrente, definire l'ambito per gli utenti di test e conservare l'elemento e il record di installazione accettati. Se la route accetta un tipo di artefatto diverso o non può stabilire la relazione con lo ZIP convalidato, considerare il controllo di associazione dell'artefatto come non verificato, non equivalente.
Testare il plug-in in pacchetto
Ripetere gli scenari di integrazione completi con il candidato installato, non con la distribuzione di sviluppo precedente:
Avvia una nuova conversazione in ogni esperienza richiesta. Usare lo stesso ruolo di identità, record noto, input e risultato previsto dei test del componente.
Verifica: viene selezionato il componente installato previsto.
Raccogliere le prove specifiche del componente. Per le chiamate remote, correlare i log del servizio autenticati con la richiesta, gli input e i dati restituiti.
Verifica: L'evidenza host identifica la competenza selezionata o caricata, se applicabile. Le chiamate agli strumenti necessarie hanno prove di chiamata correlate e i dati restituiti contribuiscono alla risposta.
Controlla i file di output e le citazioni. Ripetere l'errore applicabile e i casi limite.
Verifica: La correttezza, i limiti di accesso, le approvazioni e il comportamento degli errori soddisfano i criteri predefiniti.
Per le funzionalità delle note di rilascio, riutilizza Added CSV export; Fixed duplicate rows; Updated help text. le funzionalità di controllo, le correzioni, Altro e i file promessi. Per una ricerca MCP, confrontare il titolo, lo stato e l'URL esatti del problema noto con i registri del servizio. Utilizzare gli strumenti di evidenza specifici del componente; Un percorso di diagnostica dell'agente da solo non stabilisce che è stato eseguito un plug-in installato autonomo.
Tenere separati i risultati di correttezza e di chiamata. Le prove mancanti per un controllo richiesto rimangono non verificate. Registrare i controlli di diagnostica aggiuntivi non disponibili come limitazioni, non come dettagli di esecuzione verificati o errori automatici. Ripetere separatamente i test di individuazione, connessione, selezione e runtime in Chat e Cowork quando si richiedono entrambi.
Testare l'autenticazione e l'accesso
Chiedere a un amministratore autorizzato di preparare impostazioni di test controllate tramite Imposta la disponibilità dei plug-in per gli utenti e Gestisci plug-in, funzionalità e server MCP. Registrare le impostazioni originali e ripristinarle dopo il test approvato. Usa la stessa ricerca innocua o uno scenario equivalente supportato dal tuo plug-in. Per un controllo inapplicabile, come il consenso al servizio in uno scenario di sola competenza, registrare il motivo anziché aggiungere una funzionalità.
| Condizione | Configurazione e azione | Risultato previsto |
|---|---|---|
| Utente autorizzato | Includere l'identità di test nel gruppo di destinatari approvato. Accedi come tale utente e completa il consenso/le connessioni richiesti. | Lo scenario supportato ha esito positivo entro le autorizzazioni di origine dell'utente; L'evidenza di chiamata identifica la capacità prevista. |
| Utente con restrizioni | Limita la disponibilità al gruppo di destinatari approvato, quindi esegui il test con un account esterno a tale gruppo di destinatari. | L'utente non può usare il plug-in. Nel canale Copilot, l'inserzione può rimanere individuabile come bloccata; Gli utenti idonei possono richiedere l'accesso. La visibilità da sola non è un fallimento. |
| Consenso negato | Usa un'identità/connessione di prova senza una concessione esistente. Rifiutare il consenso richiesto per l'operazione e riprovare la ricerca protetta. | L'operazione non ottiene l'accesso protetto richiesto. Registrare l'errore di accesso/consenso e assicurarsi che nessun risultato protetto venga presentato come positivo. Le funzionalità consentite non correlate possono comunque funzionare. |
| Blocca e sblocca | Chiedere all'amministratore di seguire Bloccare un plug-in o una competenza per il candidato. Ripetere la richiesta con un utente precedentemente autorizzato, quindi chiedere all'amministratore di selezionare Sblocca per il plug-in e ripetere nuovamente la richiesta. | Mentre è bloccato, il plug-in e gli agenti dipendenti non possono essere usati. I connettori/server MCP associati rimangono disponibili per altri plug-in. Dopo lo sblocco, l'utente autorizzato in precedenza può usare nuovamente il plug-in, in base ai requisiti originali di disponibilità, autorizzazione e connessione. |
Le restrizioni della categoria dell'editore sono controlli separati. Se ne provi uno, registra la categoria e il risultato della sua politica; Non modificare le impostazioni a livello di organizzazione solo per testare un candidato. Testare il rinnovo/la riconnessione dell'accesso, le autorizzazioni di origine e le connessioni mancanti, se applicabile.
Per l'autenticazione con codice di autorizzazione di Microsoft Entra, il consenso negato restituisce un errore di autorizzazione. Utilizzare l'errore effettivo del provider anziché aspettarsi una formulazione identica in ogni host.
Testare le esperienze supportate
Registra un risultato per esperienza, ruolo di identità e scenario, inclusa l'evidenza dell'installazione e della versione consegnata. Un pass in Cowork non stabilisce un pass in Chat o in un altro host. Utilizzare il percorso supportato per ciascuno; L'installazione non risolta o l'evidenza della versione impedisce una richiesta di rilascio per tale esperienza.
Registra risultati di qualità agente
Se è incluso un agente e i criteri di rilascio richiedono una valutazione della qualità, valutare la versione distribuita corrispondente e collegare i risultati al record candidato. Inizia con Panoramica della valutazione dell'agente. I punteggi di qualità non sostituiscono il pacchetto, la versione installata, l'accesso o l'evidenza di chiamata.
Ripetere i test di regressione per un candidato
Eseguire nuovamente gli scenari di base registrati, i test di accesso, i casi di errore e qualsiasi valutazione dell'agente necessaria per il candidato installato. Aggiungere casi specifici della modifica senza rimuovere la previsione. Conserva entrambi i set di record di test, confronta i risultati e risolvi le regressioni o i controlli non verificati richiesti prima dell'approvazione.
Per la preparazione di base e il ciclo di vita dell'aggiornamento, incluse le decisioni di pubblicazione, implementazione, sostituzione e rollback, segui Monitora, aggiorna e ritira il plug-in o l'agente. Non presupporre aggiornamenti automatici, assegnazioni conservate o un particolare trigger di riconsenso. Dopo l'implementazione, ripetere la verifica della versione consegnata e del runtime.
Determinare la preparazione al rilascio
Completa il record di test condiviso con l'identità e la versione del pacchetto, il file ZIP esatto e l'hash facoltativo, le versioni e gli endpoint dei componenti, l'ambiente, il ruolo dell'identità di test, lo scenario, i risultati previsti ed effettivi, le prove di chiamata sterilizzate, lo stato e il proprietario. Allegare rapporti di convalida e prove di installazione e versione.
Assegna un risultato:
- Pronto - Il candidato esatto ha superato tutti i controlli richiesti con prove complete e nessun blocco di rilascio irrisolto.
- Bloccato : un controllo richiesto non è riuscito o rimane non verificato, inclusa l'associazione dell'elemento, la versione consegnata, l'accesso o la chiamata.
- Pronto con limitazioni - Controlli richiesti superati; Le restanti limitazioni non bloccanti sono documentate, accettate e idonee per la divulgazione.
Applicare i controlli richiesti e i criteri di prova definiti prima del test. Una limitazione diagnostica accettata non può trasformare le prove richieste mancanti in un passaggio; La diagnostica aggiuntiva non è obbligatoria se i controlli necessari contengono già prove sufficienti. Per ogni blocco, registrare un proprietario e una risoluzione. Crea un nuovo candidato quando l'artefatto cambia, reinstallalo e ripeti i test di regressione e interessati.
Contenuti correlati
- Creare il pacchetto di plug-in
- Testa insieme i componenti del plug-in
- Monitora, aggiorna e ritira il plug-in o l'agente
Passaggio successivo
Quando le prove richieste sono complete, continua a pubblicare & distribuire: