Freigeben ü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.

Nachdem du deinen Agenten veröffentlicht und im Microsoft Admin Center verfügbar gemacht hast, kannst du Agent-Instanzen und Agenten-Nutzer erstellen. Diese Instanzen und Nutzer verwenden den von dir erstellten Agenten-Blueprint und den Agentencode.

Dieser Artikel unterteilt den Prozess in drei Hauptschritte:

  1. Agent im Teams-Entwicklerportal konfigurieren
  2. Agenteninstanz erstellen
  3. Teste deinen eingesetzten Agenten

Wenn Sie Schwierigkeiten haben, besuchen Sie den Abschnitt Fehlerbehebung .

Voraussetzungen

1. Agent im Teams-Entwicklerportal konfigurieren

Konfigurieren Sie nach der Veröffentlichung den Agent-Blueprint im Teams-Entwicklerportal, um Ihren Agent mit der Microsoft 365 Messaginginfrastruktur zu verbinden. Ohne diese Konfiguration empfängt Ihr Agent keine Nachrichten von Teams, E-Mails oder anderen Microsoft 365 Diensten.

  1. Hol dir deinen Bauplan-ID

    Führe den a365-Konfigurationsdisplay -g Befehl aus, um deine Konfiguration anzuzeigen:

    a365 config display -g

    Kopieren Sie den agentBlueprintId Wert aus der Ausgabe.

  2. Navigieren Sie zum Entwicklerportal

    Öffnen Sie Ihren Browser und gehen Sie zur Konfigurationsseite:

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

    Ersetzen Sie <your-blueprint-id> durch den Wert agentBlueprintId, den 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.

  3. Konfigurieren Sie den Agenten

    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, auf der der Agent-Typ auf Bot-basiert eingestellt ist und das Bot-ID-Feld ausgefüllt ist.

Du brauchst diese Konfiguration, bevor du Agenteninstanzen in Teams erstellen kannst.

Erfahren Sie mehr über Agent Identity Blueprints und die Konfiguration des Developer Portals.

2. Agenteninstanz erstellen

Jetzt kannst du eine Instanz deines Agenten-Blueprints aus Teams anfordern. Erfahren Sie mehr darüber, wie Sie einen Agenten entdecken, erstellen und einarbeiten.

Wenn Sie eine Agenteninstanz anfordern, sendet Teams die Anfrage zur Genehmigung an Ihren Tenant-Administrator. Administratoren können Anfragen über das Microsoft Admin Center – Seite "Requested Agents" – prüfen und genehmigen.

Nachdem der Administrator deine Anfrage genehmigt hat, erstellt Teams deine Agenteninstanz und stellt sie in Teams zur Verfügung.

3. Teste deinen eingesetzten Agenten

Testen Sie sie nach dem Erstellen einer Agentinstanz in Microsoft 365, um sicherzustellen, dass sie in der Produktion ordnungsgemäß funktioniert.

Nach der Bereitstellung und mit im Agent 365 SDK aktivierten Agentbenachrichtigungen ist Ihr Agent in Microsoft 365 Dienste integriert. Es funktioniert mit Teams für Chats, Kanäle und Besprechungen; mit E-Mail und Kalender zum Senden, Empfangen und Planen; und mit SharePoint und OneDrive für den Dokumentzugriff und die Dateifreigabe. Es unterstützt außerdem Kollaborationsfunktionen wie Organisationspräsenz, Planer-Aufgaben und Dokumentenkommentare.

Von Bedeutung

Genau wie normale Benutzer benötigen Agentbenutzer auch geeignete Microsoft 365 Lizenzen für den Zugriff auf Dienste. Allgemeine Lizenzen umfassen Microsoft 365 E5, Teams Enterprise und Microsoft 365 Copilot.

Eingesetzten Agenten im Verwaltungszentrum anzeigen

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

Wechseln Sie zum Microsoft 365 Admin Center – Agents zu:

  • Veröffentlichten Agent anzeigen
  • Verwalten der Agent-Einstellungen
  • Überwachung der Agenten-Nutzung
  • Konfigurieren von Berechtigungen

Agent in Teams testen

Testen Sie den Agent-Benutzer direkt in Microsoft Teams, nachdem Sie Ihren Agent-Blueprint bereitgestellt, veröffentlicht und konfiguriert sowie einen Agent-Benutzer erstellt haben.

Hinweis

Frontier erforderlich: Stellen Sie sicher, dass Microsoft Agent 365 Frontier für Ihren Tenant aktiviert ist und Ihr Administrator Ihnen Zugang gewähren muss. Dieser Zugriff ist erforderlich, um Agentinstanzen zu erstellen und mit Agents in Microsoft Teams zu interagieren, während Agent 365 in der Vorschau ist. Erfahren Sie mehr über Frontier Kontaktiere deinen Mieteradministrator, falls du keinen Zugriff hast.

Starten Sie mit dem Testen

  1. Suchen Sie in Teams nach Ihrem neuen Agenten-Nutzer

    Hinweis

    Der Erstellungsprozess des Agent-Benutzers ist asynchron und kann einige Minuten bis mehrere Stunden dauern, bis der Agent-Nutzer nach der Erstellung durchsuchbar ist.

  2. Starte einen neuen Chat mit deiner neu erstellten Agenten-Instanz.

  3. Senden Sie Testnachrichten, um die Funktionalität des Agenten zu überprüfen.

Beispiel-Testnachricht

Wenn Sie den Agenten mit E-Mail konfiguriert haben, senden Sie diese Nachricht, um die E-Mail-Funktionalität zu testen. Aktualisieren Sie den Wert der Empfänger-E-Mail recipient@contoso.com .

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

Der Agent bearbeitet die Anfrage und sendet die E-Mail, ohne weitere Bestätigung zu verlangen.

Checkliste für die Überprüfung

Nachdem Sie Ihre Agenteninstanz erstellt haben, überprüfen Sie, ob sie in Teams korrekt funktioniert.

✅ Entwicklerportal-Konfiguration gespeichert
✅ Agent erscheint in der Teams-Apps-Suche
✅ Du kannst einen Instanzagenten für Teams erstellen
✅ Agent-Instanz erstellt
✅ Agent-Benutzer erscheint in der Organisation
✅ Agent antwortet auf Nachrichten
✅ Der Agent kann Aktionen ausführen
✅ Anwendungsprotokolle zeigen keine Fehler
✅ Beobachtbarkeit bei der Arbeit im Verwaltungszentrum

Wenn Ihre Agenteninstanz nicht wie erwartet funktioniert, finden Sie im Abschnitt Fehlerbehebung detaillierte Lösungen für häufige Probleme.

Überprüfen Sie, ob die Konfiguration des Entwicklerportals gespeichert ist

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

✅ Agententyp zeigt: Bot-basiert
✅ Bot-ID stimmt mit deiner überein. agentBlueprintId
✅ Zeigt erfolgreich gespeicherte Nachricht

Verifizieren Sie, dass der Agent in Teams erscheint.

  1. > Teams-Apps öffnen

  2. Suche nach deinem Agentennamen

    ✅ Agent erscheint in den Suchergebnissen
    ✅ Zeigt dein Agenten-Symbol und die Beschreibung

Überprüfen Sie, dass Sie einen Instanzagenten für Teams erstellen können

Wählen Sie Ihren Agenten in Teams Apps aus

✅ Die Schaltfläche "Instanz anfordern/Instanz erstellen" ist aktiviert
✅ Kann Instanzen ohne Fehler anfordern

Verifizieren Sie die erstellte Agenteninstanz

Nach Auswahl der Anfrage-Instanz:

✅ Anfrage wird erfolgreich an die Verwaltung gesendet

Überprüfen Sie, ob der Agent User in der Organisation erscheint

Im Microsoft 365 Admin Center:

  1. Navigieren Sie zu https://admin.cloud.microsoft/#/agents/all
  2. Navigieren Sie zum Reiter Alle Agentenanfragen

✅ Ihre Agenten-Instanzanfrage ist mit dem Status "ausstehende Überprüfung" aufgeführt.
✅ Der Administrator kann die Agent-Instanz zur Nutzung genehmigen
✅ Der Benutzer kann dann eine Instanz aus Teams erstellen und ihr einen Namen geben.

Überprüfen Sie, ob der Agent auf Nachrichten antwortet

Im Teams-Chat mit deinem Agenten – sende eine Testnachricht: Hello!

✅ Agent zeigt Tippindikator an
✅ Der Agent antwortet innerhalb weniger Sekunden
✅ Die Antwort ist kohärent und relevant

Verifizieren, dass der Agent Aktionen ausführen kann

Wenn die Werkzeuge konfiguriert sind, testen Sie die Funktionsweise der Werkzeuge. Wenn Sie zum Beispiel den Mail-MCP-Server hinzugefügt haben, senden Sie sich selbst eine Test-E-Mail.

Der Makler sollte:

✅ Erkenne die Anfrage
✅ Führe den Werkzeugaufruf aus
✅ Bestätigen Sie den erfolgreichen Abschluss

Sie sollten überprüfen, ob die E-Mail in Ihrem Posteingang ankommt.

Überprüfen der Funktionalität

Die folgende Checkliste bietet einen systematischen Testansatz für Ihren Agenten:

Grundlegende Funktionalität:

✅ Der Agent antwortet auf einfache Begrüßungen.
✅ Der Agent übernimmt mehrstufige Gespräche.
✅ Der Agent liefert relevante Antworten.

Werkzeugfunktionalität:

Das hängt von der Konfiguration des MCP-Servers ab

✅ Kann E-Mails verschicken.
✅ Kann auf den Kalender zugreifen.
✅ Kann Dokumente durchsuchen.
✅ Kann konfigurierte Aktionen ausführen.

Fehlerbehandlung:

✅ Behandelt ungültige Anfragen elegant.
✅ Bietet hilfreiche Fehlermeldungen.
✅ Es stürzt nicht bei unerwarteten Eingaben ab.

Leistung:

✅ Antwortet innerhalb weniger Sekunden.
✅ Keine Timeout-Fehler.
✅ Konsistente Reaktionszeiten.

Anwendungsprotokolle überprüfen

Um zu sehen, was dein Agent macht, überprüfe die Anwendungsprotokolle mit dem az webapp log tail Befehl.

# Real-time logs from Azure
az webapp log tail --name <your-web-app> --resource-group <your-resource-group>

Worauf man in Protokollen achten sollte:

✅ Eingehende Anfragen von Teams
✅ Erfolgreiche Authentifizierung
✅ Ausführung von Toolaufrufen
✅ Antworten werden verschickt
❌ Fehlermeldungen oder Ausnahmen

Observabilität im Verwaltungszentrum überprüfen

Nachdem Ihr Makler mit dem Laufen begonnen hat:

  1. Navigieren Sie zu https://admin.cloud.microsoft/#/agents/all

  2. Wählen Sie Ihren Agent aus und öffnen Sie die Registerkarte Aktivität.

    Sie sollten Folgendes sehen:

    ✅ Sitzungen erscheinen.
    ✅ Jede Sitzung zeigt Auslöser und Aktionen.
    ✅ Tool-Aufrufe werden mit Zeitstempeln protokolliert.

Nächste Schritte

Ihr Agent ist jetzt in der Cloud und kann mit Ihrem Team 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.

Der Entwicklungszyklus Ihres Agenten ist abgeschlossen, aber seine Wirkung beginnt gerade erst. Ein Großteil dessen, was Sie im Agent 365-Entwicklungslebenszyklus gebaut haben, ist Open Source und heißt Community-Beiträge willkommen. Bugs, Feature Requests und Pull Requests einreichen:

  • Agent 365 Beispiele: Hast du interessante und spaßige Beispielagenten? Teilen Sie Ihren Agent-Code 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

Problembehandlung

Dieser Abschnitt enthält häufige Probleme beim Erstellen und Testen von Agent-Instanzen.

Tipp

Der Agent 365 Troubleshooting Guide enthält übergeordnete Empfehlungen zur Fehlerbehebung, Best Practices und Links zu Inhalten zur Fehlerbehebung für jeden Teil des Entwicklungszyklus von Agent 365.

Agent erscheint nicht in Teams

Symptom: Der Agent erscheint im Verwaltungszentrum, kann ihn aber in den Teams-Apps nicht finden.

Grundursache: Fehlende Konfiguration des Entwicklerportals.

Solution:

  1. Holen Sie sich Ihre Bauplan-ID:

    a365 config display -g
# Copy the agentBlueprintId value

  2. Im Entwicklerportal konfigurieren:

    1. Navigieren Sie zu https://dev.teams.microsoft.com/tools/agent-blueprint/<your-blueprint-id>/configuration
    2. Setzen Sie den Agententyp auf Bot-basiert
    3. Setze Bot-ID auf deineagentBlueprintId
    4. Wählen Sie "Speichern" aus.

  3. Warte 5-10 Minuten auf die Vermehrung.

Überprüfung:

  • Öffnen Sie die Teams > Apps > und suchen Sie nach Ihrem Agenten.
  • Agent erscheint und kann hinzugefügt werden

Kann keine Agenteninstanz in Teams erstellen

Symptom: Der Agent erscheint in Teams, kann aber keine Instanz hinzufügen oder erstellen; Der Button Instance anfordern funktioniert nicht.

Ursache: Microsoft Agent 365 Frontier ist für den Tenant nicht aktiviert.

Lösung: Kontaktieren Sie Ihren Tenant-Administrator, um zu überprüfen, ob Microsoft Agent 365 Frontier für den Tenant aktiviert ist

Erfahren Sie mehr über Frontier

Überprüfung:

Frontier-Features werden innerhalb von Microsoft 365 Copilot und Microsoft 365 Apps angezeigt, sobald Ihre Lizenz- und Administratoreinstellungen dies zulassen.

Agent antwortet nicht auf Nachrichten

Symptom: Agent-Instanz erstellt, aber sie antwortet nicht auf Nachrichten; Keine Protokolle in der Anwendung.

Ursache: Mehrere mögliche Ursachen – Probleme am Messaging-Endpunkt, Authentifizierungsprobleme oder Konfigurationsfehler.

Grundlegendes zur Problembehandlung

  1. Überprüfen Sie, ob die Webanwendung läuft:

    az webapp show --name <your-app-name> --resource-group <your-resource-group> --query state
# Should be: "Running"

  2. Überprüfen Sie den Messaging-Endpunkt:

    • Es sollte sein: https://<your-app-root-url>/api/messages
    • Überprüfen Sie es in a365.config.json und a365.generated.config.json

  3. Testen Sie den Endpunkt direkt:

    curl https://<your-app-root-url>/api/messages
# Should not return 404

  4. Überprüfen Sie die Bewerbungsprotokolle:

    az webapp log tail --name <your-app-name> --resource-group <your-resource-group>
# Look for incoming requests and errors

Erweiterte Diagnose

  1. Authentifizierung überprüfen:

    • Überprüfe, ob die Token abgelaufen sind. Erneuere sie bei Bedarf.
    • Überprüfen Sie die Zugangsdaten in der Web-App-Konfiguration.

  2. Tool/MCP-Konfiguration prüfen:

    • Überprüfen Sie, ob MCP-Server konfiguriert sind.
    • Stellen Sie sicher, dass Berechtigungen erteilt wurden.

  3. Testen Sie lokal:

    • Führe den Agenten lokal mit derselben Konfiguration aus.
    • Testen Sie mit Agents Playground.
    • Wenn es lokal funktioniert, aber nicht in der Cloud, gibt es ein Bereitstellungsproblem >

Gängige Lösungen

  • Messaging-Endpunkt inkorrekt: Aktualisieren Sie die Einstellungen im Azure-Portal und Developer-Portal.
  • Web-App wurde beendet: Starten Sie sie mit Azure Portal oder CLI
  • Token abgelaufen: Aktualisierungstoken in Web-App-Umgebungsvariablen
  • Fehlende Umgebungsvariablen: Überprüfen Sie die App-Einstellungen im Azure-Portal.
  • Probleme mit MCP-Servern: Service Principal und Berechtigungen überprüfen
  • Codefehler: Überprüfen Sie die Anwendungsprotokolle auf Ausnahmen

Verifizierung

Senden Sie Ihrem Agenten in Teams eine Nachricht und prüfen Sie die Anwendungsprotokolle auf eingehende Anfragen.

Sie könnten auch ausprobieren:

Werkzeugaufrufe fehlschlagen

Symptom: Der Agent antwortet auf Nachrichten, aber Tool-Anrufe schlagen fehl. Du siehst Erlaubnis verweigert oder Timeout-Fehler.

Ursache: Fehlende MCP-Serverberechtigungen, Dienstprinzip nicht konfiguriert, Netzwerkverbindungsprobleme oder falsche Werkzeugkonfiguration.

Lösungen

Versuchen Sie die folgenden Lösungen, wenn Werkzeugaufrufe fehlschlagen:

  • Berechtigungen im Verwaltungszentrum überprüfen

    Überprüfen und genehmigen Sie die erforderlichen MCP-Serverberechtigungen:

    • Navigieren Sie zu https://admin.cloud.microsoft/#/agents/all
    • Wählen Sie Ihre Agentenberechtigungen > aus
    • Stellen Sie sicher, dass die Liste die erforderlichen MCP-Server enthält und genehmigt.

  • Service Principal überprüfen

    Führe das einmalige Setup-Skript aus, falls du es vorher nicht ausgeführt hast:

    # Download and run:
# https://github.com/microsoft/Agent365-devTools/blob/main/scripts/cli/Auth/New-Agent365ToolsServicePrincipalProdPublic.ps1

  • Überprüfen Sie die MCP-Endpunktkonfiguration

    Stellen Sie sicher, dass Sie den Produktions-MCP-Endpunkt verwenden:

    # Should be production endpoint, not mock
MCP_PLATFORM_ENDPOINT=https://agent365.svc.cloud.microsoft

  • Überprüfen Sie die verwaltete Identität

    Überprüfen Sie, ob die verwaltete Identität in Ihrer Web-App aktiviert ist:

    # Verify managed identity is enabled
az webapp identity show --name <your-app-name> --resource-group <your-resource-group>

Verifizierung

Das Testtool ruft Teams auf und überprüft die Protokolle auf eine erfolgreiche Ausführung.

Sie könnten auch diese Schritte ausprobieren:

Lizenzübertragung fehlschlägt

Symptom: Lizenz kann dem agentischen Nutzer nicht zugewiesen werden; Lizenzfehler im Verwaltungszentrum.

Ursache: Unzureichende Lizenzen verfügbar, falscher Lizenztyp oder Berechtigungsprobleme.

Lösungen

Probieren Sie folgende Lösungen aus, wenn die Lizenzzuweisung fehlschlägt:

  1. Überprüfen Sie, ob Lizenzen verfügbar sind:

    • Überprüfen Sie Microsoft 365 Admin Center >Billing>Licenses
    • Stellen Sie sicher, dass Microsoft Agent 365 Frontier für den Tenant aktiviert ist

  2. Lizenz manuell zuweisen:

    • Wechseln Sie zum Microsoft 365 Admin Center >Users
    • Finde den agentischen Nutzer
    • Entsprechende Lizenz zuweisen

  3. Erforderliche Lizenzen für die volle Funktionalität:

    • Microsoft 365 E5 (oder gleichwertig)
    • Teams Enterprise
    • Microsoft 365 Copilot (für Copilot-Funktionen)

Verifizierung

Überprüfen Sie das Benutzerprofil im Admin-Center, um die zugewiesenen Lizenzen anzuzeigen.

  • Last updated on