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",
  "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. Legen Sie deploymentProjectPath nur dann auf . fest, wenn der Agent-Code nicht auf Ihrem 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
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

Von Bedeutung

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

Hinweis

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

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