Muistiinpano
Tämän sivun käyttö edellyttää valtuutusta. Voit yrittää kirjautua sisään tai vaihtaa hakemistoa.
Tämän sivun käyttö edellyttää valtuutusta. Voit yrittää vaihtaa hakemistoa.
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.
- Lisää passiivisuuskäynnistin ja määritä aikakatkaisu (esimerkiksi 15 minuuttia).
- Lisää vähintään yksi Tyhjennä muuttujien arvot -solmu, jonka avulla poistetaan istuntomuuttujat ja keskusteluhistoria kontekstin ylivuodon välttämiseksi.
- Lopeta keskustelu ja merkitse istunto ratkaistuksi.
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.
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:
- Julkaise käyttämällä Näytä vain minulle -kohtaa.
- Testaa pitkäkestoisia skenaarioita (kestävät useita tunteja).
- Julkaise päivitykset ja varmista, että agentti vaihtaa versioita.
- Varmista mukautuvien korttien hahmontaminen työpöydällä ja mobiililaitteilla.
- 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.