Slutpunkt för agentmeddelanden

Slutpunkten för agentmeddelanden är den där du skickar agentiska aviseringsmeddelanden till din agent.

Ta bort slutpunkt för agentmeddelanden

Använd a365 cleanup blueprint --endpoint-only-kommandot för att rensa registreringen av agentens meddelandeslutpunkt. Detta kommando påverkar inte din agentkod eller den distribuerade slutpunkten. Den tar bara bort registreringsposten via Teams Graph (MCP Platform).

a365 cleanup blueprint --endpoint-only

Konfigurera meddelandeslutpunkt i a365.config.json

Innan du konfigurerar meddelandeslutpunkt, specificera den i din a365.config.json konfigurationsfil. Denna fil innehåller den grundläggande konfigurationen för din agentutplacering.

Lägg till eller uppdatera dessa konfigurationsegenskaper för meddelandeterminaler:

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

  • messagingEndpoint: Ange den exakta URL:en till slutpunkten där du kan skicka meddelanden till agenten.

  • deploymentProjectPath: Sökvägen till din agentprojektkatalog. Den här egenskapen är inte relevant om din agent redan är utplacerad och du inte behöver uppdatera miljökonfigurationen. Sätt deploymentProjectPath till . endast om agentkoden inte finns på din dator.

Konfigurationsegenskaper

Egenskap Beskrivning Obligatoriskt Standardvärde Exempel
messagingEndpoint URL där agenten tar emot meddelanden Ja Inget https://your-app.azurewebsites.net/api/messages
deploymentProjectPath Sökväg till agentprojektkatalogen för konfigurationsuppdateringar Nej . ./my-agent eller .

Alternativ med slutpunktskonfiguration

Värdet messagingEndpoint beror på ditt distributionsscenario:

För Azure-distributioner:

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

För icke-Azure-distributioner:

  • AWS: https://your-api-gateway-url.amazonaws.com/api/messages
  • GCP: https://your-cloud-run-url.run.app/api/messages
  • Andra molnleverantörer: Din anpassade slutpunkts-URL

För lokal testning med utvecklingstunnlar:

  • URL för utvecklingstunnel: https://abc123xyz.devtunnels.ms:3978/api/messages

Viktigt

deploymentProjectPath specificerar var CLI:n söker projektfiler och var den uppdaterar miljökonfigurationen, såsom .env-filer.

Kommentar

När du använder utvecklingstunnlar för lokal testning, uppdatera messagingEndpoint i a365.config.json med din URL för utvecklingstunnlar innan du kör setup-kommandot. För mer information, se testning med utvecklingstunnlar.

Ange slutpunkt för agentmeddelanden

Efter att du har uppdaterat din a365.config.json-fil, använd detta kommando för att registrera meddelandeterminalen så att Agent 365-tjänsten kan skicka aviseringar till din agent. Operationen --endpoint-only registrerar slutpunkten via Teams Graph (MCP-plattform).

a365 setup blueprint --endpoint-only

Du kan också ange URL:en direkt med --messaging-endpoint, istället för att redigera a365.config.json:

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

Under lokal testning kan du konfigurera denna slutpunkt som en Dev Tunnel-slutpunkt innan du distribuerar agenten till molnet. För mer information, se testning med utvecklingstunnlar.

För att uppdatera en befintlig slutpunkts-URL:

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

Distribution av slutpunkt

Om du ännu inte har distribuerat din agent till molnet, lär dig hur du distribuerar agenten till Azure.

Om du redan har din agent distribuerad i molnet kan du konfigurera meddelandeändpunkten enligt tidigare instruktioner.

Lär dig hur du konfigurerar meddelandeändpunkten på några andra populära molnplattformar:

  • Last updated on