Skip to main content

prompt.png Outil Invite

Exigences relatives au rôle d'utilisateur

Rôle d'utilisateur*

Accès aux outils/fonctionnalités

Utilisateur complet

✓

Utilisateur de base

X

*S'applique aux clients Alteryx OneÉditions Professional et Enterprise sur les versions 2025.1 et ultérieures de Designer.

Utilisez l'outil Invite pour envoyer des invites à un grand modèle de langage (LLM), puis recevez la réponse du modèle sous forme de sortie. Vous pouvez également configurer les paramètres LLM pour ajuster la sortie du modèle.

Composants de l'outil

L'outil Invite dispose de 3 ancrages (2 entrées et 1 sortie) :

  • Ancrage d'entrée M : (facultatif) utilisez l'ancrage d'entrée M pour connecter les paramètres de connexion du modèle à partir de llm_override_icon.png Outil Remplacement de LLM. Vous pouvez également configurer une connexion dans cet outil.llm_override_icon.png Outil Remplacement de LLM

  • Ancrage d'entrée D : (facultatif) utilisez l'ancrage d'entrée D pour vous connecter aux données que vous souhaitez ajouter à votre invite. L'outil Invite accepte les types de données standard (par exemple, String, Numeric et DateTime) en plus des données Blob provenant de l' Blob Input Tool Icon Outil Entrée Blob.

  • Ancrage de sortie : utilisez l'ancrage de sortie pour transférer la réponse du modèle en aval.

Configuration de l'outil

Connexion au service de modèle IA dans Alteryx One

L'outil se connecte automatiquement à l'espace de travail Alteryx One que vous avez utilisé pour vous connecter à l'application Alteryx One. Si vous souhaitez utiliser une connexion LLM à partir d'un autre espace de travail, vous pouvez effectuer cette modification via l'application Alteryx One ou Designer Desktop.

Sélectionner un espace de travail dans l'application Alteryx One

  1. Accédez à l'application Alteryx One.

  2. Sélectionnez le menu Profil pour afficher la liste des espaces de travail disponibles.

  3. Dans la liste, sélectionnez l'espace de travail qui inclut la connexion LLM que vous souhaitez utiliser.

  4. Revenez à Designer Desktop.

Sélectionner un lien Alteryx dans Designer Desktop

Note

La modification du lien actif via DCM est active pour votre session Designer Desktop en cours uniquement. Le lien actif revient à l'espace de travail sélectionné dans l'application Alteryx One lorsque vous rouvrez Designer Desktop.

Si vous avez déjà créé un lien Alteryx…

  1. Accédez à Fichier > Gérer les connexions pour ouvrir le Gestionnaire de connexions aux données.

  2. Consultez la page Liens Alteryx.

  3. Définissez votre lien comme lien actif. Sélectionnez Définir comme actif dans le menu à 3 points. Si vous y êtes invité, sélectionnez Oui, modifier pour lier à nouveau d'autres outils à ce nouveau lien actif.

  4. Quittez DCM pour revenir à votre workflow.

Créer un lien Alteryx dans Designer Desktop

Si vous devez créer un lien Alteryx…

  1. Accédez à Fichier > Gérer les connexions pour ouvrir le Gestionnaire de connexions aux données.

  2. Consultez la page Liens Alteryx, puis sélectionnez Connexion au cloud.

  3. Sélectionnez votre instance cloud (par exemple, sélectionnez États-Unis si votre URL commence par us1).

  4. Connectez-vous à Alteryx One, puis sélectionnez l'espace de travail que vous souhaitez utiliser.

  5. Suivez les instructions à l'écran pour terminer la configuration du lien.

  6. Définissez votre nouveau lien comme lien actif. Sélectionnez Définir comme actif dans le menu à 3 points. Si vous y êtes invité, sélectionnez Oui, modifier pour lier à nouveau d'autres outils à ce nouveau lien actif.

  7. Quittez DCM pour revenir à votre workflow.

Connexion LLM

Important

Avant de pouvoir sélectionner un LLM, un Administrateur de l'espace de travail doit créer une connexion LLM dans Alteryx One.Créer des connexions LLM

  1. Utilisez la liste déroulante Fournisseur LLM pour sélectionner le fournisseur que vous souhaitez utiliser dans votre workflow. Si vous avez connecté l'outil Remplacement de LLM, cette option est désactivée.

  2. Utilisez la liste déroulante Sélectionner un modèle pour sélectionner un modèle disponible auprès de votre fournisseur LLM. Si vous avez connecté l'outil Remplacement de LLM et sélectionné un modèle spécifique, cette option est désactivée.

Paramètres des invites

Utilisez la section Paramètres des invites pour composer votre invite et configurer les colonnes de données associées à l'invite et à la réponse.

  1. Saisissez votre invite dans le champ Modèle d'invite. Pour obtenir une estimation du nombre de jetons de votre invite, consultez le Nombre de jetons au bas du champ Modèle d'invite. Le nombre de jetons ne tient pas compte des jetons supplémentaires qui pourraient provenir des colonnes de données insérées.

  2. Incluez les données en amont dans votre invite pour une analyse plus avancée. L'outil Invite crée une nouvelle invite pour chaque ligne de vos données entrantes. L'outil envoie ensuite une requête LLM pour chacune de ces lignes.

    1. Pour insérer une colonne d'entrée de données, vous pouvez…

      1. Saisir un crochet ouvrant ([) dans le champ de texte pour accéder au menu de sélection de colonne. Vous pouvez également saisir le nom de la colonne entre crochets ([]).

      2. Sélectionnez une colonne dans la liste déroulante Insérer un champ.

    2. Pour joindre des données non structurées, telles que des fichiers image ou PDF, sélectionnez la colonne qui contient les données non structurées dans la liste déroulante Joindre des colonnes non textuelles. Utilisez un Blob Input Tool Icon Outil Entrée Blob pour intégrer vos images et vos fichiers PDF dans votre workflow.

      Note

      La prise en charge des données non structurées, telles que les images et les PDF, dépend de votre fournisseur LLM et du modèle que vous sélectionnez. Consultez la documentation de votre fournisseur LLM pour plus de détails sur les types de données non structurées ou multimodales pris en charge.

  3. Saisissez le Nom de la colonne de réponse. Cette colonne contient la réponse LLM à votre invite.

  4. Exécutez le workflow. 

Prompt Builder

Utilisez Prompt Builder pour tester rapidement différentes invites et configurations de modèle. Vous pouvez ensuite comparer les résultats avec l'historique des invites. Pour tester différents modèles et différentes configurations de modèles, exécutez le workflow avec votre invite initiale, puis sélectionnez Affiner et tester dans Prompt Builder pour ouvrir la fenêtre Prompt Builder.

Important

Prompt Builder a besoin de données connectées à l'ancrage d'entrée D.

Onglet Espace de travail d'invite

Utilisez l'onglet Espace de travail d'invite pour saisir vos invites et mettre à jour les configurations de modèle :

  1. Utilisez la liste déroulante Sélectionner un modèle pour sélectionner un modèle disponible auprès de votre fournisseur LLM.

  2. Saisissez le nombre d'enregistrements à tester. Si vous disposez d'un grand jeu de données, utilisez ce paramètre pour limiter le nombre d'enregistrements testés avec votre invite.

  3. Configurez les paramètres du modèle pour la température, les jetons de sortie maximum et TopP. Reportez-vous à la section Paramètres de configuration avancés du modèle pour obtenir la description des paramètres.

  4. Saisissez ou mettez à jour votre invite dans le champ de texte Modèle d'invite.

    Astuce

    Pour vous aider à créer une invite prête à l'emploi, sélectionnez Générer une invite pour moi, puis décrivez votre tâche. Pour utiliser cette fonctionnalité, votre compte Alteryx One doit avoir accès à Ask Alteryx.

  5. Sélectionnez Tester et exécuter pour afficher les réponses d'échantillon pour chaque ligne.

  6. Si vous êtes satisfait des réponses de la nouvelle invite, sélectionnez Save Prompt to Canvas pour mettre à jour l'outil Invite avec la nouvelle invite et la configuration du modèle.

Onglet Historique

Utilisez l'onglet Historique pour afficher vos invites passées, les paramètres du modèle et une réponse d'échantillon.

Pour chaque invite passée, vous pouvez…

  • Ajouter au canevas : mettez à jour l'outil Invite avec l'invite sélectionnée et les paramètres de modèle associés.

  • Ajouter aux favoris : permet d'enregistrer l'invite sélectionnée dans une liste de vos invites favorites. Sélectionnez le menu à trois points à côté de Ajouter au canevas pour trouver cette option. Pour afficher vos invites favorites, cochez la case Afficher uniquement les favoris.

  • Modifier l'invite : revenez à l'onglet Configuration avec l'invite sélectionnée et les paramètres de modèle associés. Sélectionnez le menu à trois points à côté de Ajouter au canevas pour trouver cette option.

  • Supprimer l'invite : permet de supprimer l'invite sélectionnée dans l'onglet Historique. Sélectionnez le menu à trois points à côté de Ajouter au canevas pour trouver cette option.

  • Télécharger les résultats : enregistrez un fichier CSV contenant les paramètres d'invite et de modèle pour la ligne actuelle dans l'onglet Historique.

Avertissement

Assurez-vous d'enregistrer votre invite avant de quitter la fenêtre Prompt Builder. Vous perdez l'historique de vos invites lorsque vous sélectionnez Fermer. 

Sortie structurée

Utilisez Sortie structurée pour définir un schéma JSON pour la réponse de LLM et appliquer un format cohérent et lisible par la machine sans décrire la structure dans votre invite. Lorsque cette option est activée, l'outil Invite envoie à la fois l'invite et le schéma au modèle, qui renvoie une réponse conforme à la structure définie. L'outil valide chaque réponse par rapport au schéma pour s'assurer que les champs obligatoires sont présents, que les types de données correspondent et que seuls les champs autorisés sont inclus.

  • Colonne de schéma JSON : sélectionnez la colonne qui contient votre schéma JSON. Le schéma définit la structure de réponse attendue, notamment les noms de champs, les types de données, les champs obligatoires et les contraintes. Pour créer facilement un schéma JSON, utilisez le json_schema.png JSON Schema Tool. Si vous sélectionnez l'option Aucune (aucune sortie structurée) par défaut, la sortie structurée est désactivée et le modèle renvoie du texte libre.

  • En cas d'échec de validation du schéma : sélectionnez comment l'outil gère les réponses qui ne sont pas conformes au schéma :

    • Définissez la sortie LLM sur Null : remplacer la réponse non valide par une valeur nulle.

    • Tentative d'écrire un JSON non valide : afficher la réponse même si elle n'est pas conforme au schéma.

    • Échec de l'outil lors du premier enregistrement : arrêter l'exécution de l'outil lorsque la première erreur de validation se produit.

Traitement des erreurs

Lorsqu'une erreur se produit, choisissez votre option de gestion des erreurs dans la liste déroulante En cas d'erreur :

  • Erreur - Arrêter le traitement des enregistrements : émettre une erreur dans la fenêtre de résultats et arrêter le traitement des enregistrements.

  • Avertissement - Poursuivre le traitement des enregistrements : émettre un avertissement dans la fenêtre de résultats, mais continuer le traitement des enregistrements.

  • Ignorer - Continuer les enregistrements de traitement : ignorer les colonnes qui diffèrent et continuer le traitement des enregistrements.

Paramètres de configuration avancés du modèle

Utilisez la section Configuration avancée du modèle pour configurer les paramètres du modèle :

  • Température : contrôle le caractère aléatoire de la sortie du modèle sous la forme d'un nombre compris entre 0 et 2. La valeur par défaut est 1.

    • Des valeurs plus faibles fournissent des réponses plus fiables et cohérentes.

    • Des valeurs plus élevées fournissent des réponses plus créatives et aléatoires, mais peuvent également devenir illogiques.

  • Max Output Tokens : nombre maximal de jetons que le LLM peut inclure dans une réponse. Chaque jeton correspond à environ 3/4 d'un mot. Les jetons sont des unités d'entrée et de sortie de base dans un LLM. Il s'agit de blocs de texte qui peuvent être des mots, des ensembles de caractères ou des combinaisons de mots et de ponctuation. Reportez-vous à votre fournisseur LLM et à votre modèle spécifique pour connaître le nombre maximal de jetons de sortie disponibles.

  • TopP : contrôle les jetons de sortie des échantillons de modèle et les plages de 0 à 1. Le modèle sélectionne les jetons les plus probables aux moins probables jusqu'à ce que la somme de leurs probabilités soit égale à la valeur TopP. Par exemple, si la valeur TopP est de 0,8 et que vous avez 3 jetons avec des probabilités de 0,5, 0,3 et 0,2, le modèle sélectionne uniquement les jetons avec les probabilités de 0,5 et 0,3 (somme de 0,8). Des valeurs plus faibles produisent des réponses plus cohérentes, tandis que des valeurs plus élevées produisent des réponses plus aléatoires.

Sortie

L'outil génère 2 colonnes de données de chaîne.

  • Colonne Invite LLM : contient votre invite.

  • Colonne Réponse LLM : contient la réponse de votre fournisseur LLM et du modèle.

Dans cette section​: