Agenten mit dem Microsoft Agent 365 SDK testen

Testen Sie Ihren Agent vor der Bereitstellung lokal mithilfe des Agents-Playgrounds. Dieser Leitfaden behandelt die Einrichtung Ihrer Entwicklungsumgebung, die Konfiguration der Authentifizierung und die Validierung der Funktionalität Ihres Agenten mit dem Testtool Agents Playground.

Nachdem Ihr Agent lokal funktioniert, folgen Sie dem Agent 365 Development Lifecycle , um in Microsoft 365-Anwendungen wie Teams, Word und Outlook zu testen.

Voraussetzungen

Bevor Sie mit dem Testen Ihres Agents beginnen, überprüfen Sie, ob Sie die folgenden Voraussetzungen installiert haben:

Allgemeine Voraussetzungen

• Code-Editor: Ein beliebiger Code-Editor Ihrer Wahl. Visual Studio Code wird empfohlen.
• Agents Playground: Installiere Agents Playground mit einer der folgenden Methoden:
  • Fenster: winget install agentsplayground
  • Npm: npm install -g @microsoft/m365agentsplayground
• A365 CLI: Erforderlich für die Agent-Bereitstellung und -verwaltung. Installiere die Agent 365 CLI.
• LLM-API-Zugriff: Wählen Sie den geeigneten Dienst basierend auf der Konfiguration Ihres Agents oder Ihrem bevorzugten Modellanbieter aus:
  • OpenAI API Key: Holen Sie sich Ihren OpenAI API-Schlüssel.
  • Azure OpenAI: Erstellen und Bereitstellen einer Azure-OpenAI-Ressource, um Ihren API-Schlüssel und Endpunkt zu erhalten.
• Entwicklerportal-Konfiguration: Nach der Veröffentlichung deines Agenten musst du den Agent-Blueprint im Developer Portal konfigurieren, bevor du Instanzen erstellst. Lernen Sie, wie Sie den Agenten-Blueprint im Developer Portal konfigurieren

Sprachspezifische Voraussetzungen

Konfigurieren der Agent-Testumgebung

Dieser Abschnitt beschreibt, wie Sie Umgebungsvariablen setzen, Ihre Entwicklungsumgebung authentifizieren und Ihren Agent 365-betriebenen Agenten für Tests vorbereiten.

Richten Sie Ihre Agenttestumgebung ein, indem Sie diesem sequenziellen Workflow folgen:

1. Konfigurieren Sie Ihre Umgebung – Erstellen oder aktualisieren Sie Ihre Umgebungskonfigurationsdatei.

2. LLM-Konfiguration – API-Schlüssel abrufen und OpenAI- oder Azure OpenAI-Einstellungen konfigurieren.

3. Authentifizierung konfigurieren – Agentische Authentifizierung einrichten.

4. Referenz zu Umgebungsvariablen – Konfigurieren erforderlicher Umgebungsvariablen:

   1. Authentifizierungsvariablen
   2. MCP-Endpunkt-Konfiguration
   3. Observierbarkeitsvariablen
   4. Agent-Anwendungsserverkonfiguration

Nachdem Sie diese Schritte ausgeführt haben, können Sie mit dem Testen Ihres Agents im Agents-Playground beginnen.

Schritt 1: Konfigurieren Ihrer Umgebung

Einrichten Ihrer Konfigurationsdatei:

cp .env.template .env

cp .env.template .env

Schritt 2: LLM-Konfiguration

Konfigurieren Sie OpenAI- oder Azure OpenAI-Einstellungen für lokale Tests. Füge deine API-Schlüssel und Service-Endpunkte aus den Voraussetzungen zusammen mit allen Modellparametern zu deiner Konfigurationsdatei hinzu.

# Replace with your actual OpenAI API key
OPENAI_API_KEY=

# Azure OpenAI Configuration
AZURE_OPENAI_API_KEY=
AZURE_OPENAI_ENDPOINT=
AZURE_OPENAI_DEPLOYMENT=
AZURE_OPENAI_API_VERSION=

# Replace with your actual OpenAI API key
OPENAI_API_KEY=

# Azure OpenAI Configuration
AZURE_OPENAI_API_KEY=
AZURE_OPENAI_ENDPOINT=
AZURE_OPENAI_DEPLOYMENT=
AZURE_OPENAI_API_VERSION=

{
  "AIServices": {
    "AzureOpenAI": {
      "DeploymentName": "", // Deployment (as opposed to model) name of the Azure OpenAI model
      "Endpoint": "", // Endpoint of the Azure OpenAI model deployment
      "ApiKey": "" // API Key of the Azure OpenAI model deployment
    },
    "OpenAI": {
      "ModelId": "", // Model ID of the OpenAI model
      "ApiKey": "" // API Key of the OpenAI model
    },
    "UseAzureOpenAI": true // Flag to use Azure OpenAI vs OpenAI
  }
}

Schritt 3: Konfigurieren Sie die Authentifizierung für Ihren Agenten

Wählen Sie eine der folgenden Authentifizierungsmethoden für Ihren Agenten:

• Agentische Authentifizierung – Verwendung für Produktionsszenarien, wenn eine agentische Benutzeridentität verfügbar ist.
• OBO-Authentifizierung – Verwendung für Produktionsszenarien, wenn delegierte Benutzerberechtigungen ohne agentische Benutzeridentität benötigt werden.
• Trägertoken-Authentifizierung – Nur für frühe Entwicklungs- und Testszenarien vor der Konfiguration der Produktionsauthentifizierung verwendet.

Agentische Authentifizierung

Verwenden Sie den Agent 365 CLI-Befehl a365 config display , um Ihre Agenten-Blueprint-Zugangsdaten abzurufen.

a365 config display -g

Mit diesem Befehl wird die Konfiguration des Agent-Blueprints angezeigt. Kopieren Sie die folgenden Werte:

Verwenden Sie diese Werte, um die agentische Authentifizierung in Ihrem Agent zu konfigurieren:

USE_AGENTIC_AUTH=true
CONNECTIONS__SERVICE_CONNECTION__SETTINGS__CLIENTID=<agentBlueprintId>
CONNECTIONS__SERVICE_CONNECTION__SETTINGS__CLIENTSECRET=<agentBlueprintClientSecret>
CONNECTIONS__SERVICE_CONNECTION__SETTINGS__TENANTID=<your-tenant-id>

USE_AGENTIC_AUTH=true
connections__service_connection__settings__clientId=<agentBlueprintId>
connections__service_connection__settings__clientSecret=<agentBlueprintClientSecret>
connections__service_connection__settings__tenantId=<your-tenant-id>

{
  "AgentBluePrint": {
    "Settings": {
      "ClientId": "<agentBlueprintId>",
      "ClientSecret": "<agentBlueprintClientSecret>",
      "TenantId": "<your-tenant-id>"
    }
  }
}

OBO-Authentifizierung

Mithilfe der On-Behalf-Of-Authentifizierung (OBO) kann Ihr Agent mithilfe delegierter Benutzerberechtigungen auf MCP-Servertools zugreifen, ohne dass eine agentische Benutzeridentität erforderlich ist. In diesem Flow erhält der Agent das vom Benutzer delegierte Token und tauscht es aus, um Aktionen im Namen des Benutzers auszuführen.

OBO-Authentifizierung eignet sich für Produktionsszenarien, in:

• Dein Agent hat keine agentische Benutzeridentität.
• Du musst auf Ressourcen mit benutzerspezifischen Berechtigungen zugreifen.
• Sie möchten, dass der Agent im Namen des authentifizierten Nutzers handelt.

Details zur Funktionsweise des OBO-Flows finden Sie unter Authentication Flows. Ein vollständiges Implementierungsbeispiel finden Sie im Microsoft 365 Agents SDK im OBO-Autorisierungsbeispiel.

Bearertokenauthentifizierung

Für frühe Entwicklungs- und Testszenarien, in denen die Produktionsauthentifizierung nicht konfiguriert ist, verwenden Sie die Trägertoken-Authentifizierung, um Ihren Agenten zu testen. Diese Methode verwendet interaktive Browser-Authentifizierung, um einen delegierten Zugriffstoken zu erhalten. Mit diesem Token kann Ihr Agent die MCP-Server-Tools aufrufen, indem Sie Ihre Benutzerberechtigungen verwenden. Dieser Ansatz simuliert, wie ein Agent-Nutzer in der Produktion auf Ressourcen zugreift, ohne eine tatsächliche Agenteninstanz zu benötigen.

Zuerst verwenden Sie a365 develop add-permissions , um die erforderlichen MCP-Serverberechtigungen zu Ihrer Anwendung hinzuzufügen.

a365 develop add-permissions

Verwenden Sie dann a365 develop get-token, um Bearer-Tokens abzurufen und zu konfigurieren.

a365 develop get-token

Der Befehl get-token wird automatisch ausgeführt:

• Ruft Bearertoken für alle MCP-Server ab, die in Ihrer ToolingManifest.json Datei konfiguriert sind.
• Aktualisiert die Projektkonfigurationsdateien mit der BEARER_TOKEN Umgebungsvariable.

Richten Sie vor dem Ausführen get-tokendie Projektkonfigurationsdatei ein, damit der Befehl weiß, wo das Token gespeichert werden soll:

• .NET: Fügen Sie "BEARER_TOKEN": "" zu environmentVariables in jedem Profil in Properties/launchSettings.json hinzu. Der Befehl aktualisiert nur Profile, die diesen Schlüssel bereits definiert haben.
• Python/Node.js: Erstellen Sie vor dem Ausführen eine .envDatei mit BEARER_TOKEN=. Wenn die Datei fehlt, überspringt der Befehl das Speichern und zeigt Anleitungen an.

Schritt 4: Referenz zu Umgebungsvariablen

Schließen Sie die Einrichtung Ihrer Umgebung ab, indem Sie die folgenden erforderlichen Umgebungsvariablen konfigurieren.

• Authentifizierungsvariablen – Erforderliche Einstellungen für die agentische Authentifizierung
• MCP-Endpunktkonfiguration – Angeben des Agent 365-Plattformendpunkts
• Beobachtbarkeitsvariablen – Aktivieren von Protokollierung und verteilter Ablaufverfolgung
• Konfiguration des Agent-Anwendungsservers – Konfigurieren des Ports, an dem Ihr Agent-Server ausgeführt wird

Authentifizierungsvariablen

Konfigurieren Sie die erforderlichen Authentifizierungseinstellungen für die agentische Authentifizierung, damit sie ordnungsgemäß funktioniert.

# Agentic Authentication Settings
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__TYPE=AgenticUserAuthorization
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__SCOPES=https://graph.microsoft.com/.default
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__ALTERNATEBLUEPRINTCONNECTIONNAME=service_connection

# Connection Mapping
CONNECTIONSMAP_0_SERVICEURL=*
CONNECTIONSMAP_0_CONNECTION=SERVICE_CONNECTION

# Agentic Authentication Options
agentic_type=agentic
agentic_altBlueprintConnectionName=service_connection
agentic_scopes=ea9ffc3e-8a23-4a7d-836d-234d7c7565c1/.default

# Set service connection as default
connectionsMap__0__serviceUrl=*
connectionsMap__0__connection=service_connection

{
  "AgentApplication": {
    "StartTypingTimer": false,
    "RemoveRecipientMention": false,
    "NormalizeMentions": false,
    "UserAuthorization": {
      "AutoSignin": false,
      "Handlers": {
        "agentic": {
          "Type": "AgenticUserAuthorization",
          "Settings": {
            "Scopes": [
              "https://graph.microsoft.com/.default"
            ]
          }
        }
      }
    }
  },
  "ConnectionsMap": [
    {
      "ServiceUrl": "*",
      "Connection": "ServiceConnection"
    }
  ]
}

MCP-Endpunkt-Konfiguration

Gib den Endpunkt der Agent 365-Plattform an, mit dem dein Agent verbunden ist. Wenn Sie das Tooling-Manifest erstellen, das die Tooling-Server für Ihren Agenten definiert, geben Sie den MCP-Plattform-Endpunkt an. Dieser Endpunkt bestimmt, mit welcher Umgebung (Vorab-, Test- oder Produktionsumgebung) die MCP-Toolserver für Microsoft 365 Integrationsfunktionen verbunden sind.

# MCP Server Configuration
MCP_PLATFORM_ENDPOINT=<MCP endpoint>

# MCP Server Configuration
MCP_PLATFORM_ENDPOINT=<MCP endpoint>

{
  "profiles": {
    "Sample Agent": {
      "commandName": "Project",
      "launchBrowser": true,
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development",
        "MCP_PLATFORM_ENDPOINT": "<MCP endpoint>"
      },
      "applicationUrl": "https://localhost:64896;http://localhost:64897"
    }
  }
}

Beobachtbarkeitsvariablen

Konfigurieren Sie diese erforderlichen Variablen, um die Protokollierung und verteilte Ablaufverfolgung für Ihren Agent zu aktivieren. Erfahren Sie mehr über Observabilitätsmerkmale und Best Practices.

Agent-Anwendungsserverkonfiguration

Konfigurieren Sie den Port, an dem Ihr Agent-Anwendungsserver ausgeführt wird. Diese Einstellung ist optional und gilt für Python- und JavaScript-Agents.

# Server Configuration
PORT=3978

# Server Configuration
PORT=3978

Installieren von Abhängigkeiten und Starten des Agent-Anwendungsservers

Nachdem Sie Ihre Umgebung konfiguriert haben, installieren Sie die erforderlichen Abhängigkeiten und starten Sie Ihren Agent-Anwendungsserver lokal zum Testen.

Abhängigkeiten installieren

uv pip install -e .

python <main.py>

uv run python <main.py>

npm install

npm run dev

dotnet restore

dotnet build

dotnet run --launch-profile "Sample Agent with MCP Platform"

Ihr Agentserver wird jetzt ausgeführt und kann Anfragen von Agents Playground oder Microsoft 365 Anwendungen empfangen.

Agent im 'Agents Playground' testen

Agents Playground ist ein lokales Testtool, das die Microsoft 365-Umgebung simuliert, ohne dass eine vollständige Tenanteinrichtung erforderlich ist. Es ist die schnellste Möglichkeit, die Logik und die Toolaufrufe Ihres Agents zu überprüfen. Weitere Informationen finden Sie unter Testen mit Agents Playground.

Agents Playground für agentische Authentifizierung konfigurieren

Wenn Sie die agentische Authentifizierung verwenden, konfigurieren Sie die YaML-Datei "Agents Playground" mit den Details Ihres Agents:

1. Richte die Konfigurationsdatei ein: Erstelle oder aktualisiere die .m365agentsplayground.yml Datei im Ordner, in dem du Agents Playground ausführst. Detaillierte Einrichtungsanweisungen finden Sie unter Kontextanpassung von Teams.

2. Aktualisieren Sie die Bot-Konfiguration: Fügen Sie die folgenden Bot-Details Ihrer .m365agentsplayground.yml Datei hinzu und ersetzen die Platzhalterwerte durch Ihre tatsächlichen Agenten-Zugangsdaten:

   bot:
     id: <your-agent-email>@<your-tenant>.onmicrosoft.com
     name: <Your Agent Name>
     role: agenticUser
     agenticUserId: <your-agentic-user-id>
     agenticAppId: <your-agentic-app-id>
   

   Eigentum	Beschreibung	Erforderlich
   id	Die E-Mail-Adresse Ihres Agentennutzers im Format agentusername@tenant.onmicrosoft.com	Ja
   name	Anzeigename für Ihren Agenten-Nutzer	Ja
   role	Muss für agentische Authentifizierung auf agenticUser gesetzt werden	Ja
   agenticUserId	Die Objekt-ID des Agent-Nutzers. Suchen Sie diesen Wert im Microsoft Entra Admin Center auf der Profilseite des Agentbenutzers.	Ja
   agenticAppId	Die Agent-ID des Agent-Benutzers. Suchen Sie diesen Wert im Microsoft Entra Admin Center auf der Profilseite des Agentbenutzers.	Ja

Öffnen Sie ein neues Terminal (PowerShell auf Windows), und starten Sie Agents Playground:

agentsplayground

Dieser Befehl öffnet einen Webbrowser mit der Agents Playground-Oberfläche. Das Tool zeigt eine Chatschnittstelle an, über die Sie Nachrichten an Ihren Agent senden können.

Grundlegender Test

Überprüfen Sie zunächst, ob Ihr Agent ordnungsgemäß konfiguriert ist. Senden Sie dem Agent eine Nachricht:

What can you do?

Der Agent antwortet mit den Anweisungen, mit denen er konfiguriert ist, basierend auf dem Systemprompt und den Fähigkeiten Ihres Agenten. Diese Antwort bestätigt, dass:

• Ihr Agent funktioniert einwandfrei.
• Der Agent kann Nachrichten verarbeiten und antworten.
• Die Kommunikation zwischen Agents Playground und Ihrem Agenten funktioniert.

Test-Tool-Aufrufe

Nachdem Sie Ihre MCP-Toolserver konfiguriert toolingManifest.json haben (siehe Tooling für Einrichtungsanweisungen), testen Sie Werkzeugaufrufe anhand von Beispielen wie diesen Beispielen:

Überprüfen Sie zunächst, welche Tools verfügbar sind:

List all tools I have access to

Dann testet man spezifische Werkzeug-Aufrufe:

E-Mail-Tools

Send email to your-email@example.com with subject "Test" and message "Hello from my agent"

Erwartete Antwort: Der Agent sendet eine E-Mail über den Mail MCP-Server und bestätigt, dass die Nachricht gesendet wurde.

Kalender-Tools

List my calendar events for today

Erwartete Antwort: Der Agent ruft Ihre Kalenderereignisse für den aktuellen Tag ab und zeigt sie an.

SharePoint-Tools

List all SharePoint sites I have access to

Erwartete Antwort: Der Agent fragt SharePoint ab und gibt eine Liste der Websites zurück, auf die Sie Zugriff haben.

Sie können die Toolaufrufe anzeigen in:

• Das Chatfenster – sehen Sie sich die Antwort des Agents und alle Toolanrufe an.
• Im Protokollbereich finden Sie detaillierte Aktivitätsinformationen, einschließlich Toolparametern und Antworten.

Testen mit Benachrichtigungsaktivitäten

Während der lokalen Entwicklung werden Benachrichtigungsszenarien mit den eingebauten Benachrichtigungsauslösern im Agents Playground getestet.

Bevor Sie Benachrichtigungsaktivitäten testen, stellen Sie sicher, dass Sie:

• Konfigurieren Sie die erforderlichen MCP-Tool-Server in Ihrem toolingManifest.json. Erfahren Sie mehr über Werkzeuge.
• Aktivieren Sie Benachrichtigungen für Ihren Agenten. Erfahren Sie, wie Sie Benachrichtigungen einrichten.
• Konfigurieren Sie die .m365agentsplayground.yml Datei mit den agentischen Authentifizierungsdetails Ihres Agenten, wie in Configure Agents Playground for agentic authentication beschrieben.

Test-E-Mail-Benachrichtigungen

Um die Behandlung von E-Mail-Benachrichtigungen zu testen:

1. Starten Sie Ihren Agenten und den Agents Playground.
2. Im Agents Playground gehe zu eine Aktivität simulieren>Aktivität Benachrichtigung auslösen.
3. Wählen Sie E-Mail senden aus.
4. Im Nutzlast-Dialog werden die Mock-E-Mail-Details wie Absendername und Inhalt der E-Mail nach Bedarf aktualisiert.
5. Wählen Sie Aktivität senden aus.
6. Sehen Sie sich das Ergebnis sowohl im Chat-Gespräch als auch im Log-Panel an.

Der Agent erhält eine simulierte E-Mail-Benachrichtigung und verarbeitet sie gemäß Ihrer Benachrichtigungshandhabungslogik. Details zur E-Mail-Benachrichtigungsnutzlaststruktur finden Sie unter E-Mail-Benachrichtigungsnutzlast.

Test von Erwähnungsbenachrichtigungen in Word

So testen Sie Word-Benachrichtigungen von Dokumenterwähnungen:

1. Starten Sie Ihren Agenten und den Agents Playground.
2. Im Agents Playground gehe zu eine Aktivität simulieren>Aktivität Benachrichtigung auslösen.
3. Wählen Sie Mention in Word aus.
4. Aktualisieren Sie im Nutzlastdialogfeld die simulierten Kommentardetails, z. B. die Dokument-ID und den Kommentartext nach Bedarf.
5. Wählen Sie Aktivität senden aus.
6. Sehen Sie sich das Ergebnis sowohl im Chat-Gespräch als auch im Log-Panel an.

Der Agent empfängt eine simulierte Word-Erwähnungsbenachrichtigung und reagiert entsprechend Ihrer Benachrichtigungsbehandlungslogik. Ausführliche Informationen zur Nutzlaststruktur der Word-Kommentar-Benachrichtigung finden Sie unter Dokument-Kommentar-Benachrichtigungsnutzlast.

Test-Agent-Installations- und Deinstallationsereignisse

Wenn Agents Playground eine Verbindung mit Ihrem Agent herstellt, sendet er automatisch eine InstallationUpdate Aktivität mit Aktion add. Wenn Sie einen Installationshandler implementieren, wird die Willkommensnachricht des Agents unmittelbar nach dem Herstellen der Verbindung im Chat angezeigt.

So überprüfen Sie die Ereignisbehandlung für die Installation:

1. Starten Sie Ihren Agent-Server.
2. Öffnen Sie den Agents Playground. Der Playground stellt eine Verbindung mit Ihrem Agent und löst das Installationsereignis automatisch aus.
3. Bestätigen Sie, dass die Willkommensnachricht in der Chatunterhaltung angezeigt wird.

Ausführliche Informationen zum Implementieren des Handlers finden Sie unter Behandeln von Installations- und Deinstallationsereignissen des Agents.

Anzeigen von Observability-Logs

Um Observability-Protokolle während der lokalen Entwicklung anzuzeigen, instrumentieren Sie Ihren Agenten mit Observability-Code (siehe Observability für Codebeispiele) und konfigurieren Sie die Umgebungsvariablen, wie in Observability-Variablen beschrieben. Nach der Konfiguration erscheinen in der Konsole Echtzeit-Traces, die anzeigen:

• Agent-Aufrufablaufverfolgungen
• Tool-Ausführungsdetails
• LLM-Vorhersageaufrufe
• Ein- und Ausgabenachrichten
• Verwendung von Token
• Reaktionszeiten
• Fehlerinformationen

Diese Protokolle helfen Ihnen, Probleme zu debuggen, das Verhalten der Agenten zu verstehen und die Leistung zu optimieren.

Nächste Schritte,

Nachdem Sie Ihren Agent lokal getestet haben, stellen Sie ihn in Azure bereit, und veröffentlichen Sie ihn in Microsoft 365.

Informationen zum Testen Ihres Agents in Microsoft 365-Anwendungen wie Microsoft Teams, Word und Outlook finden Sie im Agent 365 Development Lifecycle.

Problembehandlung

Dieser Abschnitt bietet Lösungen für häufige Probleme, auf die Sie beim lokalen Testen Ihres Maklers stoßen könnten.

Verbindungs- und Umweltprobleme

Diese Probleme beziehen sich auf Netzwerkkonnektivität, Portkonflikte und Umgebungseinrichtungsprobleme, die verhindern, dass Ihr Agent ordnungsgemäß kommuniziert.

Agents Playground-Verbindungsprobleme

Symptom: Agents Playground kann sich nicht mit deinem Agenten verbinden.

Lösungen:

• Überprüfen Sie, ob Ihr Agent-Server läuft.
• Überprüfe, ob die Portnummern zwischen deinem Agenten und dem Agents Playground übereinstimmen.
• Stellen Sie sicher, dass keine Firewall-Regeln lokale Verbindungen blockieren.
• Versuche, sowohl den Agenten- als auch den Agents Playground neu zu starten.

Veraltete Agents Playground-Version

Symptom: Unerwartete Fehler oder fehlende Funktionen im Agents Playground.

Lösung: Agents Playground deinstallieren und neu installieren.

winget uninstall agentsplayground
winget install agentsplayground

Portkonflikte

Symptom: Fehler, der darauf hinweist, dass der Port bereits benutzt wird.

Lösung:

• Stoppen Sie alle weiteren Fälle Ihres Agenten.
• Ändere den Port in deiner Konfiguration.
• Beenden Sie alle Prozesse, die den Port verwenden.

# Windows PowerShell
Get-Process -Id (Get-NetTCPConnection -LocalPort <port>).OwningProcess | Stop-Process

DeveloperMCPServer kann nicht hinzugefügt werden

Symptom: Fehler beim Hinzufügen von DeveloperMCPServer in Visual Studio Code.

Lösung: Schließen Sie Visual Studio Code, und öffnen Sie sie erneut, und versuchen Sie dann erneut, den Server hinzuzufügen.

Authentifizierung und Tokenprobleme

Diese Probleme treten auf, wenn Ihr Agent sich nicht ordnungsgemäß mit Microsoft 365 Diensten authentifizieren kann oder wenn Anmeldeinformationen ablaufen oder falsch konfiguriert sind.

Symptome:

• 401 Nicht autorisierte Fehler
• Nachrichten "Inhabertoken abgelaufen"
• Agentische Authentifizierungsfehler

Grundursache:

• Token laufen nach etwa einer Stunde ab.
• Falsche Authentifizierungskonfiguration
• Fehlende oder ungültige Anmeldeinformationen

Lösungen :

• Für den Ablauf des Inhabertokens

  Aktualisieren Sie Ihr Token und aktualisieren Sie Ihre Umgebungsvariablen.

  # Get a new token
  a365 develop get-token
  
  # Update your .env file with the new token
  

• Für agentische Authentifizierungsfehler (Python)

  Überprüfen Sie Ihre .env Datei:

  # Should be (with underscore):
  AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__ALT_BLUEPRINT_NAME=SERVICE_CONNECTION
  
  # Not:
  AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__ALT_BLUEPRINT_NAME=ServiceConnection
  

• Für fehlende Zugangsdaten

  Bestätigen Sie vor der Prüfung, dass die erforderlichen Zugangsdaten vorhanden sind.

  Stellen Sie sicher, dass .env oder appsettings.json enthält:

  • API-Schlüssel und Geheimnisse
  • Mieter-ID
  • Kunden-ID
  • Blueprint-ID (bei Verwendung von agentischer Authentifizierung)

  Überprüfung:

  Testen Sie mit einer einfachen Anfrage in Agents Playground. Du solltest eine Antwort ohne 401-Fehler erhalten.

• Werkzeug- und Benachrichtigungsprobleme

  Diese Probleme betreffen Probleme mit Tool-Aufrufen, MCP-Serverinteraktionen und Benachrichtigungszustellung.

E-Mail nicht erhalten

Symptom: Agent gibt an, dass E-Mails gesendet wurden, aber Sie erhalten sie nicht

Lösungen:

• Überprüfe deinen Junk- oder Spam-Ordner.
• Die Zustellung von E-Mails kann sich um einige Minuten verzögern. Warte bis zu fünf Minuten.
• Überprüfen Sie die korrekte E-Mail-Adresse des Empfängers.
• Überprüfen Sie die Agentenprotokolle auf Fehler beim Versand von E-Mails.

Word Kommentarantworten funktionieren nicht

Bekanntes Problem: Der Benachrichtigungsdienst kann derzeit nicht direkt auf Word-Kommentare antworten. Diese Funktionalität befindet sich in der Entwicklung.

Nachrichten erreichen den Agenten nicht

Symptom: Ihre Agentenanwendung erhält keine Nachrichten, die an den Agenten in Teams gesendet werden.

Mögliche Ursachen

• Das Developer Portal ist nicht mit dem Agenten-Blueprint konfiguriert.
• Azure Web App-Probleme (Bereitstellungsfehler, Nicht ausgeführte App, Konfigurationsfehler).
• Die Agenteninstanz wird in Teams nicht richtig erstellt.

Lösungen:

• Verifizieren Sie die Konfiguration des Entwicklerportals:

  Stelle sicher, dass du die Agenten-Blueprint-Konfiguration im Developer Portal abschließt. Lernen Sie, wie Sie den Agenten-Blueprint im Developer Portal konfigurieren.

• Azure Web App-Zustand überprüfen:

  Wenn Sie Ihren Agent für Azure bereitstellen, überprüfen Sie, ob die Web App ordnungsgemäß ausgeführt wird:

  1. Wechseln Sie zu Azure Portal.
  2. Geh zu deiner Web-App-Ressource.
  3. Überprüfen Sie Übersicht>Status (sollte "Laufend" anzeigen).
  4. Überprüfen Sie den Logstrom unter Monitoring auf Laufzeitfehler.
  5. Überprüfen Sie die Protokolle des Deployment Centers, um sicherzustellen, dass die Bereitstellung erfolgreich war.
  6. Überprüfen Sie die Konfiguration>:Die Anwendungseinstellungen enthalten alle erforderlichen Umweltvariablen.

• Überprüfen Sie die Erstellung von Agenten-Instanzen:

  Stellen Sie sicher, dass Sie die Agentinstanz ordnungsgemäß in Microsoft Teams erstellen:

  1. Öffnen Sie Microsoft Teams.
  2. Gehe zu Apps und suche nach deinem Agenten.
  3. Überprüfen Sie, ob der Agent in den Suchergebnissen erscheint.
  4. Wenn sie nicht gefunden wurde, überprüfen Sie, ob sie im Microsoft 365 Admin Center – Agents veröffentlicht wurde.
  5. Erstellen Sie eine neue Instanz, indem Sie auf Add bei Ihrem Agenten auswählen.
  6. Für detaillierte Anweisungen siehe Onboard-Agenten.