Aller au contenu principal

OpenAI

Cette action permet de générer du texte en fonction d'un stimulus et des messages précédents de la conversation. Elle peut être utilisée dans divers scénarios, allant des interactions de style conversationnel classique avec un assistant à des actions spécifiques telles que la résumé de conversations pour vos agents, la fourniture de conseils ou la détection de comportements utilisateur potentiels. L'efficacité de l'action dépend largement de la qualité du stimulus fourni.

astuce

Avant d'utiliser cette action, il est recommandé de se familiariser avec l'ingénierie de stimulus, disponible ici.

Fonctionnement de cette action

Voici quelques explications sur le fonctionnement de cette action et ses limitations :

  • Le bot exécute toujours cette action de manière synchrone, c'est-à-dire qu'il attend que l'API OpenAI renvoie une réponse avant de passer à l'étape suivante. De manière similaire à l'action Webhook, si vous avez plusieurs actions OpenAI consécutives, elles seront exécutées séquentiellement plutôt que par lots.

  • Le bot poursuivra son flux même si l'action OpenAI échoue pour une raison quelconque, comme un délai d'attente.

  • Il est de votre responsabilité de gérer la réponse, qu'elle soit réussie ou non. Vous devrez spécifier des variables pour stocker la réponse OpenAI. Ensuite, c'est à vous d'utiliser ces variables plus tard dans le bot, par exemple, comme conditions dans un bloc de choix, dans des messages ou des notes.

Comment l'utiliser

Seuls le jeton et le stimulus sont obligatoires.

Paramètre Jeton OpenAI

Vous pouvez trouver la clé API sur votre compte OpenAI.

astuce

Vous pouvez directement coller la clé dans le champ d'entrée, ou vous pouvez la sauvegarder en tant que variable avec une valeur par défaut, ce qui peut être utile pour la réutilisation dans plusieurs actions :

Paramètre Stimulus

Le stimulus vous permet de construire un assistant personnalisé. Vous pouvez y insérer des variables pour le rendre plus dynamique.

Messages précédents analysés

TypeAction
Tous les messages de la conversationEnvoie l'ensemble de la conversation à OpenAI. Chaque message envoyé est interprété comme "Assistant" par OpenAI, et chaque message reçu est interprété comme "Utilisateur".
Seulement de la session de bot actuelleEnvoie les messages dans le même "fil de discussion" à partir du dernier redémarrage du bot dans la conversation.
Seulement le dernier messageLa dernière réponse de l'utilisateur.
Seulement le stimulusSeul le stimulus est utilisé pour interroger l'API OpenAI.

Gestion de la réponse OpenAI

Même après avoir correctement configuré votre action OpenAI, des échecs occasionnels (principalement dus à des délais d'attente) peuvent survenir. Si le comportement de votre bot dépend de la réponse OpenAI, il est crucial de gérer les erreurs de manière appropriée. Toutes les erreurs rencontrées seront stockées dans la variable spécifiée, ou utiliseront la variable last webhook failure :

Il vous appartient de décider comment gérer ces erreurs. L'approche recommandée est de créer une variable spécifique pour chaque webhook, puis d'utiliser un bloc de choix pour vérifier si la variable contient un message.