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.
Verwenden Sie Überwachung, Feedback und Supportnachweise, um zu entscheiden, ob Sie Ihr Plug-In oder Ihren Agent reparieren, aktualisieren, übergeben oder zurückziehen sollen. Testen Sie die Änderungen vor der Veröffentlichung, und überprüfen Sie das Ergebnis mit den vorgesehenen Benutzern.
Bauherren warten und testen die Lösung. Microsoft 365-Administratoren führen bei Bedarf organisationsweite Rollout- und Zugriffsaktionen durch. Dienstbesitzer verwalten die Konnektoren, Remote-MCP-Server, Identitäten und externen Dienste, die sie verwenden. Diese Verantwortlichkeiten übertragen sich nicht automatisch zusammen.
Auswählen einer Aufgabe
Verwenden Sie den Abschnitt für die Arbeit, die Sie erledigen müssen. Für Überwachung, Support, Übergabe und Einstellung müssen Sie nicht den Updateworkflow befolgen.
| Notwendige Aktionen | Beginnen mit |
|---|---|
| Überprüfen Sie die Ergebnisse von Einführung, Feedback oder Aufgaben | Überwachen der Nutzung und der Aufgabenergebnisse |
| Untersuchen eines Benutzerproblems | Benutzer unterstützen und Probleme untersuchen |
| Ändern und Freigeben der Lösung | Aktualisieren Sie Ihr Plug-In oder Ihren Agent |
| Übertragen von Instandhaltungsaufgaben | Übergabe der Verantwortung und des Supports |
| Beenden der Verteilung oder des Zugriffs | Zurückziehen des Plug-Ins oder Agents |
Bevor Sie beginnen
Identifizieren:
- Die aktuelle Identität und Version des Plug-Ins oder Agents.
- Die betroffenen Benutzer und Microsoft 365-Erfahrungen.
- Der Besitzer, der für die Aufgabe und alle beteiligten Verbindungen oder Dienste verantwortlich ist.
Verwenden Sie für einen eigenständigen Agenten die Überwachungs- und Freigabeverfahren, die vom Entwicklungsprodukt unterstützt werden. Gehen Sie nicht davon aus, dass eine Plugin-Paketprozedur darauf zutrifft.
Überwachen der Nutzung und der Aufgabenergebnisse
Wählen Sie einen Berichtszeitraum, eine Version, eine Zielgruppe und repräsentative Aufgaben aus. Verwenden Sie die Überwachungserfahrung für das Produkt, das Besitzer der Aktivität ist.
| Was Sie überwachen | Erste Schritte | Umfang, den Sie berücksichtigen sollten |
|---|---|---|
| Ein im Agent Builder integrierter Agent | Überwachen von Agents im Agent Builder | Auf der Registerkarte "Monitor" des Agents werden die Nutzung und das Feedback dazu behandelt. Für die Sichtbarkeit von Feedback gelten separate Voraussetzungen. |
| Ein Copilot Studio-Agent mit dem Standardkabelbaum | Überwachen der Agent-Leistung in Copilot Studio | Verwenden Sie die für diesen Agent unterstützten Analysen. Gehen Sie nicht davon aus, dass dieselben Berichte im Agent-Generator oder in anderen Buildpfaden vorhanden sind. |
| Plug-In-Zugriff, Benutzeraufgaben und Fehler | Überwachen Sie Ihr Plug-In | Überprüfen Sie die Paketverfügbarkeit, repräsentative Aufgabenergebnisse, Benutzerfeedback und Supportfälle. |
| Nutzung und Überwachung von Microsoft 365 | Zu überprüfendes Element auswählen | Verwenden Sie jeden Bericht für die Aktivität, die er abdeckt. Ein Überwachungsereignis stellt nicht fest, dass eine Aufgabe erfolgreich war oder eine Antwort korrekt war. |
| Einen Connector oder Remote-MCP-Dienst | Untersuchen von Fehlern und Überwachungsleitfaden des Diensts | Überprüfen Sie den Verbindungsstatus, die Quellberechtigungen, die Endpunktintegrität, Protokolle und Fehler beim Dienstbesitzer. Die Paketverfügbarkeit beweist nicht die Laufzeitintegrität. |
Gehen Sie nicht davon aus, dass die Telemetrie- oder Berichtsabdeckung über die Plugin- und Agent-Buildpfade hinweg gemeinsam genutzt wird. Der Bericht eines enthaltenen Agenten deckt diesen Agenten ab, nicht unbedingt jede Funktion im Plugin.
Erfassen Sie Änderungen bei der Einführung, dem Aufgabenerfolg, der Antwortqualität, den Anmelde- oder Toolfehlern und dem Supportvolumen, sofern die verfügbaren Beweise diese Schlussfolgerungen unterstützen. Vergleichen Sie repräsentative Aufgaben und Benutzerfeedback sowie die Anzahl der Nutzungen.
Benutzer unterstützen und Probleme untersuchen
Erfassen Sie für jedes Problem die betroffene Version, das Produkt, die Zielgruppe, das erwartete Ergebnis, das beobachtete Ergebnis und relevante Fehlerdetails. Zuweisen eines Besitzers und der nächsten Aktion.
- Bitten Sie den Administrator, die Verfügbarkeit, Installation, Richtlinien oder ausstehenden Zugriffsanforderungen zu untersuchen.
- Bitten Sie den Bauherrn oder Agent-Besitzer, Anweisungen, Wissen, Werkzeugauswahl oder Regressionen zu untersuchen.
- Bitten Sie den Identitäts-, Verbindungs- oder Dienstbesitzer, Authentifizierungs-, Einwilligungs-, Quellzugriffs- und Laufzeitfehler zu untersuchen.
Verwenden Sie für API- oder MCP-Aktionsanmeldefehler die Option Problembehandlung bei der Plug-In-Authentifizierung. Verwenden Sie für Task- und Abhängigkeitsprüfungen Fehler untersuchen.
Bestätigen Sie die Fehlerbehebung mit einem betroffenen Benutzer, und notieren Sie das Ergebnis. Eine korrigierte Konfiguration oder ein erfolgreicher Toolaufruf allein stellt nicht sicher, dass die gesamte Aufgabe des Benutzers jetzt funktioniert.
Aktualisieren Sie Ihr Plug-In oder Ihren Agent
Folgen Sie diesem Workflow, wenn Sie die Lösung ändern müssen. Verwende die Paketschritte für ein komponiertes Plugin. Verwenden Sie das Freigabeverfahren des Erstellungsprodukts für einen eigenständigen Agenten.
Vor dem Update
Haben Sie:
- Überwachung von Evidenz, Benutzerfeedback, Supportfällen oder einer geplanten Verbesserung.
- Repräsentative Aufgaben und Akzeptanzkriterien.
- Zugriff auf die Quell- und die betroffenen Funktionen.
- Der Veröffentlichungsdatensatz, einschließlich der aktuellen Version, Zielgruppe und Vertriebsroute.
- Besitzer für Verbindungs-, Identitäts- oder Dienständerungen verwenden.
Legen Sie einen Basisplan fest.
- Geben Sie das Problem oder die Verbesserung an, die Sie angehen möchten.
- Identifizieren Sie die betroffene Paket- oder Agent-Version, die Benutzer, Erfahrungen, Funktionen und Abhängigkeiten.
- Definieren Sie repräsentative Aufgaben und messbare Akzeptanzkriterien.
- Führen Sie die Aufgaben für die aktuelle Version aus, und notieren Sie die Ergebnisse.
- Wenn Ihre organization das Plug-In verwaltet, notieren Sie den aktuellen Status, die Benutzerverfügbarkeit und den Installationsstatus in den Plug-Insder Agents-Tools>>. Verwenden Sie für die anwendbaren Steuerelemente eines Agenten dieRegistrierung"Alle> Agents>".
- Bewahren Sie die Beweise auf, die Sie benötigen, um das aktuelle und das aktualisierte Verhalten zu vergleichen.
Verwenden Sie für ein Plug-In, das einen Agenten enthält, die Übersicht über die Agentenbewertung , um eine Bewertung zu entwerfen, wenn Antwortqualität, Anweisungen, Wissen oder Toolnutzung Teil der Änderung sind. Die Auswertung kann Nachweise vor der Veröffentlichung liefern und helfen, Qualitätsprobleme nach der Bereitstellung zu untersuchen, einschließlich solcher, die durch Nutzungssignale, Benutzerfeedback oder Änderungen an Agenten und Abhängigkeiten aufgeworfen werden.
Die Agent-Auswertung ist nicht für jedes Plug-In erforderlich. Sie ersetzen nicht das Testen von Funktionen, Paketen oder das Testen der gesamten Benutzererfahrung.
Verwenden Sie für bereitgestellte deklarative Agents den geführten wiqd agent eval Workflow. Eine direkte Befehlszeilen- oder Pipelinesteuerung finden Sie unter Übersicht über die Microsoft 365 Copilot Evaluations-CLI.
Anwenden und Testen der Änderung
Kehren Sie zu Erstellen zurück, oder verwenden Sie sie wieder, wenn Sie eine Funktion, Integration oder Quelle ändern müssen. Kehren Sie zu Package & Test zurück, wenn Sie den Release Candidate vorbereiten und validieren müssen. Halten Sie die betroffenen Abhängigkeiten und unterstützten Erfahrungen im Geltungsbereich.
- Aktualisieren Sie die Quelle oder die betroffene Funktion.
- Aktualisieren Sie separat betriebene Dienste oder Konfigurationen, wenn die Änderung dies erfordert.
- Testen Sie jede geänderte Fähigkeit und betroffene Abhängigkeit.
- Führen Sie die Baselineaufgaben und Auswertungen erneut aus.
- Vergleichen Sie die Ergebnisse mit den Akzeptanzkriterien.
- Untersuchen Sie Regressionen, bevor Sie das Releasepaket erstellen.
Wenn sich die Änderung auf einen Connector, einen Remote-MCP-Server, eine Identität, eine Berechtigung oder einen externen Dienst auswirkt, beziehen Sie den Besitzer dieser Abhängigkeit mit ein. Gehen Sie nicht davon aus, dass durch das Ändern des Pakets ein separat betriebener Dienst aktualisiert wird.
Erstellen und Überprüfen des Pakets
Befolgen Sie bei einem eigenständigen Agent die Anweisungen zur Versionierung, zum Testen und zur Veröffentlichung des Erstellungsprodukts. Die folgenden Paketschritte gelten für zusammengestellte Plugins.
- Weisen Sie eine neue Paketversion zu, und überprüfen Sie die Identitätsanforderungen für Ihre Veröffentlichungsmethode.
- Erstellen Sie das Plug-In-Paket.
- Überprüfen und testen Sie genau das Paket, das Sie veröffentlichen möchten.
- Testen Sie die erforderliche Anmeldung, Zustimmung, Verbindungen und externe Dienste.
- Testen Sie das Paket in jeder Microsoft 365-Erfahrung, die Sie unterstützen möchten.
- Notieren Sie bekannte Einschränkungen, die erforderliche Konfiguration und alle dokumentierten Wiederherstellungsoptionen.
Veröffentlichen Sie kein Paket, das sich von dem von Ihnen überprüften Paket unterscheidet.
Veröffentlichen und Bereitstellen des Updates
Wählen Sie das Aktualisierungsverfahren für Ihr Produkt und Ihre Vertriebsroute. Bei den Veröffentlichungsrouten wird zwischen Freigabe, Einreichung der Organisation und Marketplace-Veröffentlichung unterschieden.
| Distributionsroute | Dokumentierte Anleitungen oder Einschränkungen | Wer agiert |
|---|---|---|
| Ein über Cowork freigegebenes Plug-In | Befolgen Sie das dokumentierte Upload- und erneute Freigabeverfahren für eine neuere Version eines bereits freigegebenen Plug-Ins. Dieses Verfahren gilt für die Freigabe von Cowork, nicht für den allgemeinen Registrierungsersatz. | Plugin-Besitzer |
| Übermittlung des Organisations-App-Katalogs über Work IQ Dev Tools |
Übermitteln Sie ein genehmigtes Update für den App-Katalog der organization. Bewahren Sie die vorhandene Identität und den Umgebungsstatus des Releaseziels bei, testen Sie die aktualisierte Version, übermitteln Sie sie an wiqd plugin publishund holen Sie die Administratorgenehmigung ein. |
Plug-In-Besitzer und -Administrator |
| Manuelles Hochladen der Registrierung oder eine andere direkte Freigabemethode | Bestätigen Sie das produktspezifische Aktualisierungsverfahren für vorhandene Artikel vor der Freigabe. Dieser Artikel enthält keine manuellen Schritte zum Austauschen von Registrierungspaketen. Gehen Sie nicht davon aus, dass ein neuer Upload einen vorhandenen Eintrag ersetzt oder dessen Verfügbarkeitseinstellungen beibehält. | Plug-In-Besitzer und -Administrator |
| Microsoft Marketplace | Folgen Sie der Aktualisierungsanleitung für den Angebotstyp, der von Ihrem veröffentlichten Angebot verwendet wird. Beginnen Sie mit dem Partner Center-Leitfaden, der unter Veröffentlichen Ihres Plug-Ins im Microsoft Marketplace verlinkt ist. Schließen Sie alle erforderlichen Prüfungen und Veröffentlichungen ab, bevor Sie Kunden an das Update weiterleiten. | Herausgeber und Kundenadministrator, falls erforderlich |
Behalten Sie für ein WIQD-Update die eingerichteten Ressourcen- und Veröffentlichungs-IDs bei. Die Neubereitstellung verwendet die vorhandene Umgebungsidentität und kann Ressourcen ändern, die von aktuellen Benutzern vor der Kataloggenehmigung verwendet werden. Testen Sie Änderungen unter Berücksichtigung dieses Effekts. Überprüfen des Veröffentlichungslebenszyklus des Projekts anhand der WIQD-Leitlinien für bestehende Projekte; Beim Aktualisieren der CLI werden keine Projektdateien aktualisiert.
wiqd plugin publish submits a project and environment, not a captured ZIP through --package-file. Halten Sie den genehmigten Quell- und Umgebungszustand durch die Übermittlung fest und überprüfen Sie die übermittelte Version. Die Paketüberprüfung allein beweist nicht, dass die Veröffentlichung genau diese Bytes übermittelt.
Für eine Route mit dokumentiertem Aktualisierungsverfahren:
- Verwenden Sie das Verfahren zur Bestätigung der Veröffentlichung oder Freigabe für die getestete Version, und notieren Sie, ob sie eingereicht, veröffentlicht, freigegeben, abgelehnt oder blockiert wurde.
- Teilen Sie dem Administrator oder Rolloutbesitzer die genaue Version, die beabsichtigten Benutzer, die erforderliche Konfiguration, bekannte Einschränkungen und den Supportkontakt mit.
- Führen Sie nur die entsprechenden Schritte aus, um das aktualisierte Plug-In oder den Update-Agent verfügbar zu machen. Genehmigungs-, Zuweisungs- und Installationsanforderungen hängen von der Methode und den Einstellungen der organization ab.
- Aktualisieren Sie bei Bedarf separat gesteuerte Agents, Verbindungen, Identitäten, Remote-MCP-Server oder externe Dienste.
- Bestätigen Sie, welche Version jede Zielgruppe erreicht hat.
Wiederherstellung planen, ohne Rollback anzunehmen
Administratoren können ein Plug-In im Microsoft 365 Admin Center blockieren und entsperren. Verwenden Sie die Aktion zum Entsperren des Plug-Ins, um eine Blockierung zu entfernen, und überprüfen Sie dann den Zugriff für die vorgesehenen Benutzer. Andere Verfügbarkeits-, Installations-, Genehmigungs- und Verbindungsanforderungen gelten weiterhin. Durch das Aufheben der Blockierung wird weder eine frühere Paketversion wiederhergestellt noch Dienständerungen rückgängig gemacht.
Die aktuellen Richtlinien dokumentieren kein allgemeines Rollbackverfahren für Plugin-Paketversionen. Verwenden Sie einen produktspezifischen Rollbackvorgang nur, wenn das Produkt dies dokumentiert.
Notieren Sie vor der Freigabe die dokumentierte Wiederherstellungsoption und ihre Voraussetzungen, oder notieren Sie die Verfahrenslücke und den für einen fehlgeschlagenen Rollout verantwortlichen Besitzer.
Durch das Ersetzen eines Pakets wird nicht automatisch eine Änderung eines externen Dienstes, einer Verbindung, einer Identität, von Daten oder einer Berechtigung wiederhergestellt. Planen Sie diese Abhängigkeiten separat.
Überprüfen des Updates
- Testen Sie die repräsentativen Aufgaben mit einem vorgesehenen Benutzer in jeder unterstützten Oberfläche.
- Vergewissern Sie sich, dass der Benutzer die erwartete Version erhalten hat.
- Vergewissern Sie sich, dass Anmeldung, Zustimmung, Verbindungen, Tool-Aufrufe und externe Dienste funktionieren.
- Wenn das Plug-In in Ihrer organization verwaltet wird, überprüfen Sie in Agents>Tools>Plug-Ins, ob sein Status, seine Benutzerverfügbarkeit und sein Installationsstatus mit der Zielgruppe übereinstimmen. Überprüfen Sie, ob veraltete Versionen noch verwendet werden.
- Wiederholen Sie die Auswertungen, die zur Genehmigung der Änderung verwendet wurden.
- Überprüfen Sie Nutzungssignale, Feedback, Fehler und Supportfälle nach dem Rollout.
- Wenn das Update die Akzeptanzkriterien nicht erfüllt, halten Sie das Rollout an, notieren Sie den Fehler, und beziehen Sie den verantwortlichen Besitzer ein. Führen Sie nur dann einen Wiederherstellungsvorgang durch, wenn das Produkt dies dokumentiert.
Das Update ist abgeschlossen, wenn die Zielgruppe über die richtige Version verfügt, ihre Zugriffseinstellungen mit dem beabsichtigten Rollout übereinstimmen, die repräsentativen Aufgaben ihre Akzeptanzkriterien erfüllen und jedes ungelöste Problem einen Besitzer und die nächste Aktion hat.
Aufzeichnen des Updates
Aufzeichnung:
- Vorherige und aktualisierte Paket- oder Agent-Versionen.
- Änderung, Grund, betroffene Funktionen und Abhängigkeiten.
- Baseline-, Auswertungs-, Validierungs- und Benutzertestergebnisse.
- Veröffentlichungsmethode, Zielgruppe, Rollout-Status und anwendbarer Registrierungsstatus.
- Konfigurations- oder Dienständerungen.
- Bekannte Einschränkungen, dokumentierte Wiederherstellungsoption oder Verfahrenslücke und Support-Besitzer.
Übergabe der Verantwortung und des Supports
Bevor der aktuelle Besitzer die Rolle verlässt, geben Sie dem nächsten Besitzer Folgendes:
- Die Quell-, Paket- oder Agentidentität, die aktuelle Version, die Releasedatensätze und die Veröffentlichungsroute.
- Überwachung von Standorten, repräsentativen Tests, bekannten Problemen und offenen Supportfällen.
- Die Zielgruppe – Verwaltungskontakte, erforderliche Verbindungen und externe Dienstbesitzer.
- Die dokumentierten Aktualisierungs-, Wiederherstellungs- und Einstellungsverfahren, einschließlich etwaiger Lücken.
Verwenden Sie für einen freigegebenen Agent, der in Agent Builder oder Copilot Studio integriert ist, die Option "Einem Agenten neuen Besitzer zuweisen", wenn dieses Verfahren angewendet wird. Der Agent Builder unterstützt auch das Hinzufügen eines Besitzers. Überprüfen Sie die Auswirkungen auf den Zugriff des Vorbesitzers, bevor Sie eine Änderung vornehmen.
Dies sind Agentenbesitzverfahren, keine allgemeine Übertragungsprozedur für das äußere Plugin-Paket. Bestätigen Sie den Quellzugriff, den Veröffentlichungszugriff, Verbindungen, Anmeldeinformationen und Dienstverantwortlichkeiten separat. Lassen Sie den nächsten Besitzer überprüfen, ob er die Lösung überwachen, warten und unterstützen kann.
Zurückziehen des Plug-Ins oder Agents
Ziehen Sie die Lösung zurück, wenn Sie sie nicht mehr verwenden sollte. Legen Sie fest, ob Sie die Verteilung für alle Kunden beenden oder den Zugriff nur in Ihrer organization entfernen. Diese Bereiche unterscheiden sich.
- Identifizieren Sie aktive Versionen, Benutzer, Veröffentlichungs- und Freigabespeicherorte und freigegebene Abhängigkeiten.
- Benachrichtigen Sie Benutzer und Supportteams, einschließlich aller Ersetzungen und des Einstellungsdatums.
- Beenden Sie die Verteilung und den Zugriff über die unterstützte Route und entfernen Sie bei Bedarf Administratorinstallationen.
- Lassen Sie Dienstbesitzer Plug-In-spezifische Zugriffe und Ressourcen entfernen, während die von anderen Lösungen verwendeten Ressourcen erhalten bleiben.
- Überprüfen Sie das Ergebnis mit einem zuvor autorisierten Benutzer, und notieren Sie die aufbewahrten Ressourcen, Ausnahmen und Besitzer.
Informationen zum Zurückziehen eines Pakets finden Sie unter Zurückziehen des Plug-Ins. Verwenden Sie für einen eigenständigen Agent das entsprechende Produktverfahren, z. B. Agents löschen. Gehen Sie nicht davon aus, dass durch das Entfernen eines Agenten oder Pakets alle Verbindungen, Berechtigungen oder externen Dienste widerrufen werden.
Siehe auch
- Überwachen Sie Ihr Plug-In
- Überwachen von Agents im Agent Builder
- Funktionen für Ihr Plug-In erstellen oder wiederverwenden
- Packen Sie Ihr Plug-In
- Validieren und testen Sie Ihr Plug-In
- Auswählen, wie das Plug-In veröffentlicht und verteilt werden soll
- Plug-Ins und Agents verfügbar machen
- Zugriff steuern, Tools und Verbindungen steuern
- Verwalten von Plug-Ins, Skills und MCP-Servern
- Zurückziehen Ihres Plug-Ins