Utiliser les outils d'IA sur Server
Configurer et exécuter Outils d'IA sur Server avec un principal de service. Utilisez ce guide pour créer un principal de service dans Alteryx One et connecter vos outils d’IA. Pour plus d’informations sur les principaux de service dans Alteryx One, accédez à la page Principaux de service.
Configuration requise
Un Administrateur de l'espace de travail doit créer et gérer les principaux de service.
Vous devez être Utilisateur complet ou disposer d'un rôle personnalisé avec la capacité Outils d’IA générative pour utiliser les outils d’IA.
AMP doit être activé pour Server. Un administrateur doit activer AMP dans les Paramètres système. Pour plus d'informations sur AMP et Server, accédez à Bonnes pratiques du moteur AMP.
Première configuration
Effectuez ces étapes une fois pour permettre aux outils d'IA de se connecter à votre connexion LLM dans Alteryx One.
Créer un principal de service dans Alteryx One
Note
Vous devez être un Administrateur de l'espace de travail pour effectuer cette étape.
Dans Alteryx One, ouvrez le menu Profil.
Accédez à Admin de l'espace de travail > Principaux de service.
Sélectionner Nouveau.
Saisir les valeurs :
Nom : Saisir un nom unique.
Description : Saisir une description.
Durée de vie secrète (jours) : saisissez une valeur comprise entre 1 et 365.
Dans Rôles, sélectionnez un rôle Utilisateur complet ou un rôle personnalisé avec la fonctionnalité Outils GenIA.
Sélectionnez Créer.
Après avoir créé le principal de service :
Copiez l'ID client.
Copiez le secret client.
Stockez ces valeurs en toute sécurité.
Partagez la connexion LLM dans Alteryx One
Accédez à Données.
Sélectionnez Connexions.
Localisez la connexion LLM.
Sélectionnez le menu à trois points, puis sélectionnez Partager.
Dans la section Sélectionner des utilisateurs ou des principaux de service, sélectionnez le principal de service.
Dans la liste déroulante des rôles, sélectionnez Éditeur (ou le rôle requis).
Assurez-vous de modifier le paramètre de partage des informations d'identification en remplaçant Ne pas partager les informations d'identification par Partager les informations d'identification.
Sélectionnez Partager.
Configurer l'outil Invite ou Remplacement de LLM dans Designer
Sélectionnez la connexion du principal de service
Dans Designer, ouvrez votre workflow.
Sélectionner l’outil Prompt.
Dans la section Options de connexion, sélectionnez Principal de service (pour Server).
Créer une connexion
Sélectionner Créer une nouvelle connexion.
Dans Data Connection Manager (DCM), sélectionnez + Nouveau.
Dans la liste déroulante Sélectionner la technologie, sélectionnez Application OAuth Alteryx One.
Saisir les informations d'identification
Note
Pour saisir ces informations d'identification, vous devez avoir accès à l’ID client et au secret client du principal de service. Si vous n'avez pas créé le principal de service, demandez à Administrateur de l'espace de travail de fournir ces valeurs.
Dans Nom de la source de données, saisissez un nom.
Dans ID client, saisissez l’ID client du principal de service.
Dans Secret client, saisissez le secret client du principal de service.
Sélectionner Enregistrer.
Publier le Workflow dans Server
Après avoir configuré la connexion principale du service, publiez votre workflow sur Server.
Le Workflow s’exécute sur Server à l’aide du principal de service. Les outils d’IA utilisent la connexion LLM partagée et s’exécutent sans nécessiter l’authentification des utilisateurs.
Changer les secrets du principal de service
Les secrets clients d’un principal de service expirent après un an. Lorsque le secret expire, mettez à jour la connexion du principal de service avec un nouveau secret client dans le Gestionnaire de connexions de données. Pour plus d’informations sur la rotation des secrets, accédez à la page Principaux de service.
Note
Si vous n'avez pas créé le principal de service, demandez à un Administrateur de l'espace de travail de fournir un nouveau secret client.
Générer un nouveau secret client
Depuis Alteryx One, accédez à Admin de l'espace de travail > Principaux de service.
Sur la page Principaux de service, sélectionnez un principal de service pour ouvrir sa page de détails.
Sélectionner Générer le secret.
Copiez et stockez le nouveau code secret en toute sécurité.
Mettre à jour la connexion dans Designer
Dans Designer, sélectionnez Fichier > Gérer les connexions.
Sur la page Connexions, sélectionnez la connexion du principal de service.
Sélectionner Modifier.
Saisissez le secret client, puis sélectionnez Enregistrer.
Vérifiez la connexion pour vous assurer qu'elle fonctionne comme prévu avant de l'utiliser dans des workflows.