Distribuera agenter i Microsoft Teams

Microsoft Teams medför unika distributionsutmaningar för Copilot Studio-agenter på grund av sin ihållande konversationsmiljö. Till skillnad från webbaserade lösningar där sessioner återställs automatiskt, behåller Teams samtalstrådar på obestämd tid, vilket kan leda till inaktuell kontext, utgångna tokens och föråldrat cache-innehåll.

Den här artikeln ger vägledning för att effektivt distribuera Copilot Studio-agenter i Teams. Du lär dig att hantera ihållande sessioner, implementera felsökningsstrategier och säkerställa tillförlitlig prestanda över längre samtalslivscykler.

Centrala överväganden som behandlas:

• Livscykelhantering för sessionen och inaktivitetshantering
• Felsökningstekniker för persistenta konversationer
• Versionshantering och strategier för distribution av uppdateringar
• Teams-specifika implementeringsmönster

Följ dessa metoder för att skapa robusta agenter som presterar konsekvent i Teams-miljön samtidigt som de ger tydlig återkoppling till användarna om tillståndsförändringar och systembeteende.

Varför Teams-distribution är annorlunda

Teams-konversationer kvarstår i flera dagar utan automatisk återställning. Till skillnad från webbchatt-sessioner triggas händelsen ConversationStart bara första gången en agent läggs till. Att installera om appen utlöser inte händelsen på nytt.

Teams persistens medför flera risker:

• Inaktuell kontext: Konversationshistoriken kvarstår om den inte rensas.
• Token-utgång: Anslutningsprogram kan gå ut under långa sessioner.
• Kontextbegränsningar: Ackumulerade meddelanden kan överskrida modellens begränsningar.
• Cache för uppdateringar: Användare kan fortsätta interagera med föråldrad logik.

Proaktiv tillståndshantering och tydlig användarvägledning är avgörande.

Hantera sessionens livscykel

Hantera sessionens livscykel med inaktivitetshantering.

Implementera återställningar vid inaktivitet

Skapa ett nytt ämne och välj Användaren är inaktiv ett tag-trigger för att starta ett återställningsflöde efter en period av användarinaktivitet. Läs mer i Inaktivitetsutlösare om Teams-specifika mönster, inklusive skyddsvariabler och den beständiga konversationsmodellen.

1. Lägg till en trigger för inaktivitet och sätt en timeout (till exempel 15 minuter).
2. Lägg till en eller flera Rensa variabelvärden-noder för att ta bort sessionsvariabler och konversationshistorik och förhindra överflöd av kontext.
3. Avsluta samtalet och markera sessionen som löst.

Denna metod förhindrar kontextöverflöd och säkerställer förutsägbart beteende när en användare återvänder.

Ge vägledning efter återställning

Skicka ett meddelande som förklarar vad som har inträffat efter att du har rensat tillståndet. Till exempel: "Det ser ut som om vår konversation har blivit inaktiv, så jag rensar det tidigare sammanhanget för säkerhets skull." Säg "hej" för att starta om."Lär känna Copilot

Eftersom ConversationStart bara aktiveras en gång, första gången en agent läggs till, blir hälsningsämne din egentliga initialiseringspunkt. Att be användaren säga "hej" säkerställer att din startlogik fungerar korrekt.

Tillhandahåll ett återställningskommando som användaren kan utföra själv

Lägg till ett meddelande som informerar användare om att de kan skriva ett specifikt kommando: "Om något verkar fel, prova att skriva /debug clearstate för att uppdatera mitt tillstånd."

Detta kommando initierar en fullständig konversationsåterställning:

• Rensar konversationstillstånd
• Tar bort cachelagrad anslutningsprogramsinformation
• Autentiserar anslutningsprogram på nytt
• Läser in den senaste versionen av agenten

Använd det här kommandot i följande fall:

• Boten verkar "fast" med föråldrad information
• Anslutningsprogramautentiseringen har gått ut
• Efter uppdateringar av robotlogiken
• När beteendet verkar inkonsekvent

Öka transparensen och förbättra felsökningen

För att öka transparensen och förbättra felsökningen för agenter som distribueras i Teams, använd triggern OnKnowledgeRequested.

Använd OnKnowledgeRequested för att visa omskrivna frågor

Copilot Studio skriver om användarfrågor innan den hämtar information. Om du aktiverar triggern OnKnowledgeRequested kan du:

• Diagnostisera avsiktsmatchningsfel
• Förstå hur sökfrågor omskrivs
• Öka användarförtroendet under felsökning

Lägg till ett meddelande som visar både genererade nyckelords- och semantiska sökfrågor. Till exempel:

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

Denna fråga ger skrivskyddad åtkomst till den förfinade sökfrågan (omskriven sökfråga/query rewrite) som orkestrering genererade från användarens fråga.

Förmåner:

• Hjälper till att felsöka felmatchningar i avsikten.
• Visar användarna vad agenten söker efter.
• Bygger förtroende för agentens handlingar.
• Hjälper skapare under tester.

Versionskontroll och uppdateringssäkerhet

Att hantera agentversioner och säkerställa att användare interagerar med den senaste logiken är särskilt viktigt i en persistent miljö som Teams.

Visa robotversion i hälsning eller ett dedikerat ämne

Inkludera en versionsidentifierare genom att använda hälsningsämne eller ett dedikerat versionsämne:

Contoso Helpdesk Bot – Version 1.3 (Nov 2025)

Uppdatera detta värde vid varje publicering för att hjälpa användare och supportteam att verifiera vilken build som är aktiv. Att uppdatera versionsmetadata uppdaterar också cachelagrat innehåll. Att ändra agentens namn eller beskrivning får Teams att ladda den som en ny version.

Aktivera "Tvinga senaste versionen" när du publicerar

Inställningen Tvinga nyaste versionen säkerställer att Teams laddar den senaste agentlogiken nästa gång användaren skickar ett meddelande. Denna inställning hjälper också till att ogiltigförklara cachade versioner. Men att tvinga fram en uppdatering avbryter alla pågående samtal.

Teams-specifika implementeringsöverväganden

Teams har unika beteenden som kräver särskild uppmärksamhet.

Behandla hälsningsämnet som din startlogik

Eftersom ConversationStart endast utlöses en gång läggs en agent till första gången:

• Placera initialiseringslogiken i Hälsningen.
• Lägg till tydliga instruktioner i Teams-appens beskrivning.
• Påminn användarna: "Efter en timeout, skriv 'hello' för att starta en ny konversation."

Optimera triggers och reservlösningar

Teams-användare interagerar naturligt och oförutsägbart. Säkerställ att din robot:

• Hanterar flera hälsningsvariationer.
• Hanterar avsked.
• Ger flera exempel på yttranden.
• Erbjuder vänliga och hjälpsamma fallback-svar.
• Använder nyckelord för att vägleda användare till relevanta ämnen.
• Använder OnKnowledgeRequested för att hjälpa till att diagnostisera missade avsikter.
• Omdirigerar till relevanta ämnen baserat på nyckelord.
• Uppmanar användare att omformulera om roboten verkligen fastnar.

Validera autentiseringsbeteende för anslutningsprogram

När du använder anslutningsprogram (ServiceNow, Outlook och andra), testa:

• Hur det initiala inloggningskortet beter sig.
• Vad händer när tokenen går ut och hur den automatiskt förnyas.
• Hur forcerad ogiltigförklaring och återsamtyckesflöden fungerar.

Testa under verkliga förhållanden

Eftersom Teams behåller tillstånd över sessioner bör din testning spegla den verkliga användarupplevelsen:

1. Distribuera genom att använda Visa endast för mig.
2. Testa långvariga scenarier (återvänder efter stängning).
3. Publicera uppdateringar och bekräfta att agenten byter version.
4. Validera Adaptiva kort-rendering på både dator och mobil.
5. Testa åtgärder i varierande samtalskontexter.

Checklista för distribution

Viktiga punkter

• Hantera sessionens livscykel genom att konfigurera inaktivitetstriggers och använda tillståndsrensningsalternativ när det är lämpligt.
• Förbättra transparensen genom att synliggöra systemets aktivitet via förfrågningar och relaterade tillståndsmeddelanden.
• Ta hänsyn till Teams-specifika beteenden, såsom att hantera manuella hälsningar och beständigt minne.
• Upprätthåll agentens tillförlitlighet genom att införa versionshantering och kräva uppdateringar när det behövs.
• Stöd användarens autonomi genom att tillhandahålla självservice-felsökningskommandon och guidade återställningsalternativ.

Relaterad information

• Ansluta och konfigurera en agent för Teams och Microsoft 365
• Viktiga begrepp – Publicera och distribuera din agent