Agent-berichten-eindpunt

Het agent-berichten-eindpunt is het eindpunt waar u agentische meldingsberichten naar uw agent stuurt.

Verwijder agent-berichten-eindpunt

Gebruik de a365 cleanup blueprint --endpoint-only opdracht om de registratie van het agent-berichten-eindpunt te wissen. Deze opdracht beïnvloedt uw agentcode of het geïmplementeerde eindpunt niet. Het verwijdert alleen de registratievermelding via Teams Graph (MCP Platform).

a365 cleanup blueprint --endpoint-only

Configureer berichten-eindpunt in a365.config.json

Specificeer dit voordat u het berichten-eindpunt instelt in uw a365.config.json configuratiebestand. Dit bestand bevat de kernconfiguratie voor uw agentimplementatie.

Voeg deze configuratie-eigenschappen van het berichten-eindpunt toe of werk deze bij:

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

  • messagingEndpoint: specificeer de exacte eindpunt-URL waar u berichten naar de agent kunt sturen.

  • deploymentProjectPath: pad naar de projectmap van uw agent. Deze eigenschap is niet relevant als uw agent al is uitgerold en u de omgevingsconfiguratie niet hoeft te updaten. Stel deploymentProjectPath alleen in op . als de agentcode niet op uw apparaat staat.

Configuratie-eigenschappen

Eigenschap Beschrijving Vereist Standaard Voorbeeld
messagingEndpoint De URL waar uw agent berichten ontvangt Ja Nee https://your-app.azurewebsites.net/api/messages
deploymentProjectPath Pad naar uw agentprojectmap voor configuratie-updates Nee . ./my-agent of .

Eindpuntconfiguratie-opties

De messagingEndpoint waarde hangt af van uw implementatiescenario:

Voor Azure-implementaties:

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

Voor niet-Azure-implementaties:

  • AWS: https://your-api-gateway-url.amazonaws.com/api/messages
  • GCP: https://your-cloud-run-url.run.app/api/messages
  • Andere cloudproviders: uw aangepaste eindpunt-URL

Voor lokaal testen met dev-tunnels:

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

Belangrijk

De deploymentProjectPath specificeert waar de CLI zoekt naar projectbestanden en waar de omgevingsconfiguratie wordt bijgewerkt, zoals .env bestanden.

Notitie

Als u dev-tunnels gebruikt voor lokaal testen, werk dan de messagingEndpoint ingang a365.config.json bij met uw dev-tunnels-URL voordat u de setup-opdracht uitvoert. Voor meer informatie, zie testen met dev-tunnels.

Agent-berichten-eindpunt instellen

Na het updaten van uw a365.config.json bestand gebruikt u deze opdracht om het berichten-eindpunt te registreren, zodat de Agent 365-service meldingen naar uw agent kan sturen. De --endpoint-only bewerking registreert het eindpunt via Teams Graph (MCP Platform).

a365 setup blueprint --endpoint-only

U kunt de URL ook direct doorgeven met --messaging-endpoint, in plaats van a365.config.json te bewerken:

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

Tijdens lokaal testen kunt u dit eindpunt instellen op een dev-tunnels-eindpunt voordat u de agent naar de cloud uitrolt. Voor meer informatie, zie testen met dev-tunnels.

Om een bestaande eindpunt-URL bij te werken:

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

Implementatie van eindpunt

Als u uw agent nog niet in de cloud hebt geïmplementeerd, ontdek dan hoe u de agent naar Azure kunt implementeren.

Als u uw agent al in de cloud hebt geïmplementeerd, kunt u het berichten-eindpunt instellen zoals eerder getoond.

Ontdek hoe u het berichten-eindpunt instelt op andere populaire clouds:

  • Last updated on