Agentmeldingsendepunkt

Agentmeldingsendepunktet er endepunktet hvor du sender varslingsmeldinger til agenten din.

Slett agentmeldingsendepunkt

Bruk a365 cleanup blueprint --endpoint-only-kommandoen for å fjerne registreringen av agentens meldingsendepunkt. Denne kommandoen påvirker ikke agentkoden din eller det deployerte endepunktet. Den fjerner kun registreringsoppføringen via Teams Graph (MCP Platform).

a365 cleanup blueprint --endpoint-only

Konfigurer meldingsendepunkt i a365.config.json

Før du konfigurerer meldingsendepunktet, spesifiser det i din a365.config.json-konfigurasjonsfil. Denne filen inneholder den grunnleggende konfigurasjonen for agentdistribusjonen.

Legg til eller oppdater disse konfigurasjonsinnstillingene for meldingsendepunkt:

{
  "messagingEndpoint": "https://your-endpoint-url.com/api/messages",
  "deploymentProjectPath": "."
}
  • messagingEndpoint: Angi den eksakte endepunktnettadresse der du kan sende meldinger til agenten.

  • deploymentProjectPath: Sti til agentprosjektkatalogen. Denne egenskapen er ikke relevant dersom agenten allerede er distribuert og du ikke trenger å oppdatere miljøkonfigurasjonen. Sett deploymentProjectPath til . bare hvis agentkoden ikke er lokalisert på maskinen din.

Konfigurasjonsegenskaper

Egenskap Beskrivelse Obligatorisk Standard Eksempel
messagingEndpoint Nettadresse hvor agenten din mottar meldinger Ja Ingen https://your-app.azurewebsites.net/api/messages
deploymentProjectPath Sti til agentens prosjektkatalog for konfigurasjonsoppdateringer Nei . ./my-agent eller .

Endepunkt-konfigurasjonsalternativer

Verdien messagingEndpoint avhenger av distribusjonsscenarioet:

For Azure-distribusjoner:

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

For distribusjoner utenfor Azure:

  • AWS: https://your-api-gateway-url.amazonaws.com/api/messages
  • GCP: https://your-cloud-run-url.run.app/api/messages
  • Andre skyleverandører: Din egendefinerte endepunktsnettadresse

For lokal testing med Dev Tunnels:

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

Viktig!

deploymentProjectPath angir hvor CLI-en leter etter prosjektfiler og hvor den oppdaterer miljøkonfigurasjonen, for eksempel .env-filer.

Notat

Når du bruker Dev Tunnels for lokal testing, oppdater messagingEndpoint i a365.config.json med din Dev Tunnel-nettadresse før du kjører oppsettkommandoen. For mer informasjon, se testing med Dev Tunnels.

Konfigurer agentens meldingsendepunkt

Etter at du har oppdatert a365.config.json-filen, bruker du denne kommandoen for å registrere meldingsendepunktet slik at Agent 365-tjenesten kan sende meldinger til agenten din. --endpoint-only-operasjonen registrerer endepunktet via Teams Graph (MCP Platform).

a365 setup blueprint --endpoint-only

Du kan også angi nettadressen direkte med --messaging-endpoint, i stedet for å redigere a365.config.json:

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

Under lokal testing kan du konfigurere dette endepunktet som et Dev Tunnel-endepunkt før du utrullerer agenten til skyen. For mer informasjon, se testing med Dev Tunnels.

For å oppdatere en eksisterende endepunkt-nettadresse:

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

Utrulling av endepunkt

Hvis du ikke allerede har distribuert agenten din til skyen, lær hvordan du distribuerer agenten til Azure.

Hvis du allerede har agenten din distribuert til skyen, kan du konfigurere meldingsendepunktet som vist tidligere.

Lær hvordan du konfigurerer meldingsendepunktet på noen andre populære skytjenester: