Distribuer agenter i Microsoft Teams

Microsoft Teams utgjør særegne distribusjonsutfordringer for Copilot Studio-agenter på grunn av det vedvarende samtalemiljøet. I motsetning til nettbaserte distribusjoner hvor øktene tilbakestilles automatisk, opprettholder Teams samtaletråder på ubestemt tid, noe som kan føre til foreldet kontekst, utløpte token og utdatert bufret innhold.

Denne artikkelen gir veiledning for effektiv distribusjon av Copilot Studio-agenter i Teams. Du lærer hvordan du håndterer vedvarende sesjoner, implementerer feilsøkingsstrategier og sikrer pålitelig ytelse over lengre samtalelivssykluser.

Viktige punkter som dekkes:

• Håndtering av administrasjon av øktlivssyklus og inaktivitet
• Feilsøkingsteknikker for vedvarende samtaler
• Versjonskontroll og oppdateringsdistribusjonsstrategier
• Teams-spesifikke implementeringsmønstre

Følg disse anbefalingene for å skape robuste agenter som fungerer stabilt i Teams-miljøet, samtidig som de gir tydelig tilbakemelding til brukerne om tilstandsendringer og systematferd.

Hvorfor Teams-distribusjon er annerledes

Teams-samtaler vedvarer i flere dager uten automatisk tilbakestilling. I motsetning til nettprat-økter, utløses hendelsen ConversationStart kun første gang en agent legges til. Hvis du installerer appen på nytt, utløses ikke denne hendelsen på nytt.

Persistens i Teams skaper flere risikoer:

• Utdatert kontekst: Samtalehistorikken forblir med mindre den fjernes.
• Token-utløp: Tilkoblinger kan utløpe under lange økter.
• Kontekstbegrensninger: Akkumulerte meldinger kan overstige modellgrenser.
• Oppdateringscache: Brukere kan fortsette å samhandle med utdatert logikk.

Proaktiv tilstandshåndtering og tydelig brukerveiledning er avgjørende.

Administrer sesjonslivssyklusen

Administrer øktens livssyklus med håndtering av inaktivitet.

Implementer tilbakestilling ved inaktivitet

Opprett et nytt emne og velg "Brukeren er inaktiv en stund"-triggeren for å starte en tilbakestillingsflyt etter en periode med brukerinaktivitet. Les mer i Inaktivitet trigger om Teams-spesifikke mønstre, inkludert guard-variabler og den vedvarende samtalemodellen.

1. Legg til inaktivitetstriggeren og sett en timeout (f.eks. 15 minutter).
2. Legg til én eller flere Fjern variabelverdier-noder for å fjerne sesjonsvariabler og samtalehistorikk for å forhindre kontekstoverløp.
3. Avslutt samtalen og merk økten som resolved.

Denne tilnærmingen forhindrer kontekstoverløp og sikrer forutsigbar atferd når en bruker kommer tilbake.

Gi veiledning etter tilbakestilling

Etter å ha nullstilt tilstanden, send en melding som forklarer hva som skjedde. Eksempel: "Det ser ut til at samtalen vår ble inaktiv, så jeg sletter den tidligere konteksten for sikkerhets skyld." Si "Hallo" for å starte på nytt."

Fordi ConversationStart bare utløses én gang, nemlig første gang en agent legges til, blir Hilsen-emnet ditt effektive initialiseringspunkt. Å be brukeren si «hei» sikrer at oppstartslogikken din fungerer riktig.

Tilby en selvbetjent tilbakestillingskommando

Legg til en melding som informerer brukerne om at de kan skrive inn en spesifikk kommando: «Hvis noe virker galt, prøv å skrive /debug clearstate for å tilbakestille tilstanden min.»

Denne kommandoen tvinger frem en fullstendig tilbakestilling av samtalen:

• Sletter samtaletilstand
• Fjerner bufret tilkoblingsinformasjon
• Autentiserer koblinger på nytt
• Laster den nyeste versjonen av agenten

Bruk denne kommandoen når:

• Roboten virker «fastlåst» med utdatert informasjon
• Autentisering for kobling har utløpt
• Etter oppdatering av robot-logikk
• Når atferden virker inkonsekvent

Øk åpenheten og forbedre feilsøkingen

For å øke åpenheten og forbedre feilsøking for agenter utplassert i Teams, bruk OnKnowledgeRequested-utløseren.

Bruk OnKnowledgeRequested for å vise omskrevne spørsmål

Copilot Studio omskriver brukerspørsmål før det gjennomfører søk. Hvis du aktiverer utløseren OnKnowledgeRequested , kan du:

• Diagnostiser intensjonsavvik
• Forstå hvordan spørringer skrives om
• Øk brukertilliten under feilsøking

Legg til en melding som viser både genererte nøkkelord- og semantiske spørringer. Eksempel:

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: {}

Denne spørringen gir skrivebeskyttet tilgang til den raffinerte søkespørringen (spørringsomskriving) som iverksetteren genererte fra brukerens spørsmål.

Godtgjøring:

• Hjelper med å feilsøke misforhold i intensjon.
• Viser brukerne hva agenten slår opp.
• Bygger tillit til agentens handlinger.
• Hjelper utviklere under testing.

Versjonskontroll og oppdateringspålitelighet

Å administrere agentversjoner og sikre at brukere benytter den nyeste logikken er spesielt viktig i et kontinuerlig miljø som Teams.

overflate-robotversjon i hilsen eller et dedikert emne

Legg til en versjons-ID ved å bruke hilsningemnet eller et dedikert versjonsemne:

Contoso Helpdesk Bot – Version 1.3 (Nov 2025)

Oppdater denne verdien ved hver publisering for å hjelpe brukere og kundestøtter med å verifisere hvilken build som er aktiv. Oppdatering av versjonsmetadata oppdaterer også bufret innhold. Å endre agentens navn eller beskrivelse får Teams til å laste den inn som en ny oppdatering.

Aktiver "Tving nyeste versjon" når du publiserer

Innstillingen Tving frem nyeste versjon sikrer at Teams laster inn den nyeste agentlogikken neste gang brukeren sender en melding. Denne innstillingen hjelper også med å ugyldiggjøre bufrede versjoner. Men å tvinge frem en oppdatering avbryter enhver pågående samtale.

Teams-spesifikke implementeringshensyn

Teams har unike atferder som krever spesiell oppmerksomhet.

Bruk Greeting-emnet som oppstartslogikk

Siden ConversationStart bare utløses én gang, første gang en agent legges til:

• Plasser initialiseringslogikk i Greeting.
• Legg til tydelige instruksjoner i beskrivelsen av Teams-appen.
• Minn brukerne: «Etter en timeout, skriv 'hello' for å starte en ny samtale.»

Optimaliser triggere og fallback-responser

Teams-brukere samhandler naturlig og uforutsigbart. Sørg for at roboten din:

• Håndterer ulike hilsener.
• Inkluderer håndtering av avskjeder.
• Tilbyr flere eksempelutsagn.
• Tilbyr vennlige og hjelpsomme fallback-svar.
• Bruker nøkkelord for å veilede brukere til relevante emner.
• Bruker OnKnowledgeRequested for å hjelpe med å diagnostisere manglende intents.
• Omdirigerer til relevante emner basert på nøkkelord.
• Oppfordrer brukere til å omformulere hvis roboten virkelig sitter fast.

Valider autentiseringsatferd for koblinger

Når du bruker koblinger (ServiceNow, Outlook og andre), test:

• Hvordan det første innloggingskortet oppfører seg.
• Hva skjer når tokenet utløper, og hvordan det automatisk fornyes.
• Hvordan tvungen ugyldiggjøring og gjenopptakelse fungerer.

Test under reelle forhold

Ettersom Teams beholder tilstand på tvers av økter, bør testingen din reflektere den reelle brukeropplevelsen:

1. Distribuer ved å bruke Show to only me.
2. Test langvarige scenarioer (for eksempel når brukeren kommer tilbake etter flere timer).
3. Publiser oppdateringer og bekreft at agenten skifter versjon.
4. Valider visningen av Dynamiske kort på både desktop og mobil.
5. Test handlinger i ulike samtalekontekster.

Sjekkliste for distribusjon

Viktige punkter

• Administrer øktlivssyklusen ved å konfigurere inaktivitetstriggere og bruke alternativer for å fjerne tilstand når det er hensiktsmessig.
• Forbedre åpenheten ved å synliggjøre systemaktivitet gjennom spørringsomskrivninger og tilstandsrelaterte meldinger.
• Ta hensyn til Teams-spesifikke atferder, som håndtering av manuelle hilsener og håndtering av vedvarende minne.
• Oppretthold agentens pålitelighet ved å implementere versjonsstyring og sørge for oppdateringer når det er nødvendig.
• Støtt brukerautonomi ved å tilby selvbetjente feilsøkingskommandoer og veiledede gjenopprettingsalternativer.

Relatert informasjon

• Koble til og konfigurer en agent for Teams og Microsoft 365
• Nøkkelbegreper – Publiser og distribuer agenten din