Ota agentteja käyttöön Microsoft Teamsissa

Microsoft Teamsissa on yksilöllisiä käyttöönoton haasteita Copilot Studio -agenteilla, koska keskusteluympäristö on pysyvä. Toisin kuin verkkopohjaisissa käyttöönotossa, jossa istunnot nollautuvat automaattisesti, Teamsissa keskusteluketjut pidetään aktiivisina rajattomasti. Tämä voi johtaa vanhentuneeseen kontekstiin, tunnusten vanhentumiseen sekä välimuistisisällön vanhenemiseen.

Tämä artikkeli tarjoaa ohjeita Copilot Studio -agenttien tehokkaaseen käyttöönottoon Teamsissa. Tietoja pysyvien istuntojen hallinnasta, virheenkorjausstrategioiden toteuttamisesta ja luotettavan suorituskyvyn varmistamisesta pitkien keskustelusessioiden elinkaaren aikana.

Keskeiset näkökohdat:

  • Istunnon elinkaaren hallinta ja passiivisuuden käsittely
  • Pysyvien keskustelujen virheenkorjaustekniikat
  • Versionhallinta ja päivitysten käyttöönottostrategiat
  • Teams-kohtaiset toteutusmallit

Noudata näitä käytäntöjä luodaksesi luotettavia agentteja, jotka toimivat johdonmukaisesti Teams-ympäristössä ja antavat käyttäjille selkeää palautetta tilan muutoksista sekä järjestelmän toiminnasta.

Miksi Teamsin käyttöönotto on erilainen

Teams-keskustelut jatkuvat päivien ajan ilman automaattista nollausta. Toisin kuin verkkokeskusteluistunnoissa, ConversationStart-tapahtuma käynnistyy vain ensimmäisellä kerralla, kun agentti lisätään. Sovelluksen uudelleenasennus ei käynnistä tätä tapahtumaa uudelleen.

Teamsin keskustelujen pysyvyys aiheuttaa useita seuraavia riskejä:

  • Vanhentunut konteksti: Keskusteluhistoria pysyy tallessa, ellei sitä tyhjennetä.
  • Tunnuksen vanheneminen: Yhdistimet voivat vanhentua pitkien istuntojen aikana.
  • Kontekstirajoitukset: Kertyneet viestit voivat ylittää mallin rajat.
  • Välimuistin päivitys: Käyttäjät saattavat jatkaa vanhentuneen logiikan käsittelyä.

Ennakoiva tilanhallinta ja selkeät ohjeet käyttäjille ovat välttämättömiä.

Istunnon elinkaaren hallinta

Hallitse istunnon elinkaarta ja käsittele passiivisuutta.

Passiivisuuden nollausten toteuttaminen

Luo uusi aihe ja valitse Käyttäjä on ollut passiivinen hetken-käynnistin, jotta nollausprosessi käynnistyy käyttäjän passiivisuuden jälkeen. Lisätietoja passiivisuuskäynnistimestä Teams-kohtaisissa malleissa, mukaan lukien suojamuuttujat ja pysyvä keskustelumalli.

  1. Lisää passiivisuuskäynnistin ja määritä aikakatkaisu (esimerkiksi 15 minuuttia).
  2. Lisää vähintään yksi Tyhjennä muuttujien arvot -solmu, jonka avulla poistetaan istuntomuuttujat ja keskusteluhistoria kontekstin ylivuodon välttämiseksi.
  3. Lopeta keskustelu ja merkitse istunto ratkaistuksi.

Näyttökuva Copilot Studion aiheen editorista, jossa näkyy passiivisuuden nollauksen työnkulku ja käynnistin, viesti sekä Tyhjennä muuttujien arvot- ja Lopeta keskustelu -solmu.

Tämä lähestymistapa estää kontekstin ylivuodon ja varmistaa ennustettavan toiminnan, kun käyttäjä palaa.

Ohjeiden antaminen nollauksen jälkeen

Kun tila on tyhjennetty, lähetä viesti, jossa selitetään, mitä tapahtui. Esimerkki: Näyttää siltä, että keskustelumme jäi tauolle, joten tyhjennän aiemman kontekstin varmuuden vuoksi. Sano Hei, jos haluat aloittaa uudelleen.

Koska ConversationStart käynnistyy vain kerran eli agentin ensimmäisellä lisäyskerralla, Tervehdys-aihe toimii käytännössä aloituspisteenä. Käyttäjää pyydetään sanomaan Hei, koska sen avulla varmistetaan, että aloituslogiikka toimii oikein.

Itsepalvelun nollauskomennon tarjoaminen

Lisää viesti, jossa kerrotaan käyttäjille, että he voivat kirjoittaa tietyn komennon. Viesti voi olla esimerkiksi seuraava: Jos jokin vaikuttaa olevan pielessä, kokeile kirjoittaa /debug clearstate päivittääksesi tilani."

Seuraava komento pakottaa keskustelun nollaamiseen kokonaan:

  • tyhjentää keskustelun tilan
  • poistaa välimuistissa olevat käynnistimen tiedot
  • todentaa yhdistimet uudelleen
  • lataa agentin uusimman version.

Käytä tätä komentoa, kun

  • botti vaikuttaa olevan jumissa vanhentuneen tiedon kanssa
  • yhdistimen todennus on vanhentunut
  • bottilogiikka on päivitetty
  • toiminta vaikuttaa epäjohdonmukaiselta.

Läpinäkyvyyden lisääminen ja virheenkorjauksen parantaminen

Voit lisätä Teamsissa käyttöönotettujen agenttien läpinäkyvyyttä ja parantaa niiden virheenkorjausta OnKnowledgeRequested-käynnistimen avulla.

Käytä OnKnowledgeRequested-käynnistintä uudelleenkirjoitettujen kyselyiden näyttämisessä

Copilot Studio kirjoittaa käyttäjän kysymykset uudelleen ennen haun suorittamista. Jos otat OnKnowledgeRequested-käynnistimen käyttöön, voit

  • diagnosoida tarkoituksen ristiriitoja
  • saada lisätietoja siitä, miten kyselyt kirjoitetaan uudelleen
  • parantaa käyttäjien luottamusta virheenkorjauksen aikana.

Muistiinpano

Voit määrittää OnKnowledgeRequested-käynnistimen vain koodinäkymässä YAML:n avulla. Visuaalisen suunnittelijan tukea ei ole.

Lisää viesti, joka näyttää luodut avainsanakyselyt ja semanttiset kyselyt. Esimerkki:

kind: AdaptiveDialog
beginDialog:
  kind: OnKnowledgeRequested
  id: main
  actions:
    - kind: SendActivity
      id: sendActivity_debug
      activity: |-    
        **Debug**: sending this lexical query "{System.KnowledgeSearchQuery}"
        **Debug**: sending this semantic query "{System.SearchQuery}"
inputType: {}
outputType: {}

Tämä kysely tarjoaa vain lukuoikeuden tarkennettuun hakukyselyyn (kyselyn uudelleenkirjoitus), jonka orkestroija loi käyttäjän kysymyksestä.

Edut:

  • auttaa tarkoituksen ristiriitojen korjaamisessa
  • näyttää käyttäjille, mitä agentti etsii
  • rakentaa luottamusta agentin toimintoihin
  • avustaa agentin tekijöitä testauksen aikana.

Versionhallinta ja päivitysten luotettavuus

Agenttiversioiden hallinta ja sen varmistaminen, että käyttäjät käyttävät uusinta logiikkaa, on erityisen tärkeää Teamsin kaltaisessa pysyvässä ympäristössä.

Botin version näyttäminen tervehdyksessä tai erillisessä aiheessa

Lisää versiotunniste tervehdysaiheen avulla tai erilliseen versioaiheeseen seuraavasti

Contoso Helpdesk Bot – Version 1.3 (Nov 2025)

Päivitä tämä arvo jokaisen julkaisun yhteydessä, jotta käyttäjät ja tukitiimit voivat varmistaa, mikä versio on aktiivinen. Version metatietojen päivittäminen päivittää myös välimuistissa olevaa sisältöä. Kun agentin nimeä tai kuvausta muutetaan, Teams lataa sen uudeksi päivitykseksi.

Pakota uusimman version käyttö -ominaisuuden ottaminen käyttöön julkaisun yhteydessä

Pakota uusimman version käyttö -asetus varmistaa sen, että Teams lataa uusimman agenttilogiikan seuraavalla kerralla, kun käyttäjä lähettää viestin. Tämä asetus auttaa myös mitätöimään välimuistissa olevat versiot. Päivityksen pakottaminen keskeyttää kuitenkin kaikki käynnissä olevat keskustelut.

Näyttökuva agentin julkaisuvalintaikkunasta, jossa näkyvät varoitukset tunnistetiedoista, esiversiomallista ja Pakota uusimman version käyttö -asetuksesta.

Teams-kohtaista toteutusta koskevat huomioon otettavat seikat

Teams tarjoaa ainutlaatuisen toiminnan, joka edellyttää erityistä huomiota.

Tervehdysaiheen käyttäminen aloituslogiikkana

Koska ConversationStart käynnistyy vain kerran eli silloin, kun agentti lisätään ensimmäisen kerran,

  • aseta alustuslogiikka tervehdykseen
  • lisää selkeät ohjeet Teams-sovelluksen kuvaukseen
  • muistuta käyttäjiä seuraavalla viestillä: Kirjoita aikakatkaisun jälkeen Hei, jos haluat aloittaa uuden keskustelun.

Käynnistinten ja varatoimintojen optimoiminen

Teamsin käyttäjät keskustelevat luonnollisesti ja arvaamattomasti. Varmista, että botti

  • käsittelee useita tervehdysmuotoja
  • sisältää hyvästelyjen käsittelyn
  • tarjoaa useita esimerkkejä käyttäjän syötteistä
  • tarjoaa ystävällisiä ja hyödyllisiä varavastauksia
  • käyttää avainsanoja ohjatakseen käyttäjiä relevantteihin aiheisiin
  • käyttää OnKnowledgeRequested-komentoa huomaamatta jääneiden aikomusten selvittämisessä
  • ohjaa olennaisiin aiheisiin avainsanojen perusteella
  • kehottaa käyttäjää muotoilemaan viestinsä uudelleen, jos botti on todella jumissa.

Käynnistimen todennustoiminnan tarkistaminen

Kun käytät käynnistimiä (esimerkiksi ServiceNow ja Outlook), testaa

  • miten ensimmäinen sisäänkirjauskortti toimii
  • mitä tapahtuu, kun tunnus erääntyy ja miten se uudistetaan automaattisesti
  • miten pakotettu mitätöinti ja suostumuksen antaminen uudelleen toimivat.

Vinkki

Käynnistimet eivät välttämättä päivitä tunnuksia pitkien istuntojen aikana. Käytä passiivisuuden nollauksia tai /debug clearstate-komentoa OAuthin uudelleenkäynnistämiseksi tarvittaessa. Kerro tästä komennosta tukitiimeille ja käyttäjille, jotta nopea vianmääritys on mahdollinen.

Testaaminen käytännön olosuhteissa

Koska Teams säilyttää tilan eri istuntojen välillä, testauksen tulee heijastaa todellista käyttäjäkokemusta seuraavasti:

  1. Julkaise käyttämällä Näytä vain minulle -kohtaa.
  2. Testaa pitkäkestoisia skenaarioita (kestävät useita tunteja).
  3. Julkaise päivitykset ja varmista, että agentti vaihtaa versioita.
  4. Varmista mukautuvien korttien hahmontaminen työpöydällä ja mobiililaitteilla.
  5. Testaa toimintoja erilaisissa keskustelukonteksteissa.

Käyttöönoton tarkistuslista

Valmis? Tehtävä
Passiivisuuskäynnistin on määritetty tyhjentämään keskusteluhistoria
Käyttäjäviestintä selittää nollaukset ja ohjaa uudelleenkäynnistystä
/debug clearstate on dokumentoitu käyttäjille
OnKnowledgeRequested on käytössä läpinäkyvyyttä varten kehityksen aikana
Versiotunniste sisältyy vastauksiin
Pakota uusimman versio käyttö otettu käyttöön tarpeen mukaan
Tervehdysaihe sisältää alustuslogiikan
Varatoiminta on käyttäjäystävällistä
Käynnistimen todennus testattu vanhentumisen ja uusimisen osalta
Testaus Teamsissa todellisissa olosuhteissa on suoritettu

Tärkeimmät seikat

  • Hallitse istunnon elinkaarta määrittämällä passiivisuuskäynnistimet ja käyttämällä tilan tyhjennyksen vaihtoehtoja tarvittaessa.
  • Paranna läpinäkyvyyttä näyttämällä järjestelmän aktiviteettia kyselyiden uudelleenmuotoilun ja tilaviestien avulla.
  • Huomioi Teams-kohtainen toiminta, kuten manuaalisten tervehdysten käsittely ja pysyvän muistin hallinta.
  • Ylläpidä agentin luotettavuutta ottamalla käyttöön versiotietojen käytännöt ja pakottamalla päivitykset tarvittaessa.
  • Tue käyttäjän itsenäisyyttä tarjoamalla vianmäärityskomentoja itsepalveluominaisuutena sekä ohjattuja palautustoimintoja.