Teilen über


Agent-Instanzen erstellen

Von Bedeutung

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.

Sobald dein Agent veröffentlicht und im Microsoft Admin Center verfügbar ist, ist er nun bereit, basierend auf dem von Ihnen erstellten Agenten-Blueprint und Agentencode in Agenteninstanzen und Agentenbenutzer instanziiert zu werden.

Voraussetzungen

1. Agent im Teams 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.

2. Agenteninstanz erstellen

Jetzt können Sie Instanzen Ihres Agenten-Blueprints von Teams anfordern. Diese Anfrage geht erneut an den Tenant-Administrator, der über den Reiter Anfragen im Microsoft 365 Admin Center: Microsoft Admin Center - Requested Agents genehmigen muss. Sobald dies genehmigt ist, kannst du eine Agenteninstanz aus Teams erstellen. Wie das hier möglich ist: Entdecken, erstellen und integrieren Sie einen Agenten

3. Teste deinen eingesetzten Agenten

Nachdem Sie eine Agenteninstanz erstellt haben, können Sie sie in Microsoft 365 testen, um sicherzustellen, dass sie in der Produktion korrekt funktioniert.

Nach der Bereitstellung und mit aktivierten Agentenbenachrichtigungen im Agent 365 SDK integriert sich Ihr Agent mit den Microsoft 365-Diensten. Es arbeitet mit Teams für Chats, Kanäle und Meetings; mit E-Mail und Kalender zum Versenden/Empfangen und Terminplanen; und mit SharePoint und OneDrive für Dokumentenzugriff und Dateifreigabe. Es unterstützt außerdem Kollaborationsfunktionen wie Organisationspräsenz, Planer-Aufgaben und Dokumentenkommentare.

Von Bedeutung

Wie normale Nutzer benötigen auch Agent-Nutzer entsprechende Microsoft 365-Lizenzen, um auf Dienste zugreifen zu können. Allgemeine Lizenzen umfassen Microsoft 365 E5, Teams Enterprise und Microsoft 365 Copilot.

Anzeigen des bereitgestellten Agents im Admin Center

Nachdem du deinen Agenten veröffentlicht hast, erscheint er im Microsoft Admin Center zur Einstellung. Es kann eine Weile dauern, bis es sich vermehrt.

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, während Agent 365 sich in der Vorschau befindet. Kontaktiere deinen Mieteradministrator, falls du diese Lizenz nicht hast.

  1. Starten Sie mit dem Testen

    • Suchen Sie in Teams nach Ihrem neuen Agenten-Nutzer. Der Erstellungsprozess des Agent-Benutzers ist asynchron und kann einige Minuten bis mehrere Stunden dauern, bis der Agent-Nutzer nach der Erstellung durchsuchbar ist.
    • Starte einen neuen Chat mit deiner neu erstellten Agenten-Instanz.
    • Senden Sie Testnachrichten, um die Funktionalität des Agenten zu überprüfen.
  2. Beispieltestnachricht

    Wenn Sie den Agenten mit E-Mail konfiguriert haben, senden Sie diese Nachricht, um die E-Mail-Funktionalität zu testen (aktualisieren Sie die Empfänger-E-Mail bei 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

Glückwunsch! Dein Agent ist jetzt live in der Cloud und bereit, mit deinem Team in Microsoft 365 zusammenzuarbeiten. Was als lokaler Code begann, ist heute ein auffindbarer, unternehmensbereiter Assistent, mit dem Nutzer Agent-Instanzen in Ihrer Organisation erstellen können. Der Entwicklungszyklus Ihres Agenten ist abgeschlossen – aber seine Wirkung beginnt gerade erst.

Vieles von dem, womit du im Agent-365-Entwickler-Lebenszyklus gebaut hast, ist Open Source und begrüßt Community-Beiträge. Bugs, Feature Requests und Pull Requests aufstellen:

  • Agent 365 Muster: Haben Sie interessante und unterhaltsame Musteragenten? Teile deinen Agentencode hier mit der Open-Source-Community!
  • Node.js SDK: Das Agent 365 SDK in Node.js
  • Python SDK: Das Agent 365 SDK in Python
  • .NET SDK: Das Agent 365 SDK in C# (.NET)
  • Agent 365 DevTools CLI: Eine CLI, die Sie durch den gesamten Entwicklungszyklus von Agent 365 unterstützt