Verbindung zu Microsoft Teams herstellen

Online bearbeiten

Microsoft Teams ist ein Chat-basiertes Tool, das Remote-Teams eine gemeinsame Plattform für den Informationsaustausch und die Zusammenarbeit bietet.

Um Microsoft Teams mit IBM watsonx Orchestrate zu integrieren, müssen Sie eine sichere Verbindung herstellen, die eine nahtlose Kommunikation zwischen beiden Systemen ermöglicht. Allgemeine Hinweise zur Verwaltung von Integrationen finden Sie unter „Apps für vorgefertigte Agenten verbinden “.

Wichtig:

Standardmäßig ist Single Sign-On (SSO) für Ihre App deaktiviert. Informationen zur Aktivierung finden Sie unter „Single Sign-On für Anwendungen konfigurieren “.

Schritte zum Verbinden

Führen Sie die folgenden Schritte aus, um eine Verbindung zwischen Microsoft Teams und watsonx Orchestrate herzustellen:

Gehen Sie zu „Verwalten“ > „Verbindungen“ und suchen Sie nach der entsprechenden „ Microsoft Teams “-Verbindungs-ID.
Klicken Sie auf Bearbeiten neben der passenden Verbindungs-ID.
Wählen Sie die von Ihrer Organisation verwendete Authentifizierungsmethode aus ( OAuth2.0, Multi Auth oder Key Value Pair ).
Geben Sie die für „ Microsoft Teams “ spezifischen Felder ein. Allgemeine Informationen zum Verbindungsablauf finden Sie auf der Seite „Apps für vorgefertigte Agenten verbinden “.
Führen Sie die Schritte zum Entwurf und zur Live-Einrichtung durch.
Speichern Sie die Verbindung und testen Sie sie, um sicherzustellen, dass sie erfolgreich hergestellt wurde.

Unterstützte Authentifizierungsmethoden

Microsoft Teams unterstützt die folgenden Authentifizierungstypen in „ watsonx Orchestrate “:

OAuth2 Autorisierungscode : Empfohlen für Produktionsverbindungen
Multi-Authentifizierung : Unterstützt sowohl „ OAuth2 “ (Anmeldecode) als auch „ OAuth2 “ (Client-Anmeldeinformationen)
Schlüssel-Wert-Paar : Unterstützt für API-Schlüssel-basierte und Legacy-Szenarien

Hinweis:

Für Agenten, die nach September 2025 erstellt wurden, ist „ OAuth “ unter 2.0 die einzige unterstützte Authentifizierungsmethode für Microsoft Teams.

Verbindungs-ID

Verwenden Sie die folgenden Verbindungs-IDs, wenn Sie Ihre „ Microsoft Teams “-Verbindung auf der Seite „Verbindungseinstellungen“ suchen. Informationen zum Suchen einer Verbindungs-ID und zum Öffnen einer Verbindung zum Bearbeiten finden Sie unter Verbinden von Apps für vorgefertigte Agenten.


Authentifizierungstyp	Verbindungs-ID
OAuth2 Autorisierungscode	`microsoft_oauth2_auth_code_ibm_184bdbd3`
Multi-Authentifizierung (Autorisierungscode „ OAuth2 “ und Client-Anmeldeinformationen „ OAuth2 “)	`microsoft_ibm_184bdbd3`
Schlüssel/Wert-Paar	`microsoft_key_value_ibm_184bdbd3` (veraltet)

OAuth 2.0 Verbindungsdetails

Wenn Ihr Unternehmen die Authentifizierung über „ OAuth “ verwendet, legen Sie den Authentifizierungstyp auf „ OAuth2 -Autorisierungscode“ fest und füllen Sie die folgenden Felder aus:


Feld	Beschreibung
`Server URL`	Basis- URL des Microsoft-Servers, zum Beispiel `https://graph.microsoft.com`
`Token URL`	Endpunkt zum Austausch des Autorisierungscodes gegen einen Zugriffstoken. Beispiel:`https://login.microsoftonline.com/Tenant_ID/oauth2/v2.0/token`
`Scope`	Geben Sie offline_access an. Definiert die Ebene des beantragten Zugriffs. Sie können durch Leerzeichen getrennt weitere Bereiche hinzufügen. Zum Beispiel,`https://graph.microsoft.com/`
`Authorization URL`	URL wo Benutzer weitergeleitet werden, um sich anzumelden und den Zugriff zu autorisieren. Beispiel:`https://login.microsoftonline.com/Tenant_ID/oauth2/v2.0/authorize`
`Client ID`	Eindeutige ID für Ihre Anwendung (verfügbar in der Microsoft-Benutzeroberfläche)
`Client Secret`	Ein geheimer Schlüssel, der zur Authentifizierung Ihrer App bei Microsoft verwendet wird

Diese Werte finden Sie in der Microsoft-API-Dokumentation.

Multi-Auth-Verbindungsdetails

Legen Sie den Authentifizierungstyp auf „ OAuth2 -Autorisierungscode“ oder „ OAuth2 -Client-Anmeldeinformationen“ fest und füllen Sie die folgenden Felder aus:

OAuth2 Autorisierungscode


Feld	Beschreibung
`server_url`	Basis- URL en zur Microsoft Graphs API. Beispiel:`https://graph.microsoft.com`
`token_url`	Endpunkt zum Austausch des Autorisierungscodes gegen einen Zugriffstoken. Ersetzen Sie TENANT_ID durch Ihre Verzeichnis-ID (Tenant-ID). Beispiel:`https://login.microsoftonline.com/Tenant_ID/oauth2/v2.0/token`
`scope`	Geben Sie offline_access und andere Bereiche nach Bedarf an, getrennt durch Leerzeichen. Der Umfang definiert die angeforderte Zugriffsebene. Zum Beispiel,`https://graph.microsoft.com/`
`authorization_url`	URL wo Benutzer weitergeleitet werden, um sich anzumelden und den Zugriff zu autorisieren. Ersetzen Sie TENANT_ID durch Ihre Verzeichnis-ID (Tenant-ID). Beispiel:`https://login.microsoftonline.com/Tenant_ID/oauth2/v2.0/authorize`
`client_id`	Eine eindeutige Kennung für Ihre Anwendung (verfügbar im Microsoft-Portal)
`client_secret`	Der geheime Schlüssel, der zur Authentifizierung Ihrer App bei Microsoft verwendet wird
`Token request field`	Es wird verwendet, um zusätzliche Parameter einzuschließen, die der Autorisierungsserver beim Austausch eines Codes oder von Anmeldedaten für ein Zugriffstoken benötigt. Sie sind für benutzerdefinierte Implementierungen erforderlich, bei denen der Server zusätzliche Details erwartet, wie beispielsweise einen Bestätigungscode oder eine Ressourcen-ID.
`Auth request field`	Es wird verwendet, um zusätzliche Informationen während des Anmeldeschritts am Autorisierungsendpunkt OAuth bereitzustellen. Sie helfen dem Server dabei, den richtigen Mandanten oder Identitätsanbieter zu identifizieren, und sind für Setups unerlässlich, die benutzerdefinierte Parameter wie `idp` oder `tenant_id`

OAuth2 Anmeldedaten des Kunden


Feld	Beschreibung
`Server URL`	Dies bezieht sich auf die Basis- URL -Adresse des Servers, der die geschützten Ressourcen hostet
`Send Credentials Via`	Geben Sie an, wie die Anmeldedaten gesendet werden sollen (Header oder Body)
`Token URL`	Geben Sie den Wert für den Token- URL relativ zum Server- URL an. Der Token „ URL “ wird in der Regel vom Autorisierungsserver während der Registrierung der Anwendung bereitgestellt
`Client ID`	Eine eindeutige Kennung für die Client-Anwendung. Rufen Sie die Client-ID über die Benutzeroberfläche Ihres Kontos ab
`Client Secret`	Ein geheimer Schlüssel, der nur dem Client und dem Autorisierungsserver bekannt ist
`Grant Type`	Der Grant-Typ ist immer „client_credentials“. Dies gibt den Autorisierungsserver an, bei dem der Client mithilfe des Client Credential Flow ein Zugriffstoken anfordert
`Scope`	Der Geltungsbereich ist eine Möglichkeit, den Zugriff zu beschränken. Es definiert die spezifischen Berechtigungen oder Ressourcen, auf die Zugriff gewährt wird. Beispiel: Lese-/Schreibprofil
`Token request field`	Es wird verwendet, um zusätzliche Parameter einzuschließen, die der Autorisierungsserver beim Austausch eines Codes oder von Anmeldedaten für ein Zugriffstoken benötigt. Sie sind für benutzerdefinierte Implementierungen erforderlich, bei denen der Server zusätzliche Details erwartet, wie beispielsweise einen Bestätigungscode oder eine Ressourcen-ID

Verbindungsdetails für Schlüssel-Wert-Paare

Wenn Ihre Organisation die Authentifizierung auf Basis von „ OAuth “ verwendet, legen Sie den Authentifizierungstyp auf „Schlüssel-Wert-Paar“ fest und fügen Sie jedes der folgenden Felder mit „Neues Feld hinzufügen“ hinzu:


Schlüssel	Beschreibung
`client_id`	Die Client-ID Ihrer registrierten Microsoft-Anwendung
`client_secret`	Das Client-Geheimnis, das mit Ihrer Microsoft-Anwendung verknüpft ist
`username`	Der Benutzername des Teams-Kontos (in der Regel die E-Mail-Adresse)
`password`	Das Passwort für das Teams-Konto oder das app-spezifische Passwort
`authority`	Die Autorität URL für die Authentifizierung, zum Beispiel `https://login.microsoftonline.com`
`base_url`	Die Basis- URL -Datei für Microsoft beispielsweise `https://login.microsoftonline.com`

Diese Werte finden Sie in der Microsoft-API-Dokumentation.

Nächste Schritte

Nachdem die Verbindung zu Ihrer App nun hergestellt ist, können Sie sie in „ watsonx Orchestrate “ nutzen.

Starten Sie einen Agenten in Orchestrate Chat, um Aufgaben mithilfe natürlicher Sprache auszuführen.
Verwenden Sie geeignete Tools, um anwendungsspezifische Aktionen auszuführen.