Veröffentlichen im Microsoft Admin Center

Verwenden Sie den a365 publish-Befehl, um Ihren Agent zu paketieren und das Paket dann in das Microsoft 365 Admin Center hochzuladen. Nach der Veröffentlichung können Sie Agent-Instanzen innerhalb Ihrer Organisation erstellen und den Agent verwalten.

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie folgendes Elemente haben.

Erforderliche Konten und Berechtigungen

  • Microsoft 365-Mandant mit einer der folgenden Rollen (erforderlich für den Upload ins Admin Center):

    • Globaler Administrator

Notwendige Werkzeuge

Erforderliche Einrichtungsschritte

Führen Sie vor der Veröffentlichung folgende Schritte aus:

  1. Agent-Blueprint erstellen – Befolgen Sie den Einrichtungsschritt, um Ihren Agent-Blueprint zu erstellen.
  2. Agent lokal testen – Überprüfen Sie mit Agents Playground, ob Ihr Agent ordnungsgemäß funktioniert (siehe Lokales Testen von Agents).
  3. Konfigurationsdateien vorbereiten – Stellen Sie sicher, dass a365.config.json und a365.generated.config.json auf dem neuesten Stand sind.

Veröffentlichen-Befehl

Führen Sie den a365 publish-Befehl aus:

a365 publish

Anmerkung

Wenn Sie a365 publish -h ausführen, werden alle Optionen angezeigt, die dieser Befehl unterstützt.

Was bedeutet dieser Befehl:

  1. Manifest aktualisieren - Aktualisieren manifest.json mit Ihrer Agenten-Blueprint-ID.
  2. Paket erstellen – Pakete manifest.json und Symbole in manifest.zip.
  3. Anweisungen ausgeben – Zeigt schrittweise Anweisungen zum Hochladen über das Microsoft 365 Admin Center an.

Anmerkung

Der Befehl a365 publish funktioniert sowohl für Agents als auch für KI-Teammitglieder. Für Agent, die mit --agent-name (konfigurationsfrei) bereitgestellt wurden, muss a365.generated.config.json in Ihrem Arbeitsverzeichnis vorhanden sein, bevor Sie a365 publish ausführen, da der Befehl die Blueprint-ID aus dieser Datei liest.

Upload zum Admin Center

Folgen Sie nach Abschluss von a365 publish den gedruckten Anweisungen, um Ihren Agent hochzuladen:

  1. Gehen Sie zum Microsoft 365 Admin-Center.
  2. Navigieren Sie zu Agents>Alle Agents.
  3. Wählen Sie Benutzerdefinierten Agent hochladen aus.
  4. Laden Sie die manifest.zip-Datei aus dem manifest-Ordner Ihres Projekts hoch.

Weitere Informationen finden Sie unter Admin-Rollen im Microsoft 365 Admin Center.

Erfolg der Veröffentlichung prüfen

Verwenden Sie die folgende Checkliste, um zu überprüfen, ob Ihr Agent erfolgreich veröffentlicht wurde:

✅ CLI-Veröffentlichung erfolgreich
✅ manifest Ordner erstellt mit manifest.json und manifest.zip
✅ Agent erscheint im Microsoft Admin Center

CLI-Ausgabe

Sie sehen diese Ausgabemeldungen, wenn der Veröffentlichungsbefehl erfolgreich ist:

✅ Manifest updated successfully
✅ manifest.zip created successfully
✅ Schritt-für-Schritt-Upload-Anweisungen ausgegeben

Wenn der Befehl fehlschlägt, überprüfen Sie die Fehlermeldungen und stellen Sie sicher, dass Sie die Blueprint-Einrichtung abgeschlossen haben.

Mögliche Fehler:

Fehler Schritt zur Behebung
Agent blueprint ID not found Führen Sie den Befehl a365 setup aus, um die Einrichtung des Blueprints abzuschließen.
Permissions missing Führen Sie die Einrichtung erneut mit dem a365 setup permissionsBefehl aus.

Befolgen Sie diese Schritte, wenn die Veröffentlichung fehlschlägt.

Manifestdateien

Sie können die folgenden Dateien im manifest Ordner mit dem Test-Pfad PowerShell-Befehl testen.

# Check manifest folder and contents exists
Test-Path <deploymentProjectPath>/manifest/
Test-Path <deploymentProjectPath>/manifest/manifest.json
Test-Path <deploymentProjectPath>/manifest/manifest.zip
# All should return: True

Anmerkung

Wenn Sie diese Dateien nicht sehen, versuchen Sie, den a365 publish Befehl erneut auszuführen.

Der Agent erscheint im Admin Center

Anmerkung

Nach dem Hochladen kann es 5-10 Minuten dauern, bis Ihr Agent im Admin Center und in Teams erscheint. Diese Verzögerung ist normal.

Bestätigen Sie, dass der Agent anwesend ist, indem Sie folgende Schritte anwenden:

  1. Wechseln Sie zu Microsoft 365 Admin Center.
  2. Navigieren Sie zu Agents>Alle Agents.
  3. Ihr Agent erscheint in der Liste.

Die folgende Tabelle zeigt, welche Details Sie finden können:

Feld Was zu prüfen ist
Name Ihr Agentname (von manifest.json)
Version Versionsnummer (zum Beispiel, 1.0.0)
Publisher Name Ihrer Organisation
Verfügbarkeit Verfügbar/Alle Benutzer

Siehe auch

Nächste Schritte,

Nachdem Sie Ihren Agent veröffentlicht haben, erstellen Sie eine Instanz, damit Sie ihn in Ihrem Mandanten konfigurieren und verwenden können.

Erstellen der Agent-Instanz

Problembehandlung

Häufige Probleme beim Veröffentlichen von Agents im Microsoft 365 Admin Center.

Trinkgeld

Die Agent 365 Troubleshooting-Anleitung enthält übergeordnete Empfehlungen zur Fehlerbehebung, Best Practices und Links zu Inhalten zur Fehlerbehebung für jeden Abschnitt des Entwicklungszyklus von Agent 365.

Veröffentlichungsbefehl schlägt fehl

Symptome:

  • Fehler während a365 publish
  • manifest.zip wird nicht erstellt

Ursachen:

  • Einrichtung ist nicht vollständig
  • Manifestprüffehler
  • Berechtigungen reichen nicht aus

Lösung:

  1. Stellen Sie sicher, dass die Einrichtung abgeschlossen ist.

    Get-Content a365.generated.config.json | ConvertFrom-Json | Select-Object agentBlueprintId

  2. Führen Sie den Veröffentlichen-Befehl aus, und befolgen Sie die Prompts.

Upload schlägt im Admin-Center fehl

Symptome:

  • Fehler beim Hochladen manifest.zip im Microsoft 365 Admin Center
  • Der Agent wird nach dem Hochladen nicht angezeigt

Ursachen:

  • Nicht ausreichende Berechtigungen im Admin Center
  • Ungültige oder veraltete manifest.zip

Lösung:

  1. Stellen Sie sicher, dass Sie die globale Admin-Rolle haben.
  2. Führen Sie a365 publish erneut aus, um ein neues manifest.zip zu erstellen.
  3. Versuchen Sie das Hochladen erneut nach den Upload-Schritten.

Weitere Informationen finden Sie unter Agents im Microsoft 365 Admin Center hochladen.

  • Last updated on