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.
Verifica cosa contiene o fa riferimento il pacchetto di plug-in: competenze, connettori MCP remoti e un agente dichiarativo, se ne includi uno. Questa attività di test Package & stabilisce il comportamento e l'integrazione dei componenti prima di creare l'artefatto di rilascio. Seguono i controlli finali di convalida del pacchetto, installazione e esperienza di rilascio in Testare e convalidare il plug-in. Scegliere i test per i componenti, conservare un record di test e quindi completare prima del pacchetto.
Scegli i tuoi test
Verificare i componenti nello scenario integrato
| Nel plug-in | Esegui il test con | Sezione |
|---|---|---|
| Competenze a livello di plug-in, con o senza un agente | Sessione di sviluppo Cowork; selezione delle competenze tramite chat supportata | Testare le competenze |
| Connettori plug-in che puntano a server MCP remoti | Inspector, quindi la stessa attività tramite il plug-in in Cowork | Test dei connettori MCP remoti |
| Agente dichiarativo, se incluso | Work IQ Dev Tools ask command e DevUI | Testare un agente dichiarativo incluso |
| Dipendenze usate dalla soluzione | Diagnostica del connettore, quindi ripetere l'attività integrata | Dipendenze di test |
Conoscere il connettore che si sta testando
-
Connettore plug-in: Una voce del manifesto
agentConnectors[]dell'app. Questo articolo testa il tipo MCP remoto: il pacchetto fa riferimento a un server; Non contiene il servizio in esecuzione. - Connettore Copilot (sincronizzato): Inserisce conoscenze in Microsoft Graph. Testa l'inserimento e il successivo recupero come dipendenze.
- Connettore Copilot (federato): Recupera i dati in tempo reale sotto l'identità connessa. Testare l'accesso live separatamente dall'inserimento.
- Connettore di Power Platform: Uno strumento di Copilot Studio. Il test non stabilisce che il suo agente sia un plug-in di registro.
Il riferimento alla creazione del plug-in documenta anche un percorso esplicito per i riferimenti ai connettori personalizzati OpenAPI esistenti. Utilizzare i requisiti di quel percorso, se applicabile; la procedura MCP in questo articolo non verifica quel tipo di connettore.
Come giudicare un risultato
Controlla ogni componente in modo indipendente, quindi esegui un'attività che usa i componenti insieme. Una chiamata di servizio diretta andata a buon fine stabilisce il comportamento del server. L'attività integrata stabilisce la selezione, l'input, l'autenticazione e l'uso dei dati restituiti.
Prima di eseguire il test, definisci i controlli richiesti e le prove accettabili per ogni componente e esperienza di destinazione. Includi la selezione dei componenti, i risultati corretti e i limiti di accesso. Utilizzare prove appropriate per l'affermazione:
| Componente o attestazione | Prove da conservare |
|---|---|
| Selezione delle competenze e comportamento | Prove host che identificano la competenza selezionata o caricata, oltre agli output e ai file richiesti. Nel pannello laterale di Cowork, Competenze identifica le competenze caricate. La selezione esplicita non stabilisce la chiamata automatica. |
| Invocazione MCP remota | I log del servizio autenticati erano correlati alla richiesta host, identificando l'operazione, gli input e il risultato. Una chiamata di controllo diretta non stabilisce una chiamata tramite il plug-in. |
| Agente incluso | Identità dell'agente distribuita, richiesta e risposta e diagnostica di selezione, recupero e citazione delle funzionalità disponibili. La sola diagnostica dell'agente non stabilisce la chiamata di ogni abilità o script incluso. |
| Competenze per l'esecuzione di script | Diagnostica dell'esecuzione quando esposto. I file di output necessari stabiliscono il risultato di output, non la prova che un particolare script è stato eseguito. Se l'esecuzione di tale script è un requisito di rilascio, ottieni prove che lo stabiliscano. |
- Giudica la correttezza della risposta separatamente dalla prova dell'invocazione. Un agente può produrre note di rilascio plausibili senza caricare la tua competenza.
- Le prove mancanti per un controllo richiesto rimangono non verificate e bloccano la preparazione. Non indebolire un controllo necessario perché la diagnostica non è disponibile.
- Quando un host non espone ulteriori dettagli diagnostici, registrare tale limitazione senza affermare che il dettaglio è stato verificato. La diagnostica non disponibile non è un blocco separato quando le prove soddisfano già i controlli richiesti.
- Considerare un fallback invisibile all'utente o un risultato incompleto come un errore.
- Salva le prove sterilizzate in un archivio approvato, mai credenziali. Gli snapshot dell'agente possono contenere contenuto sensibile.
Prerequisiti e dati di test noti
Usa un progetto di plug-in esistente, un tenant di sviluppo, identità di test note e dati non di produzione. Seleziona gli ambienti e le esperienze Microsoft che intendi supportare. Autorizzare l'accesso, il consenso, le connessioni e i servizi esterni richiesti prima del test.
Per i comandi seguenti, installa gli strumenti di sviluppo di Work IQ: Node.js 24.15+ e npm sono necessari per l'interfaccia della riga di comando, oltre a PowerShell 7+ in Windows.
Preparazione:
- Record noto: Problema 123 in un repository di test, con il titolo, lo stato e l'URL esatti registrati dall'origine.
-
Input di abilità:
Added CSV export; Fixed duplicate rows; Updated help text.Per una funzionalità di note sulla versione, aspettati rispettivamente funzionalità, correzioni e altro, oltre a qualsiasi file promesso o contenuto prodotto da script.
Sostituisci i nomi, gli ID e i segnaposto di esempio. Accedere e verificare la preparazione prima dei comandi del tenant:
wiqd auth login --interactive
wiqd doctor
Verifica: I controlli di accesso e conformità hanno esito positivo per il tenant previsto.
Per le richieste dell'assistente facoltativo, installa l'interfaccia della riga di comando di GitHub Copilot. Se il plug-in della guida WIQD non è già installato, eseguire questi comandi, quindi avviare una nuova sessione nel progetto di plug-in esistente:
copilot plugin install wiqd@awesome-copilot
copilot plugin list --json
copilot
Verifica: Inventario mostra la guida WIQD installata e abilitata. Le installazioni esistenti devono seguire la guida all'installazione anziché aggiungere duplicati. Questo plug-in della guida non installa l'interfaccia della riga di comando di WIQD. Incollare le richieste dell'assistente alla codifica nella sessione dell'assistente alla codifica. Le richieste dell'agente distribuito usano invece l'opzione -q in Testare un agente dichiarativo incluso.
Testare le competenze
Componente plug-in: Competenze a livello di plug-in registrate tramite app-manifest agentSkills.
Cosa dimostra: L'abilità prevista viene caricata e produce l'output previsto in una distribuzione di sviluppo.
Ancora da dimostrare dopo l'imballaggio: L'artefatto esatto viene convalidato, installato attraverso il percorso di distribuzione ed eseguito in ogni esperienza richiesta.
Prove da conservare: Distribuzione/versione, abilità caricata, input, file di output e registri delle chiamate remote disponibili.
Usa Copilot Cowork per la distribuzione di sviluppo. Riutilizza il collegamento di installazione/test stampato effettivo, se disponibile.
Se è necessario il provisioning, controllare
m365agents.ymle configurare prima il file di ambiente selezionato nella relativa configurazioneenvironmentFolderPath. Confermare il tenant ed effettivoAGENT_SCOPE. Gli scaffold standard usanolocall'ambito personale edevcondiviso, ma i nomi da soli non ne sono la prova. Approvare le modifiche proposte, quindi eseguire:wiqd plugin provision --env "<test-environment>"Verifica: Il provisioning ha esito positivo e restituisce il collegamento di installazione/test della distribuzione.
Aprire il collegamento restituito e completare l'installazione e le connessioni necessarie usando l'identità di test. Avvia una sessione di Cowork e richiedi le note sulla versione utilizzando l'input noto.
Verifica: La tua abilità viene visualizzata in Abilità nel pannello laterale della sessione.
Controlla la risposta e qualsiasi file nella cartella >di output, in anteprima o in download.
Verifica: Tutte le modifiche vengono visualizzate nelle categorie previste e i file promessi corrispondono ai requisiti.
Esegui i test di individuazione e chiamata in ogni esperienza supportata, usando questa distribuzione e l'input noto.
Verifica: Il comportamento di individuazione, selezione e fallimento soddisfa i requisiti della competenza per quell'esperienza.
Una competenza caricata personalmente verifica una registrazione diversa da quella agentSkillsdel plug-in; le competenze allegate all'agente vengono invece utilizzate agent_skills nel manifesto dell'agente dichiarativo. L'evidenza delle competenze caricate non stabilisce l'esecuzione per script.
Nel ciclo di vita documentato, il provisioning crea o aggiorna la distribuzione del tenant nell'ambito selezionato e scrive le associazioni di ambiente. Il riutilizzo di un'identità di risorsa esistente può influire sugli utenti correnti. autorizzare tali modifiche. Il provisioning non esegue i comandi di pubblicazione o condivisione separati. Il collegamento di installazione non è la prova della pubblicazione del Registro di sistema, della disponibilità del pubblico o dell'installazione del file ZIP finale. Continua separatamente tramite Pubblica & distribuisci e Rendi disponibile & regolare, tra cui l'approvazione, l'installazione, il consenso e le connessioni applicabili.
Preferisci usare l'interfaccia della riga di comando di GitHub Copilot?
Help test <skill-name> in this plugin's existing Cowork development deployment.
Reuse its printed install link. Ask before provisioning; inspect the actual
environment scope first. Don't publish or share. Request release notes for
"Added CSV export; Fixed duplicate rows; Updated help text." Compare categories
and promised files; test missing input. Guide explicit/automatic Chat selection
if supported. Let me operate inaccessible UI and handle sign-in/consent.
Show actual evidence and ask before installs, exposure, or external changes.
Test dei connettori MCP remoti
Componente plug-in:agentConnectors[] voci che puntano a servizi MCP remoti.
Cosa dimostra: Comportamento server indipendente, quindi utilizzato autenticato tramite il plug-in di sviluppo.
Ancora da dimostrare dopo l'imballaggio: Le dichiarazioni del connettore, la configurazione della connessione e le chiamate di runtime funzionano in base all'esatto artefatto installato.
Prove da conservare: Endpoint/versione, schema dello strumento, input/risultati, identità e record host/server correlati.
Utilizzare MCP Inspector con Node.js 22.19.0+, l'endpoint HTTP Streamable attendibile, i relativi dettagli di autenticazione e un'operazione sicura di sola lettura.
Avviare Controllo gruppo, sostituendo l'URL di esempio:
$serverUrl = 'https://your-server.example/mcp' npx @modelcontextprotocol/inspector --server-url "$serverUrl" --transport httpVerifica: L'autenticazione viene completata e vengono visualizzate l'identità e le funzionalità server previste.
Elencare gli strumenti, selezionare l'operazione di ricerca, immettere i campi definiti dallo schema per il record noto ed eseguirla.
Verifica: Lo schema e il titolo, lo stato e l'URL restituiti corrispondono alle aspettative.
Ripeti con un record inesistente e un'identità limitata.
Verifica: Il comportamento di assenza di record è perseguibile e il contenuto non autorizzato rimane inaccessibile.
Apri il collegamento di installazione e test di Cowork del plug-in di sviluppo, usando il passaggio di provisioning in Testare le competenze, se necessario; i progetti con solo connettore non richiedono una competenza. Completare la configurazione della connessione e richiedere lo stesso record. Se una competenza deve usare il connettore, richiamarlo con tale richiesta.
Verifica: I log del servizio autenticati mostrano l'operazione e gli input previsti e i valori restituiti corrispondono al risultato della sessione.
Testare qualsiasi operazione di scrittura approvata solo con record disponibili e disponibile, incluso l'annullamento.
Verifica: Le modifiche approvate corrispondono alla richiesta e l'annullamento lascia invariati i dati di origine.
Confrontare l'endpoint e il riferimento di autenticazione nella configurazione del componente con ciò che è stato effettivamente eseguito. Seguire i requisiti del connettore, inclusi i requisiti applicabili per la descrizione dello strumento; Il solo successo del server non stabilisce la preparazione della connessione host.
Per un servizio locale, avviarlo con il comando del relativo progetto. Dopo aver approvato l'esposizione, segui Creare un tunnel di sviluppo permanente. Per questo connettore plug-in, impostato remoteMcpServer.mcpServerUrl sull'endpoint HTTPS pubblico con il percorso MCP effettivo. Aggiornare la distribuzione di sviluppo tramite il flusso di lavoro del progetto e ripetere il test. Mantenere l'autenticazione dell'applicazione e arrestare il tunnel al termine del test.
Verifica: I log del servizio mostrano la richiesta dell'host autenticato all'endpoint previsto.
Preferisci usare l'interfaccia della riga di comando di GitHub Copilot?
Help test this plugin's remote MCP connector at <endpoint>. Show the Inspector
command and ask before downloads or launch. Let me authenticate and call
<read-only-tool/input>; compare with <expected-record>. Then guide the same
task in the existing Cowork deployment and correlate sanitized server logs.
Ask before exposure, deployment, or writes; report diagnostics you can't see.
Testare un agente dichiarativo incluso
Componente plug-in: Agente dichiarativo facoltativo composto nel progetto plug-in.
Cosa dimostra: Risposte degli agenti e diagnostica di plug-in selezionati, recupero e citazione disponibili.
Ancora da dimostrare dopo l'imballaggio: I riferimenti all'agente in pacchetto e lo scenario completo del plug-in installato funzionano nelle esperienze dichiarate.
Prove da conservare: Agente/versione, ID richiesta/conversazione, capacità selezionata, input e output effettivo.
Segui l'anatomia del progetto plug-in supportata. Usare gli strumenti di sviluppo di Work IQ e DevUI sull'agente già distribuito corrispondente a tale componente.
Elencare gli agenti ed eseguire la ricerca:
wiqd agent list wiqd plugin ask --component agent --agent-id "<agent-id>" -q "Find issue 123 in my test repository. Return its title, status, and source URL."Verifica: L'agente selezionato e i valori restituiti corrispondono al record del componente e di origine.
Abilita il flag di anteprima DevUI documentato e ripeti:
wiqd config flags set devui true wiqd devui start --agent "<agent-name>" wiqd devui ask --agent "<agent-name>" -q "Find issue 123 in my test repository. Return its title, status, and source URL."Analizza i plug-in selezionati, il recupero, le citazioni e i risultati non elaborati.
Verifica: La diagnostica disponibile identifica la funzionalità prevista e i dati restituiti previsti.
Se l'agente ha una competenza collegata, controlla il suo output:
wiqd devui ask --agent "<agent-name>" -q "Draft release notes from these changes: Added CSV export; Fixed duplicate rows; Updated help text."Verifica: Le modifiche e i file promessi soddisfano i requisiti dell'abilità.
Arresta il server di diagnostica:
wiqd devui stopVerifica: Il comando indica che è stato arrestato o non è in esecuzione.
La diagnostica pubblicata di DevUI non stabilisce chiamate per competenza o per script. Registrare separatamente la correttezza dell'output. Testare anche le istruzioni specifiche dell'agente, le richieste suggerite e le richieste fuori ambito rispetto al comportamento definito.
Preferisci usare l'interfaccia della riga di comando di GitHub Copilot?
Use WIQD to list agents; let me choose the component's deployed <agent-id>.
Ask it for issue 123 in <repository>, comparing with <expected-title/status/URL>.
Open DevUI and repeat; help inspect selected plugins, retrieval, citations,
raw results, and request IDs. If <skill-name> is attached, request release
notes for "Added CSV export; Fixed duplicate rows; Updated help text."
Compare outputs separately from invocation evidence. Show commands/results
and stop DevUI. Ask before configuration, deployment, sharing, or external
writes. Let me handle sign-in and inaccessible UI; don't publish anything.
Vedere il flusso di lavoro agente DevUI documentato.
Dipendenze di test
Testa i servizi e le conoscenze su cui si basano i tuoi componenti e poi ripeti l'attività del plug-in integrata. Questi controlli delle dipendenze non sono registrazioni aggiuntive dei componenti del plug-in.
Connettore Copilot sincronizzato
Dipendenza: Conoscenza indicizzata usata dall'agente incluso.
Cosa dimostra: Acquisizione, aggiornamento, autorizzazioni e successivo recupero.
Ancora da dimostrare dopo l'imballaggio: Il plug-in installato utilizza la connessione e i record previsti.
Prove da conservare: ID connessione, output della ricerca per indicizzazione, conteggio indicizzato, citazioni e valori di origine.
Per il modello Problemi di GitHub, segui Creare il primo connettore sincronizzato per i controlli dei prerequisiti, della configurazione del repository, del consenso, della ricerca per indicizzazione e dell'indicizzazione. Per altre implementazioni, utilizzare le procedure di ricerca per indicizzazione e diagnostica documentate.
Verificare che l'ID connessione configurato per l'agente incluso corrisponda alla connessione verificata e che il record noto sia indicizzato.
Verifica: La diagnostica della connessione identifica l'origine prevista e gli elementi indicizzati previsti.
Eseguire una query sull'agente configurato con tale connessione, quindi aggiornare un problema disponibile, eseguire nuovamente il connettore ed eseguire di nuovo la query. Testare l'eliminazione tramite il percorso di riconciliazione e l'accesso limitato in cui si applicano le autorizzazioni per gli elementi.
Verifica: Valori, citazioni, aggiornamenti, gestione delle eliminazioni e requisiti di corrispondenza dell'accesso.
Connettore Copilot federato
Dipendenza: Una connessione federata disponibile usata nello scenario supportato.
Cosa dimostra: Recupero in tempo reale con l'identità connessa.
Ancora da dimostrare dopo l'imballaggio: Lo scenario completo di plug-in installato usa il percorso di accesso ai dati previsto.
Prove da conservare: Identità, record di origine, risposte/citazioni e registri di servizio disponibili.
In Copilot Chat, selezionare ...>Impostazioni>origini, trovare l'origine, selezionare Connetti ed eseguire l'autenticazione.
Verifica: La connessione ha esito positivo per l'identità prevista.
Chiedere il record noto in base al nome o all'ID di origine. Aggiornare un record usa e getta e ripetere. Verificare anche un'identità con restrizioni.
Verifica: Vengono visualizzate le modifiche in tempo reale e le autorizzazioni di origine rimangono applicate.
Verificare scenari utente completi
Esegui la stessa attività nota tramite l'esperienza prevista con tutti i componenti necessari abilitati. Ad esempio, chiedi a una funzionalità di recuperare il problema noto e produrre note sulla versione solo se il flusso di lavoro combinato fa parte della soluzione.
Avviare una nuova conversazione con l'identità e l'input di test previsti.
Verifica: La competenza o l'agente previsto gestisce la richiesta.
Raccogliere le prove specifiche del componente. Per le chiamate remote, correlare la diagnostica host disponibile con i log del servizio autenticati.
Verifica: Viene selezionato il componente desiderato. Quando è richiesto uno strumento, riceve l'input e l'identità corretti e viene utilizzato il suo output effettivo.
Confrontare la risposta e i file con il risultato previsto.
Verifica: Contenuti, citazioni e risultati promessi corrispondono ai requisiti.
Limiti e fallimenti dei test
Ripetere con input mancante o ambiguo, autenticazione scaduta, consenso negato, dati con restrizioni, dipendenze non disponibili, risultati vuoti o non validi, errori di script, timeout, limitazioni e tentativi. Conferma il comportamento di errore sicuro e interattivo e le conferme necessarie. Registrare ogni risultato previsto prima di eseguire il test.
Registra i risultati dell'integrazione
Usare un record per ogni scenario e identità. Portalo nel test del pacchetto; Compilare i campi del pacchetto dopo il pacchetto.
| Campo | Mantieni |
|---|---|
| Componenti | Versioni, file, endpoint, riferimenti di connessione e revisione dell'origine |
| Pacchetto | Identità, versione, percorso ZIP e hash SHA256 facoltativo; In sospeso prima del pacchetto |
| Contesto | Ambiente, stato di esperienza/rilascio, flag delle funzionalità, ruolo di identità di test e data |
| Scenario | Controlli richiesti, prove accettabili, input ripetibili e risultato previsto rispetto a quello effettivo |
| Prove | Log delle chiamate, ID richiesta, output e percorsi dei report sterilizzati |
| Decisione | Pass, fail o non verificato; Lacune nelle prove richieste, limitazioni diagnostiche, proprietario e azione successiva |
Prima di creare un pacchetto
- Invocazione: Confermare la selezione delle capacità previste e gli input/output previsti.
- Accesso: Completare i controlli di accesso autorizzato/limitato, consenso e conferma.
- Risultati e fallimenti: Completare i test di errore applicabili.
- Esperienze previste: Registra i risultati dello sviluppo separatamente per ogni esperienza di rilascio supportata; Pianificare i controlli finali degli artefatti installati.
- Record di handoff: Salva i record di test e risolvi i blocchi di implementazione prima della creazione del pacchetto.
- Riferimenti del pacchetto: Verifica che le versioni dei componenti, i file, gli identificatori, i riferimenti di connessione e gli endpoint testati siano quelli a cui farà riferimento il pacchetto.
Contenuti correlati
- Test di Copilot Studio e diagnostica delle mappe attività per gli agenti che usano connettori Power Platform o strumenti MCP.
- Test di Agent Builder e test di competenza degli allegati. Questi test di creazione non stabiliscono una route di creazione dei pacchetti del Registro di sistema supportata.
Passaggio successivo
Continuare il pacchetto & test: creare il pacchetto del plug-in, quindi convalidare e testare il pacchetto utilizzando lo stesso record di prove e i riferimenti esatti al pacchetto.