Envoyer des avis Microsoft Teams à partir d'une base de données autonome avec intelligence artificielle

Décrit comment configurer Microsoft Teams afin que vous puissiez envoyer des messages, des alertes ou la sortie d'une interrogation à partir d'une base de données IA autonome vers un canal Microsoft Teams. Décrit également les procédures que vous utilisez pour envoyer des notifications Microsoft Teams.

Préparer l'envoi d'avis Microsoft Teams à partir d'une base de données autonome sur l'IA

Commencez par configurer un robot dans votre application Microsoft Teams. Créez ensuite des données d'identification à utiliser avec les procédures DBMS_CLOUD_NOTIFICATION pour envoyer des avis Microsoft Teams depuis Autonomous AI Database.

Pour configurer les avis Microsoft Teams :

  1. Créez votre application Microsoft Teams et ajoutez-y un robot. Voir Portail des développeurs pour les équipes pour plus d'informations sur la configuration d'une application.
  2. Dans la section Gestion des robots, assurez-vous que le robot dispose d'une clé secrète, d'une étendue réglée à Équipe et d'une autorisation pour envoyer des avis.
  3. Publiez l'application dans votre organisation pour la mettre à la disposition des personnes de votre organisation.
  4. Une fois que votre administrateur informatique a approuvé l'application à partir du centre d'administration, installez-la à partir de la section Applications dans Teams.
  5. Demandez les autorisations Files.ReadWrite.All et ChannelSettings.Read.All à l'application pour l'API Graph à partir du portail Azure en suivant les instructions suivantes :
    1. Connectez-vous à votre portail Azure, naviguez jusqu'à Azure Active Directory à l'aide du panneau de gauche, puis sélectionnez l'option Application.
    2. La page Application affiche les applications que vous possédez ainsi que les robots ajoutés à ces applications. Cliquez sur le robot pour en voir les détails.
    3. Copiez le répertoire/ID locataire à partir de la page d'aperçu du robot pour une utilisation ultérieure.
    4. Ensuite, allez à Autorisations d'API dans le panneau de gauche. Sous Autorisations d'API, cliquez sur Ajouter une autorisation, sélectionnez Graphique Microsoft, puis Autorisations d'application.
    5. Recherchez les autorisations Files.ReadWrite.All et ChannelSettings.Read.All et ajoutez-les.
  6. Demandez à votre administrateur informatique d'approuver les autorisations demandées ci-dessus à partir du portail Azure en suivant les étapes ci-dessous :
    1. Connectez-vous à votre portail Azure, naviguez jusqu'à Azure Active Directory à l'aide du panneau de gauche, puis sélectionnez l'option Application.
    2. Sélectionnez Toutes les applications dans la page Application.
    3. Recherchez l'application/bot par son nom, allez à Autorisations d'API et accordez le consentement ADMIN pour les autorisations demandées : Files.ReadWrite.All et ChannelSettings.Read.All.

    Conseil :

    Une fois votre application approuvée par l'administrateur informatique, vous pouvez fournir l'ID robot et la clé secrète à d'autres utilisateurs pour installer l'application dans Teams dans l'organisation.
  7. Une fois l'application approuvée par l'administrateur informatique et les autorisations demandées ci-dessus accordées, vous pouvez utiliser l'ID robot de l'application et la clé secrète pour créer l'objet de données d'identification et générer un jeton de robot.
  8. Pour envoyer un résultat d'interrogation à un canal Microsoft Teams, obtenez team id et tenant id.

    Conseil :

    Le team id est situé dans le lien de l'équipe entre /team/ et /conversations. Le tenant id se trouve après "tenantId=" à la fin du lien de l'équipe. Ce lien est trouvé en cliquant sur les trois points à côté du nom de l'équipe et en sélectionnant Obtenir le lien vers l'équipe.

    Exemple :

    https://teams.microsoft.com/l/team/teamID/conversations?groupId=groupid%tenantId=tenantid

  9. Obtenez channelID.

    Conseil :

    channelID se trouve dans la liaison de canal entre /team/ et le nom du canal. Ce lien est trouvé en cliquant sur les trois points à côté du nom du canal et en sélectionnant Obtenir le lien vers le canal.

    Exemple :

    https://teams.microsoft.com/l/channel/channelID/channel_name?groupId=groupid&tenantId=tenantid

  10. Créez un objet de données d'identification pour accéder à l'application Microsoft Teams à partir de Autonomous AI Database.

    Conseil :

    Si vous ne pouvez pas utiliser la procédure CREATE_CREDENTIAL avec succès, consultez l'utilisateur ADMIN pour accorder l'accès d'exécution aux ensembles DBMS_CLOUD.

    Le nom d'utilisateur des données d'identification est bot_id et le mot de passe est la clé du robot.

    Exemple :

    
    BEGIN     
        DBMS_CLOUD.CREATE_CREDENTIAL(credential_name => 'TEAMS_CRED',       
            username        => 'bot_id', 
            password        => 'bot_secret');
    END;
    /
     

    Pour plus d'informations, voir ProcédureCREATE_CREDENTIAL.

Envoyer des messages à un canal Microsoft Teams

Après avoir créé l'objet de données d'identification Microsoft Teams tel que décrit sous Préparer l'envoi d'avis Microsoft Teams à partir d'une base de données d'intelligence artificielle autonome, vous pouvez utiliser la procédure DBMS_CLOUD_NOTIFICATION.SEND_MESSAGE pour envoyer un message à un canal Microsoft Teams.

Exemple :

BEGIN
     DBMS_CLOUD_NOTIFICATION.SEND_MESSAGE(
        provider        => 'msteams',
        credential_name => 'TEAMS_CRED',
        message         => 'text from new teams api',
        params          => json_object('channel' value 'channelID'));
END;
/
 

Utilisez le paramètre params pour spécifier le canal.

Pour plus d'informations, voir ProcédureSEND_MESSAGE.

Envoyer les résultats d'interrogation à un canal Microsoft Teams

Après avoir créé l'objet de données d'identification Microsoft Teams tel que décrit sous Préparer l'envoi d'avis Microsoft Teams à partir d'une base de données autonome d'intelligence artificielle, vous pouvez utiliser la procédure DBMS_CLOUD_NOTIFICATION.SEND_DATA pour envoyer la sortie d'une interrogation à un canal Microsoft Teams.

Exemple :

BEGIN
     DBMS_CLOUD_NOTIFICATION.SEND_DATA(provider => 'msteams',
        credential_name => 'TEAMS_CRED',
        query           => 'SELECT tablespace_name FROM dba_tablespaces',
        params          => json_object('tenant'value '5b743bc******c0286',
                                       'team'value '0ae401*********5d2bd',
                                       'channel'value '19%3a94be023*****%40thread.tacv2',
                                       'title'value 'today',
                                       'type'value 'csv'));
END;
/
 

Utilisez le paramètre params pour spécifier le locataire, l'équipe, le canal, le titre et le type de données dans les valeurs string.

Note

La taille maximale de fichier prise en charge lors de l'utilisation de DBMS_CLOUD_NOTIFICATION.SEND_DATA pour Microsoft Teams est de 4 Mo.

Pour plus d'informations, voir ProcédureSEND_DATA.