Tapahtumakäynnistimen yleiskatsaus

Voit määrittää mukautetut agentit suorittamaan toimintoja tai kutsumaan aiheita vastauksena tapahtumiin tapahtumakäynnistimien avulla. Toisin kuin aihekäynnistimet, jotka edellyttävät käyttäjän syötettä, tapahtumakäynnistimien avulla agentti voi toimia itsenäisesti vastauksena määritettyyn tapahtumaan.

Tapahtumakäynnistimien toiminta

Tapahtumalaukaisijat vaativat valitun tapahtuman, joka tuottaa laukaisukuorman ja lähettää sen agentille liittimen kautta. Tietosisältö sisältää tietoja tapahtumasta, mukaan lukien tietyntyyppisten tietojen muuttujat. Kun agentti vastaanottaa tietosisällön, se suorittaa agentin tekijän agentin ohjeissa ja käynnistimen tietosisällön kautta lähetetyissä ohjeissa annetut ohjeet.

Agentit toimivat vain tekijänsä suunnittelun ja ohjeiden perusteella. Voit esimerkiksi lisätä käynnistimen, kun uusi ryhmän jäsen lisätään, ja määrittää vastaukseksi toiminnon lähetä uudelle työntekijälle perehdytysmateriaaleja sisältävä tervetuloviesti.

Tapahtumakäynnistimet aktivoidaan agentin ulkopuolisten tapahtumien perusteella. Ne eroavat aihekäynnistimistä, joita käytetään aktivoimaan aiheita tai toimintoja käyttäjien kirjoittamien käynnistinlauseiden perusteella.

Tässä artikkelissa kerrotaan, miten tapahtumakäynnistimet toimivat, niiden rajoitukset ja vianmääritysstrategiat. Lisätietoja tapahtumakäynnistimen lisäämisestä, katso Lisää tapahtumakäynnistin.

Muita tapahtumakäynnistimiä ovat esimerkiksi seuraavat:

• Kun kohde luodaan SharePoint
• Kun tiedosto luodaan OneDrive
• Kun tehtävä on suoritettu Plannerissa
• Määritetty aika kulunut (Toistuvuus-käynnistin)

Tapahtumakäynnistimien laskutus ja käyttö

Tapahtumakäynnistimen aktiivisuus lasketaan mukaan käytön ja laskutuksen kulutusyksiköihin. Viesti määritellään miksi tahansa agentille lähetetyksi pyynnöksi tai viestiksi, joka käynnistää toiminnon tai vastauksen agentilta. Tähän lasketaan myös agenteille tapahtumakäynnistimistä lähetetyt tiedot. Esimerkiksi toistuva käynnistin, joka on määritetty aktivoitumaan 10 minuutin välein, lähettää käynnistintiedot viestinä agentille 10 minuutin välein.

Lisätietoja on kohdassa Laskutushinnat ja -hallinta.

Käynnistintyönkulku

Käynnistin on yksi osa työnkulkua, joka sisältää useita osia:

1. Tapahtumakäynnistin rekisteröi, että tietty tapahtuma on tapahtunut.
2. Käynnistin lähettää tietosisällön, joka sisältää tietoja tapahtumasta ja ohjeet.
3. Agentilla on ohjeet yhden tai useamman toiminnon tai aiheen valitsemiseen tietosisällön perusteella.

Etsi tapahtumaasi sopiva käynnistin

Copilot Studiossa on käynnistimien kirjasto microsoftissa ja kumppanipalveluissa tapahtuville erilaisille tapahtumille. Käynnistimen määritys määrittää käynnistimen käynnistävän tapahtuman parametrit. Se määrittää myös käynnistimen tietosisällön.

Useimmissa käynnistimissä voit määrittää parametrit tapahtumalle, joka aktivoi käynnistimen. Esimerkiksi Dataversen Kun rivi lisätään, muokataan tai poistetaan - käynnistimessä valitaan, minkä taulukon muutokset aktivoivat käynnistimen.

Käynnistimen tietosisällön määrittäminen

Käynnistimen tietosisältö on JSON-merkkijono tai pelkkää tekstiä sisältävä viesti, joka sisältää tietoja tapahtumasta ja lähetetään agentille viestinä. Kun lisäät käynnistimen, voit säilyttää käynnistimen oletustietosisällön tai lisätä omia ohjeita. Myöhemmin voit muokata hyötykuorman sisältöä, sisältäen muuttujien ja merkkijono-operaattorien lisääminen Power Automatessa.

Esimerkiksi Kun rivi lisätään, muokataan tai poistetaan -käynnistimen oletussanoma on Käytä sisältöä kohteesta Body. Kun agentti vastaanottaa tietosisällön, siinä on rivin sisältö ja ohjeet sisällön käyttöön.

Voit lisätä tietosisällön sisällä lähetettävät ohjeet, jotka ohjaavat agenttia siinä, miten toimia, kun käynnistin aktivoi agentin. Jos käynnistimiä on useita, kullakin käynnistintietosisällöllä voi olla tarkat ja yksityiskohtaiset ohjeet. Näin voit välttää kirjoittamasta pitkiä ja monimutkaisia ohjeita agentin yleisiin ohjeisiin tai sekoittamasta agenttia sen suhteen, mitkä ohjeet koskevat mitäkin käynnistintä.

Esimerkiksi Kun rivi lisätään, muokataan tai poistetaan -käynnistimen tietosisältöön voit lisätä Lähetä yhteenveto keskustelun muutoksista. Kun agentti vastaanottaa tietosisällön, se tekee yhteenvedon käyttäjän muutoksista agenttikeskustelussa.

Älä kuitenkaan kirjoita tietosisältöohjeita, jotka ovat ristiriidassa agentin yleisten ohjeiden kanssa. Ohjeiden ristiriidat voivat aiheuttaa virheen tai odottamattomia tuloksia. Muista testata kaikki muutokset, jotka liittyvät tapahtumakäynnistimiin.

Kun olet luonut käynnistimen, voit lisää tai muuttaa muuttujia tai merkkijono-operaattoreita käynnistimen hyötykuormassa ja muokata olemassa olevia tietojen latausohjeita käyttämällä Power Automate.

Agentin ohjeet vs. tietosisällön ohjeet

Tietosisällön ohjeet ovat ominaisia sille, miten reagoida yhteen tapahtumaan. Myös agentin ohjeiden avulla voit myös ohjata agenttia siinä, miten käynnistimen tietoja käsitellään ja miten toimia, kun se vastaanottaa käynnistimen tietosisällön, sekä määrittämään agentin yleisen käyttäytymisen. Esimerkiksi agentin, joka tarkistaa tilien nimien kaksoiskappaleet uusilla Dataverse-taulukon riveillä, ohjeet voisivat olla: Kun uusi rivi lisätään, tarkista, onko kyseessä päällekkäinen tili. Jos kaksoiskappaleita on, luo To-Do-tehtävä asian tutkimiseksi ja sisällytä tiedot muutoksista ja kaksoiskappaleista.

Agentin ohjeet eivät kuitenkaan välttämättä toimi parhaiten kaikissa tilanteissa. Jos agentilla on useita käynnistimiä tai useita monimutkaisia tavoitteita, käytä sen sijaan käynnistimen tietosisällössä olevia ohjeita.

Jatkamalla viimeistä esimerkkiä voit lisätä käynnistimen tietosisältöön ohjeen Etsi päällekkäisiä tilien nimiä samasta Dataverse-taulukosta. Kun agentti vastaanottaa tietosisällön, sitä kehotetaan etsimään tilien nimien kaksoiskappaleita. Agentin yleiset käskyt sanovat sitten, että Jos kaksoiskappaleita on, luo To-Do-tehtävä asian tutkimiseksi ja sisällytä tiedot muutoksista ja kaksoiskappaleista.

Ohjeiden luominen agenteille vaatii harjoittelua. Siirry kohtaan ohjeiden kirjoittamisen opas saadaksesi lisää vinkkejä ja testaa aina kaikki tekemäsi muutokset agenttiin.

Toiminnon tai aiheen kutsuminen

Kun agentti vastaanottaa käynnistimen tietosisällön, sille antamasi ohjeet määrittävät käytettävissä olevien tietojen perusteella, mitä toimintoa tai aihetta se kutsuu vastauksena.

Agentti ei luo uutta toimintoa tai aihetta lennossa. Agentin tekijänä sinun on määriteltävä toiminnot tai aiheet, joista se voi valita. Lisätietoja siitä, miten agentti määrittää, mitä toimintoa tai aihetta kutsutaan, on kohdassa Miten generatiivinen orkestrointi toimii?

Jos agentti ei reagoi odotetulla tavalla, voit aktiviteettikartasta tarkistaa, puuttuuko siitä tärkeitä syötetietoja.

Voit tehdä ohjeisiin esimerkiksi seuraavia parannuksia:

• Tarkempien ohjeiden lisääminen käynnistimen tietosisältöön tai agentin ohjeisiin. Agentti saattaa tarvita enemmän ohjausta, kuten mitä tietoja tietyssä syötekentässä käytetään toimintoa varten.
• Ohjeiden sisällyttäminen käynnistimen tietosisältöön.
• Agentin ohjeistaminen kutsumaan tiettyä toimintoa tai aihetta.
• Käynnistimen tietosisällön ja agentin ohjeiden ristiriitaisten ohjeiden tarkistaminen.
• Toimintojen kuvausten lisääminen, jotta agentilla on enemmän tietoa sen määrittämiseksi, milloin kutsua toimintoja.
• Kuvausten lisääminen toiminnon syötekenttiin, jotta agentti täyttää parametrit oikein. Jos toiminnon syötteet ovat joka kerta samat, voit määrittää arvon itse.
• Alle 15 toiminnon tai aiheen kutsuminen peräkkäin. Monimutkaisilla agenteilla, jotka suorittavat useita toimintoja tai aiheita yhtenä sarjana, voi olla vaikeuksia suorittaa niitä luotettavasti.

Jos agenttisi yrittää edelleen kutsua odotettua toimintoa, harkitse Power Automate työnkulun lisäämistä joka täyttää tavoitteesi agenttisi toimintona.

Tapahtumakäynnistimiä käyttävien agenttien julkaiseminen

Ennen kuin julkaiset agentin, jossa on uusi tapahtumakäynnistin, agentti ei reagoi automaattisesti kyseiseen käynnistimeen. Varmista, että testaat agentin perusteellisesti ennen julkaisua, koska kun olet julkaissut agentin uudella käynnistimellä, agentti reagoi automaattisesti aina, kun sen käynnistimet aktivoituvat. Näet agenttisi käynnistimien ja reaktioiden vaiheittaisen tietueen Toiminta-sivulta .

Lisätietoja käynnistimien aktivoinnista testauksen aikana on kohdassa Käynnistimen testaaminen.

Tapahtumakäynnistimet voivat käyttää käynnistimessä vain agentin tekijän tunnistetietoja (eli tunnistetietoja, joita käytit yhteyksien valtuuttamiseen). Tämä saattaa antaa agentin käyttäjille mahdollisuuden käyttää agenttia tietojen ja järjestelmien käyttämiseen samalla valtuutuksella. Lisätietoja on kohdassa Vianmääritys ja rajoitukset.

Toimintojen todentaminen julkaisemisen jälkeen

Jos agentilta puuttuu todennus toiminnon suorittamiseksi tai se on määritetty pyytämään käyttäjän todennusta, se lähettää käyttäjälle viestin, jossa pyydetään tunnistetietoja. Jos agentin työnkulku keskeytyy, koska se ei voi vastaanottaa tietoja tai toiminto epäonnistui, istuntoa ei voi jatkaa. Jos agentin halutaan toimivan itsenäisesti, kuhunkin toimintoon on määritettävä toimiva tekijän todennus, joka ei edellytä käyttäjän toimia. Voit myös ohjeistaa agentin olemaan pyytämättä tunnistetietoja käyttäjiltä.

Koska käynnistimet käyttävät tekijän todennusta, on tiedettävä, mitä tietoja mahdolliset käyttäjät voivat käyttää käynnistimiä sisältävällä julkaistulla agentilla. Katso Käynnistimien tietosuoja -osasta lisätietoja.

Toiminta ja tietolähteiden käyttö

Copilot Studioon rakennetut agentit voivat muodostaa yhteyden Teamsiin kanavien kautta. Kun käytät tätä yhteyttä, Teamsissa ilmenee tilanteita, joissa käytetystä laukaisijasta ja agentin käyttämistä työkaluista riippuen jotkut muuttujat voivat olla Activity.Text tyhjiä. Tämä tyhjyys johtuu siitä, että jotkut työkalut ovat suunniteltuja toimintoja. Activity.Text on muuttuja, jolla voit kirjata agenttisi toimintaa. Kuitenkin Activity.Text aiempia viestejä ei aina ole. Tässä tilanteessa sinun tulisi käyttää LastMessage.Text muuttujaa sen sijaan.

Kun agentti kutsuu tiedonlähdettä riittämättömien kontekstivihjeiden vuoksi, kyseisen vuoron muuttuja Activity.Text jää tyhjäksi. Tämä tyhjä arvo syntyy, koska agentti ei rakenna luonnollisen kielen vastausta, kun päätös delegoidaan tietolähteelle. Jos odotat muuttujan Activity.Text olevan käyttäjän edellinen viesti kuten yleensä, sinun kannattaa käyttää LastMessage.Text muuttujaa sen sijaan. Muuttuja Activity.Text havaitsee kaiken agentille annetun toiminnan.

Vuorovaikutus liipaisimen OnPlanComplete kanssa

Liipaisin OnPlanComplete on suunniteltu suoritettavaksi vasta, kun työkalu on suorittanut toimintansa. Kun tietolähdettä käytetään, tietolähde kirjoitetaan suoraan toimintaan. Koska muuttuja Activity.Text oli alun perin tyhjä, aktiivisuus täyttyy työkalun käyttötiedoilla eikä keskusteluviestillä.

Tämä käyttäytyminen eroaa tilanteista, joissa muut laukaisijat, kuten intentioon perustuvat tai luonnollisen kielen laukaisijat, aktivoituvat aikaisemmin. Näissä tapauksissa aktiviteetti sisältää tyypillisesti jo rakennetun viestin, joten työkalun tulos ei korvaa tai määrittele muuttujaa Activity.Text .

Teamsin ja Copilot Studion toiminnan erot

Teams ei abstraktoi tai normalisoi aktiivisuusobjekteja samalla tavalla kuin Copilot Studio tekee. Tulos:

• Copilot Studiossa järjestelmätoimintoja voidaan muuntaa tai käsitellä tavalla, joka piilottaa nämä pohjana olevat tiedot.
• Teamsissa aktiviteettiobjektit esitetään suoremmin, mikä tekee tästä eroavaisuudesta näkyvämmän.

Tämä ero johtaa erilaisiin havaittaviin käyttäytymismalleihin, vaikka taustalla oleva agenttilogiikka olisi identtinen.

Vianmääritys ja rajoitukset

Kiintiörajoitukset

Jos käynnistimet aktivoituvat liian usein, agentti saattaa käyttää odotettua enemmän resursseja. Agentti saattaa tällöin ylittää palvelun kuormituksen kiintiön rajat ja palvelua voidaan rajoittaa.

Järjestelmänvalvojat voivat valvoa resurssien käyttöä Power Platformin kautta. Ne voivat myös estää tapahtumakäynnistimien käytön ympäristössä.

Voit välttää kiintiörajojen ylittämisen seuraavasti:

• Ole varovainen, kun lisäät hyvin usein suoritettavia käynnistimiä tai käynnistimiä, jotka toistuvat loputtomiin. Esimerkiksi toistumisen käynnistin aktivoituu aina, kun tietty aika kuluu. Mitä vähemmän aktivointien välillä on aikaa, sitä enemmän resursseja käynnistin käyttää.
• Seuraa, kuinka moni käynnistin on aktiivinen ympäristössä.

Käynnistimiä sisältävien agenttien tietosuoja

Tällä hetkellä tapahtumakäynnistimet voivat käyttää todennukseen vain agentin tekijän tunnistetietoja. Lisäksi, jotta agentti voi toimia itsenäisesti, kaikissa todennusta vaativissa käynnistimissä ja toiminnoissa on käytettävä tekijän tunnistetietoja.

Jos julkaiset asiakaspalvelijan, jossa on todennetut tapahtumakäynnistimet, käyttäjät voivat ehkä käyttää tietoja tai pyytää asiakaspalvelijaa suorittamaan toimintoja tekijän tunnistetiedoilla. Jos tekijät konfiguroivat agentin autendikoidulla tapahtumalaukaisimella, heitä muistutetaan tästä rajoituksesta ennen agentin julkaisemista.

Käynnistimen tietosisällöt voivat mahdollisesti sisältää luottamuksellisia tietoja, joita agentti voi tulostaa muissa sijainneissa toimintojen avulla. Olet esimerkiksi luonut agentin, joka käyttää saapuvien sähköpostiviestien tietoja Dataverse-taulukoiden uusien rivien täyttämiseen.

Järjestelmänvalvojat voivat estää Copilot Studio -käyttäjiä käyttämästä tapahtumakäynnistimiä agenttiensa kanssa. Lisätietoja löytyy kohdasta Määritä datakäytännöt agenteille.

Tietosuojan parhaat käytännöt

Näin estät käyttäjiä pääsemästä käsiksi arkaluontoisiin tietoihin:

• Arvioi, käyttävätkö asiakaspalvelijat todennusta edellyttäviä tietoja ja järjestelmiä tapahtumakäynnistimien avulla ja miten.
• Ymmärrä, mitä tietoa laukaisijat voivat sisällyttää hyötykuormiinsa ja mitä tietotoimintoja testauksen avulla tuotetaan näistä hyötykuorman syötteistä.
• Rajaa käynnistimen aktivointikohteita käynnistinparametrien avulla ja anna agentillesi ohjeet, kuinka käsitellä kuormatietoja.

Ratkaisutietoisten pilvityönkulkujen jakamisen on oltava otettuna käyttöön

Tekijät voivat lisätä tapahtumakäynnistimiä agentteihin vain ympäristöissä, joissa ratkaisutietojen pilvityönkulkujen jakaminen on otettu käyttöön,

Jos et voi lisätä laukaisijoita ja organisaatiosi datakäytännöt sallivat laukaisimet, ympäristössäsi tämä vaihtoehto saattaa olla pois päältä. Ota yhteyttä ympäristösi järjestelmänvalvojaan, jotta voit ottaa ratkaisutietoisen pilvijakamisen käyttöön.

Yhdistinongelmien vianmääritys

Agentit eivät ehkä pysty suorittamaan kaikkia yhdistimiä onnistuneesti. Jos agentti ei toistuvasti onnistu kutsumaan liitintä, harkitse Power Automate työnkulun toiminnon luomista, joka käyttää ongelmallista liitintä toiminnon loppuunsaattamiseen.