Freigeben über

Einen Agenten für Microsoft Teams verbinden und konfigurieren

  • Artikel

Nachdem Sie Ihren Agent veröffentlicht haben, können Sie ihn Benutzenden in Teams zur Verfügung stellen. Auf diese Weise können Sie, andere Mitglieder Ihres Teams und Ihre gesamte Organisation damit interagieren. Sie müssen den Agenten mindestens einmal veröffentlichen, bevor Benutzende in Teams mit ihm interagieren können.

Sie können Folgendes ausführen:

  • Das Erscheinungsbild Ihres Agenten in Teams anpassen
  • Den Agenten für sich selbst in Teams installieren
  • Den Installationslink des Agenten mit anderen Benutzenden teilen
  • Den Agenten im Teams-App-Store anzeigen.
    • Den Copiloten freigegebenen Benutzenden anzeigen, indem Sie ihn zum Teams-App-Store im Abschnitt Agenten-Erweiterungen hinzufügen.
    • Den Agenten für die Organisation freigeben, indem Sie ihn zur Genehmigung durch die Administrationsfachkraft einreichen, damit er im Abschnitt Für Ihre Organisation entwickelt des Teams-App-Stores angezeigt werden kann.
  • Den Agenten einem Team-Kanal hinzufügen.
  • Das App-Manifest für Ihren Agenten herunterladen, um es in Ihrem Teams-Mandanten weiterzugeben.

Wenn Sie einen Agenten zu Teams hinzufügen, werden einige Ihrer Daten wie Agenteninhalte und Endbenutzer-Chat-Inhalte mit Teams geteilt. Ihre Daten verlassen eventuell die Compliance der Organisation und die geografischen oder regionalen Grenzen. Weitere Informationen finden Sie unter Informieren Sie sich über die Berechtigungen von Teams-Apps und die Informationen, auf die sie zugreifen.

Anforderungen

Einen Agenten mit dem Microsoft Teams-Kanal verbinden

Nachdem Sie Ihren Agenten mindestens einmal veröffentlicht haben, können Sie ihn mit dem Microsoft Teams-Kanal verbinden, damit Benutzende in Teams mit ihm chatten können.

Anmerkung

Wir empfehlen Ihnen die Aktivierung der Sicherheitseinstellungen für Agenten, die für Teams oder zur internen Mitarbeiterverwendung entwickelt wurden, um zu verhindern, dass Menschen, die nicht zu Ihrer Organisation gehören, diese Agenten verwenden.

  1. Öffnen Sie das Konfigurationsfenster für den Microsoft Teams Kanal.

  2. Wählen Sie Teams aktivieren aus.

    Screenshot des Konfigurationsbereichs für den Microsoft Teams-Kanal im Anfangszustand mit der verfügbaren Schaltfläche „Teams aktivieren“.

    Anmerkung

    Wenn Sie diese Option nicht sehen, ist der Microsoft Teams-Kanal bereits aktiviert.

Das Erscheinungsbild eines Agenten für Teams anpassen

Es ist wichtig, Agenten die richtige Beschreibung und das richtige Erscheinungsbild zu geben, bevor sie anderen Benutzenden zur Verfügung gestellt werden, da sie darüber mehr über den Zweck und ggf. das Branding des Agenten erfahren.

  1. Öffnen Sie das Konfigurationsfenster für den Microsoft Teams Kanal.

  2. Wählen Sie Details bearbeiten aus, um das Symbol, die Farbe und die Beschreibungen des Agenten zu ändern. Diese Attribute werden im Teams-App-Store und auf der Registerkarte Info der App angezeigt, nachdem der Benutzende den Agenten installiert hat. Lesen Sie die Leitlinien zum App-Symbolformat für Teams durch.

    Wichtig

    Änderungen an den Details eines Agenten stehen Benutzenden, die ihn bereits über einen freigegebenen Link oder den Abschnitt Agenten-Erweiterungen des Teams-App-Stores installiert haben, nicht zur Verfügung. Benutzende müssen den Agenten neu installieren, um die Updates zu erhalten.

    Agenten, die bereits von einer Administrationsfachkraft genehmigt wurden, müssen erneut zur Genehmigung eingereicht werden.

  3. Wählen Sie Mehr aus, um folgenden Informationen hinzuzufügen:

    • Entwicklername
    • Website
    • Datenschutzrichtlinie
    • Nutzungsbedingungen

    Sie sollten diese Informationen bereitstellen, um Ihre Benutzenden über Ihren Agenten zu informieren. Weitere Informationen finden Sie unter Datenbestimmungen und Nutzungsbedingungen in Microsoft Teams erstellen.

  4. Wählen Sie Speichern. Ihre Änderungen an Farbe, Symbol und Kurzbeschreibung werden jetzt im Konfigurationsfenster angezeigt.

Anmerkung

Die Symbolanpassung in diesem Abschnitt gilt nur für den Agenten-Avatar für Agenten, die von der Administrationsfachkraft genehmigt wurden und gilt nicht für Benutzenden, die den Agenten über einen Installationslink oder aus dem Teams-App-Store im Abschnitt Agenten-Erweiterungen direkt installieren. Sie können den Agenten-Avatar unter Das Erscheinungsbild des Agenten anpassen ändern.

Einen Agenten als App in Teams installieren

Nachdem Sie einen Agenten veröffentlicht haben, können Sie ihn direkt von Copilot Studio aus zu Ihrem eigenen Teams-Profil hinzufügen.

Wichtig

Neue Inhalte in einem neu veröffentlichten Agenten werden in derzeit laufenden Unterhaltungen nicht angezeigt.

Geben Sie „Neu starten“ in eine vorhandene Unterhaltung ein, um sofort eine neue Unterhaltung zu starten und die neuesten Updates für den Agenten zu sehen.

Wir empfehlen, Ihren Agenten zunächst zu Ihrem eigenen Profil in Teams hinzuzufügen, bevor Sie ihn mit anderen teilen.

  1. Öffnen Sie das Konfigurationsfenster für den Microsoft Teams Kanal.

  2. Wählen Sie Agenten öffnen aus, um die Installationsaufforderung in Teams zu starten. Wählen Sie Hinzufügen, um ihn als App in Teams hinzuzufügen. Durch diesen Vorgang wird der Agent nur für Sie installiert.

  1. Öffnen Sie das Konfigurationsfenster für den Microsoft Teams Kanal.

  2. Wählen Sie Verfügbare Optionen aus.

  3. Wählen Sie Link kopieren aus.

  4. Geben Sie den Link an andere Benutzende frei, damit sie den Agenten in Teams installieren können.

Wichtig

Nur Benutzende, die auf den Agenten zugreifen können, können den Installationslink verwenden, um den Agenten zu installieren. Sie können den agenten freigeben, um Benutzenden Zugriff auf ihn zu gewähren.

Es ist nicht möglich, einen Installationslink in der mobilen Teams-App zu verwenden. Um sicherzustellen, dass Ihr Agent für mobile Teams-Benutzende verfügbar ist, konfigurieren Sie ihn so, dass er im Teams-App-Store angezeigt wird.

Einen Agenten im Teams-App-Store anzeigen

Sobald Sie Ihren Agenten veröffentlicht haben, können Sie ihn im Teams-App-Store anzeigen, damit Benutzende ihn finden und installieren können.

Für geteilte Benutzer anzeigen

Sie können Ihren Agenten freigeben, indem Sie ihn zum Abschnitt Agenten-Erweiterungen des Teams-App-Stores hinzufügen. Nur freigegebene Benutzende können den Agenten dort finden.

Wichtig

Nur freigegebene Benutzende können den Agenten im Abschnitt Agenten-Erweiterungen des Teams-App-Stores finden und installieren. Der Agent wird nicht für alle in der Organisation angezeigt, selbst wenn er so konfiguriert ist, dass jeder ihn verwenden kann. Um den Agenten der Organisation anzuzeigen, senden Sie ihn zur Genehmigung an die Administration, damit er im Abschnitt Für Ihre Organisation entwickelt im Teams-App-Store angezeigt wird.

Ein Agent kann nur dann im Abschnitt Agenten-Erweiterungen des Teams-App-Stores erscheinen, wenn die Gesamtzahl der freigegebenen Benutzenden die durch die Ermittlungsrichtlinie für den Teams-App-Store für Ihren Mandanten festgelegten Grenzwerte nicht überschreitet. Um Ihren Agenten einer größeren Anzahl von Benutzenden zur Verfügung zu stellen, arbeiten Sie mit Ihren Administrierenden zusammen, um den Agenten für die ganze Organisation anzuzeigen.

  1. Öffnen Sie das Konfigurationsfenster für den Microsoft Teams Kanal.

  2. Wählen Sie Verfügbare Optionen aus.

  3. Wählen Sie Meinen Teamkollegen anzeigen und überprüfen Sie, wer Zugriff auf den Agenten hat.

  4. Bestätigen Sie, dass das Kontrollkästchen In Agenten-Erweiterungen sichtbar aktiviert ist und wählen Sie Freigeben aus.

    Ihr Agent wird im Abschnitt Agenten-Erweiterungen des Teams-App-Stores verfügbar und auf der Seite mit den Verfügbarkeitsoptionen wird die grüne Beschriftung Zu Teams hinzugefügt angezeigt.

Anmerkung

Wenn Ihre App nicht im Abschnitt Agenten-Erweiterungen angezeigt wird, speichert Ihre Teams-App möglicherweise Informationen in einem Zwischenspeicher.

Versuchen Sie, sich ab- und wieder anzumelden (wenn Sie die Teams-Desktop-App verwenden) oder Ihren Browser zu aktualisieren (wenn Sie die Team-Web-App verwenden).

Einen Agenten aus dem Abschnitt „Agenten-Erweiterungen“ entfernen

Sie können einen Agenten aus dem Abschnitt Agenten-Erweiterungen entfernen. Es wirkt sich nicht auf die Benutzenden, die den Agenten installiert haben, aus, wenn Sie ihn hieraus entfernen.

  1. Öffnen Sie das Konfigurationsfenster für den Microsoft Teams Kanal.

  2. Wählen Sie Verfügbare Optionen aus.

  3. Wählen Sie Für meine Teamkollegen anzeigen aus, und deaktivieren Sie das Kontrollkästchen Sichtbar in Agent-Erweiterungen .

  4. Wählen Sie Teilen aus. Der Agent wird nicht mehr im Abschnitt Agenten-Erweiterungen des Teams-App Store angezeigt.

Der Organisation anzeigen

Sie können einen Agenten an Ihre Organisation freigeben, indem Sie ihn zur Genehmigung durch die Administrierenden einreichen, woraufhin er im Teams-App Store im Abschnitt Für Ihre Organisation entwickelt angezeigt wird. Ihre App in Für Ihre Organisation entwickelt zu präsentieren, ist eine großartige Möglichkeit, um dafür zu sorgen, dass Ihr Agent von vielen anderen übernommen wird. Arbeiten Sie mit Ihrer Administration zusammen, damit er allen in der Organisation oder bestimmten Benutzenden bereitgestellt wird.

Administrierende können auch App-Einrichtungsrichtlinien verwenden, um einen Agenten für Benutzende in der Organisation automatisch zu installieren und anzuheften, sodass sie direkt von ihrer App-Leiste in Teams darauf zugreifen können.

Stellen Sie Folgendes sicher, bevor Sie den Agenten an Ihre Organisation senden:

  • Der Agent ist für die Veröffentlichung bereit und erfüllt die Standards, Regeln und Richtlinien des Unternehmens.
  • Du stimmst dich mit anderen Agent Managern ab. Nachdem Sie einen Agenten eingereicht haben, können ihn andere Benutzende nicht erneut einreichen, solange die Administration die vorherige Einreichung nicht genehmigt oder abgelehnt hat.
  • Sie entfernen den Agenten gegebenenfalls aus dem Abschnitt Agenten-Erweiterungen des Teams-App-Stores. Ist dies nicht geschehen, könnte Ihr Agent möglicherweise an zwei Stellen angezeigt werden, wenn Sie ihn zur Genehmigung bei der Administration einreichen.

Anmerkung

Sobald ein Agent von der Administration genehmigt wurde, wird die Verfügbarkeit des Agenten im Abschnitt Für Ihre Organisation vollständig von Ihrer Administration verwaltet. Nur eine Administrationsfachkraft kann den Agenten aus dem Abschnitt Für Ihre Organisation entwickelt entfernen.

Einen Agenten für den Abschnitt „Für Ihre Organisation entwickelt“ einreichen

  1. Öffnen Sie das Konfigurationsfenster für den Microsoft Teams Kanal.

  2. Wählen Sie Verfügbare Optionen aus.

  3. Vergewissern Sie sich, dass der Agent anderen Teammitgliedern oder freigegebenen Benutzenden nicht angezeigt wird. Entfernen Sie es, wenn es heißt Zu Teams hinzugefügt.

  4. Wählen Sie Jedem in meiner Organisation anzeigen.

  5. Überprüfen Sie die Anforderungen für die Einreichung, und wählen Sie Für Administratorgenehmigung übermitteln aus.

    Notiz

    Stellen Sie sicher, dass Sie den Inhalt überprüfen und dass ein Administrator ihn überprüfen kann. Sie müssen eine neue Genehmigungsanforderung einreichen, um für zuvor genehmigte Agenten das Symbol und die Beschreibungen zu aktualisieren.

    Nach der Genehmigung erhalten alle neuen und vorhandenen Benutzenden des Agenten in Teams das Update.

    Dies gilt nur für die Agentendetails. Sie können weiterhin Inhaltsaktualisierungen an Ihrem Agenten vornehmen und ihn beliebig oft veröffentlichen. Sie müssen Ihren Agenten nach der Veröffentlichung solcher Inhaltsänderungen nicht erneut zur Genehmigung einreichen.

    Eine endgültige Bestätigungsaufforderung erscheint.

  6. Wählen Sie Ja aus, um fortzufahren. Der Agent wird an die Administration zur Genehmigung gesendet, und Sie sehen einen Hinweis über den Status Ihrer Einreichung.

    Anmerkung

    Nachdem Sie den Agenten zur Genehmigung durch die Administration eingereicht haben, sollten Sie die Zugriffseinstellung des Agenten nicht so ändern, dass sie geringer ist als die aller Personen in Ihrer Organisation.

    Wird die Einstellung auf weniger als alle Personen gesetzt, können Benutzende in der Organisation nach der Agenteninstallation über den Abschnitt Für Ihre Organisation entwickelt des Teams-App-Store nicht mehr mit dem Agenten chatten.

    Arbeiten Sie mit Ihrer Administration an der Microsoft Teams App-Richtlinie, um zu bestimmten, wer den Agenten finden und installieren darf.

  7. Sie müssen auf die Genehmigung Ihrer Administration warten. Sie können den neuesten Status überprüfen, indem Sie Aktualisieren auswählen oder das Fenster Agenten für andere verfügbar machen auf der Seite Veröffentlichen öffnen.

  8. Nachdem die Administration den Agenten genehmigt hat, wird der Status auf Genehmigt aktualisiert. Sie können den Agenten direkt öffnen und den Link der genehmigten Version für andere Benutzende freigeben.

  9. Bitten Sie andernfalls Ihre Administrierenden App-Einrichtungsrichtlinien verwenden, um einen Agenten für Benutzende in der Organisation automatisch zu installieren und anzuheften, sodass sie direkt von ihrer App-Leiste in Teams darauf zugreifen können.

Anmerkung

Wenn Ihre App nicht im Abschnitt Für Ihre Organisation entwickelt angezeigt wird, obwohl sie als Genehmigt markiert ist, speichert Ihre Teams-App möglicherweise Informationen in einem Zwischenspeicher.

Versuchen Sie, sich ab- und wieder anzumelden (wenn Sie die Desktop-App verwenden) oder Ihren Browser zu aktualisieren (wenn Sie die Team-Web-App verwenden).

Benutzenden erlauben, in Teams einen Agenten hinzuzufügen

Benutzende können in Teams einen Agenten einem spezifischen Team hinzufügen. Sobald der Agent für ein Team verfügbar ist, können Teammitglieder ihn in allen Teamkanälen „@erwähnen“ und alle Teamkollegen sehen die Antworten des Agenten. Dieses Feature ist beispielsweise in den folgenden Situationen nützlich:

  • Ihr Agent unterstützt die Zusammenarbeit, z. B. das Teilen der neuesten Erkenntnisse aus dem Vertriebsbericht mit dem Rest des Vertriebsteams.
  • Sie möchten allen Teammitglied ermöglichen, mit dem Agenten in einem Teamkanal oder über einen privaten Chat zu interagieren, ohne ihn selbst manuell installieren zu müssen.

Zwei Optionen bestimmen, ob Benutzende einem Team, dem sie angehören, oder zu Gruppen- und Besprechungschats in Teams einen Agenten hinzufügen können. Wenn diese Optionen ausgewählt sind, hat der Agent Zugriff auf den Unterhaltungsverlauf aus dem Teamkanal, Gruppenchat oder Besprechungschat, was dem Agenten hilft, Antworten zu geben, die besser zum Kontext der Unterhaltung passen.

Wenn Benutzende einen Agenten aus dem Teams-App-Store oder mithilfe des Installationslinks installieren, wird ihnen je nach dem von Ihnen für den Agenten festgelegten Umfang der Zusammenarbeit eine der folgenden Optionen angezeigt:

  • Den Agenten einem Team-Kanal hinzufügen
  • Den Agenten zu Gruppen- und Besprechungschats in Teams hinzufügen

Teammitglieder können auch den Agenten aus einem Team entfernen.

Wichtig

Der Agent sollte so konfiguriert sein, dass alle in der Organisation mit ihm chatten können. Dadurch wird sichergestellt, dass alle Teammitglieder die Berechtigung haben, mit dem Agenten zu chatten. Wir empfehlen, die Sicherheitseinstellungen des Agenten nach der Aktivierung dieser Funktion nicht mehr zu ändern. Andernfalls werden Benutzenden möglicherweise Berechtigungsfehler angezeigt, wenn sie versuchen, mit dem Agenten in Teams-Kanälen oder Gruppenchats zu interagieren.

Sie können Benutzenden wie folgt erlauben, einem Team einen Agenten hinzuzufügen:

  1. Öffnen Sie das Konfigurationsfenster für den Microsoft Teams Kanal.

  2. Wählen Sie Details bearbeiten.

  3. Wählen Sie Benutzenden erlauben, diesen Agenten einem Team hinzuzufügen.

  4. Wählen Sie Speichern.

Teams speichert Informationen zwischen, sodass es eine Weile dauern kann, bis Benutzende die Option zum Hinzufügen des Agenten zu einem Team oder Gruppenchat sehen. Benutzende können den Browser aktualisieren (oder sich im Teams-Desktop-Client ab- und wieder anmelden), um die neuesten Änderungen zu erhalten.

Wenn Sie den Agenten bereits zur Genehmigung durch die Administration eingereicht haben, müssen Sie ihn nach dem Aktivieren dieser Option erneut einreichen. Die Administration muss Ihre Änderungen genehmigen, bevor Benutzende den Agenten vom Abschnitt Von Ihrer Organisation entwickelt des Teams-App-Store ihren Teams hinzufügen können.

Benutzenden das Hinzufügen eines Agenten zu einem Team oder zu Gruppen- und Besprechungschats verbieten

Das Deaktivieren dieser Option verhindert, dass Benutzende einen Agenten einem neuen Team-, Gruppen- oder Besprechungschat hinzufügen. Wenn Sie einer Unterhaltung bereits einen Agenten hinzugefügt haben, wird dieser durch das Deaktivieren dieser Option nicht entfernt. Sie müssen den Agenten manuell entfernen.

Gehen Sie wie folgt vor, wenn Sie verhindern wollen, dass Benutzende einem Team einen Agenten hinzufügen:

  1. Öffnen Sie das Konfigurationsfenster für den Microsoft Teams Kanal.

  2. Wählen Sie Details bearbeiten.

  3. Deaktivieren Sie das Kästchen Benutzenden erlauben, diesen Agenten einem Team hinzuzufügen.

  4. Wählen Sie Speichern.

Verhalten für private Begrüßungen konfigurieren

Private Begrüßungen von einem Agenten sind nützlich, wenn Sie möchten, dass Teammitglieder Einzelgespräche mit dem Agenten führen können, ohne ihn selbst manuell installieren zu müssen.

Anmerkung

Die Konfiguration privater Begrüßungen ist nur für klassische Chatbots verfügbar.

Wenn diese Option aktiviert ist, beginnt Ihr Agent automatisch eine Unterhaltung mit Teammitgliedern. Um die Begrüßungsnachricht des Agenten anzupassen, ändern Sie das Begrüßungssystemthema.

Überlegen Sie, wie relevant der Agent für die Teammitglieder ist. Stellen Sie sicher, dass die Begrüßung des Agenten den Benutzenden hilft, zu verstehen, was sie mit dem Agenten tun können, welche Einschränkungen er hat und dass sie sich vor allem bei der Interaktion mit ihm wohlfühlen.

So konfigurieren Sie, wann ein Agent eine private Begrüßung senden soll:

  1. Öffnen Sie das Konfigurationsfenster für den Microsoft Teams Kanal.

  2. Wählen Sie Einstellungen aus.

  3. Konfigurieren Sie die Optionen für private Begrüßungen.

  4. Wählen Sie Speichern.

Teams-App-Manifest für einen Agenten herunterladen (erweitert)

Sie können das Teams-App-Manifest des Agenten herunterladen, um detaillierte Änderungen direkt am Manifest vorzunehmen und es mit Ihrer Administration oder den Benutzenden im Mandanten zu teilen. Sie können ein App-Manifest auch direkt in Teams hochladen, wenn die Richtlinien Ihrer Organisation zulassen, dass Sie benutzerdefinierte Anwendungen hochladen.

  1. Öffnen Sie das Konfigurationsfenster für den Microsoft Teams Kanal.

  2. Wählen Sie Verfügbare Optionen aus.

  3. Wählen Sie .zip herunterladen.

    Das Manifest wird als ZIP-Datei generiert und gemäß den Speichereinstellungen des Browsers gespeichert.

Agenten von Teams trennen

Sie können Ihren Agenten offline schalten, damit Benutzende in Teams nicht mehr mit ihm chatten können. Wenn Ihr Agent offline ist, reagiert er auf niemanden, der versucht, mit ihm zu chatten. Sie sollten gründlich überlegen, ob Sie Ihren Agenten trennen müssen, bevor Sie es tun.

Getrennte Agenten werden nicht im Abschnitt Agenten-Erweiterungen des Teams-App-Stores angezeigt und können nicht über einen freigegebenen Link installiert werden. Wenn Benutzende bereits einen solchen Agenten in Teams installiert haben, bleibt er verfügbar, bis die Benutzenden ihn deinstallieren.

Nachdem Sie eine Agenten-Verbindung getrennt haben, die von der Administration genehmigt wurde, erscheint sie weiterhin im Abschnitt Für Ihre Organisation entwickelt des Teams-App Stores. Sie müssen Ihre Administration bitten, ihn zu entfernen.

  1. Öffnen Sie das Konfigurationsfenster für den Microsoft Teams Kanal.

  2. Wählen Sie Von Teams trennen.

  3. Überprüfen Sie die Informationen zum Trennen Ihres Agenten und wählen Sie Trennen aus, um fortzusetzen.

Sie können Ihren Agenten jederzeit wieder verbinden, indem Sie Teams aktivieren in dem Fenster Den Agenten für andere verfügbar machen auf der Seite Veröffentlichen wählen.

Öffnen Sie das Konfigurationsfenster für den Microsoft Teams Kanal

  1. Öffnen Sie Ihren Agenten in Copilot Studio.

  2. Wählen Sie auf der obersten Menüleiste Kanäle aus.

  3. Wählen Sie die Kachel Microsoft Teams. Die Seite Konfigurationsbereich wird angezeigt.

Bekannte Einschränkungen