Connexion à Microsoft Teams

Aperçu

Microsoft Teams est une puissante plateforme de communication et de collaboration. Il regroupe le chat, les réunions, le partage de fichiers et l'intégration d'applications dans un espace de travail unifié. En connectant votre agent à Microsoft Teams, vous pouvez créer un hub centralisé où les utilisateurs peuvent interagir avec votre agent afin de rationaliser les flux de travail, d'automatiser les tâches et d'améliorer la productivité.

Avant de commencer

Les conditions suivantes doivent être remplies avant de commencer l'intégration :

Pour connecter votre agent à Microsoft Teams, vous devez :

Enregistrez votre application dans Microsoft Azure
Créez votre robot
Créer une application pour l' Microsoft Teams

Procédure

Pour vous connecter à Microsoft Teams, procédez comme suit :

Accédez à la page de configuration de l'agent.
Naviguez vers Channels > Teams.
Sélectionnez l'environnement (Draft ou Live) et cliquez sur Créer un nouveau.
Passez en revue les instructions de la page de démarrage et cliquez sur Suivant.
Consultez les instructions de la section « Enregistrement de l'application ».
Saisissez l 'ID de l'application (client), l'ID du tenant et la clé secrète du client indiqués sur la page d'enregistrement de l'application.
Cliquez sur Suivant.
Vérifiez et complétez les étapes liées à la création de votre bot sur la page Configurer l' Microsoft Teams. Pour plus d'informations, reportez-vous à la section Créer un robot.
Copiez le champ « Point de terminaison de messagerie » situé sous « ID du locataire ». Passez à l'étape 7 de la section « Créer votre bot » et collez-le.
Vérifiez et effectuez les étapes liées à la création de votre application Teams sur la page Configurer l' Microsoft Teams. Pour plus d'informations, reportez-vous à la section Création de l'application Équipes.
Cliquez sur Terminer pour achever la configuration.

Vous pouvez consulter les environnements d' Microsoft Teams s qui sont correctement connectés sous les environnements respectifs. Cliquez sur le bouton du menu déroulant pour modifier ou supprimer l' Microsoft Teams s de cet environnement d'agent.

Enregistrez votre application dans Microsoft Azure

Connectez-vous au portail Microsoft Azure à l'aide de vos identifiants d'administrateur.
Accédez à Inscriptions aux applications > Nouvelle inscription.
Sur la page Enregistrer une demande, entrez un nom, choisissez le type de locataire approprié et cliquez sur Enregistrer.
Depuis la page « Aperçu » de votre application, copiez les valeurs de l'ID d'application (client) et de l'ID de répertoire (locataire). Copiez-collez la valeur de l'identifiant d'application (client) dans votre configuration d' watsonx Orchestrate Microsoft Teams.
Accédez à Gérer > Certificats et secrets pour créer un secret client pour cette même application. Dans l'onglet « Secrets client », cliquez sur « Nouveau secret client » pour créer un nouveau secret client. Copiez et enregistrez la valeur.

Créez votre robot

Remarque :

IBM Cette politique limite l'accès aux services de bot lorsque vous utilisez un compte développeur E5. Ces services ne sont compatibles qu'avec les comptes Azure non approuvés par l' IBM. Les comptes personnels (par exemple : Gmail ou Outlook) ne sont pas éligibles à l'accès à la version « E5 » ou supérieure. Seuls les comptes d'entreprise sont éligibles. Les développeurs peuvent également acheter une licence pour obtenir l'accès nécessaire.

Connectez-vous au portail Microsoft Azure. Utilisez vos identifiants d'administrateur.
Dans la liste des services d' Azure, sélectionnez « Bot Services », puis cliquez sur « Créer » pour créer un nouveau bot. Sélectionnez l 'abonnement et la formule « Azure ». Si ce n'est pas le cas, vous devez créer un abonnement à Azure.
Indiquez le nom d'utilisateur du bot, l'abonnement et le groupe de ressources. Si vous ne disposez pas d'un groupe de ressources, vous devez en créer un. Pour créer un nouveau groupe de ressources, cliquez sur « Vérifier + créer ».
Dans le type Création, sélectionnez « Utiliser l'enregistrement d'application existant ». Dans le champ « App ID », collez la valeur de l'identifiant client enregistrée précédemment. Dans le champ « ID du tenant de l'application », collez la valeur de l'ID du tenant que vous avez enregistrée précédemment. Cliquez sur « Vérifier + Créer ».
Cliquez sur Créer.
Accédez à Paramètres > Configuration > Point de terminaison de messagerie, puis collez le point de terminaison généré que vous avez copié depuis la page « Créer votre bot » de votre configuration watsonx Orchestrate Microsoft Teams. Cliquez sur « Appliquer ».
Pour connecter le bot à Microsoft Teams, rendez-vous dans « Channels » et sélectionnez « Microsoft Teams ». Dans l'onglet « Messagerie », sélectionnez « Microsoft Teams Commercial », puis cliquez sur « Appliquer ».

Créer une application pour l' Microsoft Teams

Rendez-vous sur le portail des développeurs d' Microsoft Teams, puis connectez-vous à l'aide de vos identifiants d'administrateur.
Cliquez sur Applications > Créer une nouvelle application.
Saisissez le nom de votre application et cliquez sur Ajouter.
Dans la section « Informations de base », remplissez tous les champs obligatoires. Copiez-collez votre identifiant d'application (App ID), obtenu à l'étape 4 de la procédure d'enregistrement de votre application, dans le champ « Application (client) ID ».
Cliquez sur Sauvegarder.
Sélectionnez Configure > App features > Bot.
Accédez à la section « Identifier votre bot ». Dans le champ « Saisir un identifiant de bot », collez la valeur de l'identifiant client créé à l'étape 4 de l'enregistrement de votre application.
Sous Sélectionner la portée dans laquelle les personnes peuvent utiliser cette commande, sélectionnez Personnel, Équipe et Discussion de groupe.
Cliquez sur « Enregistrer », puis publiez votre bot.
Cliquez sur « Télécharger le package de l'application » pour télécharger le fichier ZIP.
Rendez-vous sur Microsoft Teams et cliquez sur « Apps ».
Sur la page « Applications », cliquez sur « Télécharger une application » et téléchargez le fichier ZIP téléchargé à l'étape 10.
Cliquez sur le menu déroulant (...) et recherchez l'application que vous avez ajoutée. Vous pouvez désormais communiquer avec un agent d' watsonx Orchestrate via Microsoft Teams.

Pour actualiser votre session dans l' Microsoft Teams, consultez la section « Actualiser votre session ».

Actualiser votre session dans l' Microsoft Teams

Vous pouvez actualiser votre session de conversation dans Teams à tout moment pour effacer l'ancien contexte et repartir à zéro. Cela s'avère utile si le bot est désorienté, bloqué ou si vous souhaitez simplement entamer une nouvelle tâche.

Comment actualiser votre session

Si vous souhaitez réinitialiser votre conversation ou effacer l'historique, vous pouvez actualiser votre session en utilisant l'une des options ci-dessous.

Option 1 : Utiliser une commande de chat

Dans n'importe quelle conversation Teams avec le bot, tapez :

/refreshSession

Cela efface immédiatement votre session en cours et réinitialise le contexte de la conversation.

Option 2 : Utiliser l'option via l'interface utilisateur

Vous pouvez utiliser l'option disponible dans l'interface utilisateur pour actualiser une session. Pour activer cette fonctionnalité, vous devez d'abord définir une extension de composition dans le manifeste de votre application Teams. Une fois activé, ce composant d'interface utilisateur offre un moyen supplémentaire d'actualiser la session. Comme ce processus repose sur l'identification d'une session existante, un message doit d'abord être envoyé; si aucune session active n'est détectée, l'utilisateur en sera informé.

"composeExtensions": [
  {
    "botId": "d1b6b6b7-7ae3-4c51-b05e-1316b7ff5c41",
    "commands": [
      {
        "id": "refreshSession",
        "botId": "d1b6b6b7-7ae3-4c51-b05e-1316b7ff5c41", 
        "type": "action",
        "title": "Refresh Session",
        "description": "Refresh the conversation session's context",
        "initialRun": false,
        "fetchTask": false,
        "context": [
          "commandBox",
          "compose"
        ]
      }
    ]
  }
]

Pour « botId », utilisez l'identifiant de bot Microsoft correspondant, disponible dans le manifeste de l'application.

Une fois cette configuration effectuée, l'option « Actualiser la session » apparaît dans la barre supérieure lorsque vous tapez :

/YOUR_APP_NAME

Remarque :

L'actualisation de la session s'effectue automatiquement. Aucune configuration n'est requise. Votre session actuelle se poursuivra normalement jusqu'à ce que vous décidiez de la rafraîchir.

Etape suivante

Pour ajouter des variables de contexte spécifiques au canal pour l' Microsoft Teams, suivez les instructions fournies dans Variables de contexte Teams.