Schnellstart: Verpacken eines vorhandenen deklarativen Agents als Plug-In mit Work IQ Dev Tools

Verwenden Sie Work IQ-Entwicklungstools mit der lokalen Quelle für einen vorhandenen deklarativen Agent, um ihn zu validieren, bereitzustellen, zu verpacken und als Plug-In freizugeben. Diese Schnellstartanleitung beginnt mit einem vorhandenen Quellprojekt, nicht mit einem Gerüst für einen neuen Agenten.

Mit dieser exemplarischen Vorgehensweise wird weder ein neuer Agent erstellt noch die Quelle aus einem installierten Agenten rekonstruiert. Wenn Sie stattdessen ein neues Plug-In starten, folgen Sie Build a Plugin with Work IQ Dev Tools.

Tipp

Sehen Sie, wie die Work IQ Dev Tools ein Copilot-Plug-In aus einem Prompt erstellen und es in der interaktiven Demo im Agent Store veröffentlichen.

Voraussetzungen

  • GitHub Copilot CLI mit einem aktiven Copilot-Abonnement
  • Das WIQD-Coding-Assistent-Plug-In für die GitHub Copilot-CLI (siehe die Installationsbefehle in diesem Abschnitt)
  • Node.js 24.15 oder höher und npm, available on your PATH, für die WIQD-CLI und das Installationsskript
  • 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

Installieren Sie nach der Installation der GitHub Copilot-CLI das WIQD-Coding-Assistent-Plug-In:

copilot plugin install wiqd@awesome-copilot

Alternativ können Sie den WIQD-Marktplatz hinzufügen und das Plug-In von dort installieren:

copilot plugin marketplace add microsoft/wiqd
copilot plugin install wiqd@wiqd

Installieren Sie die WIQD-CLI mithilfe des Installationsskripts.

Starten Sie nach der Installation eine neue GitHub Copilot CLI-Sitzung.

Das Coding-Assistent-Plug-In bietet Anleitungen zur Dokumenterstellung. Die wiqd CLI wird nicht installiert. Installieren Sie die CLI separat, bevor Sie Validierungs- und Lebenszyklusbefehle ausführen. Bestätigen Sie die CLI-Installation und wiqd --version überprüfen Sie die Voraussetzungen mit wiqd doctor.

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. Die Work IQ-Entwicklungstools unterstützen das Rekonstruieren des Quellprojekts anhand eines bereitgestellten Titels nicht. 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 noch kein Projekt haben, beginnen Sie mit dem WIQD-Schnellstart , um ein Plug-In zu erstellen und einen deklarativen Agenten hinzuzufügen. WIQD ist der empfohlene Pro-Code-Ausgangspunkt für unterstützte Szenarien.

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

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

Überprüfen des Plug-In-Projekts

Wählen Sie explizit die Offlinequellenvalidierung aus, bevor Sie das Plug-In bereitstellen oder verpacken. Fragen Sie in der GitHub Copilot CLI:

Validate the plugin source offline in the dev environment

Bereitstellen des Plug-Ins

Wichtig

In diesem Beispiel wird die standardmäßige freigegebene dev Umgebung verwendet. Überprüfen Sie die effektive Lebenszykluskonfiguration und die ausgewählte Umgebungsdatei unter environmentFolderPath (Standard env) für AGENT_SCOPE=shared vor der Bereitstellung für die Freigabe. Eine allein benannte Umgebung dev richtet keinen freigegebenen Bereich ein. Behalten Sie für die Bereitstellung, Verpackung, Überprüfung und Freigabe die gleiche Umgebung bei.

Bitten Sie GitHub Copilot, das Plug-In bereitzustellen.

Provision the plugin using the dev environment

Warten Sie, bis die Bereitstellung abgeschlossen ist. Durch die Bereitstellung wird nicht festgelegt, dass alle Plug-In-Funktionen in Copilot Chat verfügbar sind. Die Unterstützung hängt von der Komponente und der Microsoft 365-Zielerfahrung ab.

Packen Sie das Plug-In

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

Package the plugin using the dev environment

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

Suchen Sie nach dem Verpacken die generierte ZIP-Datei, und vergewissern Sie sich, dass die Datei existiert. Geben Sie in der GitHub Copilot CLI den tatsächlichen Pfad an, und fragen Sie:

Validate this existing plugin ZIP in package mode using the dev environment

Die Paketvalidierung verwendet --mode package und eine vorhandene ZIP-Datei wird über --package-filebereitgestellt, kein automatischer Build. Überprüfen Sie das zurückgegebene Urteil und die Ergebnisse. Exitcode 0 bedeutet, dass die ausgewählten Prüfungen bestanden wurden; Warnungen können weiterhin gemeldet werden. Das Blockieren von Ergebnissen oder unvollständigen Ergebnissen ist kein Durchlauf, und die Paketvalidierung beweist nicht das Laufzeitverhalten.

Die aktuellen Gültigkeitsprüfungsmodi sind source, package, und marketplace. source ist die explizite Offlineprüfung. Die Standardeinstellung package, erfordert eine vorhandene ZIP-Datei, lädt eine erfasste Kopie in den Microsoft 365-Validierungsdienst hoch und erfordert möglicherweise eine Authentifizierung. marketplace fügt Richtlinien- und Beweisprüfungen hinzu; Es handelt sich nicht um die offizielle Genehmigung des Ladens. Die Validierung erstellt nicht automatisch eine ZIP-Datei, meldet Sie nicht an oder stellt das Plug-In bereit. Weitere Informationen finden Sie unter Validierung und MVL.

Freigeben des Plug-Ins

Sie können jetzt GitHub Copilot bitten, Ihre Plug-In-Bereitstellung entweder für bestimmte Benutzer in Ihrer organization oder für Ihre gesamte organization freizugeben. In der ausgewählten Umgebung bestätigen, bevor Sie die Freigabe AGENT_SCOPE=shared vornehmen. Die Freigabezielgruppe (--scope users oder --scope tenant) ändert den Bereitstellungsumfang nicht.

Share the plugin with AmberR@contoso.com using the dev environment

Zweite Möglichkeit:

Share the plugin with my organization using the dev environment

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

Anstatt Ihr Plug-In freizugeben, können Sie die Veröffentlichung Ihres Plug-Ins in der Plug-In-Registrierung Ihrer Organization anfordern. Die Administratoren Ihrer organization können Ihr Plug-In überprüfen und die Anforderung genehmigen oder ablehnen.

Submit my plugin to the organization catalog for admin approval using the dev environment

Die Freigabe gewährt direkten Zugriff; Die Katalogübermittlung ist ein separater Vorgang und stellt keine Administratorgenehmigung oder abgeschlossene Benutzerinstallation dar.

Löschen des Pakets (optional)

Wenn dieses Plug-In nur ein Test-Plug-In ist, bitten Sie GitHub Copilot, das Plug-In zu entfernen. Durch diese Aktion werden alle bereitgestellten Cloudressourcen gelöscht.

Delete the plugin using the dev environment