Agent veröffentlichen im Microsoft Admin Center

Verwenden Sie den a365 publish Befehl, um Ihren Agent zu verpacken, und laden Sie das Paket dann in das Microsoft 365 Admin Center hoch. Nach der Veröffentlichung können Sie Agentinstanzen innerhalb Ihrer Organisation erstellen und den Agent steuern.

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie die folgenden Gegenstände haben.

Erforderliche Konten und Berechtigungen

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

  • Globaler Administrator
  • Administrator der Agenten-ID

Erforderliche Tools

• A365 CLI installiert (Agent 365 CLI)

Erforderliche Einrichtungsschritte

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

1. Erstellen Sie einen Agenten-Blueprint – Folgen Sie dem Einrichtungsschritt, um Ihren Agenten-Blueprint zu erstellen.
2. Agent lokal testen – Überprüfen Sie, ob Ihr Agent ordnungsgemäß funktioniert, indem Sie Agents Playground verwenden (siehe Test-Agents lokal).
3. Vorbereiten von Konfigurationsdateien – Stellen Sie sicher, dass a365.config.json und a365.generated.config.json auf dem neuesten Stand sind.

Befehl veröffentlichen

Führe den Befehla365 publish aus:

a365 publish

Was dieser Befehl bewirkt:

1. Updatemanifest – Updates manifest.json mit Ihrer Agent-Blueprint-ID
2. Paket erstellen – Pakete manifest.json und Symbole in manifest.zip verpacken
3. Druckanweisungen – Zeigt schrittweise Anleitungen zum Hochladen über das Microsoft 365 Admin Center an.

Upload ins Verwaltungszentrum

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

1. Navigieren Sie zu 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 in Ihrem Projekt hoch.

Weitere Informationen finden Sie unter Hochladen von Agents in das Microsoft 365 Admin Center.

Überprüfen Sie erfolgreiche Veröffentlichungen

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 wird im Microsoft Admin Center angezeigt

CLI-Ausgabe

Diese Ausgabemeldungen werden angezeigt, wenn der Befehl zum Veröffentlichen erfolgreich ist:

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

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

Mögliche Fehler:

Befolgen Sie diese Schritte, wenn das Veröffentlichen scheitert.

Manifestdateien

Sie können die folgenden Dateien im manifest Ordner mithilfe des PowerShell-Befehls "Test-Path " 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

Agent erscheint im Verwaltungszentrum

Vergewissern Sie sich, dass der Agent vorhanden ist, indem Sie die folgenden Schritte ausführen:

1. Wechseln Sie zu Microsoft 365 Admin Center.
2. Navigieren Sie zu Agenten>Alle Agenten.
3. Ihr Agent wird in der Liste angezeigt.

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

Siehe auch

• Setup-Agent-Blueprint
• Agent erscheint nicht in Teams

Nächste Schritte

Nachdem du deinen Agenten veröffentlicht hast, erstelle eine Instanz, damit du ihn in deinem Tenant konfigurieren und verwenden kannst.

Problembehandlung

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

Publish Command fehlschlägt

Symptome:

• Fehler bei a365 publish
• manifest.zip wird nicht erstellt.

Ursachen:

• Der Aufbau ist noch nicht vollständig
• Manifest Validierungsfehler
• Unzureichende Berechtigungen

Solution:

1. Überprüfen Sie, ob die Einrichtung abgeschlossen ist.

   a365 config display -g
   # Check for: agentBlueprintId
   

2. Führe den Befehl publish aus und folge den Aufforderungen.

Upload schlägt im Admin Center fehl

Symptome:

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

Ursachen:

• Unzureichende Berechtigungen im Admin Center
• Ungültig oder veraltet manifest.zip

Solution:

1. Stellen Sie sicher, dass Sie über die Rolle "Globaler Administrator" oder "Agent-ID-Administrator" verfügen.
2. Führen Sie den Vorgang a365 publish erneut aus, um eine neue manifest.zipDatei zu generieren.
3. Versuchen Sie, den Upload erneut gemäß den Uploadschritten durchzuführen.

Weitere Hilfe finden Sie unter Hochladen von Agents in das Microsoft 365 Admin Center.