Outil Invite
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
Outil Remplacement de LLM. Vous pouvez également configurer une connexion dans cet outil.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'
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
Si vous n'utilisez pas l'outil Remplacement de LLM pour fournir les paramètres de connexion du modèle à l'outil Invite, vous devez configurer une connexion au service de modèle IA dans Alteryx One.
Pour la première configuration de l'outil Invite, créez un lien Alteryx vers votre espace de travail Alteryx One. En vous connectant à Designer via Alteryx One, vous devriez voir une connexion déjà configurée pour cet espace de travail.
Connexion LLM
Important
Avant de pouvoir sélectionner un LLM, un doit créer une connexion LLM dans Alteryx One.
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.
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.
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.
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.
Pour insérer une colonne d'entrée de données, vous pouvez…
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 ([]).Sélectionnez une colonne dans la liste déroulante Insérer un champ.
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
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.
Saisissez le Nom de la colonne de réponse. Cette colonne contient la réponse LLM à votre invite.
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 :
Utilisez la liste déroulante Sélectionner un modèle pour sélectionner un modèle disponible auprès de votre fournisseur LLM.
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.
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.
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 à Alteryx Copilot.
Sélectionnez Tester et exécuter pour afficher les réponses d'échantillon pour chaque ligne.
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.
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.
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.
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.