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.
Testen Sie das Artefakt mit exakter Versionsangabe, das von Erstellen Sie das Plug-In-Paket. Verbinden Sie im Test "Paket &" die Komponentenbeweise mit dieser ZIP-Datei, installieren Sie sie über eine unterstützte Route, und überprüfen Sie die bereitgestellte Version, den Zugriff und das tatsächliche Laufzeitverhalten in jeder beanspruchten Microsoft-Erfahrung.
Schließen Sie mit diesem Beweis ab: "Ich habe diese Komponenten getestet, genau diese Referenzen verpackt, genau diese Version installiert, diese Szenarien ausgeführt und diese Ergebnisse aufbewahrt." Eine erfolgreiche Schemaprüfung, ein Bereitstellungsbefehl oder eine plausible Antwort stellt diese Kette nicht her.
Bevor Sie beginnen
Haben Sie:
- Abgeschlossene Komponenten- und Integrationstests, einschließlich bekannter Testdaten und erwarteter Ergebnisse.
- Die Kandidaten-ZIP-Datei, ihre Paketidentität/-version sowie die darin enthaltenen Komponentenversionen, Endpunkte und Verbindungsverweise.
- Einen Entwicklungsmandanten, Nichtproduktionsdaten, eine für die Paketkomponenten unterstützte Installationsroute und die Berechtigung zu ihrer Verwendung.
- Testen von Identitäten für zulässige und eingeschränkte Benutzer; Ein autorisierter Administrator für Verfügbarkeits- und Blockierungstests.
- Erforderliche Lizenzen, Anmeldung, Zustimmung, Verbindungen und externe Dienste für jede Zielumgebung.
- Ein Testdatensatz für jedes Szenario und jede Identität.
Definieren Sie vor dem Testen die erforderlichen Paket-, Installations-, Zugriffs- und Laufzeitprüfungen sowie die Nachweise, aus denen jedes Ergebnis hervorgeht. Verwenden Sie die komponentenspezifischen Nachweiskriterien für Laufzeitansprüche und die Installationsnachweise, die unter Bestätigen der gelieferten Version beschrieben sind.
Holen Sie sich die Genehmigung ein, bevor Sie ein Paket hochladen, installieren, die Zustimmung erteilen, es freigeben oder die Verwaltungseinstellungen ändern. Diese Verfahren ändern den Mandantenstatus. Verwenden Sie kontrollierte Testidentitäten und Zielgruppen.
Validieren von Schemas und Komponentenverweisen
Öffnen Sie die ZIP-Option, ohne sie zu ändern. Lesen Sie den Stamm, manifest.jsondie Aufzeichnung id, versionund manifestVersion. Stellen Sie sicher, dass:
- Das Manifest verwendet das Microsoft 365-App-Manifestschema , das für Ihre Route erforderlich ist.
- Enthaltene Agent-Definitionen und Aktionsmanifeste verwenden die entsprechenden Schemas. Ein API-Plug-In-Manifest beschreibt eine Agent-Aktion, nicht das äußere Registrierungs-Plug-In.
- Auf diese wird verwiesen und Skill-Ordner, Begleitdateien, Symbole und Toolbeschreibungen sind unter den angegebenen Paketpfaden vorhanden.
- Versionen, Bezeichner, Endpunkte und Verbindungsverweise stimmen mit den Testdatensätzen der Komponente und der vorgesehenen Umgebung überein.
- Es sind keine Anmeldeinformationen, Geheimnisse, Protokolle oder nicht zugehörigen Testdateien enthalten.
Verwenden Sie für die Work IQ Dev Tools die dokumentierten CLI-Voraussetzungen, einschließlich Node.js 24.15+, npm und PowerShell 7+ für diese Windows-Beispiele. Eine optionale Offlinequellenüberprüfung im vorhandenen Projekt ist:
wiqd plugin validate --mode source --env "<test-environment>"
Überprüfen Sie: Anwendbare Quellprüfungen werden erfolgreich und übersprungene oder nicht abgedeckte Funktionen werden aufgezeichnet.
Der Quellmodus überprüft gespeicherte deklarative Agent-Diagnosen und grundlegende Projektwächter. Das App-Schema, der Skill-Inhalt, der Stamm agentConnectors[]oder der referenzierte API-/OpenAPI-Inhalt werden nicht vollständig validiert. Für ein reines Skill- oder Connectorprojekt können keine anwendbaren Agent-Überprüfungen durchgeführt werden. Explizite Verwendung source : Der Standardmodus ist die Paketüberprüfung, keine Offlineüberprüfung.
Überprüfen des genauen Pakets
Wählen Sie explizit eine ZIP-Datei aus, anstatt sich auf ein Buildverzeichnis mit mehreren Kandidaten zu verlassen. Ersetzen Sie in PowerShell den Beispielpfad durch Ihr Artefakt:
$packageFile = (Resolve-Path '.\appPackage\build\<candidate>.zip').Path
Get-FileHash -LiteralPath $packageFile -Algorithm SHA256
Überprüfen Sie: Die aufgelöste Datei ist der vorgesehene Kandidat. Behält optional den lokal berechneten Hash bei, um nachfolgende Änderungen zu erkennen. Ein lokaler Hash beweist nicht, welche Bytes der Host ausführt.
Melden Sie sich vor einer authentifizierten Überprüfung mit der beabsichtigten Microsoft 365-Identität an:
wiqd auth login --interactive wiqd doctorÜberprüfen Sie: Die Authentifizierungs- und Bereitschaftsprüfungen für den vorgesehenen Mandanten sind erfolgreich.
Führen Sie mit der Genehmigung zum Hochladen dieser ZIP-Datei in den Plattformvalidierungsdienst Folgendes aus:
wiqd plugin validate --mode package --package-file "$packageFile"Überprüfen Sie: Die Ergebnisse für genau diese ZIP-Datei erfüllen die erforderlichen Überprüfungen. die zurückgegebenen unveränderlichen JSON- und HTML-Berichte beibehalten.
Wenn Ihre Veröffentlichungsroute zusätzliche Marketplace-Richtlinien- und Beweisprüfungen erfordert, führen Sie Folgendes aus:
wiqd plugin validate --mode marketplace --package-file "$packageFile"Überprüfen Sie: Die erforderlichen Paket-, Richtlinien- und Nachweisprüfungen werden bestanden, ohne dass erforderliche Nachweise fehlen.
Beide package und marketplace verwenden die erstellte ZIP-Datei, laden Sie sie hoch und kann eine Anmeldung erforderlich sein. Sie erstellen es nicht automatisch und melden sich nicht automatisch an. Sie akzeptieren auch eine ZIP-Datei ohne ihr Quellprojekt. Der Marketplace-Modus fügt Richtlinien- und Beweisprüfungen hinzu. Der Bericht ist keine offizielle Store- oder Partner Center-Genehmigung. Folgen Sie dem aktuellen WIQD-Validierungsvertrag, nicht den veralteten deepstatic, oder manifest Modusnamen.
Lesen Sie Ergebnisse, Abdeckung, übersprungene Überprüfungen und erforderliche Nachweise, nicht nur das Beendigungsergebnis des Befehls. Verwenden Sie für eine unterstützte Route des Agents Toolkit-Pakets "App-Paket mithilfe von Validierungsregeln überprüfen" oder atk validate --app-package-file-path <path> wie unter "App überprüfen" dokumentiert.
Wenn sich etwas in der ZIP-Datei ändert, erstellen Sie einen neuen Kandidaten, und wiederholen Sie die Validierung. Remotedienständerungen erfordern relevante erneute Laufzeittests, auch wenn die ZIP-Datei unverändert ist.
Paket installieren oder querladen
Verwenden Sie eine Route, die Ihr natives Microsoft 365-App-Paket akzeptiert und dessen Komponenten unterstützt. Ein WIQD-Bereitstellungsinstallations- und Testlink identifiziert eine Bereitstellung; Durch das Öffnen wird nicht festgestellt, dass Ihre endgültige validierte ZIP-Datei installiert wurde.
Persönliche exakte PLZ-Installation
Befolgen Sie das persönliche Cowork Sideloading-Verfahren für die CLI-Installation, Authentifizierung und Paketinstallation, wenn diese Paket- und Zielerfahrung unterstützt werden. Übergeben Sie die exakte Datei, die unter Überprüfen des genauen Pakets ausgewählt wurde, indem Sie als Wert von --file-path und Personal als Bereich verwenden$packageFile.
Überprüfen Sie: Die Installation für das beabsichtigte Konto ist erfolgreich. Speichern Sie die zurückgegebene TitleId und AppId zusammen mit der Paketidentität/-version und der Ausgabe des Installationsprogramms. Vergewissern Sie sich in der unterstützten Oberfläche, dass das installierte Plug-In die erwarteten Komponenten und die Identität verfügbar macht und dass die erforderlichen Verbindungen vollständig sind.
Wenn die Richtlinie die persönliche Route deaktiviert oder die Route für den Kandidaten nicht unterstützt wird, verwenden Sie eine genehmigte kompatible Route, anstatt die Sicherheitskontrollen zu ändern.
Cowork Paket-Upload
Weitere Informationen zu einem unterstützten Cowork-Paket finden Sie unter Hochladen eines Plug-In-Pakets und der Anleitung zur Freigabe. Wählen Sie die exakt validierte native Microsoft 365 ZIP-Datei aus, und beschränken Sie den Zugriff auf die Testidentität oder eine explizit autorisierte Testzielgruppe. Folgen Verwenden Sie Plugins mit Cowork, um das Plug-In zu aktivieren und die erforderlichen Verbindungen in einer neuen Unterhaltung abzuschließen.
Überprüfen Sie: Die ausgewählte Datei und die angezeigte Plug-In-Identität stimmen mit dem Kandidatendatensatz überein. Das Plug-In wird für die beabsichtigte Identität installiert, die erwarteten Fähigkeiten und der Connector-Status werden angezeigt, und geschützte Vorgänge verwenden das beabsichtigte verbundene Konto.
Uploads in fremden Formaten können automatisch konvertiert werden. Eine solche Konvertierung ist kein Beweis dafür, dass Ihre ursprüngliche Microsoft 365-ZIP-Version unverändert getestet wurde. Stellen Sie das Artefakt und den Validierungsnachweis wieder her, wenn die Route es transformiert.
Bestätigen Sie die gelieferte Version.
Führen Sie einen Installationsdatensatz, der die genau ausgewählte ZIP-Datei und ihr Manifest idversion sowie die erfolgreichen Installationsidentitäten, das beabsichtigte Konto und die zurückgegebenen Installationsidentitäten verknüpft. Bewahren Sie für die dokumentierte persönliche Querladeroute den Befehl mit seinem aufgelösten Dateipfad, den Manifestmetadaten des Kandidaten und der Installer-Ausgabe bei, die and enthält TitleIdAppId. Bewahren Sie für einen unterstützten nativen Cowork-Upload die ausgewählte Datei und den erfolgreichen Upload-/Installationsdatensatz mit der angezeigten Plug-In-Identität und dem Testkonto auf.
Verwenden Sie diese Kette als Installationsnachweis für den getesteten Kandidaten. Korrelieren Sie alle Versionsmetadaten, die vom Host- oder Administrationsweg verfügbar gemacht werden, mit dem Kandidaten, und untersuchen Sie Konflikte vor dem Testen. Erfassen Sie Installationsnachweise getrennt vom Aufruf.
Die zitierten persönlichen Installationsschritte dokumentieren keine Abfrage der universellen installierten Version oder serverseitigen Pakethash. Beides ist für dieses Verfahren nicht erforderlich: Der Installationsdatensatz legt fest, welcher Kandidat übermittelt und erfolgreich installiert wurde, keine unabhängige Überprüfung der Bytes, die der Host ausführt. Wenn Ihre Freigabekriterien eine unabhängige Überprüfung der hostseitigen Version oder des Bytes erfordern, beschaffen Sie sich diese Nachweise. seine Abwesenheit bleibt nicht überprüft und blockiert diesen Freigabeanspruch. Ein Bereitstellungslink, ein Plug-In-Name, eine erfolgreiche Antwort oder ein lokaler Hash allein bilden nicht die Installationskette.
Befolgen Sie für einen vom Administrator verwalteten Kandidaten das aktuelle Verfahren zum Hochladen und Installieren der Registrierung, begrenzen Sie die Testbenutzer und bewahren Sie das akzeptierte Artefakt und den Installationseintrag bei. Wenn die Route einen anderen Artefakttyp akzeptiert oder keine Beziehung zu der validierten ZIP-Datei herstellen kann, behandeln Sie die Artefaktbindungsprüfung als nicht verifiziert und nicht als gleichwertig.
Testen des verpackten Plug-Ins
Wiederholen Sie die vollständigen Integrationsszenarien mit dem installierten Kandidaten, nicht die frühere Entwicklungsbereitstellung:
Starten Sie in jeder beanspruchten Erfahrung eine neue Unterhaltung. Verwenden Sie die gleiche Identitätsrolle, den gleichen bekannten Datensatz, die gleiche Eingabe und das erwartete Ergebnis wie bei den Komponententests.
Überprüfen Sie: Die gewünschte installierte Komponente ist ausgewählt.
Sammeln Sie die komponentenspezifischen Nachweise. Korrelieren Sie bei Remoteaufrufen authentifizierte Dienstprotokolle mit der Anforderung, den Eingaben und den zurückgegebenen Daten.
Überprüfen Sie: Hostnachweise identifizieren ggf. den ausgewählten oder geladenen Skill. Erforderliche Toolaufrufe verfügen über korrelierte Aufrufbeweise, und ihre zurückgegebenen Daten tragen zur Antwort bei.
Überprüfen Sie Ausgabedateien und Zitate. Wiederholen Sie die anwendbaren Fehler- und Grenzfälle.
Überprüfen Sie: Korrektheit, Zugriffsgrenzen, Genehmigungen und Fehlerverhalten erfüllen die vordefinierten Kriterien.
Verwenden Sie Added CSV export; Fixed duplicate rows; Updated help text. für Release-Note-Fähigkeiten die Dateien "Features überprüfen", "Fixes", "Sonstiges" und "Zugesagt" wieder. Vergleichen Sie für eine MCP-Suche den genauen Titel, den Status und die URL des bekannten Problems mit Dienstprotokollen. Verwenden Sie die komponentenspezifischen Beweiswerkzeuge; Eine Agent-Diagnoseroute allein stellt nicht fest, dass ein eigenständiges installiertes Plug-In ausgeführt wurde.
Halten Sie die Korrektheits- und Aufrufergebnisse getrennt. Fehlende Nachweise für eine erforderliche Überprüfung bleiben nicht überprüft. Nicht verfügbare zusätzliche Diagnosen als Einschränkungen und nicht als verifizierte Ausführungsdetails oder automatische Fehler aufzeichnen. Wiederholen Sie Ermittlungs-, Verbindungs-, Auswahl- und Laufzeittests separat in Chat und Cowork, wenn Sie beide beanspruchen.
Testen der Authentifizierung und des Zugriffs
Lassen Sie einen autorisierten Administrator kontrollierte Testeinstellungen über Plug-in-Verfügbarkeit für Benutzer festlegen und Plug-ins, Skills und MCP-Server verwalten. Zeichnen Sie die ursprünglichen Einstellungen auf, und stellen Sie sie nach dem genehmigten Test wieder her. Verwenden Sie dieselbe harmlose Suche oder ein ähnliches Szenario, das Ihr Plug-In unterstützt. Notieren Sie bei einer nicht anwendbaren Überprüfung, wie z. B. der Dienstgenehmigung in einem Skill-Only-Szenario, den Grund, anstatt eine Funktion hinzuzufügen.
| Test | Setup und Aktion | Erwartetes Ergebnis |
|---|---|---|
| Zulässiger Benutzer | Fügen Sie die Testidentität in die genehmigte Zielgruppe ein. Melden Sie sich als dieser Benutzer an, und schließen Sie die erforderliche Zustimmung/Verbindung ab. | Das unterstützte Szenario ist innerhalb der Quellberechtigungen dieses Benutzers erfolgreich. Aufrufbeweis identifiziert die erwartete Fähigkeit. |
| Eingeschränkter Benutzer | Beschränken Sie die Verfügbarkeit auf die genehmigte Zielgruppe, und testen Sie dann mit einem Konto außerhalb dieser Zielgruppe. | Der Benutzer kann das Plug-In nicht verwenden. Im Copilot-Kanal kann der Eintrag als blockiert auffindbar bleiben. Berechtigte Benutzer können Zugriff anfordern. Sichtbarkeit allein ist kein Fehler. |
| Zustimmung verweigert | Verwenden Sie eine Testidentität/-verbindung ohne vorhandene Gewährung. Lehnen Sie die erforderliche Zustimmung des Vorgangs ab, und wiederholen Sie die geschützte Suche. | Der Vorgang erhält nicht den angeforderten geschützten Zugriff. Zeichnen Sie den Anmelde-/Zustimmungsfehler auf, und stellen Sie sicher, dass kein geschütztes Ergebnis als Erfolg angezeigt wird. Nicht verwandte zulässige Funktionen können weiterhin funktionieren. |
| Blockieren und Aufheben der Blockierung | Lassen Sie den Administrator folgen: Blockieren eines Plug-Ins oder einer Fähigkeit für den Kandidaten. Wiederholen Sie die Anforderung mit einem zuvor zugelassenen Benutzer, lassen Sie den Administrator dann Entsperren für das Plugin auswählen und die Anforderung erneut wiederholen. | Während der Blockierung können das Plug-In und die abhängigen Agents nicht verwendet werden. Zugeordnete MCP-Server/Connectors bleiben für andere Plug-Ins verfügbar. Nach dem Aufheben der Blockierung kann der zuvor zugelassene Benutzer das Plug-In erneut verwenden, vorbehaltlich der ursprünglichen Verfügbarkeits-, Genehmigungs- und Verbindungsanforderungen. |
Einschränkungen nach Herausgeberkategorie sind separate Steuerelemente. Wenn Sie eine testen, notieren Sie die Kategorie und ihr Richtlinienergebnis; Ändern Sie keine organization-weiten Einstellungen, nur um einen Kandidaten zu testen. Testen Sie die Verlängerung/Wiederverbindung der Anmeldung, die Quellberechtigungen und ggf. fehlende Verbindungen.
Für die Authentifizierung mit Microsoft Entra-Autorisierungscode gibt die verweigerte Zustimmung einen Autorisierungsfehler zurück. Verwenden Sie den tatsächlichen Anbieterfehler, anstatt auf jedem Host identische Formulierungen zu erwarten.
Unterstützte Testumgebungen
Zeichnen Sie ein Ergebnis pro Erfahrung, Identitätsrolle und Szenario auf, einschließlich Installations- und bereitgestellter Versionsnachweise. Ein Durchgang in Cowork richtet keinen Durchgang im Chat oder bei einem anderen Host ein. Verwenden Sie für jeden die unterstützte Route. Ungeklärte Installations- oder Versionsnachweise verhindern einen Freigabeanspruch für diese Erfahrung.
Aufzeichnen von Ergebnissen in Agent-Qualität
Wenn ein Agent enthalten ist und Ihre Releasekriterien eine Qualitätsbewertung erfordern, bewerten Sie die entsprechende bereitgestellte Version und verknüpfen Sie ihre Ergebnisse mit dem Kandidatendatensatz. Beginnen Sie mit der Übersicht über die Agent-Bewertung. Qualitätsauswertungen ersetzen nicht die Beweise für Pakete, installierte Versionen, Zugriff oder Aufrufe.
Wiederholen von Regressionstests für einen Kandidaten
Führen Sie die aufgezeichneten Baselineszenarien, Zugriffstests, Fehlerfälle und alle erforderlichen Agent-Bewertungen für den installierten Kandidaten erneut aus. Fügen Sie änderungsspezifische Fälle hinzu, ohne die Baseline zu entfernen. Bewahren Sie beide Sätze von Testdatensätzen auf, vergleichen Sie die Ergebnisse und klären Sie Regressionen oder erforderliche nicht überprüfte Prüfungen vor der Freigabe.
Für die Baselinevorbereitung und den Updatelebenszyklus, einschließlich Veröffentlichungs-, Rollout-, Ersetzungs- und Rollbackentscheidungen, folgen Sie Überwachen, Aktualisieren und Außerbetriebnehmen Ihres Plug-Ins oder Agents. Gehen Sie nicht von automatischen Upgrades, beibehaltenen Zuweisungen oder einem bestimmten erneuten Zustimmungstrigger aus. Wiederholen Sie nach dem Rollout die Verifizierung der gelieferten Version und der Laufzeit.
Festlegen der Releasebereitschaft
Vervollständigen Sie den freigegebenen Testdatensatz mit der Paketidentität und -version, der genauen ZIP-Datei und dem optionalen Hash, den Komponentenversionen und Endpunkten, der Umgebung, der Rolle der Testidentität, dem Szenario, den erwarteten und tatsächlichen Ergebnissen, dem bereinigten Aufrufbeweis, dem Status und dem Besitzer. Fügen Sie Validierungsberichte sowie Installations- und Versionsnachweise bei.
Weisen Sie ein Ergebnis zu:
- Bereit – Der genaue Kandidat hat alle erforderlichen Prüfungen mit vollständigen Beweisen und ohne ungelösten Release-Blocker bestanden.
- Blockiert – eine erforderliche Überprüfung ist fehlgeschlagen oder wird nicht überprüft, einschließlich Artefaktbindung, bereitgestellte Version, Zugriff oder Aufruf.
- Bereit mit Einschränkungen - Erforderliche Prüfungen bestanden; Verbleibende nicht blockierende Einschränkungen sind dokumentiert, akzeptiert und zur Offenlegung geeignet.
Wenden Sie die erforderlichen Prüfungen und Nachweiskriterien an, die vor der Prüfung definiert wurden. Eine akzeptierte diagnostische Einschränkung kann fehlende erforderliche Beweise nicht in einen Pass verwandeln; Zusätzliche Diagnosen sind nicht obligatorisch, wenn die erforderlichen Überprüfungen bereits über ausreichende Nachweise verfügen. Notiere für jeden Blockierer einen Besitzer und eine Lösung. Erstellen Sie einen neuen Kandidaten, wenn sich das Artefakt ändert, installieren Sie es erneut, und wiederholen Sie die betroffenen Tests und Regressionstests.
Siehe auch
- Erstellen des Plug-In-Pakets
- Testen Sie Ihre Plug-In-Komponenten zusammen
- Überwachen, Aktualisieren und Außerbetriebnehmen Ihres Plug-Ins oder Agents
Nächster Schritt
Wenn die erforderlichen Nachweise vollständig sind, fahren Sie mit Veröffentlichen & Verteilen fort: