Agentens meddelelsesslutpunkt

Agentens meddelelsesslutpunkt er det slutpunkt, hvor du sender agent-notifikationsbeskeder til din agent.

Slet agentens meddelelsesslutpunkt

Brug kommandoen a365 cleanup blueprint --endpoint-only til at slette registreringen af agentens meddelelsesslutpunkt. Denne kommando påvirker ikke din agentkode eller det udrullede slutpunkt. Den fjerner kun registreringsposten via Teams Graph (MCP Platform).

a365 cleanup blueprint --endpoint-only

Konfigurer meddelelsesslutpunkt i a365.config.json

Før du konfigurerer meddelelsesslutpunktet, skal du angive det i din a365.config.json-konfigurationsfil. Denne fil indeholder den centrale konfiguration for udrulning af agenten.

Tilføj eller opdater disse konfigurationsegenskaber for meddelelsesslutpunktet:

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

  • messagingEndpoint: Angiv den præcise URL-adresse til slutpunktet, hvor du kan sende beskeder til agenten.

  • deploymentProjectPath: Sti til din agentprojektmappe. Denne egenskab er ikke relevant, hvis agenten allerede er udrullet, og du ikke behøver at opdatere miljøkonfigurationen. Angiv kun deploymentProjectPath til ., hvis agentkoden ikke er placeret på din maskine.

Konfigurationsegenskaber

Egenskab Beskrivelse Obligatorisk Standard Eksempel
messagingEndpoint URL-adressen, hvor din agent modtager beskeder Ja Ingen https://your-app.azurewebsites.net/api/messages
deploymentProjectPath Sti til din agents projektmappe for konfigurationsopdateringer Nej . ./my-agent eller .

Indstillinger for slutpunktskonfiguration

Værdien messagingEndpoint afhænger af dit udrulningsscenarie:

For Azure-udrulninger:

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

For ikke-Azure-udrulninger:

  • AWS: https://your-api-gateway-url.amazonaws.com/api/messages
  • GCP: https://your-cloud-run-url.run.app/api/messages
  • Andre cloud-udbydere: Din brugerdefinerede slutpunkts URL-adresse

For lokal test med Dev Tunnels:

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

Vigtigt

deploymentProjectPath angiver, hvor CLI'en søger efter projektfiler, og hvor den opdaterer miljøkonfigurationen, såsom .env-filer.

Bemærk

Når du bruger Dev Tunnels til lokal test, skal du opdatere messagingEndpoint i a365.config.json med URL-adressen til din Dev Tunnel, inden du kører kommandoen til opsætning. For flere oplysninger, se testning med Dev Tunnels.

Indstil agent-meddelelsespunkt

Når du har opdateret din a365.config.json-fil, skal du bruge denne kommando til at registrere meddelelsesslutpunktet, så Agent 365-tjenesten kan sende meddelelser til din agent. Handlingen --endpoint-only registrerer slutpunktet via Teams Graph (MCP Platform).

a365 setup blueprint --endpoint-only

Du kan også angive URL-adressen direkte med --messaging-endpoint, i stedet for at redigere a365.config.json:

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

Ved lokal testning kan du indstille dette slutpunkt til et Dev Tunnel-slutpunkt, før du udruller agenten til skyen. For flere oplysninger, se testning med Dev Tunnels.

For at opdatere en eksisterende slutpunkts-URL-adresse:

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

Udrulning af slutpunkt

Hvis du ikke allerede har din agent installeret i skyen, så lær hvordan du udruller agenten til Azure.

Hvis du allerede har din agent udrullet i skyen, kan du konfigurere meddelelsesslutpunktet som tidligere beskrevet.

Få mere at vide om, hvordan du sætter meddelelsesslutpunktet på nogle andre populære clouds:

  • Last updated on