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