Agent-Messaging-Endpunkt

Der Agent-Messaging-Endpunkt ist der Endpunkt, an den Sie agentische Benachrichtigungsnachrichten an Ihren Agenten 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 beeinflusst weder deinen Agentencode noch den bereitgestellten Endpunkt. Er entfernt nur den Registrierungseintrag.

Übergeben Sie für M365-Agents (Teams, Copilot) --m365, um den Endpunkt über Microsoft Teams Graph zu löschen:

# M365 agents — clears via Teams Graph (MCP Platform)
a365 cleanup blueprint --endpoint-only --m365

# Non-M365 agents — prints the Teams Developer Portal URL for manual configuration
a365 cleanup blueprint --endpoint-only

Messaging-Endpunkt in a365.config.json konfigurieren

Bevor Sie den Messaging-Endpunkt festlegen, geben Sie ihn in Ihrer a365.config.json Konfigurationsdatei an. Diese Datei enthält die Kernkonfiguration für deine Agenten-Deployment.

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

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

  • messagingEndpoint: Gib die genaue Endpunkt-URL an, an die du Nachrichten an den Agenten senden kannst.

  • deploymentProjectPath: Pfad zum Agent-Projektverzeichnis. Diese Eigenschaft ist nicht relevant, wenn Ihr Agent bereits bereitgestellt wurde und Sie die Umgebungskonfiguration nicht aktualisieren müssen. Setze deploymentProjectPath nur dann . ein, wenn der Agentencode nicht auf deinem Rechner vorhanden ist.

Konfigurationseigenschaften

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

Endpunktkonfigurationsoptionen

Der Wert messagingEndpoint hängt von deinem Einsatzszenario ab:

Für 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 individuelle Endpunkt-URL

Für lokale Tests mit Dev Tunnels:

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

Wichtig

Der deploymentProjectPath legt fest, wo die CLI nach Projektdateien sucht und wo die Umgebungskonfiguration aktualisiert wird, wie .env-Dateien.

Notiz

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

Agenten-Messaging-Endpunkt festlegen

Verwenden Sie nach dem Aktualisieren der a365.config.json Datei diesen Befehl, um den Messaging-Endpunkt zu registrieren, damit der Agent 365-Dienst Benachrichtigungen an Ihren Agent senden kann.

Für M365-Agents (Teams, Copilot) übergeben Sie --m365, um sich über Microsoft Teams Graph zu registrieren:

# M365 agents — registers via Teams Graph (MCP Platform)
a365 setup blueprint --endpoint-only --m365

# Non-M365 agents — prints the Teams Developer Portal URL for manual configuration
a365 setup blueprint --endpoint-only

Während des lokalen Tests kannst du diesen Endpunkt vor der Bereitstellung des Agenten in der Cloud auf einen Dev-Tunnel-Endpunkt setzen. Weitere Informationen finden Sie unter Testing mit Dev Tunnels.

So aktualisieren Sie eine vorhandene Endpunkt-URL:

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

Bereitstellung des Endpunkts

Wenn Ihr Agent noch nicht in der Cloud bereitgestellt wurde, learn, wie Agent für Azure bereitgestellt wird.

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

Erfahren Sie, wie Sie den Messaging-Endpunkt in einigen anderen beliebten Clouds einstellen:

  • Last updated on