Udrul agenter i Microsoft Teams

Microsoft Teams præsenterer unikke udrulningsudfordringer for Copilot Studio-agenter på grund af det vedvarende samtalemiljø. I modsætning til webbaserede udrulninger, hvor sessioner nulstilles automatisk, vedligeholder Teams samtaletråde på ubestemt tid, hvilket kan føre til forældet kontekst, udløb af token og forældet cachelagret indhold.

Denne artikel indeholder en vejledning til effektiv udrulning af Copilot Studio-agenter i Teams. Du lærer, hvordan du administrerer vedvarende sessioner, implementerer fejlfindingsstrategier og sikrer pålidelig ydeevne på tværs af udvidede samtalelivscyklusser.

Vigtige overvejelser:

• Administration af sessionens livscyklus og håndtering af inaktivitet
• Fejlfindingsteknikker for vedvarende samtaler
• Versionsstyring og opdatering af installationsstrategier
• Teams-specifikke implementeringsmønstre

Følg disse fremgangsmåder for at oprette robuste agenter, der fungerer ensartet i Teams-miljøet, samtidig med at brugerne får klar feedback om tilstandsændringer og systemfunktionsmåde.

Hvorfor Teams-udrulning er anderledes

Teams-samtaler fortsætter på tværs af dage uden automatisk nulstilling. I modsætning til webchatsessioner ConversationStart udløses begivenheden kun, første gang en agent tilføjes. Denne hændelse kan ikke gentages, når du geninstallerer appen.

Teams persistens skaber flere risici:

• Forældet kontekst: Samtaleoversigten forbliver, medmindre den ryddes.
• Udløb af token: Connectors kan udløbe under lange sessioner.
• Kontekstgrænser: Akkumulerede meddelelser kan overskride modelgrænser.
• Cachelagring af opdateringer: Brugerne kan fortsætte med at interagere med forældet logik.

Proaktiv tilstandsstyring og klar brugervejledning er afgørende.

Administrer sessionens livscyklus

Administrer sessionens livscyklus med håndtering af inaktivitet.

Implementer nulstilling af inaktivitet

Opret et nyt emne, og vælg udløserenBrugeren er inaktiv i et stykke tid for at starte et nulstillingsflow efter en periode med brugerinaktivitet.

1. Tilføj inaktivitetsudløseren, og angiv en timeout (f.eks. 15 minutter).
2. Tilføj en eller flere noder for Ryd variabelværdier for at fjerne sessionsvariabler og samtalehistorik for at forhindre kontekstoverløb.
3. Afslut samtalen, og markér sessionen som løst.

Denne fremgangsmåde forhindrer kontekstoverløb og sikrer forudsigelig funktionsmåde, når en bruger returnerer.

Angiv vejledning efter nulstilling

Når du har ryddet tilstanden, skal du sende en meddelelse, der forklarer, hvad der skete. For eksempel: "Det ser ud til, at vores samtale gik i stå, så jeg rydder den forrige kontekst for sikkerhed. Sig "hej" for at genstarte."

Da ConversationStart det kun udløses én gang, første gang en agent tilføjes, bliver emnet Hilsen dit effektive initialiseringspunkt. Når brugeren bliver bedt om at sige "hej", sikrer du, at din startlogik kører korrekt.

Tilbyd en selvbetjent nulstillingskommando

Tilføj beskeder, der informerer brugerne om, at de kan skrive en bestemt kommando: "Hvis noget virker forkert, kan du prøve at skrive /debug clearstate for at opdatere min tilstand."

Denne kommando gennemtvinger en fuldstændig nulstilling af samtaler:

• Rydder samtaletilstand
• Fjerner cachelagrede connectoroplysninger
• Genbekræfter forbindelser
• Indlæser den nyeste version af agenten

Brug denne kommando, når:

• Robotten synes "fast" med forældede oplysninger
• Connectorgodkendelsen er udløbet
• Efter opdateringer af botlogik
• Når funktionsmåden synes inkonsekvent

Øg gennemsigtigheden, og øg fejlfindingen

Hvis du vil øge gennemsigtigheden og forbedre fejlfindingen af agenter, der er udrullet i Teams, skal du bruge udløseren OnKnowledgeRequested .

Brug OnKnowledgeRequested til at få vist omskrevne forespørgsler

Copilot Studio omskriver brugerspørgsmål, før det udfører hentning. Hvis du aktiverer udløseren OnKnowledgeRequested , kan du:

• Diagnosticer hensigtsuoverensstemmelser
• Forstå, hvordan forespørgsler omskrives
• Øg brugertilliden under fejlfinding

Tilføj en meddelelse, der viser genererede både nøgleords- og semantiske forespørgsler. 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 forespørgsel giver skrivebeskyttet adgang til den afgrænsede søgeforespørgsel (omskrivning af forespørgsel), som orchestratoren oprettede ud fra brugerens spørgsmål.

Fordele:

• Hjælper med at foretage fejlfinding af uoverensstemmelse i hensigten.
• Viser brugerne, hvad agenten søger efter.
• Opbygger tillid til agentens handlinger.
• Hjælper fremstillere under test.

Versionsstyring og opdateringspålidelighed

Det er især vigtigt at administrere agentversioner og sikre, at brugerne interagerer med den nyeste logik i et vedvarende miljø som Teams.

Surface bot version i hilsen eller et dedikeret emne

Medtag et versions-id ved hjælp af emnet Hilsen eller et emne med en dedikeret version:

Contoso Helpdesk Bot – Version 1.3 (Nov 2025)

Opdater denne værdi med hver publicering for at hjælpe brugere og supportteams med at bekræfte, hvilket build der er aktivt. Opdatering af versionsmetadata opdaterer også cachelagret indhold. Hvis du ændrer agentens navn eller beskrivelse, bliver Teams bedt om at indlæse det som en ny opdatering.

Aktivér "Gennemtving nyeste version" ved publicering

Indstillingen Gennemtving nyeste version sikrer, at Teams indlæser den nyeste agentlogik, næste gang brugeren sender en meddelelse. Denne indstilling hjælper også med at ugyldiggøre cachelagrede versioner. Men hvis du gennemtvinger en opdatering, afbrydes en igangværende samtale.

Teams-specifikke implementeringsovervejelser

Teams har entydige funktionsmåder, der kræver særlig opmærksomhed.

Behandl emnet Hilsen som din startlogik

Da ConversationStart kun udløses én gang, tilføjes en agent den første gang:

• Indsæt initialiseringslogik i Hilsen.
• Tilføj tydelige instruktioner i beskrivelsen af Teams-appen.
• Påmind brugerne: "Efter en timeout skal du skrive "hej" for at starte en ny samtale."

Optimer udløsere og fallbacks

Teams-brugere interagerer naturligt og uforudsigeligt. Sørg for, at din robot:

• Håndterer flere hilsenvariationer.
• Inkluderer håndtering af farvel.
• Indeholder flere eksempelytringer.
• Tilbyder venlige og nyttige fallback svar.
• Bruger nøgleord til at guide brugerne til relevante emner.
• Bruges OnKnowledgeRequested til at hjælpe med at diagnosticere mistede hensigter.
• Omdirigerer til relevante emner baseret på nøgleord.
• Beder brugerne omformulere, hvis robotten virkelig sidder fast.

Valider funktionsmåde for connectorgodkendelse

Når du bruger connectors (ServiceNow, Outlook m.fl.), skal du teste:

• Sådan fungerer det første logonkort.
• Hvad sker der, når tokenet udløber, og hvordan det automatisk fornyes.
• Sådan fungerer tvungen ugyldiggørelse og gentilladelsesflow.

Test under reelle forhold

Da Teams bevarer tilstanden på tværs af sessioner, bør din test afspejle den reelle brugeroplevelse:

1. Udrul ved hjælp af Vis kun til mig.
2. Test langvarige scenarier (vender tilbage efter timer).
3. Publicer opdateringer og bekræft, at agenten skifter versioner.
4. Valider gengivelse af adaptivt kort på tværs af stationære og mobile enheder.
5. Test handlinger i forskellige samtalekontekster.

Tjekliste til udrulning

Vigtige takeaways

• Administrer sessionens livscyklus ved at konfigurere inaktivitetsudløsere og bruge indstillinger for tilstandsrydning, når det er relevant.
• Gør gennemsigtigheden bedre ved at få systemaktiviteten til at dukke op via omskrivninger af forespørgsler og tilstandsrelaterede meddelelser.
• Konto for Teams-specifikke funktionsmåder, f.eks håndtering af manuelle hilsener og administration af vedvarende hukommelse.
• Bevar agentpålideligheden ved at implementere versionsstyringspraksisser og gennemtvinge opdateringer, når det er nødvendigt.
• Understøtter brugerautonomi ved at levere selvbetjente fejlfindingskommandoer og automatiserede genoprettelsesindstillinger.

Relaterede oplysninger

• Opret forbindelse og konfigurer en agent til Teams og Microsoft 365
• Nøglebegreber – Publicer og udrul din agent