Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Erstelle genau das versionierte Plug-In-Paket, das du testen und veröffentlichen möchtest. Dieser Schritt erfolgt, nachdem die Komponenten des Plug-Ins in der vorgesehenen Entwicklungs- oder Testumgebung zusammengearbeitet haben.
Wichtig
Eine .zip Datei ist nicht automatisch ein unterstütztes Plug-In-Paket. Verwenden Sie eine Paketroute nur, wenn sie die Komponenten des Plug-Ins und die Microsoft 365-Erfahrungen unterstützt, die Sie veröffentlichen möchten.
Dieser Artikel beschreibt das Microsoft 365-App-Paket, das vom dokumentierten Copilot Cowork-Plug-In-Workflow verwendet wird. Einige Tools erstellen das Paket für Sie. Bei anderen Workflows können Sie sie manuell zusammenstellen. Verwenden Sie die Anleitung für das ausgewählte Produkt für die unterstützten Komponenten, die Manifestversion und den Veröffentlichungsweg. Ein gemeinsames Paketformat garantiert nicht, dass jedes Produkt die gleichen Funktionen unterstützt.
Remote-MCP-Server, APIs und andere verbundene Dienste werden separat ausgeführt. Das Paket enthält die unterstützten Deklarationen oder Verweise, die zum Herstellen einer Verbindung mit ihnen erforderlich sind, nicht die ausgeführten Dienste.
Bevor Sie beginnen
Schließen Sie Integrationstests ab. Stellen Sie sicher, dass:
- Sie haben die Komponenten einzeln und zusammen gebaut und getestet.
- Sie konfigurierten Abhängigkeiten, Authentifizierung, Berechtigungen, Verbindungen, Endpunkte und externe Dienste.
- Sie wissen, welche Microsoft 365-Erfahrungen das Plug-In unterstützen muss.
- Sie haben die Komponentenversionen, bekannte Einschränkungen und ungelöste Probleme aufgezeichnet.
Verwenden Sie Pakete nicht zum Auflösen einer unfertigen Komponente oder Integration. Kehren Sie zu "Erstellen" zurück, oder verwenden Sie es wieder , wenn eine erforderliche Komponente nicht funktioniert.
Grundlegendes zum Microsoft 365-App-Paket
Das Paket ist eine ZIP-Datei mit manifest.json den Symbolen, auf die verwiesen wird, im Stamm. Das Microsoft 365-App-Manifestschema definiert die Identitäts-, Metadaten- und Funktionsdeklarationen von Microsoft 365.
| Paketinhalt | Zweck |
|---|---|
manifest.json |
Identifiziert die App, Version, Entwickler, Namen, Beschreibungen, Symbole und unterstützten Funktionen. |
| Symbole | Die Farb- und Konturbilddateien, auf die das App-Manifest verweist. Der Cowork Workflow Dokumente color.png und outline.png. |
| Agent-Fähigkeiten | Sofern enthalten, enthalten SKILL.md Skill-Ordner unterstützte Begleitdateien. Das App-Manifest verweist auf die Ordner über agentSkills. |
| Konfiguration des Remoteconnectors | Falls enthalten, agentConnectors identifizieren Einträge im App-Manifest die Remote-MCP-Endpunkte und die entsprechende Autorisierungskonfiguration. Der Server selbst ist nicht verpackt. |
| Komponentendateien, auf die verwiesen wird | Schließen Sie die Dateien ein, die von den ausgewählten Komponenten benötigt werden, z. B. eine Toolbeschreibungsdatei, wenn die Connectorkonfiguration auf eine solche verweist, oder Agentendefinitionen in einem unterstützten Agentenpaket. |
Die Cowork-Dokumentation zeigt beispielsweise ein Paket mit diesem Layout:
manifest.json
color.png
outline.png
skills/
contract-analysis/
SKILL.md
references/
clause-taxonomy.md
tools/
contoso-legal-tools.json
Die Skill-Ordner sind nur vorhanden, wenn das Plug-In Skills enthält. Die Toolbeschreibungsdatei ist nur erforderlich, wenn von der Connectorkonfiguration darauf verwiesen wird. Folgen Sie Build-Plug-Ins für Copilot Cowork für aktuelle Datei-, Schemaversions-, Symbol- und Qualifikationsanforderungen, anstatt das Beispiel als Vorlage für jedes Produkt zu behandeln.
Hinweis
Das Plug-In-Manifestschema 2.4 beschreibt eine API- oder MCP-Aktionskomponente für einen deklarativen Agent, nicht das äußere Microsoft 365-App-Paket. Diese Aktionen sind nur für den enthaltenden Agent verfügbar. Verwenden Sie das App-Manifestschema für das äußere Paket.
Auswählen eines unterstützten Paketpfads
| Route des Plug-In-Pakets | Erstellen des Pakets | Result |
|---|---|---|
| Ein Work IQ DevTools Plug-In-Projekt (empfohlene Pro-Code-Route für unterstützte Szenarien) | Befolgen Sie die dokumentierten Schritte zur Validierung der Quelle und zur Bereitstellung für die ausgewählte Umgebung, und führen Sie wiqd plugin packagedann aus. Weitere Informationen finden Sie unter Erstellen eines Plug-Ins mit Work IQ Dev Tools. |
Ein versioniertes App-Paket, das vor der Freigabe oder Veröffentlichung überprüft werden muss. |
| Ein mit dem Microsoft 365 Agents Toolkit erstelltes Plug-In-Paket, wenn der ausgewählte Workflow die Komponenten und Zielerlebnisse des Plug-Ins unterstützt | Wählen Sie das ZIP-Teams-App-Paket aus, oder verwenden Sie die teamsApp/zipAppPackage Lifecycle-Aktion. Siehe Anpassen eines App-Manifests im Agenten-Toolkit. |
Das Plug-In-Paket, das vom unterstützten Workflow erstellt wurde. |
| Ein manuell zusammengestelltes Cowork-Plugin-Paket | Befolgen Sie die Anweisungen für Manifest, Skills, Verbinder, Symbol und ZIP in Build Plugins for Copilot Cowork. | Ein Microsoft 365-App-Paket für die dokumentierte Cowork-Route. |
Wenn keine Paketierungsroute die Komponenten und Zielerlebnisse Ihres Plug-Ins unterstützt, stoppen Sie. Wählen Sie eine unterstützte Methode aus, oder überarbeiten Sie das Plugin. Kombinieren oder benennen Sie Artefakte nicht um, um ein nicht unterstütztes Paket zu erstellen.
Für Fähigkeiten, die direkt in Copilot Chat verwendet werden, paketieren Sie Fähigkeiten auf Plug-In-Ebene über die Eigenschaft des App-ManifestsagentSkills. Dies unterscheidet sich von der Eigenschaft des deklarativen Agentmanifests agent_skills . Eine eigenständige SKILL.md oder Skill-ZIP, die vom Chat akzeptiert wird, ist kein vollständiges Plug-in-App-Paket. Siehe Verpacken einer Fähigkeit in ein Plugin.
Informationen zum Automatisieren von WIQD-Quellprüfungen, Kandidatenpaketierung und Package-First-Validierung finden Sie unter Konfigurieren von Plug-In-CI/CD mit Work IQ Dev Tools.
Hinweis
Die WIQD-Quellvalidierung ist keine vollständige Überprüfung des erstellten Pakets. Validieren Sie die genaue ZIP-Datei nach dem Verpacken mit dem aktuellen Paketvalidierungsverfahren unter Testen und Validieren Sie Ihr Plug-in.
Identifizieren des Pakets und seiner Abhängigkeiten
Wählen Sie den vorgesehenen Veröffentlichungs- und Verteilungsweg , bevor Sie das Releaseartefakt zusammenstellen. Identifizieren Sie für jede Route:
- Identität: Die App-ID, die Paketversion und Komponentenbezeichner.
- Metadaten: Namen, Beschreibungen, Entwicklerinformationen, Symbole und Links zu entsprechenden Datenschutz- und Nutzungsbedingungen.
- Authentifizierung: Das Identitätsmodell, die unterstützte Autorisierungskonfiguration, die Berechtigungs- und Zustimmungsanforderungen sowie die Anmeldeinformationsverweise.
- Verbindungen: Die Endpunkte, Verbindungsverweise und umgebungsspezifische Konfiguration.
- Externe Abhängigkeiten: Remotedienste, Datenquellen, Eigentümer und Einrichtung außerhalb des Pakets erforderlich.
Fügen Sie nur schemaunterstützte Deklarationen und Verweise in das Paket ein. Bewahren Sie operative Details im Datensatz zur Veröffentlichungsbereitschaft auf und schließen Sie keine Anmeldeinformationen oder Geheimnisse ein.
| Distributionsroute | Was für dieses Paket zu bestätigen ist |
|---|---|
| Direkte Freigabe zum Testen | Die ausgewählte Zielgruppe, die Testumgebung, die Paketidentität und die Metadaten sowie die Authentifizierung, Verbindungen und externen Dienste, die diese Tester benötigen. |
| Verteilung der Organisation | Die Paketidentität und Metadaten für die Überprüfung durch den Administrator sowie die Einrichtung von Authentifizierung, Verbindung, Berechtigung und externem Dienst, die in der organization erforderlich sind. |
| Öffentliche Verteilung | Die Paketidentität und die Metadaten für die gewählte Übermittlungsroute sowie Authentifizierung, Verbindungen und externe Abhängigkeiten, die Kundenorganisationen und Benutzer konfigurieren müssen. |
Durch das Freigeben oder Veröffentlichen des Pakets werden die Installation, Zuweisung, Zustimmung oder Verbindungseinrichtung nicht abgeschlossen. Folgen Sie den aktuellen Anforderungen der gewählten Route; Dieser Artikel definiert keinen Einreichungsvertrag.
Erstellen des Pakets
- Öffnen Sie den Paketierungsvorgang für Ihre ausgewählte Plugin-Route.
- Wählen Sie die gewünschte Umgebung und die genauen Komponentenversionen aus, die Sie getestet haben.
- Führen Sie den dokumentierten Befehl, die Benutzeroberflächenaktion oder den automatisierten Workflow aus.
- Notieren Sie den Namen des Artefakts, den Speicherort, die Version, die Umgebung und die Toolversion.
Überprüfen des generierten Artefakts
Stellen Sie Folgendes sicher:
- Die Plugin-Identität und die Paketversion sind korrekt.
- Das Paket enthält die erwarteten Manifeste, Metadaten, Konfiguration und Ressourcen.
- Die Komponentendeklarationen, Dateien, Bezeichner, Endpunkte und Dienstverweise entsprechen den von Ihnen getesteten Versionen.
- Das Paket verwendet die vorgesehene Umgebungskonfiguration.
- Authentifizierungs-, Berechtigungs-, Zustimmungs- und Verbindungsanforderungen werden ohne Anmeldeinformationen, Token oder Geheimnisse deklariert.
- Das Paket enthält keine temporären Dateien, Protokolle, Testdaten oder nicht zugehörigen Artefakte.
Veröffentlichungsbereitschaft aufzeichnen
Bringen Sie einen Veröffentlichungsbereitschaftsdatensatz in die Test- und Validierungsphase und füllen Sie ihn vor der Veröffentlichung aus. Aufzeichnung:
- Paket- oder Artefaktidentität und exakte Version.
- Komponenten, Remotedienste und externe Referenzen.
- Verpackungstool und beabsichtigte Veröffentlichungsmethode.
- Getestete Microsoft 365-Erfahrungen und -Umgebungen.
- Anforderungen an Authentifizierung, Berechtigung, Zustimmung und Verbindung.
- Validierungsnachweis und Ergebnis.
- Bekannte Einschränkungen, nicht unterstützte Kombinationen und akzeptierte Risiken.
- Release-Eigentümer und Validierungsdatum.