Freigeben über

Agent-Messaging-Endpunkt

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.

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-onlyBefehl, um den Eintrag des Endpunkts der Agent-Nachrichten zu löschen. Dieser Befehl beeinflusst weder deinen Agentencode noch den bereitgestellten Endpunkt. Es löscht nur den Registrierungseintrag dieses Endpunkts für deinen Agenten.

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",
  "needDeployment": false,
  "deploymentProjectPath": "."
}

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

  • needDeployment: Geben Sie der CLI an, ob der Code in einer Azure Web-App bereitgestellt werden soll.

  • deploymentProjectPath: Bereite deinen Agentencode in der Cloud bereit. Diese Eigenschaft ist nicht relevant, wenn dein Agent bereits eingesetzt ist und du ihn nicht erneut einsetzen musst. Setze deploymentProjectPath nur dann . ein, wenn der Agentencode nicht auf deinem Rechner vorhanden ist.

Konfigurationseigenschaften

Eigentum Description Erforderlich Standard Example
messagingEndpoint Die URL, auf der dein Agent Nachrichten empfängt Yes Nichts https://your-app.azurewebsites.net/api/messages
needDeployment Ob die CLI nach Azure (true) bereitgestellt werden soll oder ob Sie eine eigene Bereitstellung (false) durchführen Nein true false für AWS/GCP/Dev Tunnels
deploymentProjectPath Pfad zu deinem Agent-Projektverzeichnis für Bereitstellungs- und Konfigurationsupdates Nein . ./my-agent oder .

Endpunktkonfigurationsoptionen

Der Wert messagingEndpoint hängt von deinem Einsatzszenario ab:

For Azure deployments (needDeployment: true):

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

For non-Azure deployments (needDeployment: false):

  • 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 Entwicklungstunneln (needDeployment: false):

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

Von Bedeutung

  • Wenn Sie die Bereitstellung für Azure ausführen, legen Sie needDeployment auf true fest. Die CLI übernimmt die Bereitstellung automatisch.
  • Für AWS, GCP oder Dev Tunnels setze needDeployment auf false, um anzugeben, dass du die Bereitstellung separat verwaltest.
  • Der deploymentProjectPath legt fest, wo die CLI nach Projektdateien sucht und wo die Umgebungskonfiguration aktualisiert wird, wie .env-Dateien.

Hinweis

Wenn du Dev Tunnels für lokale Tests verwendest, aktualisiere das messagingEndpoint in a365.config.json mit deiner Dev-Tunnel-URL und setze needDeployment auf false vor dem Ausführen des Setup-Befehls. Weitere Informationen finden Sie unter Testing mit Dev Tunnels.

Agenten-Messaging-Endpunkt festlegen

Nachdem Sie Ihre a365.config.json Datei aktualisiert haben, verwenden Sie diesen Befehl, um den Messaging-Endpunkt beim Agent 365-Service zu registrieren, damit er Benachrichtigungen an Ihren Agenten senden kann.

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.

a365 setup blueprint --endpoint-only

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