Testa insieme i componenti del plug-in

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.

  1. Se è necessario il provisioning, controllare m365agents.yml e configurare prima il file di ambiente selezionato nella relativa configurazione environmentFolderPath . Confermare il tenant ed effettivo AGENT_SCOPE. Gli scaffold standard usano local l'ambito personale e dev condiviso, 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.

  2. 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.

  3. 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.

  4. 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.

  1. Avviare Controllo gruppo, sostituendo l'URL di esempio:

    $serverUrl = 'https://your-server.example/mcp'
    npx @modelcontextprotocol/inspector --server-url "$serverUrl" --transport http
    

    Verifica: L'autenticazione viene completata e vengono visualizzate l'identità e le funzionalità server previste.

  2. 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.

  3. Ripeti con un record inesistente e un'identità limitata.

    Verifica: Il comportamento di assenza di record è perseguibile e il contenuto non autorizzato rimane inaccessibile.

  4. 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.

  5. 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.

  1. 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.

  2. 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.

  3. 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à.

  4. Arresta il server di diagnostica:

    wiqd devui stop
    

    Verifica: 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.

  1. 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.

  2. 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.

  1. 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.

  2. 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.

  1. Avviare una nuova conversazione con l'identità e l'input di test previsti.

    Verifica: La competenza o l'agente previsto gestisce la richiesta.

  2. 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.

  3. 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.

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.