Schnellstart: Erstellen Ihres ersten Plug-Ins mit Work IQ Dev Tools

Mit der Befehlszeilenschnittstelle (CLI) von Work IQ DevTools können Sie Ihren vorhandenen deklarativen Agenten, Skill oder MCP-Server (Model Context Protocol) als Plug-In verpacken. Die CLI kann das Paket auch überprüfen, das Plug-In bereitstellen und für Ihren Mandanten freigeben.

Wichtig

Die gesamte wiqd plugin Befehlsstruktur ist Alpha und kann sich ändern. Wenn die Schritte in dieser exemplarischen Vorgehensweise nicht funktionieren, bestätigen Sie die aktuellen Befehle, die unterstützten Komponentenkombinationen, die Zielanwendungen und die Featureanforderungen in Erstellen eines Plug-Ins mit Work IQ Dev Tools.

Voraussetzungen

  • Node.js 24 oder höher
  • PowerShell 7 oder höher (nur Windows)
  • Ein Microsoft 365-Konto mit Zugriff auf Copilot
  • Benutzerdefinierter App-Upload in Ihrem Mandanten aktiviert
  • Ein unterstütztes Quellprojekt für deklarative Agents

Vergewissern Sie sich, dass Sie über ein unterstütztes Startprojekt verfügen.

Beginnen Sie mit dem Stammordner eines lokalen Quellprojekts mit deklarativen Agents. Der Ordner muss mindestens Folgendes enthalten:

contoso-support-agent/
|-- appPackage/
|   |-- manifest.json
|   |-- declarativeAgent.json
|   `-- <the instruction and action files referenced by the manifests>
`-- <a supported lifecycle file>

Die Lebenszyklusdatei kann , m365agents.ymlm365agents.local.yml, teamsapp.ymloder teamsapp.local.ymlsein. Das Projekt kann andere Ordner und Umgebungsdateien enthalten.

Diese Schnellstartanleitung gilt nicht, wenn:

  • Sie haben nur einen veröffentlichten Agenten oder ein installiertes Paket und kein lokales Quellprojekt. Work IQ Dev Tools dokumentiert keine unterstützte Methode zum Rekonstruieren des Quellprojekts aus einem bereitgestellten Titel. Stellen Sie das ursprüngliche Quellrepository wieder her oder verwenden Sie das ursprüngliche Erstellungstool.
  • Der Agent ist nur in einer verwalteten Erstellungsumgebung vorhanden, z. B. Agent Builder oder Copilot Studio. Verwenden Sie das Veröffentlichungs- und Freigabeverfahren dieses Tools.
  • Sie verfügen über einen benutzerdefinierten Modul-Agent. Diese Work IQ Dev Tools-Route unterstützt deklarative Agents.
  • You have only an agent package .zip. Für die Lebenszyklusbefehle sind das Quellprojekt und die zugehörige Lebenszyklusdatei erforderlich.

Wenn Sie über kein vorhandenes Projekt verfügen, können Sie die Schritte in Tutorial: Erstellen deklarativer Agents mithilfe des Microsoft 365 Agents Toolkit und JSON ausführen , um einen einfachen Agent zu erstellen.

Hinweis

wiqd plugin importimportiert unterstützte Formate wie Open Plugin, Claude Plugin oder Cursor Plugin. Es wird kein vorhandenes Microsoft 365 Declarative-Agent-Projekt oder -Paket importiert. Weitere Informationen finden Sie unter Import/Export (Interop).

Erstellen Sie Ihr Plug-In

  1. Falls noch nicht geschehen, installieren Sie Work IQ Dev Tools.

  2. Öffnen Sie Ihre CLI in dem Verzeichnis, in dem Sie Ihr Plug-In erstellen möchten, und melden Sie sich mit dem folgenden Befehl an:

    wiqd auth login --interactive

  3. Starten Sie in Ihrer CLI GitHub Copilot mit dem copilot Befehl.

  4. Bitten Sie GitHub Copilot, ein Plug-In mit Ihrem vorhandenen deklarativen Agenten, Skill oder MCP-Server zu erstellen. Zum Beispiel:

    Create a plugin named My Plugin by using the agent in "..\My Agent"

Überprüfen des Plug-In-Projekts

Wenn GitHub Copilot das Plug-In nicht automatisch überprüft hat, bitten Sie es, das Projekt zu überprüfen, bevor Sie es bereitstellen oder verpacken.

Validate the plugin

Bereitstellen des Plug-Ins

Bitten Sie GitHub Copilot, das Plug-In bereitzustellen.

Provision the plugin using the dev environment

Auf den Abschluss der Bereitstellung warten Sie können Ihr Plug-In jetzt in Microsoft Copilot Chat testen.

Wichtig

Das Plug-In muss mithilfe der dev Umgebung des Projekts bereitgestellt werden, um die Agent-Freigabe zu ermöglichen.

Packen Sie das Plug-In

Bitten Sie GitHub Copilot, das Plug-In zu packen.

Package the plugin

Wichtig

Sie müssen das Plug-In bereitstellen, bevor Sie es verpacken. Wenn Sie Pakete verpacken, bevor Sie sie bereitstellen, ist das resultierende Paket ungültig.

Überprüfen des Pakets

Bitten Sie GitHub Copilot, das verpackte Plug-In zu überprüfen. In diesem Schritt wird eine detailliertere Überprüfung für das generierte ZIP-Paket durchgeführt.

Validate the packaged zip

Freigeben des Plug-Ins

Sie können jetzt GitHub Copilot bitten, Ihr Paket freizugeben, entweder für bestimmte Benutzer oder Gruppen innerhalb Ihrer organization oder für Ihre gesamte organization.

Share the plugin with AmberR@contoso.com

oder -

Share the plugin with my organization

Wichtig

Die Freigabe benutzerdefinierter Plug-Ins hängt von den Einstellungen Ihrer Organization ab, um die Freigabe von Plug-Ins zuzulassen oder zu blockieren. Wenn bei diesem Schritt Fehler auftreten, wenden Sie sich an Ihre Administratoren. Weitere Informationen finden Sie unter Einstellungen für die Agent-Freigabe und -Veröffentlichung.

Veröffentlichen Sie das Plug-In in der Plug-In-Registrierung Ihrer organization

Als Alternative zur Freigabe Ihres Plug-Ins können Sie die Veröffentlichung Ihres Plug-Ins in der Plug-In-Registry Ihrer Organization beantragen. Die Administratoren Ihrer organization können dann Ihr Plug-In überprüfen und die Anforderung genehmigen oder ablehnen.

Publish my package to the plugin registry so all users in my tenant can use it

Löschen des Pakets (optional)

Wenn dies nur ein Test-Plug-In war, können Sie GitHub Copilot bitten, den Agent zu entfernen. Durch diese Aktion werden alle bereitgestellten Cloudressourcen gelöscht.

Delete the plugin

Verwandte Inhalte

  • Zuletzt aktualisiert um