Créer votre assistant IA à l'aide d'actions

Avant de commencer

Avant de créer vos actions basées sur les compétences, vous devez vous conformer aux exigences suivantes.

Création d'actions basées sur les compétences à l'aide de l'API

Pour créer une action basée sur les compétences à l'aide de l'API, vous devez d'abord créer une spécification OpenAPI de la compétence.

Vous pouvez ensuite importer la compétence en utilisant le point de terminaison « Import skills » de l'API « watsonx Assistant ». Lorsque cela est fait, vous pouvez alors utiliser la compétence dans votre assistant.

Création d'actions basées sur des compétences à l'aide de l'interface utilisateur

Pour créer une action basée sur une compétence à l'aide de l'interface utilisateur, procédez comme suit :

1. Cliquez sur la vignette « AI Assistant Builder » dans watsonx Orchestrate pour accéder à l'outil de création d'assistants IA.

2. Dans le générateur d'assistants IA, accédez à Actions > Nouvelle action > Action basée sur une compétence.

3. Sur la page « Créer une action à partir d'une compétence », cliquez sur la compétence à laquelle vous souhaitez associer l 'action, afin qu'elle serve de base à votre action. Si vous ne voyez pas votre compétence, vérifiez qu'elle est bien activée dans l'ensemble de compétences correspondant à votre assistant.

4. Dans le champ « Nom de l'action », saisissez un nom pour votre action.

5. Dans Ajouter des conditions d'action, vous pouvez ajouter ou modifier des conditions pour le déclencheur d'action.

Pour plus d'informations, voir Ajout ou édition de conditions pour déclencher une action pour une compétence

1. Dans le champ « Saisir une phrase », saisissez la phrase que les clients doivent taper ou prononcer pour déclencher une action dans le cadre de la compétence « watsonx Orchestrate ». Par exemple, I want to pay my electricity bills.

2. Vous pouvez utiliser les options suivantes, situées dans le coin supérieur droit de la page, pour améliorer l'expérience avec l'assistant IA :

   • Mode de réponse aux actions

Définit le mode de réponse de votre assistant IA, par exemple « Clarifier » ou « Assurer »**.

• Notes d'action

Ouvre la fenêtre « Notes sur l'action » pour ajouter une description, de la documentation, des commentaires ou toute autre annotation qui vous aidera à suivre votre travail pendant que vous créez une action.

• Paramètres d'action

Ouvre la fenêtre des paramètres de l'action afin d'activer ou de désactiver les options « Poser une question de clarification » et « Changer de sujet de conversation » dans l'action.

1. Cliquez sur le bouton « Enregistrer » pour enregistrer l 'action.

Définition des étapes d'une action

Une action se compose d'une ou plusieurs _étapes_. Les étapes d'une action forment une séquence de messages qui définissent les échanges avec l'utilisateur après la saisie de la phrase déclencheuse de l'action. Dans un cas simple, une étape peut consister en une réponse directe à une question du client. Par exemple, si le client demande What are your business hours?, un assistant IA capable d'effectuer une action en une seule étape répond par We are open Monday through Friday from 9 AM to 5 PM..

Pour bien comprendre la demande du client, plusieurs étapes sont nécessaires. Par exemple, pour la saisie de l'utilisateur I want to withdraw money, l'assistant IA a besoin des informations supplémentaires suivantes :

• De quel compte l'argent doit-il provenir ?

• Quel est le montant à retirer ?

Chacune des questions de suivi correspond à une étape de l 'action.

Dans le générateur d'assistants IA, vous pouvez ajouter, modifier ou dupliquer des étapes au sein d'une action. Dans une étape, vous définissez les éléments suivants :

• Titre de l'étape qui décrit les actions de l'étape. Le titre de l'étape est facultatif.

• Toutes les conditions qui déterminent si l'étape est traitée lors de la phase d'exécution. (Par défaut, une étape est toujours traitée si l'entrée de l'utilisateur correspond.)

• Ce que l'assistant dit au client lors du traitement de l'étape.

• Règles sur la façon dont le client peut répondre à ce que dit l'assistant (si une réponse est attendue).

• Que faire après la fin de l'étape.

Pour plus d'informations sur l'ajout, la modification et la duplication d'étapes dans une action, consultez les rubriques suivantes :

• Ajout d'une nouvelle étape

• Édition d'une étape

• Duplication d'une étape

• Ajout d'étapes conditionnelles

Utilisation de l'éditeur d'actions

Lorsque vous créez l'action, l'éditeur d'action s'ouvre.

La fenêtre de l'éditeur affiche les parties d'une action :

• Nom d'affichage : Définissez un nom d'affichage pour remplacer le titre de l'action qui apparaît comme texte du bouton dans la désambiguïsation. Pour permettre la désambiguïsation, voir Poser des questions de clarification.

• Ajouter des phrases d'exemple : Saisissez des phrases que votre client pourrait utiliser pour lancer cette action. Plus vous saisissez de phrases, plus votre assistant est à même de reconnaître les souhaits du client.

• Sous Étapes de conversation, vous pouvez voir les étapes de l'action. Une étape est une interaction entre l'assistant et le client ; les étapes sont exécutées dans l'ordre, de la première à la dernière. Vous pouvez réorganiser les étapes d'une action en cliquant et en faisant glisser les étapes dans la liste.

• Le bouton Aperçu ouvre une sous-fenêtre qui vous montre comment l'assistant répond aux données client. Vous pouvez prévisualiser l'assistant à tout moment pour voir l'effet des modifications que vous apportez.

• L'icône Remarques sur l'action ouvre une zone dans laquelle vous pouvez ajouter une description, une documentation, des commentaires ou toute autre annotation pour vous aider à suivre votre travail lorsque vous générez une action.

L'éditeur d'actions prend en charge la syntaxe Markdown de base.

Visualiser le déroulement de l'action

Une fois que vous avez créé une action à partir de zéro, vous avez la possibilité de basculer entre l'onglet Editer et l'onglet Visualisation . Accédez à l'onglet Visualisation pour afficher le graphique de flux de l'action.

Lorsque vous visualisez le diagramme de flux de l'action, vous pouvez effectuer un zoom et un panoramique sur le canevas.

Obtention du montant

Nous avons besoin d'une information supplémentaire avant de pouvoir répondre à la demande du client : la somme d'argent à retirer.

1. Cliquez sur Nouvelle étape.

2. Dans la zone Assistant :, entrez How much do you want to withdraw?.

3. Cliquez sur « Définir la réponse du client ». Nous avons besoin que le client spécifie un montant monétaire, donc sélectionnez Devise.

Terminer l'action

Nous disposons à présent de toutes les informations dont nous avons besoin. Pour notre exemple, nous n'allons pas implémenter de logique réelle pour faire un retrait, mais nous pouvons envoyer un message final pour résumer ce que nous faisons.

Pour effectuer ce récapitulatif, nous devons insérer des variables d'action (représentant les réponses des clients des étapes précédentes) dans notre réponse. Lors de l'exécution, ces variables d'action sont remplacées par les valeurs réelles fournies par le client.

1. Cliquez sur Nouvelle étape.

2. Maintenant, nous devons créer un message de confirmation qui dit « OK, nous allons retirer le montant de votre compte account_type ».

Pour créer cette réponse, saisissez le texte du message dans le champ « L'Assistant dit », mais à la place des valeurs des variables, cliquez sur l'icône « Insérer une variable » pour insérer des références aux variables d'action :

• Pour le montant, sélectionnez 4. Combien voulez-vous retirer ?.

• Pour account_type, sélectionnez 1. Retirer de quel compte ?.

1. Comme il s'agit de la dernière étape de l'action, il n'est pas nécessaire d'indiquer une réponse du client.

Si vous décidez qu'une étape n'est plus nécessaire, vous pouvez la supprimer de l'action. Pour supprimer une étape, cliquez sur l'icône Supprimer située sur la vignette de l'étape.

Tester l'action

Vous pouvez maintenant tester l'action pour vous assurer qu'elle fonctionne. Cliquez sur Aperçu pour ouvrir la panneau de prévisualisation. Si le texte d'un test précédent s'affiche toujours, cliquez sur l'icône Actualiser pour relancer la conversation.

Commencez par saisir I want to withdraw money. Essayez différentes permutations de votre entrée pour tester le comportement de l'assistant :

• Essayez de sélectionner Savings et Checking. Confirmez que si vous sélectionnez Checking, l'assistant vous avertit qu'il y a des frais à payer et vous demande si vous souhaitez continuer, mais si vous sélectionnez Savings, il procède sans avertissement.

• Lorsque vous sélectionnez Checking, essayez les deux réponses lorsque l'assistant vous demande si vous souhaitez continuer. Confirmez que si vous sélectionnez No, l'action se termine.

• Essayez d'inclure des informations supplémentaires dans votre message initial. Par exemple, essayez de saisir I want to withdraw $50 from my savings account. Confirmez que l'assistant ne vous demande plus d'indiquer les informations que vous avez déjà fournies.

Voilà ! Vous avez créé une action simple qui inclut plusieurs étapes, qui collecte des informations qu'elle stocke en tant que variables d'action et qui conditionnent ses réponses en fonction de ce que votre client choisit. Il y a beaucoup d'autres choses que vous pouvez faire avec les actions, mais tout est construit sur ce modèle de base.