Scegliere gli strumenti di sviluppo per il plug-in

Durante la preparazione, trasforma le opzioni di funzionalità in un piano di compilazione. Inizia con gli strumenti di sviluppo di Work IQ per lo sviluppo professionale, scegli un ambiente documentato e aggiungi Microsoft 365 Agents Toolkit o un SDK solo quando lo scenario lo richiede. Concludi con uno strumento, un percorso di origine, un proprietario e i prerequisiti per ogni componente.

Per creare funzionalità di Copilot in un'app di cui sei proprietario, segui Crea app basate su Copilot .

Inizia con gli strumenti di sviluppo di Work IQ

Work IQ Dev Tools è il percorso predefinito per sviluppatori professionisti per gli scenari di plug-in supportati. Utilizza il flusso di lavoro guidato per creare e comporre un plug-in, quindi convalidarlo, eseguirne il provisioning, creare pacchetti e condividerlo. Utilizzare i comandi CLI diretti quando è necessaria un'esecuzione ripetibile o uno scripting.

Scegli la superficie di comando proprietaria dell'origine:

Origine e attività Inizia qui Limite
Un nuovo plug-in contenente competenze supportate, connettori di plug-in per server MCP remoti o un agente dichiarativo facoltativo Creare un plug-in con WIQD wiqd plugin add agent impalcatura di un componente agente; Non importa un progetto agente esistente.
Progetto di origine agente dichiarativo esistente Ciclo di vita dei componenti dell'agente Utilizzare il flusso di lavoro documentato wiqd agent per il progetto.
Un'origine supportata per plug-in Open, plug-in Claude o plug-in Cursor Importazione ed esportazione di WIQD La conversione del formato non stabilisce un comportamento di runtime o un supporto host equivalente.
Una distribuzione condivisa testata per gli utenti selezionati Creare un plug-in con WIQD La condivisione concede l'accesso; non è l'invio del catalogo dell'organizzazione.
Un plug-in testato per il catalogo dell'organizzazione Pubblicazione e progetti esistenti wiqd plugin publish invia per l'approvazione dell'amministratore, non per la certificazione pubblica del Marketplace.

Usa la convalida dell'origine esplicita per i controlli offline. La modalità di convalida predefinita è la convalida del pacchetto rispetto a un file ZIP esistente; Può caricare il pacchetto e richiedere l'autenticazione. Nessuna delle due modalità sostituisce il test delle funzionalità effettive nell'esperienza prevista.

Scegliere l'ambiente

Nella tabella seguente sono elencate le route WIQD documentate. Non è una matrice di compatibilità esaustiva:

Ambiente Usalo per Configurazione e vincoli
Interfaccia della riga di comando di GitHub Copilot Creazione guidata di plug-in con il plug-in dell'assistente codifica WIQD Installare l'host e il relativo plug-in WIQD del marketplace, quindi avviare una nuova sessione. Il plug-in del marketplace non installa l'interfaccia della riga di comando di WIQD.
Claude Code Creazione guidata con il plug-in WIQD per tale host Seguire i passaggi del marketplace specifico dell'host nell'installazione di WIQD.
Riga di comando diretta Convalida e ripetibilità dei comandi del ciclo di vita degli agenti o del plug-in Installare la CLI separata. La rotta dello script di installazione richiede Node.js 24.15 o versioni successive e npm; Windows richiede PowerShell 7 o versione successiva.
Visual Studio Code Modifica dei progetti e diagnostica dei manifesti tramite l'estensione facoltativa WIQD Seguire l'installazione di WIQD per l'integrazione corrente dell'editor. La diagnostica dell'editor non sostituisce la convalida del pacchetto finale.
Pipeline CI/CD attendibili Operazioni di provisioning, pubblicazione e condivisione con supporto core, soggette ai limiti di autenticazione della release selezionata Seguire le indicazioni CI/CD del plug-in e l'autenticazione della pipeline. Gli esempi di pipeline agente-progetto non sono generatori di pipeline compatibili con i plug-in.

Per le operazioni del tenant locale, accedere in modo interattivo prima del provisioning. Per l'automazione, usare il contratto della pipeline attendibile pubblicato e l'archiviazione segreta. Non eseguire funzionalità interattive wiqd auth login in CI o esporre le credenziali a processi di richiesta pull non attendibili. L'autenticazione del ciclo di vita di base non autentica le query, le valutazioni o altre estensioni di Work IQ. Non applicare un corpo di comando agent-project invariato a un progetto di plug-in.

Per i prerequisiti di account, tenant e strumento, usa Configura l'ambiente di sviluppo. Un assistente di codifica può aiutare a creare file, ma non sostituisce lo strumento di creazione, il runtime, le autorizzazioni o i requisiti di pubblicazione del componente.

Aggiungi strumenti specifici per i componenti quando necessario

Utilizzare queste route di prodotti quando il componente selezionato richiede controlli di creazione o di progetto specifici. Seguire la procedura del prodotto piuttosto che trattare gli strumenti come formati di confezioni intercambiabili.

Requisiti Trasferimento di strumenti o prodotti
Controllo di livello inferiore di un progetto, manifesti o integrazioni di agenti dichiarativi supportato Microsoft 365 Agents Toolkit, con JSON o TypeSpec
Esperienza di creazione di agenti dichiarativi guidata e gestita Costruttore di agenti; usare la propria procedura di abilità per le competenze supportate
Flussi di lavoro gestiti, connettori Power Platform, ambienti e logica agente low-code Copilot Studio; usare il suo canale di pubblicazione Microsoft 365 quando applicabile
Un agente con sede in siti o raccolte documenti selezionati di SharePoint Indicazioni per l'agente SharePoint e per l'aggiornamento del formato selezionato
Connettori di competenze o plug-in per Copilot Cowork Crea plug-in per Copilot Cowork per requisiti di file, runtime e test specifici del prodotto
Un connettore Copilot (sincronizzato) che inserisce contenuto esterno in Microsoft Graph Creare il primo connettore Copilot personalizzato
Azione MCP remota in un agente dichiarativo Creare un plug-in da un server MCP

Generatore di agenti in Copilot Studio attualmente non supporta l'aggiunta di competenze. Non dedurre il set di funzionalità dall'esperienza separata di Generatore agente in Microsoft 365 Copilot. Gli agenti autonomi di Copilot Studio vengono visualizzati nel Registro degli agenti, non nei plug-in.

Per i progetti Cowork importati, controlla le limitazioni correnti nella guida allo sviluppo di Cowork prima di pianificare il packaging o la pubblicazione.

Utilizzare un SDK nel percorso dell'app quando sono necessari orchestrazione, modelli, hosting o runtime personalizzati. Non spostare lo sviluppo di app del motore personalizzato nel flusso di lavoro del plug-in solo perché usa anche i servizi di Microsoft 365.

Registrare il piano di compilazione

Per ogni componente, registra:

  • L'attività, l'esperienza prevista e il formato del componente documentato.
  • Se crei un nuovo componente, configuri un'origine esistente o usi un flusso di lavoro di riutilizzo specifico del prodotto.
  • Strumento di creazione, repository di origine o ambiente gestito e proprietario responsabile.
  • Account, sottoscrizioni, autorizzazioni, servizi e utenti di test richiesti.
  • Strumento che produce l'artefatto e metodo di distribuzione che lo accetta.
  • I test di runtime e le prove necessarie prima di & test del pacchetto.

Un pacchetto condiviso non significa un'esperienza identica ovunque. Le funzionalità supportate, la disponibilità e la configurazione richiesta variano in base al prodotto, al percorso di pubblicazione e all'implementazione.

Passaggio successivo

Immetti Crea o riutilizza con funzionalità di compilazione o riutilizzo per il plug-in. Per creare un nuovo plug-in, segui Crea un plug-in con WIQD. Se si dispone già di un'origine dell'agente dichiarativo, seguire Impacchettare un agente dichiarativo esistente come plug-in.