Freigeben über

Agents bereitstellen und veröffentlichen

Wichtig

Sie müssen Teil des Frontier-Vorschauversionsprogramms sein, um Vorabzugriff auf Microsoft Agent 365 zu erhalten. Frontier verbindet Sie direkt mit den neuesten KI-Innovationen von Microsoft. Frontier-Vorschauversionen unterliegen den bestehenden Vorschauversionsbedingungen Ihrer Kundenvereinbarungen. Da sich diese Funktionen noch in der Entwicklung befinden, können sich ihre Verfügbarkeit und Merkmale im Laufe der Zeit ändern.

Sie haben Ihren Agent erstellt und lokal getestet – jetzt ist es an der Zeit, ihn in der Cloud zum Leben zu erwecken. Das Bereitstellen und Veröffentlichen Ihres Agenten macht ihn in Ihrer Organisation verfügbar, sodass Teams Agenteninstanzen entdecken, erstellen und mit Microsoft 365 interagieren können.

Dieser Leitfaden führt Sie durch die Bereitstellung Ihres Agent-Codes in Azure und die Veröffentlichung im Microsoft Admin Center, wo er zu einem auffindbaren Objekt für Ihre Organisation wird.

Übersicht

Der Bereitstellungs- und Veröffentlichungsprozess umfasst zwei wichtige Schritte:

  1. Deployen – Deploye deinen Agenten in der Azure Web App (optional, überspringen, wenn dein Agent bereits läuft und zugänglich ist)
  2. Veröffentlichen – Veröffentlicht Ihren Agent im Agent Store im Microsoft 365 Admin Center

Nach der Veröffentlichung schließen Sie das Onboarding ab, indem Sie eine Agenteninstanz über Microsoft Teams erstellen.

Wichtig

Der Befehl create-instance wird vorübergehend entfernt. Es umging die erforderlichen Registrierungsschritte, was die Funktionalität des Agenten einschränkte. Dieser Befehl kann in einer späteren Version wieder eingeführt werden, sobald er dem empfohlenen Workflow entspricht. Verwenden Sie den publish Befehl und erstellen anschließend eine Agenteninstanz über Microsoft Teams.

Voraussetzungen

Bevor Sie beginnen, sollten Sie sicherstellen, dass Folgendes vorhanden ist:

Erforderliche Konten und Berechtigungen

  • Microsoft Entra-Mandant mit einer der folgenden Rollen:
    • Globaler Administrator
    • Agent-ID-Administrator
    • Agent-ID-Entwickler
  • Azure-Abonnement mit Mitwirkendenzugriff

Notwendige Werkzeuge

Erforderliche Einrichtungsschritte

Stellen Sie vor der Bereitstellung und Veröffentlichung sicher, dass Sie die folgenden Schritte ausführen:

  1. Agenten-Blueprint erstellt – Führen Sie die Einrichtungsschritte in Register Agents durch, um Ihren Agent-Blueprint zu erstellen
  2. Agent lokal getestet – Überprüfen Sie mit Agents Playground, ob Ihr Agent ordnungsgemäß funktioniert (siehe Lokales Testen von Agents).
  3. Konfigurationsdateien bereit – Stellen Sie sicher, dass a365.config.json und a365.generated.config.json auf dem neuesten Stand sind.

Schritt 1: Bereitstellen in Azure

Durch den Befehl a365 deploy wird Ihr Agent während der Einrichtung in der Azure Web-App bereitgestellt. Dadurch wird Ihr Agent-Code in Azure hochgeladen, sodass er für die Ausführung in der Cloud verfügbar ist und Anforderungen von Microsoft 365 verarbeitet.

Bereitstellen des Agents

Führen Sie den Bereitstellungsbefehl aus:

a365 deploy

Der Bereitstellungsbefehl für .NET-Agents:

  • Erkennt .NET-Projektdateien (*.csproj, *.fsprojoder *.vbproj)
  • Stellt NuGet-Pakete mithilfe von dotnet restore wieder her
  • Veröffentlicht die Anwendung mithilfe von dotnet publish mit der Versionskonfiguration
  • Erstellt das Oryx-Manifest mit dem Einstiegspunkt-DLL-Befehl (z. B dotnet YourApp.dll)
  • Konfiguriert die Azure-Runtime basierend auf der erkannten .NET-Version (Standard: DOTNET|8.0)
  • Bereitstellung per ZIP mit Echtzeitfortschritt

Warnung

Geheimnisverwaltung: Bei der Bereitstellung werden Umgebungsvariablen (einschließlich API-Schlüsseln und Geheimnissen) als Azure-App Einstellungen gespeichert. Während Umgebungsvariablen oft für die Konfiguration verwendet werden, werden sie in Nur-Text gespeichert. Für Produktionsumgebungen empfiehlt Microsoft die Verwendung von Azure Key Vault für vertrauliche Geheimnisse. Weitere Informationen finden Sie unter Sicheres Speichern von App-Geheimnissen bei der Entwicklung in ASP.NET Core und Azure Key Vault-Konfigurationsanbieter. Übergeben Sie niemals .env-Dateien mit vertraulichen Informationen an die Quellcodeverwaltung.

Überprüfen der Bereitstellung

Nach Abschluss der Bereitstellung:

  1. Navigieren Sie zu Ihrer Web-App im Azure Portal.
  2. Gehen Sie zu Einstellungen>Konfiguration, um die App-Einstellungen zu überprüfen.
  3. Überprüfen Sie die Bereitstellungsprotokolle im Deployment Center.

Schritt 2: Veröffentlichen im Microsoft Admin Center

Der Befehl a365 publish veröffentlicht Ihren Agent im Agent Store im Microsoft 365 Admin Center, sodass er auffindbar und installierbar ist. Dieser letzte Schritt macht Ihren Agenten für Organisationen verfügbar, um Agent-Instanzen zu erstellen und in ihrer Microsoft 365-Umgebung zu verwenden.

Veröffentlichen des Agents

Führen Sie den Veröffentlichungsbefehl aus:

a365 publish

Der Veröffentlichungsbefehl führt folgende Aktionen aus:

  • Extrahiert Manifestvorlagen aus eingebetteten Ressourcen (wenn der Ordner manifest nicht vorhanden ist)
  • Aktualisiert manifest.json mit der Agent-Blueprint-ID
  • Hält an, damit Sie Manifestfelder anpassen könne (Version, Namen, Beschreibungen, Entwicklerinformationen, Symbole)
  • Verpackt das App-Bundle (manifest.zip)
  • Lädt es in den Agent Store im Microsoft 365 Admin Center hoch
  • Erstellt Verbundidentität für die Integration in Teams
  • Weist die erforderlichen Graph-Berechtigungen zu

Anpassen des Manifests

Die CLI hält während der Veröffentlichung an, damit Sie Ihr Agent-Manifest anpassen können:

=== CUSTOMIZE YOUR AGENT MANIFEST ===

Your manifest has been updated at: [path]\manifest\manifest.json

When you're done customizing, type 'continue' (or 'c') and press Enter to proceed:

Manuelle Schritte:

  1. Öffnen Sie manifest.json in Ihrem Texteditor.

  2. Passe die erforderlichen Felder an:

    • Aktualisieren Sie die Versionsnummer. Erhöhen Sie den Wert vom vorherigen, wenn Sie erneut hochladen.
    • Legen Sie einen aussagekräftigen Agent-Namen fest. Die Namen sollten kleiner oder gleich 30 Zeichen sein.
    • Schreiben Sie klare Beschreibungen.
    • Aktualisieren Sie die Entwicklerinformationen.
    • Ersetzen Sie optional Symboldateien.

  3. Speichern Sie die Manifest-Datei.

  4. Kehren Sie zur CLI zurück, und geben Sie continue oder c ein, und drücken Sie die EINGABETASTE.

Die CLI schließt den Veröffentlichungsprozess ab und Ihr Agent ist jetzt im Microsoft 365 Admin Center verfügbar. Bevor du jedoch deinen Agenten testen oder Nutzern erlauben kannst, Instanzen zu erstellen, musst du den Agenten-Blueprint im Developer Portal konfigurieren.

Schritt 3: Agent-Blueprint im Developer Portal konfigurieren

Nach der Veröffentlichung müssen Sie den Agent-Blueprint im Teams Developer Portal konfigurieren, um Ihren Agenten mit der Microsoft 365-Messaging-Infrastruktur zu verbinden. Ohne diese Konfiguration erhält Ihr Agent keine Nachrichten von Teams, E-Mails oder anderen Microsoft 365-Diensten.

Hol dir deinen Bauplan-ID

Führe folgenden Befehl aus, um deine Konfiguration anzuzeigen:

a365 config display -g

Kopieren Sie den agentBlueprintId Wert aus der Ausgabe.

Öffnen Sie Ihren Browser und navigieren Sie zur Konfigurationsseite:

https://dev.teams.microsoft.com/tools/agent-blueprint/<your-blueprint-id>/configuration

Ersetzen Sie <your-blueprint-id> den Wert, den agentBlueprintId Sie kopiert haben.

Hinweis

Wenn Sie keinen Zugriff auf das Developer Portal haben, wenden Sie sich an Ihren Tenant-Administrator, um Ihnen Zugang zu gewähren oder diese Konfiguration in Ihrem Namen abzuschließen.

Konfigurieren des Agents

Im Entwicklerportal:

  1. Setzen Sie den Agententyp auf Bot-basiert
  2. Setze die Bot-ID auf deinen agentBlueprintId Wert
  3. Wählen Sie "Speichern" aus.

Screenshot zeigt die Entwicklerportal-Konfigurationsseite mit Agent Type auf Bot-basiert und ausgefülltem Bot ID-Feld.

Diese Konfiguration ist erforderlich, bevor du Agenteninstanzen in Teams erstellen kannst.

Weitere Informationen zu Agent Identity Blueprints und Developer Portal Konfiguration finden Sie unter Configure the Agent Identity Blueprint.

Schritt 4: Teste deinen eingesetzten Agenten

Nachdem Sie Ihren Agent bereitgestellt und veröffentlicht haben, können Sie ihn in Microsoft 365 testen, um sicherzustellen, dass er in der Produktion ordnungsgemäß funktioniert. Nach der Bereitstellung ist Ihr Agent in Microsoft 365-Dienste integriert, einschließlich Teams (Chats, Kanäle, Besprechungen), E-Mails und Kalender (Senden/Empfangen, Planen), SharePoint und OneDrive (Dokumentzugriff, Dateifreigabe) und Zusammenarbeitstools (organisatorische Anwesenheit, Planeraufgaben, Dokumentkommentare).

Wichtig

Agentische Benutzer benötigen entsprechende Microsoft 365-Lizenzen für den Zugriff auf diese Dienste. Allgemeine Lizenzen umfassen Microsoft 365 E5, Teams Enterprise und Microsoft 365 Copilot.

Anzeigen des bereitgestellten Agents im Admin Center

Nach der Veröffentlichung wird Ihr Agent im Microsoft Admin Center zur Übernahme angezeigt. Es kann einige Zeit dauern, bis er verteilt wurde.

Navigieren Sie zu Microsoft 365 Admin Center – Agents, um folgende Aufgaben auszuführen:

  • Anzeigen Ihres veröffentlichten Agents
  • Verwalten der Agent-Einstellungen
  • Überwachen der Agent-Nutzung
  • Konfigurieren von Berechtigungen

Testen des Agents in Teams

Nach der Bereitstellung, Veröffentlichung, Konfiguration Ihres Agent-Blueprints und der Erstellung eines Agent-Benutzers können Sie den Agent-Benutzer direkt in Microsoft Teams testen:

Hinweis

Lizenzvoraussetzung: Stellen Sie sicher, dass Ihnen die Lizenz "Microsoft Agent 365 Frontier" zugewiesen ist. Diese Lizenz ist erforderlich, um Agent-Instanzen zu erstellen und mit Agenten in Microsoft Teams zu interagieren. Kontaktiere deinen Mieteradministrator, falls du diese Lizenz nicht hast.

Wichtig

Stellen Sie vor dem Test sicher, dass Sie Schritt 3 abgeschlossen haben: Konfigurieren Sie den Agenten-Blueprint im Developer Portal. Ihr Agent erhält keine Nachrichten, bis diese Konfiguration abgeschlossen ist.

  1. Erstellen Sie eine Agenteninstanz in Teams

    • Öffnen Sie Microsoft Teams mit Ihrem Konto.
    • Gehen Sie zum Teams App Store und suchen Sie nach Ihrem veröffentlichten Agenten
    • Erstelle eine neue Agenteninstanz aus deinem Agenten-Blueprint

  2. Starten Sie mit dem Testen

    • Starte einen neuen Chat mit deiner neu erstellten Agent-Instanz
    • Senden Sie Testnachrichten zur Überprüfung der Agent-Funktionalität.

  3. Beispieltestnachricht

    Senden Sie diese Nachricht, um die E-Mail-Funktionalität zu testen (aktualisieren Sie die Empfänger-E-Mail nach Bedarf):

    Send an email to recipient@contoso.com with subject "Hello from Teams" and message "This is a test message from my agent!"

    Der Agent sollte die Anforderung verarbeiten und die E-Mail senden, ohne dass eine weitere Bestätigung erforderlich ist.

Nächste Schritte,

Herzlichen Glückwunsch! Ihr Agent befindet sich jetzt in der Cloud und kann mit Ihren Teams in Microsoft 365 zusammenarbeiten. Was als lokaler Code begann, ist heute ein auffindbarer, unternehmensbereiter Assistent, mit dem Nutzer Agent-Instanzen in Ihrer Organisation erstellen können.

Berücksichtigen Sie die folgenden Schritte, wenn Ihr Agent reale Anforderungen verarbeitet:

  • Leistung überwachen: Verwenden Sie Observability-Funktionen zum Nachverfolgen des Agent-Verhaltens und Optimieren von Antworten.
  • Weitere Tools hinzufügen: Erkunden Sie den Toolkatalog, um die Funktionen Ihres Agents zu erweitern.
  • Iterieren und verbessern: Aktualisieren Sie Ihren Agent-Code, stellen Sie ihn erneut bereit und veröffentlichen Sie ihn wieder (denken Sie daran, die Versionsnummer zu erhöhen!).
  • Organisationsweit skalieren: Teilen Sie die Erfolgsgeschichten Ihres Agents, um die Einführung zu beschleunigen.

Die Reise Ihres Agents von der Entwicklung bis zur Bereitstellung ist abgeschlossen – aber seine erfolgreiche Arbeit fängt gerade erst an.

Zugehöriger Inhalt

  • Last updated on