Bereitstellen von Agenten in Microsoft Teams

Microsoft Teams stellt aufgrund seiner beständigen Gesprächsumgebung einzigartige Bereitstellungsprobleme für Copilot Studio-Agenten dar. Im Gegensatz zu webbasierten Bereitstellungen, bei denen Sitzungen automatisch zurückgesetzt werden, verwaltet Teams Unterhaltungsthreads unbegrenzt, was zu veraltetem Kontext, Tokenablauf und veralteten zwischengespeicherten Inhalten führen kann.

Dieser Artikel enthält Anleitungen für die effektive Bereitstellung von Copilot Studio-Agents in Teams. Sie erfahren, wie Sie persistente Sitzungen verwalten, Debuggingstrategien implementieren und eine zuverlässige Leistung über erweiterte Unterhaltungszyklen hinweg sicherstellen.

Wichtige Überlegungen:

• Verwaltung des Sitzungslebenszyklus und Inaktivitätsbehandlung
• Debuggingtechniken für persistente Unterhaltungen
• Strategien zur Versionskontrolle und Bereitstellungsaktualisierung
• Teams-spezifische Implementierungsmuster

Befolgen Sie diese Methoden, um stabile Agents zu erstellen, die konsistent in der Teams-Umgebung ausgeführt werden, und geben Sie Benutzern klares Feedback zu Zustandsänderungen und Systemverhalten.

Warum die Bereitstellung von Teams anders ist

Teams-Unterhaltungen bleiben tagesübergreifend ohne automatisches Zurücksetzen erhalten. Im Gegensatz zu Web-Chat-Sitzungen wird das Ereignis ConversationStart nur beim ersten Mal ausgelöst, wenn ein Agent hinzugefügt wird. Durch das erneute Installieren der App wird dieses Ereignis nicht erneut ausgelöst.

Die Persistenz von Teams führt zu mehreren Risiken:

• Veralteter Kontext: Der Unterhaltungsverlauf bleibt, es sei denn, er wird gelöscht.
• Tokenablauf: Token von Verbindern können während langer Sitzungen ablaufen.
• Kontextgrenzwerte: Akkumulierte Nachrichten können Modellgrenzwerte überschreiten.
• Cache aktualisieren: Benutzer könnten möglicherweise weiterhin mit veralteter Logik interagieren.

Proaktive Zustandsverwaltung und klare Benutzerführung sind unerlässlich.

Verwalten des Sitzungslebenszyklus

Management des Sitzungslebenszyklus mit Inaktivitätsbehandlung.

Implementieren von Inaktivitätszurücksetzungen

Erstellen Sie ein neues Thema und wählen Sie den Auslöser 'Benutzer ist für eine Weile inaktiv', um den Zurücksetzungsablauf nach einer bestimmten Dauer der Benutzerinaktivität zu starten.

1. Fügen Sie den Inaktivitätstrigger hinzu, und legen Sie ein Timeout fest (z. B. 15 Minuten).
2. Fügen Sie einen oder mehrere Knoten " Variablenwerte löschen" hinzu, um Sitzungsvariablen und Unterhaltungsverlauf zu entfernen, um den Kontextüberlauf zu verhindern.
3. Beenden Sie die Unterhaltung, und markieren Sie die Sitzung als aufgelöst.

Dieser Ansatz verhindert den Kontextüberlauf und stellt ein vorhersagbares Verhalten beim Zurückgeben eines Benutzers sicher.

Geben Sie Anleitungen nach dem Zurücksetzen

Senden Sie eine Nachricht, in der erläutert wird, was passiert ist, nachdem Sie den Zustand gelöscht haben. Beispiel: "Es sieht so aus, als ob unsere Unterhaltung eingeschlafen ist, sodass ich den vorherigen Kontext aus Sicherheitsgründen lösche. Sagen Sie 'Hallo', um neu zu starten."

Da ConversationStart nur einmal ausgelöst wird, wird das Grußthema zum effektiven Initialisierungspunkt, wenn ein Agent zum ersten Mal hinzugefügt wird. Wenn der Benutzer aufgefordert wird, "Hello" zu sagen, wird sichergestellt, dass die Startlogik ordnungsgemäß ausgeführt wird.

Bereitstellen eines Selbstbedienungs-Reset-Befehls

Fügen Sie Nachrichten hinzu, die Benutzer darüber informieren, dass sie einen bestimmten Befehl eingeben können: "Wenn etwas falsch erscheint, versuchen Sie, /debug clearstate einzugeben, um meinen Zustand zu aktualisieren."

Mit diesem Befehl wird die Konversation vollständig zurückgesetzt.

• Löscht den Konversationsstatus
• Entfernt zwischengespeicherte Connectorinformationen.
• Erneute Authentifizierung von Verbindern
• Lädt die neueste Version des Agents.

Verwenden Sie diesen Befehl in folgenden Fällen:

• Der Bot scheint mit veralteten Informationen "hängen geblieben" zu sein.
• Die Connectorauthentifizierung ist abgelaufen.
• Nach Botlogikaktualisierungen
• Wenn das Verhalten inkonsistent erscheint

Transparenz erhöhen und Debuggen verbessern

Verwenden Sie den OnKnowledgeRequested Trigger, um die Transparenz zu erhöhen und das Debuggen für in Teams bereitgestellte Agents zu verbessern.

Verwenden Sie "OnKnowledgeRequested", um umgeschriebene Abfragen aufzudecken.

Copilot Studio schreibt Benutzerfragen neu, bevor der Abruf ausgeführt wird. Wenn Sie den OnKnowledgeRequested Trigger aktivieren, können Sie:

• Diagnostizieren von Intent-Nichtübereinstimmungen
• Verstehen, wie Abfragen umgeschrieben werden
• Erhöhen der Benutzervertrauensstellung beim Debuggen

Fügen Sie eine Nachricht hinzu, die sowohl Schlüsselwort- als auch semantische Abfragen anzeigt, die generiert werden. Beispiel:

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

Diese Abfrage bietet schreibgeschützten Zugriff auf die verfeinerte Suchabfrage (query rewrite), die der Orchestrator aus der Frage des Benutzers generiert hat.

Vorteile:

• Hilft beim Debuggen von Nichtübereinstimmungen in Absichten.
• Zeigt Benutzern an, was der Agent nachsieht.
• Schafft Vertrauen in die Handlungen des Agenten.
• Unterstützt Entwickler beim Testen.

Versionssteuerung und Update-Zuverlässigkeit

Das Verwalten von Agentversionen und die Sicherstellung, dass Benutzer mit der neuesten Logik interagieren, ist in einer beständigen Umgebung wie Teams besonders wichtig.

Surface Bot-Version in Begrüßung oder einem dedizierten Thema

Fügen Sie einen Versionsbezeichner mithilfe des Begrüßungsthemas oder eines dedizierten Versionsthemas ein:

Contoso Helpdesk Bot – Version 1.3 (Nov 2025)

Aktualisieren Sie diesen Wert mit jeder Veröffentlichung, um Benutzern und Supportteams zu helfen, zu überprüfen, welcher Build aktiv ist. Beim Aktualisieren der Versionsmetadaten werden auch zwischengespeicherte Inhalte aktualisiert. Wenn Sie den Namen oder die Beschreibung des Agents ändern, werden Teams aufgefordert, ihn als neues Update zu laden.

Aktivieren von "Neueste Version erzwingen" beim Veröffentlichen

Die Einstellung "Neueste Version erzwingen " stellt sicher, dass Teams die neueste Agentlogik lädt, wenn der Benutzer das nächste Mal eine Nachricht sendet. Diese Einstellung hilft auch beim Ungültigstellen zwischengespeicherter Versionen. Das Erzwingen eines Updates unterbricht jedoch alle laufenden Unterhaltungen.

Überlegungen zur teamspezifischen Implementierung

Teams verfügt über einzigartige Verhaltensweisen, die besondere Aufmerksamkeit erfordern.

Behandeln Sie das Begrüßungsthema als Startlogik.

Da ConversationStart nur einmal ausgelöst wird, nämlich dann, wenn ein Agent zum ersten Mal hinzugefügt wird:

• Initialisierungslogik in Greeting platzieren.
• Fügen Sie in der Beschreibung der Teams-App klare Anweisungen hinzu.
• Erinnern Sie Benutzer: "Geben Sie nach einem Timeout "Hallo" ein, um eine neue Unterhaltung zu beginnen."

Optimieren von Triggern und Fallbacks

Teams-Benutzer interagieren natürlich und unvorhersehbar. Stellen Sie sicher, dass Ihr Bot:

• Behandelt mehrere Grußvariationen.
• Umfasst die Abwicklung von Verabschiedungen.
• Stellt mehrere Beispiel-Äußerungen bereit.
• Bietet freundliche und hilfreiche Fallback-Antworten.
• Verwendet Schlüsselwörter, um Benutzer zu relevanten Themen zu führen.
• Wird OnKnowledgeRequested verwendet, um nicht erkannte Intentionen zu diagnostizieren.
• Leitet basierend auf Schlüsselwörtern zu relevanten Themen um.
• Fordert Benutzer auf, eine Neuphrase zu erstellen, wenn der Bot wirklich hängen bleibt.

Das Authentifizierungsverhalten von Connectors überprüfen

Wenn Sie Connectors verwenden (ServiceNow, Outlook und andere), testen Sie Folgendes:

• Verhalten der anfänglichen Anmeldekarte.
• Was geschieht, wenn das Token abläuft und wie es automatisch verlängert wird.
• Wie erzwungene Ungültigmachung und Wiedereinwilligungsprozesse funktionieren.

Testen unter realen Bedingungen

Da Teams den Zustand über Sitzungen hinweg beibehält, sollten Ihre Tests die authentische Benutzererfahrung widerspiegeln.

1. Bereitstellen mithilfe von "Nur mir anzeigen".
2. Testen Sie lang ausgeführte Szenarien (rückgaben nach Stunden).
3. Veröffentlichen Sie Updates, und bestätigen Sie, dass der Agent Versionen wechselt.
4. Überprüfen des Renderns adaptiver Karten auf Desktops und Mobilgeräten.
5. Testen Sie Aktionen in unterschiedlichen Unterhaltungskontexten.

Checkliste für die Bereitstellung

Wichtige Erkenntnisse

• Verwalten Sie den Sitzungslebenszyklus, indem Sie Inaktivitätstrigger konfigurieren und bei Bedarf Zustands-Clearing-Optionen verwenden.
• Verbessern Sie die Transparenz, indem Sie systembezogene Aktivitäten durch das Umschreiben von Abfragen und das Aufzeigen zustandsbezogener Nachrichten sichtbar machen.
• Berücksichtigen Sie teamsspezifische Verhaltensweisen, z. B. das Behandeln manueller Begrüßungen und das Verwalten des beständigen Speichers.
• Verwalten Sie die Zuverlässigkeit des Agents, indem Sie Versionsverwaltungspraktiken implementieren und Updates bei Bedarf erzwingen.
• Unterstützen Sie die Benutzerautonomie, indem Sie Self-Service-Problembehandlungsbefehle und geführte Wiederherstellungsoptionen bereitstellen.

Verwandte Informationen

• Verbinden und Konfigurieren eines Agents für Teams und Microsoft 365
• Schlüsselkonzepte – Veröffentlichen und Bereitstellen Ihres Agent