Agents in Microsoft Teams bereitstellen

Microsoft Teams stellt aufgrund seiner persistenten Unterhaltungsumgebung einzigartige Herausforderungen bei der Bereitstellung von Copilot Studio-Agents dar. Im Gegensatz zu webbasierten Bereitstellungen bei denen Sitzungen automatisch zurückgesetzt werden, verwaltet Teams Unterhaltungsthreads unbegrenzt, was zu veraltetem Kontext, Tokenablaufdatum und veralteten zwischengespeicherten Inhalten führen kann.

Dieser Artikel bietet eine Anleitung zur effektiven Bereitstellung von Copilot Studio-Agents in Teams. Sie erfahren, wie Sie persistente Sitzungen verwalten, Debugging-Strategien implementieren und eine zuverlässige Leistung über längere Unterhaltungslebenszyklen hinweg sicherstellen.

Wichtige Überlegungen:

• Verwalten des Sitzungslebenszyklus und Inaktivitätsbehandlung
• Debugging-Techniken für persistente Unterhaltungen
• Versionskontrolle und Update-Bereitstellung
• Teams-spezifische Implementierungsmuster

Befolgen Sie diese Praktiken, um robuste Agents zu erstellen, die in der Teams-Umgebung zuverlässig arbeiten und den Nutzern klares Feedback zu Zustandsänderungen und Systemverhalten geben.

Warum die Bereitstellung in Teams anders ist

Teams-Unterhaltungen bleiben tagesübergreifend ohne automatisches Zurücksetzen erhalten. Im Gegensatz zu Webchat Sitzungen löst das Ereignis ConversationStart nur das erste Mal aus, wenn ein Agent hinzugefügt wird. Eine Neuinstallation der App löst dieses Ereignis nicht erneut aus.

Die Persistenz von Teams birgt mehrere Risiken:

• Veralteter Kontext: Der Unterhaltungsverlauf bleibt, es sei denn, er wird gelöscht.
• Tokenablaufdatum: Token von Konnektoren können während langer Sitzungen ablaufen.
• Kontextgrenzen: Akkumulierte Nachrichten können die Modellgrenzen überschreiten.
• Update-Caching: Benutzer könnten weiterhin mit veralteter Logik interagieren.

Proaktives Zustandsmanagement und klare Benutzerführung sind unerlässlich.

Verwalten des Sitzungslebenszyklus

Verwalten Sie den Sitzungslebenszyklus mit Inaktivitätsbehandlung.

Implementieren von Inaktivitätszurücksetzungen

Erstellen Sie ein neues Thema und wählen Sie den TriggerDer Benutzer ist eine Zeit lang inaktiv aus, um einen Reset-Flow nach einer Phase der Benutzerinaktivität zu starten. Erfahren Sie mehr in Inaktivitäts-Trigger über Teams-spezifische Muster, einschließlich Guard-Variablen und des Persistent-Conversation-Modells.

1. Fügen Sie den Inaktivitäts-Trigger hinzu und setzen Sie einen Timeout (z. B. 15 Minuten).
2. Fügen Sie einen oder mehrere Knoten Variablenwerte löschen hinzu, um Sitzungsvariablen und Unterhaltungsverlauf zu entfernen und Kontextüberlauf zu verhindern.
3. Beenden Sie die Unterhaltung und markieren Sie die Sitzung als beendet.

Dieser Ansatz verhindert Kontextüberlauf und gewährleistet vorhersehbares Verhalten, wenn ein Nutzer zurückkehrt.

Geben Sie nach dem Reset Orientierung

Nach dem Löschen des Zustands eine Nachricht senden, die erklärt, was passiert ist. Beispiel: „Es sieht so aus, als ob unsere Unterhaltung eingeschlafen ist, sodass ich den vorherigen Kontext aus Sicherheitsgründen lösche.“ Sagen Sie ‚Hallo‘ zum Neustart.“

Da ConversationStart es nur einmal feuert, wird beim ersten Hinzufügen eines Agents das Begrüßungs-Thema zu Ihrem effektiven Initialisierungspunkt. Die Aufforderung an den Benutzer, „Hallo“ zu sagen, gewährleistet, dass die Initialisierungslogik ordnungsgemäß funktioniert.

Bieten Sie einen selbst durchführbaren Reset-Befehl an

Informieren Sie die Benutzer darüber, dass sie einen bestimmten Befehl eingeben können: „Wenn etwas nicht stimmt, versuchen Sie, /debug clearstate einzugeben, um meinen Status zu aktualisieren.“

Dieser Befehl erzwingt einen vollständigen Neustart der Unterhaltung:

• Löscht den Unterhaltungsstatus
• Entfernt zwischengespeicherte Konnektorinformationen
• Konnektoren erneut authentifizieren
• Lädt die aktuelle Version des Agents

Verwenden Sie diesen Befehl wenn:

• Der Bot mit veralteten Informationen „festzustecken“ scheint
• Die Authentifizierung des Connectors abgelaufen ist
• Nach Updates der Bot-Logik
• Wenn das Verhalten inkonsistent wirkt

Transparenz erhöhen und Debugging verbessern

Um die Transparenz zu erhöhen und das Debugging für in Teams eingesetzte Agents zu verbessern, verwenden Sie den OnKnowledgeRequested Trigger.

Verwenden Sie „OnKnowledgeRequested“, um umgeschriebene Anfragen anzuzeigen

Copilot Studio schreibt Benutzerfragen um, bevor es den Abruf durchführt. Wenn Sie den OnKnowledgeRequested Trigger aktivieren, können Sie:

• Absicht-Fehlzuordnungen diagnostizieren
• Verstehen, wie Anfragen umgeschrieben werden
• Das Vertrauen der Nutzer während der Fehlerbehebung erhöhen

Fügen Sie eine Nachricht hinzu, die sowohl die erzeugten Schlüsselwortabfragen als auch die erzeugten semantischen Abfragen anzeigt. Zum 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 (Umschreibung der Abfrage), die der Orchestrator aus der Frage des Benutzers generiert hat.

Nutzen:

• Hilft beim Debuggen von Nichtübereinstimmungen in Absichten.
• Zeigt Benutzern an, was der Agent nachsieht.
• Stärkt das Vertrauen in die Handlungen des Agents.
• Unterstützt Ersteller während des Testens.

Versionskontrolle und Update-Zuverlässigkeit

Die Verwaltung der Agentversionen und die Gewährleistung, dass Nutzer mit der aktuellen Logik interagieren, sind besonders wichtig in einer persistenten Umgebung wie Teams.

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

Fügen Sie eine Versionskennung hinzu, indem Sie das Begrüßungsthema oder ein dediziertes Versionsthema verwenden:

Contoso Helpdesk Bot – Version 1.3 (Nov 2025)

Aktualisieren Sie diesen Wert bei jedem Release, damit Benutzer und Support-Teams feststellen können, welcher Build aktuell verwendet wird. Das Aktualisieren der Versionsmetadaten sorgt außerdem dafür, dass zwischengespeicherte Inhalte aktualisiert werden. Wenn Sie den Namen oder die Beschreibung des Agents ändern, lädt Teams ihn als neues Update.

Aktivieren Sie die Option „Neueste Version erzwingen“ beim Veröffentlichen

Die Einstellung Neueste Version erzwingen sorgt dafür, dass Teams beim nächsten Senden einer Nachricht die neueste Agentlogik lädt. Diese Einstellung trägt außerdem dazu bei, im Cache gespeicherte Versionen zu invalidieren. Ein erzwungenes Update unterbricht jedoch alle laufenden Unterhaltungen.

Teams-spezifische Implementierungsaspekte

Teams weist einzigartige Verhaltensweisen auf, die besonderer Beachtung bedürfen.

Verwenden Sie das Begrüßungsthema als Ihre Startup-Logik

Da ConversationStart nur einmal ausgelöst wird, und zwar beim ersten Hinzufügen eines Agents:

• Die Initialisierungslogik sollte im Begrüßungsthema platziert werden.
• Fügen Sie klare Anweisungen in der Beschreibung der Teams-App hinzu.
• Erinnern Sie die Nutzer daran: „Nach einem Timeout tippen Sie ‚Hallo‘, um eine neue Unterhaltung zu beginnen.“

Triggers und Fallbacks optimieren

Teams-Nutzer interagieren spontan und unvorhersehbar. Stellen Sie sicher, dass Ihr Bot:

• Mehrere Begrüßungsvarianten handhabt.
• Eine Abschiedshandhabung beinhaltet.
• Mehrere Beispieläußerungen bereitstellt.
• Freundliche und hilfreiche Fallback-Antworten bietet.
• Schlüsselwörter verwendet, um Nutzer zu relevanten Themen zu führen.
• OnKnowledgeRequested verwendet, um fehlgeschlagene Absichten zu diagnostizieren.
• Auf Schlüsselwörtern basieren auf relevante Themen umlenkt.
• Nutzer auffordert, ihre Eingabe neu zu formulieren, wenn der Bot wirklich feststeckt.

Das Authentifizierungsverhalten der Konnektoren validiert

Testen Sie Folgendes, wenn Sie Konnektoren (ServiceNow, Outlook und andere) verwenden:

• Verhalten der anfänglichen Anmeldekarte.
• Was passiert, wenn der Token abläuft und wie er automatisch erneuert wird.
• Wie erzwungene Anerkennungs- und Wiederzustimmungsflows funktionieren.

Testen unter realen Bedingungen

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

1. Stellen Sie mithilfe von Nur mir anzeigen bereit.
2. Testen Sie langlaufende Szenarien (Rückgaben nach Stunden).
3. Veröffentlichen Sie Updates und stellen Sie sicher, dass der Agent auf eine neue Version umschaltet.
4. Validieren Sie das Rendering von adaptiven Karten auf Desktop und Mobilgeräten.
5. Testen Sie Aktionen in unterschiedlichen Unterhaltungskontexten.

Bereitstellungsprüfliste

Wichtige Erkenntnisse

• Verwalten Sie den Sitzungslebenszyklus, indem Sie Inaktivitätsauslöser konfigurieren und Zustandslöschoptionen verwenden, wenn angemessen.
• Verbessern Sie die Transparenz, indem Sie Systemaktivitäten durch Abfrage-Neuschreibungen und zustandsbezogene Nachrichten sichtbar machen.
• Berücksichtigen Sie Teams-spezifische Verhaltensweisen, wie zum Beispiel manuelle Begrüßungen und das Management persistenter Speicher.
• Stellen Sie die Zuverlässigkeit des Agents sicher, indem Sie Versionierungspraktiken implementieren und Updates bei Bedarf durchsetzen.
• Stärken Sie die Benutzerautonomie, indem Sie Befehle zur Selbsthilfe bei Fehlerbehebung und geführte Wiederherstellungsoptionen bereitstellen.

Verwandte Informationen

• Einen Agent mit Teams und Microsoft 365 verbinden und konfigurieren
• Hauptkonzepte – Ihren Agent veröffentlichen und bereitstellen