Agent-Messaging-Endpunkt

Der Agent-Messaging-Endpunkt ist der Endpunkt, an den Sie agentische Benachrichtigungsnachrichten an Ihren Agent senden.

Agent-Messaging-Endpunkt löschen

Verwenden Sie den a365 cleanup blueprint --endpoint-only-Befehl, um die Registrierung des Agent-Messaging-Endpunkts zu löschen. Dieser Befehl wirkt sich nicht auf Ihren Agentcode oder den bereitgestellten Endpunkt aus. Es wird lediglich der Registrierungseintrag über Teams Graph (MCP Platform) entfernt.

a365 cleanup blueprint --endpoint-only

Konfigurieren Sie den Messaging-Endpunkt in a365.config.json

Bevor Sie den Messaging-Endpunkt festlegen, geben Sie ihn in Ihrer a365.config.json-Konfigurationsdatei an. Diese Datei enthält die grundlegende Konfiguration für die Bereitstellung Ihres Agent.

Fügen Sie die folgenden Messaging-Endpunkt-Konfigurationseigenschaften hinzu oder aktualisieren Sie sie:

{
  "messagingEndpoint": "https://your-endpoint-url.com/api/messages",
  "deploymentProjectPath": "."
}

  • messagingEndpoint: Geben Sie die exakte Endpunkt-URL an, an die Sie Nachrichten an den Agent senden können.

  • deploymentProjectPathPfad zu Ihrem Agent-Projektverzeichnis. Diese Eigenschaft ist nicht relevant, wenn der Agent bereits bereitgestellt ist und die Umgebungskonfiguration nicht aktualisiert werden muss. Legen Sie deploymentProjectPath nur dann auf . fest, wenn der Agent-Code nicht auf Ihrem Computer vorhanden ist.

Konfigurationseigenschaften

Eigenschaften Beschreibung Erforderlich Standard Beispiel
messagingEndpoint Die URL, unter der Ihr Agent Nachrichten empfängt Ja Kein Wert https://your-app.azurewebsites.net/api/messages
deploymentProjectPath Pfad zum Agent-Projektverzeichnis für Konfigurationsaktualisierungen Nein . ./my-agent oder .

Optionen der Endpunkt-Konfiguration

Der Wert messagingEndpoint hängt von Ihrem Bereitstellungsszenario ab:

Azure -Bereitstellungen:

  • Azure Web App: https://your-app-name.azurewebsites.net/api/messages

Für Nicht-Azure-Bereitstellungen:

  • AWS: https://your-api-gateway-url.amazonaws.com/api/messages
  • GCP: https://your-cloud-run-url.run.app/api/messages
  • Andere Cloud-Anbieter: Ihre benutzerdefinierte Endpunkt-URL

Für lokale Tests mit Dev Tunnels:

  • Dev Tunnel URL: https://abc123xyz.devtunnels.ms:3978/api/messages

Wichtig

Die deploymentProjectPath legt fest, wo die CLI nach Projektdateien sucht und wo sie die Umgebungskonfiguration aktualisiert, beispielsweise .env-Dateien.

Anmerkung

Wenn Sie Entwicklertunnel für lokale Tests verwenden, aktualisieren Sie messagingEndpoint in a365.config.json mit Ihrer Entwicklertunnel-URL, bevor Sie den Einrichtungsbefehl ausführen. Weitere Informationen finden Sie unter Testen mit Dev Tunnels.

Agent-Messaging-Endpunkt festlegen

Nachdem Sie die a365.config.json-Datei aktualisiert haben, verwenden Sie diesen Befehl, um den Messaging-Endpunkt zu registrieren, damit der Agent 365-Service Ihrem Agent Benachrichtigungen senden kann. Der --endpoint-only-Befehl registriert den Endpunkt über Teams Graph (MCP Platform).

a365 setup blueprint --endpoint-only

Alternativ können Sie die URL auch direkt mit --messaging-endpoint übergeben, anstatt a365.config.json zu bearbeiten:

a365 setup blueprint --endpoint-only `
  --messaging-endpoint https://your-app.azurewebsites.net/api/messages

Während des lokalen Testens kannst du diesen Endpunkt auf einen Dev-Tunnel-Endpunkt konfigurieren, bevor Sie den Agent in der Cloud bereitstellen. Weitere Informationen finden Sie unter Testen mit Dev Tunnels.

Um eine bestehende Endpunkt-URL zu aktualisieren:

a365 setup blueprint --update-endpoint https://your-new-host.example.com/api/messages

Endpunkt-Bereitstellung

Falls Sie Ihren Agent noch nicht in der Cloud ausgerollt haben, lernen Sie, wie man den Agent auf Azure bereitstellt.

Wenn Sie Ihren Agent bereits in der Cloud installiert haben, können Sie den Messaging-Endpunkt wie zuvor gezeigt einstellen.

Erfahren Sie, wie Sie den Messaging-Endpunkt auf einigen anderen beliebten Cloud-Plattformen konfigurieren:

  • Last updated on