Créer une requête de nœud Requête HTTP

  • 3 minutes

(Facultatif) Créer une requête de nœud Requête HTTP

Se connecter aux données offre de grands avantages aux sociétés, car elles fournissent aux utilisateurs des informations et insights à jour et souvent pertinents pour les questions client ou utilisateur.

Dans cet exercice, vous allez examiner la création d’une rubrique, l’ajout d’une action de nœud Requête HTTP simple pour récupérer des informations à partir d’un service externe et la présentation de ces données à l’utilisateur.

Tâche 1 : créer une rubrique

  1. Connectez-vous à Copilot Studio et ouvrez l’agent de support Contoso que nous avons créé dans les labos précédents.

  2. Accédez à l’onglet Rubriques dans le menu de navigation.

  3. Cliquez sur Ajouter une rubrique et sélectionnez l’option À partir de zéro. Nommez la rubrique Crypto Currency Price.

    Capture d’écran de l’ajout d’une rubrique à partir de zéro.

  4. Ajoutez les phrases déclencheur suivantes au nœud Déclencheur :

    What's the current price of Bitcoin 
Can you tell me the latest crypto prices 
How much does Bitcoin cost now 
What are the prices of digital currencies today 
What's the latest on crypto prices

  5. Ajoutez un nœud Envoyer une requête HTTP, à partir de l’onglet Avancé, sous le nœud Déclencheur.

    Capture d’écran du nœud Envoyer une requête HTTP.

  6. Nous devons maintenant fournir un lien afin que l’API récupère les informations dont nous avons besoin.

  7. Pour ce faire, cliquez sur le menu volant URL, sélectionnez Formule, collez l’URL suivante dans le champ Formule : "https://api.gemini.com/v2/ticker/btcusd", puis cliquez sur Insérer.

    Capture d’écran de l’insertion d’une URL dans une requête HTTP.

  8. Ensuite, nous devons indiquer au nœud le type de données que l’appel d’API va renvoyer. Redéfinissez le champ Type de données de la réponse sur Enregistrement.

    Capture d’écran du champ Type de données de la réponse de la requête HTTP.

    Remarque

    Lorsque nous définissons le type de données de réponse Enregistrement, nous devons donner un Schéma au nœud, afin qu’il puisse corréler les types de données des variables individuelles.

  9. Cliquez sur Modifier le schéma et effacez ce qui est déjà renseigné. Collez le schéma suivant dans la fenêtre Modifier le schéma et cliquez sur Confirmer :

    kind: Record
properties:
    bid: String

    Capture d’écran du schéma de la requête HTTP.

    Remarque

    Le schéma suivant a été simplifié pour les besoins de ce labo. En général, un schéma pour cette requête a plusieurs propriétés et peut être généré à partir d’un exemple de charge utile JSON.

  10. Nous devons maintenant créer une variable pour stocker les résultats de la requête API.

  11. Cliquez sur le champ sous Enregistrer la réponse sous, puis sur Créer une variable. Nommez la variable CurrentCryptoPrice.

    Capture d’écran de la variable CurrentCryptoPrice.

  12. Ajoutez maintenant un nœud Message qui donne aux utilisateurs une réponse formatée avec le prix actuel du Bitcoin.

  13. Cliquez sur le symbole + sous le nœud Requête HTTP, puis sélectionnez Envoyer un message.

  14. Dans le nœud Message venant d’être créé, ajoutez le message suivant : The current bid price for Bitcoin is ${Topic.CurrentCryptoPrice.bid}.

    Capture d’écran du nœud Message avec la variable Topic.CurrentCryptoPrice.

  15. Pour mettre fin à la conversation, ajoutez un nœud Accéder à une autre rubrique sous Gestion des rubriques, puis sélectionnez Fin de la conversation.

    Capture d’écran du nœud de rubrique Fin de la conversation.

  16. Enregistrez la rubrique.

  17. À présent, ouvrez le volet Test et testez votre agent avec la phrase suivante : What's the current price of Bitcoin?

    Capture d’écran du test relatif au prix du Bitcoin.