Utilisez les outils d'intelligence artificielle sur le serveur
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
A Administrateur de l'espace de travail doit créer et gérer les principes de service.
Vous devez être un Utilisateur complet ou avoir un rôle personnalisé avec la fonctionnalité Outils d'IA de génération 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.
Configuration initiale
Effectuez ces étapes une fois pour permettre aux outils d'intelligence artificielle de se connecter à votre connexion LLM dans Alteryx One.
Créer un principal du service
Note
Vous devez être un utilisateur enregistré Administrateur de l'espace de travail pour effectuer cette étape.
Dans Alteryx One, ouvrez le menu de votre profil.
Accédez à Workspace Admin > Service Principals.
Sélectionnez Nouveau.
Saisir une valeur…
Nom : saisissez un nom descriptif.
[Facultatif] Saisissez une description.
Durée de vie secrète (jours): saisissez une valeur comprise entre 1 et 365.
Dans " Rôles", sélectionnez un Utilisateur complet rôle ou un rôle personnalisé avec la fonctionnalité "Outils Gen AI".
Sélectionnez Créer.
Après avoir créé le principal de service :
Saisissez l'ID Client.
Saisir le secret du 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 Supprimer.
Dans la section " Sélectionner des utilisateurs ou des directeurs de service", sélectionnez le "Service Principal".
Dans la liste déroulante rôle, sélectionnez Éditeur (ou le rôle requis).
Définissez le partage des informations d'identification sur partager les informations d'identification.
Sélectionnez Partager.
Configurez l'invite ou l'outil de remplacement LLM dans Designer
Sélectionnez la connexion principale de service
Dans Designer, ouvrez votre flux de travail.
Sélectionnez l'outil invite.
Dans la section Options de connexion, sélectionnez principal de service (pour le serveur).
Créer une connexion
Sélectionnez Créer une application.
Dans la fenêtre Gestionnaire de connexions, sélectionnez + NOUVEAU.
Dans la liste déroulante Select Technology (Sélectionner une technologie), sélectionnez Alteryx One OAuth application(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 à a 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 de rôle utilisateur de l'application.
Dans le champ client Secret, saisissez le code secret du client principal du service.
Sélectionnez Enregistrer.
Publier le flux de travail dans Server
Après avoir configuré la connexion principale du service, publiez votre flux de travail sur Server.
Le flux de travail s'exécute à 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 de l'utilisateur.
Rotation des secrets de service principal
Les secrets client d'un principal de service expirent après 1 an. Lorsque le code secret expire, mettez à jour la connexion principale du service avec un nouveau code secret client dans le Gestionnaire de connexion de données. Pour plus d'informations sur la rotation secrète, consultez la https://help.alteryx.com/aac/en/platform/admin/admin-reference/service-principals.html#secret-rotation page Principes de service.
Note
Si vous n'avez pas créé l'entité de sécurité du 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 à Workspace Admin > Service Principals.
Sur la page des principes de service, sélectionnez un service principal 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é.
Mettez à jour la connexion dans Designer Desktop
Dans Designer Desktop, sélectionnez fichier > gérer les connexions.
Sur la page connexions, sélectionnez la connexion principale du service.
Sélectionnez Modifier.
Saisissez le code secret du client , puis sélectionnez Enregistrer.
Vérifiez la connexion pour vous assurer qu'elle fonctionne comme prévu avant de l'utiliser dans les workflows.