Agentin viestinnän päätepiste

Agentin viestinnän päätepiste on päätepiste, johon agentin ilmoitusviestit lähetetään.

Agentin viestinnän päätepisteen poistaminen

Käytä a365 cleanup blueprint --endpoint-only -komentoa agentin viestinnän päätepisteen rekisteröinnin tyhjentämiseksi. Tämä komento ei vaikuta agentin koodiin eikä käyttöönotettuun päätepisteeseen. Se poistaa vain rekisteröintimerkinnän Teams Graphin (MCP-ympäristö) kautta.

a365 cleanup blueprint --endpoint-only

Agentin viestinnän päätepisteen määrittäminen a365.config.json-tiedostossa

Määritä viestinnän päätepiste a365.config.json-määritystiedostossa ennen sen asetusten määrittämistä. Tämä tiedosto sisältää agentin käyttöönoton perusmäärityksen.

Lisää tai päivitä seuraavat viestinnän päätepisteen määrityksen ominaisuudet:

{
  "messagingEndpoint": "https://your-endpoint-url.com/api/messages",
  "deploymentProjectPath": "."
}
  • messagingEndpoint: Määritä tarkka päätepisteen URL-osoite, johon agentille voi lähettää viestejä.

  • deploymentProjectPath: Agentin projektihakemiston polku. Tämä ominaisuus ei ole tarpeellinen, jos agentti on jo otettu käyttöön eikä ympäristön asetuksia tarvitse päivittää. Määritä kohteen deploymentProjectPath arvoksi . vain, jos agentin koodi ei sijaitse koneella.

Määrityksen ominaisuudet

Ominaisuus Kuvaus Pakollinen Oletus Esimerkki
messagingEndpoint URL-osoite, johon agentti vastaanottaa viestejä Kyllä Ei mikään https://your-app.azurewebsites.net/api/messages
deploymentProjectPath Agentin projektihakemiston polku määrityksen päivityksiä varten Ei . ./my-agent tai .

Päätepisteen määrityksen valinnat

Arvo messagingEndpoint riippuu käyttöönoton skenaariosta seuraavasti:

Azure-käyttöönotot:

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

Muut kuin Azure-käyttöönotot:

  • AWS: https://your-api-gateway-url.amazonaws.com/api/messages
  • GCP: https://your-cloud-run-url.run.app/api/messages
  • Muut pilvipalveluntarjoajat: Mukautetun päätepisteen URL-osoite

Paikallinen testaus Dev Tunnelsin avulla:

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

Tärkeää

deploymentProjectPath määrittää, mistä CLI hakee projektitiedostot ja minne se päivittää ympäristön määrityksen, kuten .env-tiedostot.

Muistiinpano

Kun käytät Dev Tunnelia paikalliseen testaukseen, päivitä messagingEndpointa365.config.json-tiedostossa Dev Tunnelin URL-osoitteella ennen asetuskomennon suorittamista. Lisätietoja on kohdassa Testaaminen Dev Tunnelsin avulla.

Agentin viestinnän päätepisteen määrittäminen

Kun olet päivittänyt a365.config.json-tiedoston, käytä tätä komentoa agentin viestinnän päätepisteen rekisteröimisessä, jotta Agent 365 -palvelu voi lähettää ilmoituksia agentille. --endpoint-only-toiminto rekisteröi päätepisteen Teams Graphin (MCP-ympäristö) kautta.

a365 setup blueprint --endpoint-only

Voit myös antaa URL-osoitteen suoraan kohteelle --messaging-endpointa365.config.json-tiedoston muokkaamisen sijaan seuraavasti:

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

Paikallisessa testauksessa tämän päätepiste voi määrittään Dev Tunnel -päätepisteeksi ennen agentin käyttöönottoa pilvessä. Lisätietoja on kohdassa Testaaminen Dev Tunnelsin avulla.

Voit päivittää nykyisen päätepisteen URL-osoitteen seuraavasti:

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

Päätepisteen käyttöönotto

Jos agenttia ei ole vielä otettu käyttöön pilvessä, katso lisätietoja agentin käyttöönotosta Azuressa.

Jos agentti on jo käytössä pilvessä, voit määrittää viestinnän päätepisteen aiemmin esitetyllä tavalla.

Seuraavassa on tietoja siitä, miten viestinnän päätepiste määritetään muissa suosituissa pilvipalveluissa: