Utiliser les outils d'IA sur Server
Configurez et exécutez des Outils d'IA sur Server 2026.1 avec un principaux 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 GenIA 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, consultez AMP Engine.
Première configuration
Effectuez ces étapes une fois pour permettre aux outils d'IA de se connecter à votre connexion LLM dans Alteryx One.
Créez un principal du service dans Alteryx One
Note
Vous devez être un Administrateur de l'espace de travail pour effectuer cette étape.
Dans Alteryx One, ouvrez votre menu de profil.
Accédez à Admin de l'espace de travail > Principaux de service.
Sélectionnez Nouveau.
Saisir les valeurs :
Nom : saisissez un nom unique.
Description : saisissez 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 du client.
Stockez ces valeurs en toute sécurité.
Partager 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 du service.
Dans la liste déroulante rôle, sélectionnez Éditeur (ou le rôle requis).
Définissez le partage d'informations d'identification sur 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électionnez l'outil Invite.
Dans la section Options de connexion, sélectionnez Principal de service (pour Server).
Créer une connexion
Sélectionnez Créer une connexion.
Dans le Gestionnaire de connexions aux données (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 de l'entité de sécurité du service. Si vous n'avez pas créé le principal de service, demandez à un 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 du service.
Dans Secret client, saisissez le secret client du principal de service.
Sélectionnez Enregistrer.
Publier le workflow vers Server
Après avoir configuré la connexion principale du service, publiez votre workflow sur Server.
Le workflow s'exécute sur Server en utilisant le principal de service. Les outils d'IA utilisent la connexion LLM partagée et s'exécutent sans nécessiter l'authentification de l'utilisateur.
Changer les secrets du principal de service
Les secrets client d'un principal de service expirent après 1 an. Lorsque le code secret expire, mettez à jour la connexion du principal du service avec un nouveau code secret client dans le Gestionnaire de connexion aux données. Pour plus d'informations sur la rotation secrète, consultez 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érez un nouveau secret client
Depuis Alteryx One, accédez à Admin de l'espace de travail > Principaux de service.
Sur la page des Principaux du service, sélectionnez un principal du service pour accéder à sa page de détails.
Sélectionnez Générer le jeton.
Copiez et stockez le nouveau code secret en toute sécurité.
Mettre à jour la connexion dans Designer Desktop
Dans Designer Desktop, sélectionnez Fichier > Gérer les connexions.
Sur la page Connexions, sélectionnez la connexion du principal de service.
Sélectionnez 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.