Microsoft Teams
Ein Teams-Bot verbindet einen Agenten mit einem Bot aus deinem Teams Developer Portal. Die Leute in deiner Organisation schreiben dem Agenten dann direkt in Microsoft Teams, im 1:1-Chat.
Voraussetzungen
- Ein Bot aus dem Teams Developer Portal. Ein Azure-Abo brauchst du nicht.
- Ein Konto, das im Microsoft-Tenant Apps anlegen darf. Der Tenant ist die Microsoft-Umgebung deiner Organisation.
- Jemand, der in Teams eigene Apps hochladen darf.
- Ein Agent auf Workspace und ohne eingeschränkten Zugriff, siehe Teilen und Zugriff. Steht für den Agenten ein Preisangebot offen, lässt er sich nicht verbinden.
- Das Recht zu bauen (Rolle Admin oder die frühere Rolle Entwickler). Nur wer bauen darf, sieht den Tab Teams-Bots. Auf dem Handy fehlt der Tab.
Bot verbinden
- Öffne über das Benutzermenü Verbindungen und dort den Tab Teams-Bots.
- Klicke auf Agent mit Teams verbinden. Gibt es schon einen Bot, heißt der Knopf Verbinden.
- Lege im Teams Developer Portal mit + New Bot einen Bot an.
- Trage seine App-ID im Dialog in das Feld App-ID des Bots ein.
- Trage die Adresse, die der Dialog dann zeigt, im Portal unter Configure als Endpoint ein.
- Lege im Portal unter Client secrets ein Secret an. Das Portal zeigt den Wert nur einmal.
- Trage das Secret in das Feld Secret ein.
- Trage die Tenant-ID ein. lowcloud sucht sie über deine Mail-Domain, du kannst sie auch direkt eintragen.
- Wähle den Agenten, der in Teams antworten soll.
- Klicke auf Verbinden.
lowcloud prüft die Zugangsdaten bei Microsoft und speichert erst danach. Das Secret wird verschlüsselt gespeichert. Eine App-ID lässt sich nur einmal verbinden.
App in Teams hochladen
- Klicke auf der Karte des Bots auf Paket laden. Das App-Paket wird heruntergeladen.
- Lade das Paket in Teams hoch: Apps > Apps verwalten > App hochladen > Benutzerdefinierte App hochladen.
Ist der Knopf in Teams gesperrt, lädt eure IT die Datei im Teams Admin Center hoch.
Dem Agenten in Teams schreiben
Nach dem Hochladen kann jeder im Tenant dem Agenten schreiben. Sobald die erste Nachricht angekommen ist, zeigt die Karte des Bots die Links Für Kolleginnen und Kollegen installieren und Chat in Teams öffnen. Wer die App installiert, bekommt eine Begrüßung mit Namen und Beschreibung des Agenten und bis zu drei Conversation Starters.
Der Bot antwortet nur im Tenant, den du eingetragen hast. Auf einzelne Personen oder Sicherheitsgruppen begrenzt euer Teams-Administrator die App im Teams Admin Center unter Apps verwalten > Verfügbar für. lowcloud führt dafür keine eigene Liste.
Bot ändern oder entfernen
- Testen: prüft, ob Microsoft für die gespeicherten Zugangsdaten noch ein Token ausstellt.
- Stift-Symbol: öffnet Teams-Bot bearbeiten. Dort wählst du einen anderen Agenten oder trägst unter Neues Secret ein neues Secret ein.
- Trennen: entfernt den Bot. Er antwortet danach in Teams nicht mehr. Die App bleibt in Teams installiert, bis jemand sie dort entfernt.
Änderst du Name, Beschreibung oder Logo, lädst du ein neues Paket herunter und aktualisierst damit die App in Teams.
Stellst du den Agenten auf Privat, schränkst seinen Zugriff ein oder löschst ihn, bleibt der Bot verbunden. Er antwortet in Teams dann nur noch, dass er keinem Agenten zugeordnet ist.
Funktionen in Teams
| Thema | In Teams |
|---|---|
| Ort | Nur der 1:1-Chat mit dem Bot. In Gruppenchats und Kanälen antwortet er nicht. |
| Eingabe | Nur Text. Dateien und Bilder liest der Agent nicht. Auf eine Nachricht ohne Text antwortet er, dass er nur Text lesen kann. |
| Wissen | Die Dokumente des Agenten und die Buckets, die er lesen darf. Das globale Wissen kommt dazu, wenn Wissen nutzen an ist. |
| Skills | Nur die angehängten Skills. Alle Skills nutzen gilt in Teams nicht. |
| Modell | Das Modell, das der Agent gepinnt hat, sonst das Standardmodell des Workspace. Eine Modellauswahl gibt es in Teams nicht. |
| Verlauf | Eine Person hat mit einem Bot genau eine Unterhaltung. Der Agent bekommt die jüngsten Nachrichten mit, bis zu 60.000 Zeichen. |
| Nicht verfügbar | Eigene Integrationen, MCP-Werkzeuge und Subagenten. |
Werkzeuge, Freigaben und Kosten
Was der Agent in Teams darf, hängt davon ab, ob die Person zugeordnet ist. Zugeordnet ist, wer Mitglied des Workspace ist und dort unter Verbindungen das Microsoft-Konto verbunden hat, mit dem er in Teams angemeldet ist. Haben zwei Mitglieder dasselbe Konto verbunden, gilt keine Zuordnung.
| Ohne Zuordnung | Mit Zuordnung | |
|---|---|---|
| Werkzeuge | Nur lesende Werkzeuge, die kein verbundenes Konto brauchen, zum Beispiel die Web-Suche. | Zusätzlich die Werkzeuge des Agenten auf den verbundenen Konten dieser Person. |
| Schreiben | Nicht möglich. Der Agent speichert, versendet und ändert nichts. | Jede schreibende Aktion wartet auf einer Karte mit Freigeben und Ablehnen, auch wenn die Freigabe am Agenten abgeschaltet ist. |
| Kosten | Gebucht auf die Person, die den Bot verbunden hat. | Gebucht auf die Person, die schreibt. Es gilt ihr Monatslimit. |
Eine Karte bleibt 24 Stunden offen. Eine neue Nachricht im selben Chat ersetzt sie. Freigeben kann nur die Person, die gefragt hat.
Jede Antwort verbraucht Guthaben des Workspace. Ist das Guthaben oder ein Monatslimit aufgebraucht, sagt der Agent das in Teams.
Datenverarbeitung
Nachrichten in Teams laufen über das Bot Framework von Microsoft. Microsoft garantiert dafür keine Verarbeitung ausschließlich in der EU. Wo die Modelle rechnen, steht unter Souveränität und Modelle.
lowcloud speichert den Verlauf jedes Teams-Chats. Ein Admin kann ihn in der Übersicht des Agenten unter Verlauf öffnen.