Erstellen von Agent-Instanzen

Nachdem Sie Ihren Agent veröffentlicht und im Microsoft Admin Center verfügbar gemacht haben, können Sie Agent-Instanzen und Agent-Benutzer erstellen. Diese Instanzen und Benutzer verwenden den Agent-Blueprint und den Agentcode, den Sie erstellt haben.

Dieser Artikel unterteilt den Prozess in drei Hauptschritte:

  1. Agent im Teams-Entwicklerportal konfigurieren
  2. Erstellen der Agent-Instanz
  3. Ihren bereitgestellten Agent testen

Wenn Sie auf Probleme stoßen, lesen Sie den Abschnitt zur Fehlerbehebung.

Voraussetzungen

1. Agent im Teams-Entwicklerportal konfigurieren

Nach der Veröffentlichung konfigurieren Sie den Agent-Blueprint im Teams-Entwicklerportal, um Ihren Agent 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.

  1. Ihre Blueprint-ID abrufen

    Öffnen Sie a365.generated.config.json in Ihrem Arbeitsverzeichnis und kopieren Sie den Wert von agentBlueprintId.

  2. Navigieren Sie zum Entwicklerportal

    Öffnen Sie Ihren Webbrowser, und wechseln Sie zur Konfigurationsseite:

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

    Ersetzen Sie <your-blueprint-id> durch den kopierten Wert aus agentBlueprintId.

    Anmerkung

    Wenn Sie keinen Zugriff auf das Entwicklerportal haben, wenden Sie sich an Ihren Mandantenadministrator, damit er Ihnen Zugriff gewährt oder die Konfiguration für Sie durchführt.

  3. Agent konfigurieren

    Im Entwicklerportal:

    1. Legen Sie den Agent-Typ auf API-basiert fest

    2. Setzen Sie die Benachrichtigungs-URL auf den Messaging-Endpunkt Ihres Agents. Finden Sie den Wert messagingEndpoint in a365.generated.config.json.

    3. Wählen Sie Speichern aus.

    Screenshot der Konfigurationsseite des Entwicklerportals mit auf API-basiertem gesetztem Agenttyp und Notification URL-Feld.

Diese Konfiguration ist erforderlich, bevor Sie Agentinstanzen in Teams erstellen können.

Weitere Informationen zu Agentidentität-Blueprints und der Konfiguration des Entwicklerportals.

2. Erstellen der Agentinstanz

Jetzt können Sie eine Instanz Ihrer Agent-Blaupause aus Teams anfordern. Weitere Informationen zum Entdecken, Erstellen und Onboarding eines Agents.

Wenn Sie eine Agent-Instanz anfordern, sendet Teams die Anfrage zur Genehmigung an Ihren Tenant-Admin. Admins können Anfragen auf der Seite Microsoft Admin Center – Requested Agents überprüfen und genehmigen.

Nachdem der Administrator Ihre Anfrage genehmigt hat, erstellt Teams Ihre Agentinstanz und stellt sie in Teams bereit.

3. Testen Sie Ihren bereitgestellten Agent

Nachdem Sie eine Agentinstanz erstellt haben, testen Sie sie in Microsoft 365, um sicherzustellen, dass sie in der Produktivumgebung korrekt funktioniert.

Nach der Bereitstellung und mit aktivierten Agentbenachrichtigungen im Agent 365 SDK integriert sich Ihr Agent in die Microsoft 365-Dienste. Es funktioniert mit Teams für Chats, Kanäle und Besprechungen, mit E-Mail und Kalender zum Versenden, Empfangen und Planen von Terminen sowie mit SharePoint und OneDrive für Dokumentenzugriff und Dateifreigabe. Es unterstützt außerdem Kollaborationsfunktionen wie Organisationspräsenz, Planner-Aufgaben und Dokumentenkommentare.

Wichtig

Genau wie normale Benutzer benötigen auch Agent-Benutzer 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

Nach Sie Ihren Agent veröffentlicht haben, wird er im Microsoft Admin Center zur Einstellung angezeigt. Es kann einige Zeit dauern, bis er verteilt wurde.

Gehen Sie zu Microsoft 365 Admin Center – Agents, um Folgendes auszuführen:

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

Testen des Agents in Teams

Nachdem Sie Ihren Agent-Blueprint bereitgestellt, veröffentlicht und konfiguriert und einen Agent-Benutzer erstellt haben, testen Sie diesen direkt in Microsoft Teams:

Test starten

  1. Suchen Sie in Teams nach Ihrem neuen Agent-Benutzer.

    Anmerkung

    Die Erstellung des Agent-Benutzers erfolgt asynchron. Nach der Erstellung kann es einige Minuten bis zu einigen Stunden dauern, bis Sie nach dem Agent-Benutzer suchen können.

  2. Starten Sie einen neuen Chat mit der neu erstellten Agentinstanz.

  3. Senden Sie Testnachrichten zur Überprüfung der Agent-Funktionalität.

Beispieltestnachricht

Wenn Sie den Agent für E-Mail konfiguriert haben, senden Sie diese Nachricht, um die E-Mail-Funktionalität zu testen. Aktualisieren Sie den Wert der E-Mail-Adresse des Empfängers 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 verarbeitet die Anforderung und sendet die E-Mail, ohne dass eine weitere Bestätigung erforderlich ist.

Checkliste für die Überprüfung

Stellen Sie nach dem Erstellen Ihrer Agenteninstanz sicher, dass sie in Teams korrekt funktioniert.

✅ Konfiguration im Entwicklerportal gespeichert
✅ Agent erscheint in der Teams-App-Suche
✅ Sie können eine Agent-Instanz in 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
✅ Einblicke bei der Arbeit im Admin Center

Wenn Ihre Agentinstanz nicht wie erwartet funktioniert, siehe Abschnitt „Fehlerbehebung“ für detaillierte Lösungen zu häufigen Problemen.

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

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

✅ Agenttyp zeigt: API-basiert✅Benachrichtigungs-URL stimmt mit dem Nachrichtenendpunkt Ihres Agenten überein ✅ Zeigt die Nachricht Erfolgreich gespeichert an

Überprüfen Sie, ob der Agent in Teams erscheint

  1. Öffnen Sie die Teams >App

  2. Suchen Sie nach Ihrem Agentnamen

    ✅ Agent erscheint in den Suchergebnissen ✅ Zeigt Ihr Agentensymbol und Ihre Beschreibung

Überprüfen Sie, ob Sie eine Agenteninstanz zu Teams erstellen können

Wählen Sie Ihren Agent in Teams-Apps aus

✅ Schaltfläche Instanz anfordern/Instanz erstellen ist aktiviert ✅ Instanz kann ohne Fehler angefordert werden

Überprüfen Sie, ob die Agentinstanz erstellt wurde

Nach Auswahl von Instanz anfordern:

✅ Anfrage sendet erfolgreich an den Admin

Überprüfen Sie, ob der Agent-Nutzer in der Organisation vorhanden ist

In Microsoft 365 Admin Center:

  1. Wechseln Sie zu: https://admin.cloud.microsoft/#/agents/all
  2. Navigieren Sie zur Registerkarte Alle Agent-Anfragen

✅ Ihre Agent-Instanzanfrage ist mit dem Status 'Zur Überprüfung ausstehend' aufgeführt ✅ Der Admin kann die Agent-Instanz zur Nutzung freigeben ✅ Der Benutzer kann eine Instanz aus Teams erstellen und ihr einen Namen vergeben.

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

Im Teams-Chat mit Ihrem Agent – Senden Sie eine Testnachricht: Hello!

✅ Agent zeigt Schreibindikator ✅ Agent antwortet innerhalb weniger Sekunden ✅ Die Antwort ist sinnvoll und relevant

Stellen Sie sicher, dass der Agent kann Aktionen ausführen kann

Wenn Sie Tools konfigurieren, testen Sie deren Funktionalität. Wenn Sie zum Beispiel den Mail-MCP-Server hinzufügen, senden Sie eine Test-E-Mail an sich selbst.

Der Agent sollte:

✅ Bestätigen der Anfrage ✅ Ausführen des Toolaufrufs ✅ Bestätigung des erfolgreichen Abschlusses

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 Agent:

Grundlegende Funktionen:

✅ Agent antwortet auf einfache Begrüßungen. ✅ Agent führt mehrstufige Unterhaltungen. ✅ Agent liefert relevante Antworten.

Werkzeugfunktionen:

Abhängig von der Konfiguration des MCP-Servers

✅ Kann E-Mails senden. ✅ 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 Ihr Agent tut, überprüfen Sie die Anwendungsprotokolle, indem Sie den Befehl az webapp log tail verwenden.

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

Worauf Sie in den Protokollen achten sollten:

✅ Eingehende Anfragen von Teams ✅ Erfolgreiche Authentifizierung ✅ Ausgeführte Toolaufrufe ✅ Gesendete Antworten ❌ Fehlermeldungen oder Ausnahmen

Überprüfung des Einblicks im Admin Center

Nachdem die Ausführung Ihres Agents begonnen hat:

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

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

    Folgendes sollte angezeigt werden:

    ✅ Sitzungen erscheinen. ✅ Jede Sitzung zeigt Trigger und Aktionen. ✅ Toolaufrufe werden mit Zeitstempeln protokolliert.

Nächste Schritte,

Ihr Agent befindet sich jetzt in der Cloud und kann mit Ihrem Team in Microsoft 365 zusammenarbeiten. Was als lokaler Code begann, ist heute ein registrierter, unternehmensreifer Assistent, mit dem Nutzer Agent-Instanzen in Ihrer Organisation erstellen können.

Der Entwicklungslebenszyklus Ihres Agents ist abgeschlossen, aber seine erfolgreiche Arbeit fängt gerade erst an. Ein Großteil dessen, was Sie im Agent 365-Entwicklungslebenszyklus erstellt haben, ist Open Source und begrüßt Community-Beiträge. Bugs, Feature Requests und Pull Requests erstellen:

  • Agent 365 Beispiele: Gibt es interessante und unterhaltsame Beispielagenten? Teilen Sie Ihren 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.

Problembehandlung

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

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.

Agent erscheint nicht in Teams

Symptom: Der Agent wird im Admin Center angezeigt, ist aber in den Teams-Apps nicht auffindbar.

Ursache: Entwicklerportal nicht konfiguriert.

Lösung:

  1. Rufen Sie Ihre Blueprint-ID von a365.generated.config.json ab — suchen Sie nach agentBlueprintId.

  2. Im Entwicklerportal konfigurieren:

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

    2. Legen Sie den Agent-Typ auf API-basiert fest

    3. Setzen Sie die Benachrichtigungs-URL auf den Messaging-Endpunkt Ihres Agents. Finden Sie den Wert messagingEndpoint in a365.generated.config.json.

    4. Wählen Sie Speichern aus.

  3. Warten Sie 5-10 Minuten, bis sich die Änderungen verbreitet haben.

Überprüfung:

  • Öffnen Sie Teams > Apps > Suchen Sie nach Ihrem Agent.
  • Der Agent erscheint und kann hinzugefügt werden.

Kann keine Agentinstanz in Teams erstellen

Symptom: Der Agent erscheint in Teams, aber Sie können keine Instanz hinzufügen oder erstellen; die Schaltfläche Instanz anfordern funktioniert nicht.

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

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

Weitere Informationen über Frontier.

Überprüfung:

Frontier-Funktionen erscheinen in Microsoft 365 Copilot und Microsoft 365 Apps, sobald Ihre Lizenz und Admin-Einstellungen dies erlauben.

Agent antwortet nicht auf Nachrichten

Symptom: Sie haben eine Agentinstanz erstellt, aber sie reagiert nicht auf Nachrichten. Sie sehen keine Protokolle in der Anwendung.

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

Grundlegendes zur Problembehandlung

  1. Stellen Sie sicher, dass die Web-App ausgeführt wird:

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

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

    • 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 Anwendungsprotokolle:

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

Erweiterte Diagnose

  1. Authentifizierung bestätigen:

    • Überprüfen Sie, ob die Token abgelaufen sind. Erneuern Sie die Token bei Bedarf.
    • Überprüfen Sie die Anmeldeinformation in der Web-App Configuration.

  2. Prüfen des Tools/der MCP-Configuration:

    • Überprüfen Sie, ob die MCP-Server konfiguriert sind.
    • Prüfen, dass Berechtigungen gewährt sind.

  3. Lokal testen:

    • Führen Sie den Agent lokal mit derselben Konfiguration aus.
    • Testen Sie mit Agents Playground.
    • Es funktioniert lokal, aber nicht in der Cloud > Bereitstellung

Gängige Lösungen

  • Messaging-Endpunkt falsch: Aktualisieren Sie im Azure-Portal und im Entwicklerportal.
  • Web-App gestoppt: Starten Sie sie über das Azure-Portal oder die CLI.
  • Token abgelaufen: Aktualisieren Sie die Token in den Umgebungsvariablen der Web-App.
  • Fehlende Umgebungsvariablen: Überprüfen Sie die App-Einstellungen im Azure-Portal.
  • MCP-Serverprobleme: Überprüfen Sie Dienstprinzipal und Berechtigungen.
  • Codefehler: Überprüfen Sie die Anwendungsprotokolle auf Ausnahmen.

Überprüfung

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

Vielleicht möchten Sie auch Folgendes ausprobieren:

Tool-Aufrufe fehlschlagen

Symptom: Der Agent antwortet auf Nachrichten, aber Tool-Anrufe schlagen fehl. Sie sehen Berechtigungsverweigerungen oder Timeout-Fehler.

Ursache: Fehlende MCP-Server-Berechtigungen, Dienstprinzipal nicht konfiguriert, Netzwerkverbindungsprobleme oder falsche Tool-Konfiguration.

Lösungen

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

  • Überprüfen Sie die Berechtigungen im Admin Center

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

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

  • Dienstprinzipal prüfen

    Führen Sie das einmalige Einrichtungsskript aus, falls Sie es vorher nicht ausgeführt haben:

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

  • MCP-Endpunkt-Konfiguration überprüfen

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

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

  • Verwaltete Identität prüfen

    Ü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>

Überprüfung

Testen Sie Toolaufrufe über Teams und überprüfen Sie die Protokolle auf eine erfolgreiche Ausführung.

Folgende Schritte können ebenfalls ausprobiert werden:

Lizenzzuweisung fehlgeschlagen

Symptom: Sie können einem Agent-Nutzer keine Lizenz zuweisen. Im Admin Center werden Lizenzfehler angezeigt.

Ursache: Nicht genügend verfügbare Lizenzen, falscher Lizenztyp oder Berechtigungsproblem.

Lösungen

Gehen Sie wie folgt vor, wenn die Lizenzzuweisung fehlschlägt:

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

    • Prüfen Sie im Microsoft 365 Admin Center >Fakturierung>Lizenzen.
    • Stellen Sie sicher, dass Microsoft Agent 365 Frontier für den Mandant aktiviert ist.

  2. Lizenz manuell zuweisen:

    • Navigieren Sie zum Microsoft 365 Admin Center >Benutzer.
    • Agentbenutzer suchen.
    • 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).

Überprüfung

Überprüfen Sie, ob das Benutzerprofil im Admin Center zugewiesene Lizenzen anzeigt.

  • Last updated on